Class StatusLoggerAdmin

java.lang.Object

javax.management.NotificationBroadcasterSupport

org.apache.logging.log4j.core.jmx.StatusLoggerAdmin

All Implemented Interfaces:

Closeable, AutoCloseable, EventListener, MBeanRegistration, NotificationBroadcaster, NotificationEmitter, StatusLoggerAdminMBean, StatusListener

public class StatusLoggerAdmin
extends NotificationBroadcasterSupport
implements StatusListener, StatusLoggerAdminMBean, MBeanRegistration

Implementation of the StatusLoggerAdminMBean interface.

Field Summary

Fields

Modifier and Type	Field	Description
private final String	contextName
private Level	level
private final ObjectName	objectName
private final AtomicLong	sequenceNo
private boolean	statusListenerRegistered
private final Lock	statusListenerRegistrationGuard

Fields inherited from interface StatusLoggerAdminMBean

NOTIF_TYPE_DATA, NOTIF_TYPE_MESSAGE, PATTERN

Constructor Summary

Constructors

Constructor	Description
StatusLoggerAdmin(String contextName, Executor executor)	Constructs a new StatusLoggerAdmin with the Executor to be used for sending Notifications asynchronously to listeners.

Method Summary

Modifier and Type	Method	Description
void	addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)	BEGIN: Conditional StatusListener registration ///////////////////////////////////////////////////////////////
void	close()
private static MBeanNotificationInfo	createNotificationInfo()
String	getContextName()	Returns the name of the LoggerContext that the StatusLogger is associated with.
String	getLevel()	Returns the StatusLogger level as a String.
ObjectName	getObjectName()	Returns the ObjectName of this mbean.
List<StatusData>	getStatusData()	Returns a list with the most recent StatusData objects in the status history.
String[]	getStatusDataHistory()	END: Conditional StatusListener registration /////////////////////////////////////////////////////////////////
Level	getStatusLevel()	Return the Log Level that this listener wants included.
void	log(StatusData data)	Called as events occur to process the StatusData.
private long	nextSeqNo()
private long	nowMillis()
void	postDeregister()
void	postRegister(Boolean registrationDone)
void	preDeregister()
ObjectName	preRegister(MBeanServer server, ObjectName name)
void	setLevel(String level)	Sets the StatusLogger level to the specified value.

Methods inherited from class NotificationBroadcasterSupport

getNotificationInfo, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class Object

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

Field Details

sequenceNo

private final AtomicLong sequenceNo

objectName

private final ObjectName objectName

contextName

private final String contextName

level

private Level level

statusListenerRegistered

private boolean statusListenerRegistered

statusListenerRegistrationGuard

private final Lock statusListenerRegistrationGuard

Constructor Details

StatusLoggerAdmin

public StatusLoggerAdmin(String contextName,
 Executor executor)

Constructs a new StatusLoggerAdmin with the Executor to be used for sending Notifications asynchronously to listeners.

Parameters:

contextName - name of the LoggerContext under which to register this StatusLoggerAdmin. Note that the StatusLogger may be registered multiple times, once for each LoggerContext. In web containers, each web application has its own LoggerContext and by associating the StatusLogger with the LoggerContext, all associated MBeans can be unloaded when the web application is undeployed.

executor - used to send notifications asynchronously

Method Details

createNotificationInfo

private static MBeanNotificationInfo createNotificationInfo()

addNotificationListener

public void addNotificationListener(NotificationListener listener,
 NotificationFilter filter,
 Object handback)

BEGIN: Conditional StatusListener registration ///////////////////////////////////////////////////////////////

Specified by:

addNotificationListener in interface NotificationBroadcaster

Overrides:

addNotificationListener in class NotificationBroadcasterSupport

preRegister

public ObjectName preRegister(MBeanServer server,
 ObjectName name)

Specified by:

preRegister in interface MBeanRegistration

postRegister

public void postRegister(Boolean registrationDone)

Specified by:

postRegister in interface MBeanRegistration

preDeregister

public void preDeregister()

Specified by:

preDeregister in interface MBeanRegistration

postDeregister

public void postDeregister()

Specified by:

postDeregister in interface MBeanRegistration

getStatusDataHistory

public String[] getStatusDataHistory()

END: Conditional StatusListener registration /////////////////////////////////////////////////////////////////

Specified by:

getStatusDataHistory in interface StatusLoggerAdminMBean

Returns:

the most recent messages logged by the StatusLogger.

getStatusData

public List<StatusData> getStatusData()

Description copied from interface: StatusLoggerAdminMBean

Returns a list with the most recent StatusData objects in the status history. The list has up to 200 entries by default but the length can be configured with system property "log4j2.status.entries".

Note that the returned objects may contain Throwables from external libraries.

JMX clients calling this method must be prepared to deal with the errors that occur if they do not have the class definition for such Throwables in their classpath.

Specified by:

getStatusData in interface StatusLoggerAdminMBean

Returns:

the most recent messages logged by the StatusLogger.

getLevel

public String getLevel()

Description copied from interface: StatusLoggerAdminMBean

Returns the StatusLogger level as a String.

Specified by:

getLevel in interface StatusLoggerAdminMBean

Returns:

the StatusLogger level.

getStatusLevel

public Level getStatusLevel()

Description copied from interface: StatusListener

Return the Log Level that this listener wants included.

Specified by:

getStatusLevel in interface StatusListener

Returns:

the Log Level.

setLevel

public void setLevel(String level)

Description copied from interface: StatusLoggerAdminMBean

Sets the StatusLogger level to the specified value.

Specified by:

setLevel in interface StatusLoggerAdminMBean

Parameters:

level - the new StatusLogger level.

getContextName

public String getContextName()

Description copied from interface: StatusLoggerAdminMBean

Returns the name of the LoggerContext that the StatusLogger is associated with.

Specified by:

getContextName in interface StatusLoggerAdminMBean

Returns:

logger context name

log

public void log(StatusData data)

Description copied from interface: StatusListener

Called as events occur to process the StatusData.

Specified by:

log in interface StatusListener

Parameters:

data - The StatusData for the event.

getObjectName

public ObjectName getObjectName()

Returns the ObjectName of this mbean.

Specified by:

getObjectName in interface StatusLoggerAdminMBean

Returns:

the ObjectName

See Also:

• StatusLoggerAdminMBean.PATTERN

nextSeqNo

private long nextSeqNo()

nowMillis

private long nowMillis()

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException