Package org.apache.logging.log4j.core.appender.mom

Class JmsManager

java.lang.Object

org.apache.logging.log4j.core.appender.AbstractManager

org.apache.logging.log4j.core.appender.mom.JmsManager

All Implemented Interfaces:

java.lang.AutoCloseable

@Deprecated
public class JmsManager
extends AbstractManager

Deprecated.

Use org.apache.logging.log4j.core.appender.mom.jakarta.JmsManager.

Consider this class private; it is only public for access by integration tests.

JMS connection and destination manager. Uses a MessageProducer to send log events to a JMS Destination.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	JmsManager.JmsManagerConfiguration	Deprecated.
private static class	JmsManager.JmsManagerFactory	Deprecated.
private class	JmsManager.Reconnector	Deprecated. Handles reconnecting to JMS on a Thread.

Nested classes/interfaces inherited from class org.apache.logging.log4j.core.appender.AbstractManager

AbstractManager.AbstractFactoryData

Field Summary

Fields

Modifier and Type	Field	Description
private JmsManager.JmsManagerConfiguration	configuration	Deprecated.
private javax.jms.Connection	connection	Deprecated.
private javax.jms.Destination	destination	Deprecated.
(package private) static JmsManager.JmsManagerFactory	FACTORY	Deprecated.
private JndiManager	jndiManager	Deprecated.
private javax.jms.MessageProducer	messageProducer	Deprecated.
private JmsManager.Reconnector	reconnector	Deprecated.
private javax.jms.Session	session	Deprecated.

Fields inherited from class org.apache.logging.log4j.core.appender.AbstractManager

count, LOGGER

Constructor Summary

Constructors

Modifier	Constructor	Description
private	JmsManager(java.lang.String name, JmsManager.JmsManagerConfiguration configuration)	Deprecated.

Method Summary

Modifier and Type	Method	Description
private boolean	closeConnection()	Deprecated.
private boolean	closeJndiManager()	Deprecated.
private boolean	closeMessageProducer()	Deprecated.
private boolean	closeSession()	Deprecated.
private javax.jms.Connection	createConnection(JndiManager jndiManager)	Deprecated.
private javax.jms.Destination	createDestination(JndiManager jndiManager)	Deprecated.
javax.jms.Message	createMessage(java.io.Serializable object)	Deprecated. Creates a TextMessage, MapMessage, or ObjectMessage from a Serializable object.
private void	createMessageAndSend(LogEvent event, java.io.Serializable serializable)	Deprecated.
javax.jms.MessageConsumer	createMessageConsumer()	Deprecated. Creates a MessageConsumer on this Destination using the current Session.
javax.jms.MessageProducer	createMessageProducer(javax.jms.Session session, javax.jms.Destination destination)	Deprecated. Creates a MessageProducer on this Destination using the current Session.
private JmsManager.Reconnector	createReconnector()	Deprecated.
private javax.jms.Session	createSession(javax.jms.Connection connection)	Deprecated.
static JmsManager	getJmsManager(java.lang.String name, java.util.Properties jndiProperties, java.lang.String connectionFactoryName, java.lang.String destinationName, java.lang.String userName, char[] password, boolean immediateFail, long reconnectIntervalMillis)	Deprecated. Gets a JmsManager using the specified configuration parameters.
JmsManager.JmsManagerConfiguration	getJmsManagerConfiguration()	Deprecated.
(package private) JndiManager	getJndiManager()	Deprecated.
(package private) <T> T	lookup(java.lang.String destinationName)	Deprecated.
private javax.jms.MapMessage	map(MapMessage<?,?> log4jMapMessage, javax.jms.MapMessage jmsMapMessage)	Deprecated.
protected boolean	releaseSub(long timeout, java.util.concurrent.TimeUnit timeUnit)	Deprecated. May be overridden by managers to perform processing while the manager is being released and the lock is held.
(package private) void	send(LogEvent event, java.io.Serializable serializable)	Deprecated.

Methods inherited from class org.apache.logging.log4j.core.appender.AbstractManager

close, getContentFormat, getCount, getLoggerContext, getManager, getName, getStrSubstitutor, hasManager, log, logDebug, logError, logger, logWarn, narrow, release, stop, updateData

Methods inherited from class java.lang.Object

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

Field Detail

FACTORY

static final JmsManager.JmsManagerFactory FACTORY

Deprecated.

configuration

private final JmsManager.JmsManagerConfiguration configuration

Deprecated.

reconnector

private volatile JmsManager.Reconnector reconnector

Deprecated.

jndiManager

private volatile JndiManager jndiManager

Deprecated.

connection

private volatile javax.jms.Connection connection

Deprecated.

session

private volatile javax.jms.Session session

Deprecated.

destination

private volatile javax.jms.Destination destination

Deprecated.

messageProducer

private volatile javax.jms.MessageProducer messageProducer

Deprecated.

Constructor Detail

