org.apache.excalibur.source.impl
Class SourceResolverImpl
java.lang.Object
org.apache.avalon.framework.logger.AbstractLogEnabled
org.apache.excalibur.source.impl.SourceResolverImpl
- All Implemented Interfaces:
- Component, Contextualizable, Disposable, LogEnabled, Serviceable, SourceResolver, ThreadSafe
- public class SourceResolverImpl
- extends AbstractLogEnabled
- implements Serviceable, Contextualizable, Disposable, SourceResolver, ThreadSafe
This is the default implemenation of a SourceResolver. The source resolving is done relative to a base directory/URI (if the given location is relative). This implementation looks for the base URI in the Context object of the "container" for the "context-root" information. This information can either be a File object or a URL object. If the entry does not exist, the system property "user.dir" is used as the base URI instead.
- Version:
- $Id: SourceResolverImpl.java,v 1.4 2004/02/28 11:47:24 cziegeler Exp $
- Author:
- See Also:
SourceResolver
| Method Summary |
private java.lang.String |
absolutize(SourceFactory factory, java.lang.String baseURI, java.lang.String systemID)
Makes an absolute URI based on a baseURI and a relative URI. |
void |
contextualize(Context context)
Get the context |
void |
dispose()
The dispose operation is called at the end of a components lifecycle. |
void |
release(Source source)
Releases a resolved resource |
Source |
resolveURI(java.lang.String location)
Get a Source object. |
Source |
resolveURI(java.lang.String location, java.lang.String baseURI, java.util.Map parameters)
Get a Source object. |
void |
service(ServiceManager manager)
Set the current ComponentLocator instance used by this Composable. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
m_manager
protected ServiceManager m_manager
-
The component m_manager
m_factorySelector
protected ServiceSelector m_factorySelector
-
The special Source factories
m_baseURL
protected java.net.URL m_baseURL
-
The base URL
SourceResolverImpl
public SourceResolverImpl()
contextualize
public void contextualize(Context context)
throws ContextException
-
Get the context
-
- Specified by:
contextualize in interface Contextualizable
-
- Parameters:
context - the context. Must not be null.
- Throws:
ContextException - if context is invalid
service
public void service(ServiceManager manager)
throws ServiceException
-
Set the current
ComponentLocator instance used by this Composable.
-
- Specified by:
service in interface Serviceable
-
- Parameters:
manager - The ServiceManager which this Serviceable uses. Must not be null.
- Throws:
ServiceException - if an error occurs
dispose
public void dispose()
- Description copied from interface:
Disposable
-
The dispose operation is called at the end of a components lifecycle. This method will be called after Startable.stop() method (if implemented by component). Components use this method to release and destroy any resources that the Component owns.
-
- Specified by:
dispose in interface Disposable
-
resolveURI
public Source resolveURI(java.lang.String location)
throws java.net.MalformedURLException,
java.io.IOException,
SourceException
-
Get a
Source object.
-
- Specified by:
resolveURI in interface SourceResolver
-
- Returns:
- the resolved source object.
- Throws:
SourceNotFoundException - if the source cannot be found
java.io.IOException - if the source couldn't be created for some other reason.
java.net.MalformedURLException
SourceException
resolveURI
public Source resolveURI(java.lang.String location,
java.lang.String baseURI,
java.util.Map parameters)
throws java.net.MalformedURLException,
java.io.IOException,
SourceException
-
Get a
Source object.
-
- Specified by:
resolveURI in interface SourceResolver
-
- Parameters:
location - - the URI to resolve. If this is relative it is either resolved relative to the base parameter (if not null) or relative to a base setting of the source resolver itself.
baseURI - - a base URI for resolving relative locations. This is optional and can be null.
parameters - - Additional parameters for the URI. The parameters are specific to the used scheme.
- Returns:
- the resolved source object.
- Throws:
SourceNotFoundException - if the source cannot be found
java.io.IOException - if the source couldn't be created for some other reason.
java.net.MalformedURLException
SourceException
absolutize
private java.lang.String absolutize(SourceFactory factory,
java.lang.String baseURI,
java.lang.String systemID)
-
Makes an absolute URI based on a baseURI and a relative URI.
-
-
release
public void release(Source source)
-
Releases a resolved resource
-
- Specified by:
release in interface SourceResolver
-
- Parameters:
source - the source to release
Please see keelframework.org for information about new Keel releases.