weblogic.jms.extensions
Interface WLConnection

public interface WLConnection

A WLConnection provides fields and methods that are not supported by javax.jms.Connection.

See Also:

Connection, QueueConnection, TopicConnection

setReconnectPolicy

void setReconnectPolicy(String reconnectPolicy)
                        throws IllegalArgumentException

Sets the JMS client reconnection policy after a lost network connection with a server or upon a server reboot.

• weblogic.jms.common.JMSConstants.RECONNECT_POLICY_NONE -- Prevents reconnection attempts.
• weblogic.jms.common.JMSConstants.RECONNECT_POLICY_PRODUCER -- Explicitly refreshes Producer objects and implicitly refreshes any related Session and Connection objects. However, this value does not refresh Consumers, QueueBrowsers, and Connections with a configured ClientID for a durable subscriber.
• weblogic.jms.common.JMSConstants.RECONNECT_POLICY_ALL -- Explicitly refreshes all Consumer and Producer objects and implicitly refreshes any related Session and Connection objects. However, this value does not refresh QueueBrowsers and Connections with a configured ClientID for a durable subscriber.

Throws:

IllegalArgumentException - when the argument is not: weblogic.jms.common.JMSConstants.RECONNECT_POLICY_NONE weblogic.jms.common.JMSConstants.RECONNECT_POLICY_PRODUCER weblogic.jms.common.JMSConstants.RECONNECT_POLICY_ALL

See Also:

JMSConstants.RECONNECT_POLICY_NONE, JMSConstants.RECONNECT_POLICY_PRODUCER, JMSConstants.RECONNECT_POLICY_ALL, WLMessage.getJMSRedeliveryLimit()

getReconnectPolicy

String getReconnectPolicy()

Gets the JMS client reconnection policy after a lost network connection with a server or upon a server reboot.

Returns:

The current reconnectPolicy.

See Also:

WLConnection.setReconnectPolicy(java.lang.String)

setReconnectBlockingMillis

void setReconnectBlockingMillis(long timeout)
                                throws IllegalArgumentException

Sets the maximum length of time that any synchronous JMS calls, such as a producer.send(), consumer.receive(), or session.createBrowser(), will block the calling thread before giving up on a JMS client reconnect in progress.

Parameters:

timeout - The number of milliseconds JMS operations will wait trying to reconnect to a disconnected server before throwing a JMSException.

When the timeout is zero, the reconnect starts but this call does not block waiting for the reconnected objects.

When the timeout is -1, the call blocks as long as reconnects are possible. For example, send() can block until close() is called, and send() will throw a JMSException.

Throws:

IllegalArgumentExcaption - is thrown when timeout is less than -1.

IllegalArgumentException

See Also:

WLConnection.getReconnectBlockingMillis()

getReconnectBlockingMillis

long getReconnectBlockingMillis()

Gets the maximum length of time that any synchronous JMS calls will block the calling thread before giving up on a JMS client reconnect in progress.

Returns:

The number of milliseconds JMS operations will wait trying to reconnect to a disconnected server before throwing a JMSException.

See Also:

WLConnection.setReconnectBlockingMillis(long)

setTotalReconnectPeriodMillis

void setTotalReconnectPeriodMillis(long timeout)
                                   throws IllegalArgumentException

Sets the maximum length of time that JMS client operations will continue to try to reconnect to the server after either the initial network disconnect or the last synchronous call attempt, whichever occurred most recently, before giving up retrying.

Parameters:

timeout - The number of milliseconds that JMS reconnect timers will be permitted to reconnect a disconnected server.

When the timeout is -1, there is no limit. Reconnection timers will always be scheduled until close() is called.

Throws:

IllegalArgumentExcaption - is thrown when timeout is less than -1.

IllegalArgumentException

See Also:

WLConnection.getTotalReconnectPeriodMillis()

getTotalReconnectPeriodMillis

long getTotalReconnectPeriodMillis()

Gets the maximum length of time that JMS client operations will continue to try to reconnect to the server.

Returns:

The number of milliseconds that JMS reconnect timers will be permitted to reconnect a disconnected server.

See Also:

WLConnection.setTotalReconnectPeriodMillis(long)