|
Oracle Fusion Middleware Oracle WebLogic Server API Reference 11g Release 1 (10.3.5) Part Number E13941-05 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectweblogic.jms.extensions.JMSDestinationAvailabilityHelper
public class JMSDestinationAvailabilityHelper
Provides a registration/notification mechanism for WebLogic 9.0 and later distributed destination member availability changes.
This helper can also be used for a regular (non-distributed) destination, a WebLogic pre-9.0 distributed destination, or a third party JMS destination for destination availability information. However, the listeners for such a destination never get per-member notifications, only get an availability notification once, and never get unavailability notifications.
This helper can also be used for a destination that is defined in a Foreign JMS Server configuration. An application provides the local JNDI name in the registration and the listener gets notifications for the availability/unavailability of the remote/final physical destination. The actual support is determined by the remote/final physical destination; if the remote destination is a WebLogic 9.0 and later distributed destination, the listener gets availability as well as unavailability notifications for the members of the remote distributed destination; for all other cases, the listener will only get the initial availability notification and no unavailability or subsequent availability notifications. All the notifications are about the remote destination not the local Foreign JMS Server representations.
Note:
isLocalServer()
and isLocalCluster()
methods
on the DestinationDetail
always return false
.
Method Summary | |
---|---|
static JMSDestinationAvailabilityHelper |
getInstance()
Get the singleton instance of the JMSDestinationAvailabilityHelper . |
RegistrationHandle |
register(Hashtable properties,
String destJNDIName,
DestinationAvailabilityListener listener)
Register a listener for destination availability updates. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static JMSDestinationAvailabilityHelper getInstance()
JMSDestinationAvailabilityHelper
.
JMSDestinationAvailabilityHelper
.public RegistrationHandle register(Hashtable properties, String destJNDIName, DestinationAvailabilityListener listener)
DestinationAvailabilityListener
interface
for information about notifications.
Applications register a notification listener with the helper by specifying JNDI context parameters and the JNDI name of a destination. For WebLogic 9.0 and later Distributed Destinations, the helper notifies listeners when particular members become available and unavailable as destinations are undeployed, added as a new member, migrated, shutdown, or restarted. If the listener is running in the same cluster as the destination, it is preferred not to put URL in the JNDI properties. For a URL that references a remote clustered JNDI name space, it is recommended to use a URL that references all servers in the (cluster. For example: Specify a URL that resolves to a DNS round-robin address, a URL that is resolved by a load balancer, or a WebLogic URL that contains a comma separated list of host addresses.
This helper can also be used for a regular (non-distributed) destination, a WebLogic pre-9.0 distributed destination, or a third party JMS destination for destination availability information. However, the listeners for such a destination never get per member notifications, only get an availability notification once, and never get unavailability notifications.
This helper can also be used for a destination that is defined in a Foreign JMS Server configuration. An application provides the local JNDI name in the registration and the listener gets notifications for the availability/unavailability of the remote/final physical destination. The actual support is determined by the remote/final physical destination; if the remote destination is a WebLogic 9.0 and later distributed destination, the listener gets availability as well as unavailability notifications for the members of the remote distributed destination; for all other cases, the listener will only get the initial availability notification and no unavailability or subsequent availability notifications. All the notifications are about the remote destination not the local Foreign JMS Server representations.
NOTE: Registrations for the JNDI name of a distributed destination
member are treated as "regular (non-distributed) destination"
registrations. In this case, the destination type in DestinationDetail
notifications is either
DestinationDetail.DESTINATION_TYPE_PHYSICAL_QUEUE
or
DestinationDetail.DESTINATION_TYPE_PHYSICAL_TOPIC
.
properties
- Initial context properties. Pass null
if
this destination is in the same WebLogic cluster as
the caller.destJNDIName
- The JNDI name of the destination.listener
- An instance of DestinationAvailabilityListener
.
RegistrationHandle
.RegistrationHandle.unregister()
,
DestinationAvailabilityListener
|
Copyright 1996, 2011, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Oracle Fusion Middleware Oracle WebLogic Server API Reference 11g Release 1 (10.3.5) Part Number E13941-05 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |