Package weblogic.jms.extensions

Interface WLConnection

All Superinterfaces:

java.lang.AutoCloseable, javax.jms.Connection, javax.jms.QueueConnection, javax.jms.TopicConnection

public interface WLConnection

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

See Also:

Connection, QueueConnection, TopicConnection

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	CLIENT_ID_POLICY_RESTRICTED	Only one connection that uses this policy exists in a cluster at any given time for a particular ClientID.
static java.lang.String	CLIENT_ID_POLICY_UNRESTRICTED	Connections created using this policy can specify any ClientID, even when other restricted or unrestricted connections already use the same ClientID.
static java.lang.String	RECONNECT_POLICY_ALL
static java.lang.String	RECONNECT_POLICY_NONE
static java.lang.String	RECONNECT_POLICY_PRODUCER
static java.lang.String	SUBSCRIPTION_EXCLUSIVE	All subscribers created using this connection do not share subscriptions with any other subscribers.
static java.lang.String	SUBSCRIPTION_SHARABLE	Subscribers created using this connection factory can share their subscriptions with other subscribers, regardless of whether those subscribers are created using the same connection factory or a different connection factory.

Method Summary

Modifier and Type	Method	Description
java.lang.String	getClientIDPolicy()	The ClientIdPolicy on this connection.
long	getReconnectBlockingMillis()	Deprecated. 12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated.
java.lang.String	getReconnectPolicy()	Deprecated. 12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated.
java.lang.String	getSubscriptionSharingPolicy()	The SubscriptionSharingPolicy on this connection.
long	getTotalReconnectPeriodMillis()	Deprecated. 12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated.
void	setClientID(java.lang.String clientID, java.lang.String clientIDPolicy)	Sets the ClientID and ClientIdPolicy on the connection.
void	setReconnectBlockingMillis(long timeout)	Deprecated. 12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated.
void	setReconnectPolicy(java.lang.String reconnectPolicy)	Deprecated. 12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated.
void	setSubscriptionSharingPolicy(java.lang.String subscriptionSharingPolicy)	Sets the SubscriptionSharingPolicy on this connection.
void	setTotalReconnectPeriodMillis(long timeout)	Deprecated. 12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated.

Field Detail

RECONNECT_POLICY_NONE

static final java.lang.String RECONNECT_POLICY_NONE

See Also:

setReconnectPolicy(java.lang.String), getReconnectPolicy()

RECONNECT_POLICY_PRODUCER

static final java.lang.String RECONNECT_POLICY_PRODUCER

See Also:

setReconnectPolicy(java.lang.String), getReconnectPolicy()

RECONNECT_POLICY_ALL

static final java.lang.String RECONNECT_POLICY_ALL

See Also:

setReconnectPolicy(java.lang.String), getReconnectPolicy()

CLIENT_ID_POLICY_RESTRICTED

static final java.lang.String CLIENT_ID_POLICY_RESTRICTED

Only one connection that uses this policy exists in a cluster at any given time for a particular ClientID.

See Also:

getClientIDPolicy(), setClientID(String,String)

CLIENT_ID_POLICY_UNRESTRICTED

static final java.lang.String CLIENT_ID_POLICY_UNRESTRICTED

Connections created using this policy can specify any ClientID, even when other restricted or unrestricted connections already use the same ClientID.

See Also:

getClientIDPolicy(), setClientID(String,String)

SUBSCRIPTION_EXCLUSIVE

static final java.lang.String SUBSCRIPTION_EXCLUSIVE

All subscribers created using this connection do not share subscriptions with any other subscribers.

See Also:

getSubscriptionSharingPolicy(), setSubscriptionSharingPolicy(java.lang.String)

SUBSCRIPTION_SHARABLE

static final java.lang.String SUBSCRIPTION_SHARABLE

Subscribers created using this connection factory can share their subscriptions with other subscribers, regardless of whether those subscribers are created using the same connection factory or a different connection factory.

See Also:

getSubscriptionSharingPolicy(), setSubscriptionSharingPolicy(java.lang.String)

Method Detail

setReconnectPolicy

@Deprecated
void setReconnectPolicy(java.lang.String reconnectPolicy)
                 throws java.lang.IllegalArgumentException

Deprecated.

12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated. The JMS Connection Factory configuration, javax.jms.extension.WLConnection API, and javax.jms.extension.JMSContext API for this feature will be removed or ignored in a future release. Oracle recommends that client applications handle connection exceptions as described in "Client Resiliency Best Practices" in "Best Practices for JMS Beginners and Advanced Users" in Administering JMS Resources.

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

• weblogic.jms.extensions.WLConnection.RECONNECT_POLICY_NONE -- Prevents reconnection attempts.
• weblogic.jms.extensions.WLConnection.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.extensions.WLConnection.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.

Parameters:

reconnectPolicy - reconnectPolicy is the new reconnect policy.

Throws:

java.lang.IllegalArgumentException - when the argument is not: weblogic.jms.extensions.WLConnection.RECONNECT_POLICY_NONE weblogic.jms.extensions.WLConnection.RECONNECT_POLICY_PRODUCER weblogic.jms.extensions.WLConnection.RECONNECT_POLICY_ALL

See Also:

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

getReconnectPolicy

@Deprecated
java.lang.String getReconnectPolicy()

Deprecated.

12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated. The JMS Connection Factory configuration, javax.jms.extension.WLConnection API, and javax.jms.extension.JMSContext API for this feature will be removed or ignored in a future release. Oracle recommends that client applications handle connection exceptions as described in "Client Resiliency Best Practices" in "Best Practices for JMS Beginners and Advanced Users" in Administering JMS Resources.

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

Returns:

The current reconnectPolicy.

See Also:

setReconnectPolicy(java.lang.String)

setReconnectBlockingMillis

