org.apache.myfaces.trinidadinternal.share.io
Interface NameResolver

All Known Implementing Classes:
CachingNameResolver, ClassResourceNameResolver, DefaultNameResolver, ServletNameResolver

public interface NameResolver

NameResolvers are responsible for converting string names into InputStreamProviders, which encapsulate a remote file. Implementations exist that support using URLs, Files, Class resources, and the Servlet API to locate files, but other APIs may be substituted.

In some cases, the resolved target file may have need to locate support files of its own. Since those support files should be looked for relative to the target file, NameResolver supports creating new relative NameResolvers.

Developers writing their own NameResolver should strongly consider subclassing BaseNameResolver.

Version:
$Name: $ ($Revision: adfrt/faces/adf-faces-impl/src/main/java/oracle/adfinternal/view/faces/share/io/NameResolver.java#0 $) $Date: 10-nov-2005.19:00:09 $
Author:
The Oracle ADF Faces Team
See Also:
XMLUtils.getResolver(org.apache.myfaces.trinidadinternal.share.xml.ParseContext),


Method Summary
 InputStreamProvider getProvider(java.lang.String name)
          Given a name, returns an InputStreamProvider.
 NameResolver getResolver(java.lang.String name)
          Return the new NameResolver that should be used to resolve names relative to a given name.
 

Method Detail

getProvider

InputStreamProvider getProvider(java.lang.String name)
                                throws java.io.IOException
Given a name, returns an InputStreamProvider. This function should never return null - if the target cannot be resolved, throw an IOException.

Parameters:
name - the name of the target
Throws:
java.io.IOException

getResolver

NameResolver getResolver(java.lang.String name)
Return the new NameResolver that should be used to resolve names relative to a given name. This function should never return null - if the target cannot be resolved, return a resolver that can only support absolute names.

Parameters:
name - the name of the target


Copyright © 2001-2007 Apache Software Foundation. All Rights Reserved.