JmsManager

private JmsManager(java.lang.String name,
                   JmsManager.JmsManagerConfiguration configuration)

Deprecated.

Method Detail

getJmsManager

public static JmsManager getJmsManager(java.lang.String name,
                                       java.util.Properties jndiProperties,
                                       java.lang.String connectionFactoryName,
                                       java.lang.String destinationName,
                                       java.lang.String userName,
                                       char[] password,
                                       boolean immediateFail,
                                       long reconnectIntervalMillis)

Deprecated.

Gets a JmsManager using the specified configuration parameters.

Parameters:

name - The name to use for this JmsManager.

connectionFactoryName - The binding name for the ConnectionFactory.

destinationName - The binding name for the Destination.

userName - The userName to connect with or null for no authentication.

password - The password to use with the given userName or null for no authentication.

immediateFail - Whether or not to fail immediately with a AppenderLoggingException when connecting to JMS fails.

reconnectIntervalMillis - How to log sleep in milliseconds before trying to reconnect to JMS.

jndiProperties - JNDI properties.

Returns:

The JmsManager as configured.

closeConnection

private boolean closeConnection()

Deprecated.

closeJndiManager

private boolean closeJndiManager()

Deprecated.

closeMessageProducer

private boolean closeMessageProducer()

Deprecated.

closeSession

private boolean closeSession()

Deprecated.

createConnection

private javax.jms.Connection createConnection(JndiManager jndiManager)
                                       throws javax.naming.NamingException,
                                              javax.jms.JMSException

Deprecated.

Throws:

javax.naming.NamingException

javax.jms.JMSException

createDestination

private javax.jms.Destination createDestination(JndiManager jndiManager)
                                         throws javax.naming.NamingException

Deprecated.

Throws:

javax.naming.NamingException

createMessage

public javax.jms.Message createMessage(java.io.Serializable object)
                                throws javax.jms.JMSException

Deprecated.

Creates a TextMessage, MapMessage, or ObjectMessage from a Serializable object.

For instance, when using a text-based Layout such as PatternLayout, the LogEvent message will be serialized to a String.

When using a layout such as SerializedLayout, the LogEvent message will be serialized as a Java object.

When using a layout such as MessageLayout and the LogEvent message is a Log4j MapMessage, the message will be serialized as a JMS MapMessage.

Parameters:

object - The LogEvent or String message to wrap.

Returns:

A new JMS message containing the provided object.

Throws:

javax.jms.JMSException - if the JMS provider fails to create this message due to some internal error.

createMessageAndSend

private void createMessageAndSend(LogEvent event,
                                  java.io.Serializable serializable)
                           throws javax.jms.JMSException

Deprecated.

Throws:

javax.jms.JMSException

createMessageConsumer

public javax.jms.MessageConsumer createMessageConsumer()
                                                throws javax.jms.JMSException

Deprecated.

Creates a MessageConsumer on this Destination using the current Session.

Returns:

A MessageConsumer on this Destination.

Throws:

javax.jms.JMSException - if the session fails to create a consumer due to some internal error.

createMessageProducer

public javax.jms.MessageProducer createMessageProducer(javax.jms.Session session,
                                                       javax.jms.Destination destination)
                                                throws javax.jms.JMSException

Deprecated.

Creates a MessageProducer on this Destination using the current Session.

Parameters:

session - The JMS Session to use to create the MessageProducer

destination - The JMS Destination for the MessageProducer

Returns:

A MessageProducer on this Destination.

Throws:

javax.jms.JMSException - if the session fails to create a MessageProducer due to some internal error.

createReconnector

private JmsManager.Reconnector createReconnector()

Deprecated.

createSession

private javax.jms.Session createSession(javax.jms.Connection connection)
                                 throws javax.jms.JMSException

Deprecated.

Throws:

javax.jms.JMSException

getJmsManagerConfiguration

public JmsManager.JmsManagerConfiguration getJmsManagerConfiguration()

Deprecated.

getJndiManager

JndiManager getJndiManager()

Deprecated.

lookup

<T> T lookup(java.lang.String destinationName)
      throws javax.naming.NamingException

Deprecated.

Throws:

javax.naming.NamingException

map

private javax.jms.MapMessage map(MapMessage<?,?> log4jMapMessage,
                                 javax.jms.MapMessage jmsMapMessage)

Deprecated.

releaseSub

protected boolean releaseSub(long timeout,
                             java.util.concurrent.TimeUnit timeUnit)

Deprecated.

Description copied from class: AbstractManager

May be overridden by managers to perform processing while the manager is being released and the lock is held. A timeout is passed for implementors to use as they see fit.

Overrides:

releaseSub in class AbstractManager

Parameters:

timeout - timeout

timeUnit - timeout time unit

Returns:

true if all resources were closed normally, false otherwise.

send

void send(LogEvent event,
          java.io.Serializable serializable)

Deprecated.