@Deprecated
void setReconnectBlockingMillis(long timeout)
                         throws java.lang.IllegalArgumentException

Deprecated.

12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated. The JMS Connection Factory configuration, javax.jms.extension.WLConnection API, and javax.jms.extension.JMSContext API for this feature will be removed or ignored in a future release. Oracle recommends that client applications handle connection exceptions as described in "Client Resiliency Best Practices" in "Best Practices for JMS Beginners and Advanced Users" in Administering JMS Resources.

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.

java.lang.IllegalArgumentException

See Also:

getReconnectBlockingMillis()

getReconnectBlockingMillis

@Deprecated
long getReconnectBlockingMillis()

Deprecated.

12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated. The JMS Connection Factory configuration, javax.jms.extension.WLConnection API, and javax.jms.extension.JMSContext API for this feature will be removed or ignored in a future release. Oracle recommends that client applications handle connection exceptions as described in "Client Resiliency Best Practices" in "Best Practices for JMS Beginners and Advanced Users" in Administering JMS Resources.

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

Returns:

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

See Also:

setReconnectBlockingMillis(long)

setTotalReconnectPeriodMillis

@Deprecated
void setTotalReconnectPeriodMillis(long timeout)
                            throws java.lang.IllegalArgumentException

Deprecated.

12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated. The JMS Connection Factory configuration, javax.jms.extension.WLConnection API, and javax.jms.extension.JMSContext API for this feature will be removed or ignored in a future release. Oracle recommends that client applications handle connection exceptions as described in "Client Resiliency Best Practices" in "Best Practices for JMS Beginners and Advanced Users" in Administering JMS Resources.

Sets the maximum length of time that JMS client operations 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 are permitted to reconnect a disconnected server.

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

Throws:

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

java.lang.IllegalArgumentException

See Also:

getTotalReconnectPeriodMillis()

getTotalReconnectPeriodMillis

@Deprecated
long getTotalReconnectPeriodMillis()

Deprecated.

12.2.1.3.0 The WebLogic JMS Automatic Reconnect feature is deprecated. The JMS Connection Factory configuration, javax.jms.extension.WLConnection API, and javax.jms.extension.JMSContext API for this feature will be removed or ignored in a future release. Oracle recommends that client applications handle connection exceptions as described in "Client Resiliency Best Practices" in "Best Practices for JMS Beginners and Advanced Users" in Administering JMS Resources.

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

Returns:

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

See Also:

setTotalReconnectPeriodMillis(long)

setClientID

void setClientID(java.lang.String clientID,
                 java.lang.String clientIDPolicy)
          throws javax.jms.JMSException,
                 java.lang.IllegalArgumentException

Sets the ClientID and ClientIdPolicy on the connection.

The ClientID and ClientIdPolicy can be set administratively through the connection factory. If a client sets the ClientID explicitly, it must do so immediately after it creates the connection and before any other action on the connection is taken. After this point, setting the ClientID throws an IllegalStateException. If the ClientID is specified on the connection factory, an attempt to use this setter to change it throws IllegalStateException. If the ClientIdPolicy is specified on the connection factory without a ClientID, calling this setter with a ClientID and a different ClientIdPolicy overrides the policy as well as sets the ClientID.

Note: A durable subscription that is created using a Unrestricted client ID can only be unsubscribed using WLSession.unsubscribe(String name, Topic topic) method. An attempt of unsubscribing such a subscription using standard javax.jms.Session.unsubscribe(String name) will get an InvalidDestinationException.

Parameters:

clientID - the ClientID to be set

clientIDPolicy - the ClientIdPolicy to be set

Throws:

javax.jms.JMSException - if the JMS provider fails to set the client ID for this connection due to some internal error.

javax.jms.IllegalStateException - if the JMS client attempts to set a connection's client ID at the wrong time or when it has been administratively configured.

javax.jms.InvalidClientIDException - if the JMS client specifies an invalid or duplicate client ID using the RESTRICTED policy.

java.lang.IllegalArgumentException - if the policy is not valid.

See Also:

getClientIDPolicy(), CLIENT_ID_POLICY_RESTRICTED, CLIENT_ID_POLICY_UNRESTRICTED

getClientIDPolicy

java.lang.String getClientIDPolicy()

The ClientIdPolicy on this connection.

Returns:

the ClientIdPolicy on this connection.

See Also:

setClientID(String,String), CLIENT_ID_POLICY_RESTRICTED, CLIENT_ID_POLICY_UNRESTRICTED

getSubscriptionSharingPolicy

java.lang.String getSubscriptionSharingPolicy()

The SubscriptionSharingPolicy on this connection.

Returns:

the SubscriptionSharingPolicy

See Also:

setSubscriptionSharingPolicy(java.lang.String), SUBSCRIPTION_EXCLUSIVE, SUBSCRIPTION_SHARABLE

setSubscriptionSharingPolicy

void setSubscriptionSharingPolicy(java.lang.String subscriptionSharingPolicy)
                           throws javax.jms.JMSException,
                                  java.lang.IllegalArgumentException

Sets the SubscriptionSharingPolicy on this connection. The SubscriptionSharingPolicy can be set administratively through the connection factory. Consumers can share a non-durable subscriptions only if they have the same Client ID and Client ID Policy; consumers can share a durable subscription only if they have the same Client ID, Client ID Policy, and Subscription Name.

Parameters:

subscriptionSharingPolicy - new subscription sharing policy to be set.

Throws:

javax.jms.JMSException - if the JMS provider fails to set the Subsrciption Sharing Policy for this connection due to some internal error.

java.lang.IllegalArgumentException - if the policy is not valid

See Also:

SUBSCRIPTION_EXCLUSIVE, SUBSCRIPTION_SHARABLE, getSubscriptionSharingPolicy()