Log4j 1.3alpha-7

org.apache.log4j.spi
Interface RepositorySelector

All Known Implementing Classes:
ContextJNDISelector, DefaultRepositorySelector

public interface RepositorySelector

The LogManager uses one (and only one) RepositorySelector implementation to select the LoggerRepository for a particular application context.

It is the responsability of the RepositorySelector implementation to track the application context. Log4j makes no assumptions about the application context or on its management.

See also LogManager.

Since:
1.2
Author:
Ceki Gülcü

Method Summary
 LoggerRepository detachRepository(String name)
          Remove the repository with the given name from the list maintained by the respository selector.
 LoggerRepository getLoggerRepository()
          Returns a LoggerRepository depending on the context.
 LoggerRepository getLoggerRepository(String name)
          Get a LoggerRepository by name.
 

Method Detail

getLoggerRepository

public LoggerRepository getLoggerRepository(String name)
Get a LoggerRepository by name. If the named repository does not exists or is unknown to this selector, then null is returned.

Since:
1.3

getLoggerRepository

public LoggerRepository getLoggerRepository()
Returns a LoggerRepository depending on the context. Implementors must make sure that under all circumstances a valid (non-null) LoggerRepository is returned.


detachRepository

public LoggerRepository detachRepository(String name)
Remove the repository with the given name from the list maintained by the respository selector.

When applications are stopped or recycled, this method should be called to ensure that the associated repository is recycled as well. After the repository is detached from this selector, the returned value, i.e. the detached repository, can be used to shutdown the repository.

If more than one application share the same logging context, then the applications need to coordinate their actions.

Returns:
The LoggerRepository instance that was detached.
Since:
1.3

Log4j 1.3alpha-7

Copyright 2000-2005 Apache Software Foundation.