Package org.opends.server.loggers

Class TextErrorLogPublisher

java.lang.Object

org.opends.server.loggers.ErrorLogPublisher<C>

org.opends.server.loggers.TextErrorLogPublisher

All Implemented Interfaces:

Closeable, AutoCloseable, ConfigurationChangeListener<FileBasedErrorLogPublisherCfg>, LogPublisher<FileBasedErrorLogPublisherCfg>

public final class TextErrorLogPublisher
extends ErrorLogPublisher<C>
implements ConfigurationChangeListener<FileBasedErrorLogPublisherCfg>

This class provides an implementation of an error log publisher.

Constructor Summary

Constructors

Constructor	Description
TextErrorLogPublisher()	Creates a new file-based text error log publisher.

Method Summary

Modifier and Type	Method	Description
ConfigChangeResult	applyConfigurationChange(FileBasedErrorLogPublisherCfg config)	Applies the configuration changes to this change listener.
void	close()	Close this publisher.
static TextErrorLogPublisher	createToolStartupTextErrorPublisher(TextWriter writer)	Returns a new text error log publisher which will print all messages to the provided writer.
Dn	getDN()	Gets the DN of the configuration entry for this log publisher.
void	initializeLogPublisher(FileBasedErrorLogPublisherCfg config, ServerContext serverContext)	Initializes this publisher provider based on the information in the provided debug publisher configuration.
boolean	isConfigurationAcceptable(FileBasedErrorLogPublisherCfg config, List<LocalizableMessage> unacceptableReasons)	Indicates whether the provided configuration is acceptable for this log publisher.
boolean	isConfigurationChangeAcceptable(FileBasedErrorLogPublisherCfg config, List<LocalizableMessage> unacceptableReasons)	Indicates whether the proposed change to the configuration is acceptable to this change listener.
void	log(String source, Severity severity, LocalizableMessage message, Throwable exception)	Writes a message to the error log using the provided information.

Methods inherited from class java.lang.Object

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

Constructor Detail

TextErrorLogPublisher

public TextErrorLogPublisher()

Creates a new file-based text error log publisher.

Method Detail

createToolStartupTextErrorPublisher

public static TextErrorLogPublisher createToolStartupTextErrorPublisher(TextWriter writer)

Returns a new text error log publisher which will print all messages to the provided writer. This publisher should be used by tools.

Parameters:

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

Returns:

A new text error log publisher which will print all messages to the provided writer.

initializeLogPublisher

public void initializeLogPublisher(FileBasedErrorLogPublisherCfg config,
                                   ServerContext serverContext)
                            throws 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<FileBasedErrorLogPublisherCfg>

Parameters:

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

serverContext - The server context.

Throws:

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(FileBasedErrorLogPublisherCfg config,
                                         List<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.

Specified by:

isConfigurationAcceptable in interface LogPublisher<FileBasedErrorLogPublisherCfg>

Overrides:

isConfigurationAcceptable in class ErrorLogPublisher<FileBasedErrorLogPublisherCfg>

Parameters:

config - 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(FileBasedErrorLogPublisherCfg config,
                                               List<LocalizableMessage> unacceptableReasons)

Description copied from interface: ConfigurationChangeListener

Indicates whether the proposed change to the configuration is acceptable to this change listener.

Specified by:

isConfigurationChangeAcceptable in interface ConfigurationChangeListener<FileBasedErrorLogPublisherCfg>

Parameters:

config - The new configuration containing the changes.

unacceptableReasons - A list that can be used to hold messages about why the provided configuration is not acceptable.

Returns:

Returns true if the proposed change is acceptable, or false if it is not.

applyConfigurationChange

public ConfigChangeResult applyConfigurationChange(FileBasedErrorLogPublisherCfg config)

Description copied from interface: ConfigurationChangeListener

Applies the configuration changes to this change listener.

Specified by:

applyConfigurationChange in interface ConfigurationChangeListener<FileBasedErrorLogPublisherCfg>

Parameters:

config - The new configuration containing the changes.

Returns:

Returns information about the result of changing the configuration.

close

public void close()

Description copied from interface: LogPublisher

Close this publisher.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface LogPublisher<FileBasedErrorLogPublisherCfg>

getDN

public Dn getDN()

Description copied from interface: LogPublisher

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

Specified by:

getDN in interface LogPublisher<FileBasedErrorLogPublisherCfg>

Returns:

The configuration entry DN.

log

public void log(String source,
                Severity severity,
                LocalizableMessage message,
                Throwable exception)

Description copied from class: ErrorLogPublisher

Writes a message to the error log using the provided information.

The category and severity information are used to determine whether to actually log this message.

Category is defined using either short name (used for classes in well defined packages) or fully qualified classname. Conversion to short name is done automatically when loggers are created, see LoggingCategoryNames for list of existing short names.

Specified by:

log in class ErrorLogPublisher<C extends ErrorLogPublisherCfg>

Parameters:

source - The category of the message, which is either a classname or a simple category name defined in LoggingCategoryNames class.

severity - The severity of the message.

message - The message to be logged.

exception - The exception to be logged. May be null.