org.opends.server.loggers

Class TextHTTPAccessLogPublisher

java.lang.Object

org.opends.server.loggers.HTTPAccessLogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

org.opends.server.loggers.TextHTTPAccessLogPublisher

All Implemented Interfaces:

Closeable, AutoCloseable, org.forgerock.opendj.config.server.ConfigurationChangeListener<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>, LogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

public final class TextHTTPAccessLogPublisher
extends HTTPAccessLogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>
implements org.forgerock.opendj.config.server.ConfigurationChangeListener<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

This class provides the implementation of the HTTP access logger used by the directory server.

Constructor Summary

Constructors

Constructor and Description
TextHTTPAccessLogPublisher()

Method Summary

Modifier and Type	Method and Description
org.forgerock.opendj.config.server.ConfigChangeResult	applyConfigurationChange(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg config)
void	close() Close this publisher.
org.forgerock.opendj.ldap.DN	getDN() Gets the DN of the configuration entry for this log publisher.
static TextHTTPAccessLogPublisher	getStartupTextHTTPAccessPublisher(TextWriter writer) Returns an instance of the text HTTP access log publisher that will print all messages to the provided writer.
void	initializeLogPublisher(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg cfg, ServerContext serverContext) Initializes this publisher provider based on the information in the provided debug publisher configuration.
boolean	isConfigurationAcceptable(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg configuration, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons) Indicates whether the provided configuration is acceptable for this log publisher.
boolean	isConfigurationChangeAcceptable(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg config, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)
void	logRequestInfo(HTTPRequestInfo ri) Logs the request info according to the configured extended log format.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TextHTTPAccessLogPublisher

public TextHTTPAccessLogPublisher()

Method Detail

getStartupTextHTTPAccessPublisher

public static TextHTTPAccessLogPublisher getStartupTextHTTPAccessPublisher(TextWriter writer)

Returns an instance of the text HTTP access log publisher that will print all messages to the provided writer. This is used to print the messages to the console when the server starts up.

Parameters:

writer - The text writer where the message will be written to.

Returns:

The instance of the text error log publisher that will print all messages to standard out.

applyConfigurationChange

public org.forgerock.opendj.config.server.ConfigChangeResult applyConfigurationChange(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg config)

Specified by:

applyConfigurationChange in interface org.forgerock.opendj.config.server.ConfigurationChangeListener<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

initializeLogPublisher

public void initializeLogPublisher(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg cfg,
                                   ServerContext serverContext)
                            throws org.forgerock.opendj.config.server.ConfigException,
                                   InitializationException

Description copied from interface: LogPublisher

Initializes this publisher provider based on the information in the provided debug publisher configuration.

Specified by:

initializeLogPublisher in interface LogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

Parameters:

cfg - The publisher configuration that contains the information to use to initialize this publisher.

serverContext - The server context.

Throws:

org.forgerock.opendj.config.server.ConfigException - If an unrecoverable problem arises in the process of performing the initialization as a result of the server configuration.

InitializationException - If a problem occurs during initialization that is not related to the server configuration.

isConfigurationAcceptable

public boolean isConfigurationAcceptable(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg configuration,
                                         List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)

Description copied from interface: LogPublisher

Indicates whether the provided configuration is acceptable for this log publisher. It should be possible to call this method on an uninitialized log publisher instance in order to determine whether the log publisher would be able to use the provided configuration.

Note that implementations which use a subclass of the provided configuration class will likely need to cast the configuration to the appropriate subclass type.

Specified by:

isConfigurationAcceptable in interface LogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

Overrides:

isConfigurationAcceptable in class HTTPAccessLogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

Parameters:

configuration - The log publisher configuration for which to make the determination.

unacceptableReasons - A list that may be used to hold the reasons that the provided configuration is not acceptable.

Returns:

true if the provided configuration is acceptable for this log publisher, or false if not.

isConfigurationChangeAcceptable

public boolean isConfigurationChangeAcceptable(org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg config,
                                               List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)

Specified by:

isConfigurationChangeAcceptable in interface org.forgerock.opendj.config.server.ConfigurationChangeListener<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

close

public final void close()

Description copied from interface: LogPublisher

Close this publisher.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface LogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

getDN

public final org.forgerock.opendj.ldap.DN getDN()

Description copied from interface: LogPublisher

Gets the DN of the configuration entry for this log publisher.

Specified by:

getDN in interface LogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

Returns:

The configuration entry DN.

logRequestInfo

public void logRequestInfo(HTTPRequestInfo ri)

Description copied from class: HTTPAccessLogPublisher

Logs the request info according to the configured extended log format.

Overrides:

logRequestInfo in class HTTPAccessLogPublisher<org.forgerock.opendj.server.config.server.FileBasedHTTPAccessLogPublisherCfg>

Parameters:

ri - The request info to log

See Also:

W3C's Extended Log File Format, Microsoft's W3C Extended Log File Format (IIS 6.0)