weblogic.management.runtime
Interface JMSDurableSubscriberRuntimeMBean

public interface JMSDurableSubscriberRuntimeMBean

This class is used for monitoring a WebLogic JMS durable subscriber.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX" on http://www.oracle.com/technology/products/weblogic/index.html.

getClientID

String getClientID()

A unique client identifier for this durable subscriber.

Note: The client ID is not necessarily equivalent to the WebLogic Server username; that is, a name used to authenticate a user in the WebLogic security realm. You can, of course, set the client ID to the WebLogic Server username, if it is appropriate for your JMS application.

Returns:

The clientID value

getSubscriptionName

String getSubscriptionName()

The subscription name for this durable subscriber. This name must be unique per client ID.

Valid durable subscription names cannot include the following characters: comma ",", equals "=", colon ":", asterisk "*", percent "%", or question mark"?".

Returns:

The subscriptionName value

isNoLocal

boolean isNoLocal()

Specifies whether this durable subscriber recieves local messages it has published itself.

To prevent this, set the noLocal parameter to true.

Returns:

The noLocal value

isActive

boolean isActive()
                 throws RemoteException

Indicates whether this subscription is being used by a durable subscriber.

Returns:

The active value

Throws:

RemoteException

getSelector

String getSelector()

The message selector defined for this durable subscriber.

Returns:

The selector value

getMessagesPendingCount

long getMessagesPendingCount()

The number of messages pending (uncommitted and unacknowledged) by this durable subscriber.

Returns:

The messagesPendingCount value

getMessagesCurrentCount

long getMessagesCurrentCount()

The number of messages still available by this durable subscriber.

Returns:

The messagesCurrentCount value

getMessagesHighCount

long getMessagesHighCount()

Returns the peak number of messages for the durable subscriber since the last reset.

Returns:

The messagesHighCount value

getMessagesReceivedCount

long getMessagesReceivedCount()

Returns the number of messages received by the durable subscriber since that reset.

Returns:

The messagesReceivedCount value

getBytesPendingCount

long getBytesPendingCount()

The number of bytes pending by this durable subscriber.

Returns:

The bytesPendingCount value

getBytesCurrentCount

long getBytesCurrentCount()

The number of bytes received by this durable subscriber.

Returns:

The bytesCurrentCount value

purge

void purge()

Deprecated. As of WLS 9.0. Use #deleteMessages(String)

Purges all the pending and current messages for this durable subscriber.

getDestinationRuntime

JMSDestinationRuntimeMBean getDestinationRuntime()

Returns the runtime MBean of the Topic to which this durable subscriber is associated.

Returns:

The runtime MBean of the subscriber's Topic.

getCurrentConsumerInfo

CompositeData getCurrentConsumerInfo()
                                     throws OpenDataException

Returns information about the current consumer. The information is returned in the form of an OpenMBean CompositeData object.

Returns:

A CompositeData object that contains information about the consumer, including information about the JMS session and connection.

Throws:

OpenDataException - Thrown when an error occurs while constructing the CompositeData return value.

See Also:

ConsumerInfo

destroy

void destroy()
             throws JMSException

Completely removes this durable subscriber (and all messages associated with this durable subscription). After calling this method the durable subscription represented by this MBean will no longer be valid.

Throws:

JMSException

getDestinationInfo

CompositeData getDestinationInfo()
                                 throws OpenDataException

Returns information about the durable subscriber's internal destination in JMX open data representation. The resulting object is intended for use in the message management APIs for identifying a target destination.

Returns:

The subscriber's destination.

Throws:

OpenDataException - Thrown when an error occurs while constructing the CompositeData return value.

See Also:

JMSMessageManagementRuntimeMBean#moveMessages(String, CompositeData), JMSMessageManagementRuntimeMBean#moveMessages(String, CompositeData, Integer)