|
Oracle Fusion Middleware Oracle WebLogic Server API Reference 11g Release 1 (10.3.3) Part Number E13941-03 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | ||||||||||
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.
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
.
public RegistrationHandle register(Hashtable properties, String destJNDIName, DestinationAvailabilityListener listener)
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.
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, 2010, 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 10.3.3 API Reference 11g Release 1 (10.3.3) Part Number E13941-03 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES All Classes | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |