org.apache.catalina

Interface Loader

public interface Loader

A Loader represents a Java ClassLoader implementation that can be used by a Container to load class files (within a repository associated with the Loader) that are designed to be reloaded upon request, as well as a mechanism to detect whether changes have occurred in the underlying repository.

In order for a Loader implementation to successfully operate with a Context implementation that implements reloading, it must obey the following constraints:

Version: $Revision: 467222 $ $Date: 2006-10-24 05:17:11 +0200 (Tue, 24 Oct 2006) $

Author: Craig R. McClanahan

Method Summary
voidaddPropertyChangeListener(PropertyChangeListener listener)
Add a property change listener to this component.
voidaddRepository(String repository)
Add a new repository to the set of repositories for this class loader.
voidbackgroundProcess()
Execute a periodic task, such as reloading, etc.
String[]findRepositories()
Return the set of repositories defined for this class loader.
ClassLoadergetClassLoader()
Return the Java class loader to be used by this Container.
ContainergetContainer()
Return the Container with which this Loader has been associated.
booleangetDelegate()
Return the "follow standard delegation model" flag used to configure our ClassLoader.
StringgetInfo()
Return descriptive information about this Loader implementation and the corresponding version number, in the format <description>/<version>.
booleangetReloadable()
Return the reloadable flag for this Loader.
booleanmodified()
Has the internal repository associated with this Loader been modified, such that the loaded classes should be reloaded?
voidremovePropertyChangeListener(PropertyChangeListener listener)
Remove a property change listener from this component.
voidsetContainer(Container container)
Set the Container with which this Loader has been associated.
voidsetDelegate(boolean delegate)
Set the "follow standard delegation model" flag used to configure our ClassLoader.
voidsetReloadable(boolean reloadable)
Set the reloadable flag for this Loader.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
Add a property change listener to this component.

Parameters: listener The listener to add

addRepository

public void addRepository(String repository)
Add a new repository to the set of repositories for this class loader.

Parameters: repository Repository to be added

backgroundProcess

public void backgroundProcess()
Execute a periodic task, such as reloading, etc. This method will be invoked inside the classloading context of this container. Unexpected throwables will be caught and logged.

findRepositories

public String[] findRepositories()
Return the set of repositories defined for this class loader. If none are defined, a zero-length array is returned.

getClassLoader

public ClassLoader getClassLoader()
Return the Java class loader to be used by this Container.

getContainer

public Container getContainer()
Return the Container with which this Loader has been associated.

getDelegate

public boolean getDelegate()
Return the "follow standard delegation model" flag used to configure our ClassLoader.

getInfo

public String getInfo()
Return descriptive information about this Loader implementation and the corresponding version number, in the format <description>/<version>.

getReloadable

public boolean getReloadable()
Return the reloadable flag for this Loader.

modified

public boolean modified()
Has the internal repository associated with this Loader been modified, such that the loaded classes should be reloaded?

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
Remove a property change listener from this component.

Parameters: listener The listener to remove

setContainer

public void setContainer(Container container)
Set the Container with which this Loader has been associated.

Parameters: container The associated Container

setDelegate

public void setDelegate(boolean delegate)
Set the "follow standard delegation model" flag used to configure our ClassLoader.

Parameters: delegate The new flag

setReloadable

public void setReloadable(boolean reloadable)
Set the reloadable flag for this Loader.

Parameters: reloadable The new reloadable flag

Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.