weblogic.j2ee.descriptor.wl
Interface DistributedDestinationBean

All Superinterfaces:

NamedEntityBean, SettableBean

All Known Subinterfaces:

DistributedQueueBean, DistributedTopicBean

public interface DistributedDestinationBean
extends NamedEntityBean

This bean contains all the attributes of distributed destinations that are common between distributed queues and distributed topics.

Access limited to the following security roles:

Deployer

getJNDIName

String getJNDIName()

Deprecated. 

The name used to bind a virtual destination to the JNDI tree. Applications can use the JNDI name to look up the virtual destination.

If not specified, then the destination is not bound into the JNDI namespace.

Returns:

The jNDIName value

setJNDIName

void setJNDIName(String jndiName)
                 throws IllegalArgumentException

Deprecated. 

Sets the "jndi-name" element

Parameters:

jndiName -

Throws:

IllegalArgumentException

getLoadBalancingPolicy

String getLoadBalancingPolicy()

Deprecated. 

Determines the load balancing policy for producers sending messages to a distributed destination in order to balance the message load across the members of the distributed set.

• Round-Robin - The system maintains an ordering of physical topic members within the set by distributing the messaging load across the topic members one at a time in the order that they are defined in the configuration file. Each WebLogic Server maintains an identical ordering, but may be at a different point within the ordering. If weights are assigned to any of the topic members in the set, then those members appear multiple times in the ordering.
• Random - The weight assigned to the topic members is used to compute a weighted distribution for the members of the set. The messaging load is distributed across the topic members by pseudo-randomly accessing the distribution. In the short run, the load will not be directly proportional to the weight. In the long run, the distribution will approach the limit of the distribution. A pure random distribution can be achieved by setting all the weights to the same value, which is typically set to 1.

Returns:

The loadBalancingPolicy value

Changes take effect after you redeploy the module or restart the server.

Default Value:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.ROUND_ROBIN

setLoadBalancingPolicy

void setLoadBalancingPolicy(String loadBalancingPolicy)
                            throws IllegalArgumentException

Deprecated. 

Defines the load balancing policy for producers sending messages to a distributed destination in order to balance the message load across the members of the distributed set.

• Round-Robin - The system maintains an ordering of physical topic members within the set by distributing the messaging load across the topic members one at a time in the order that they are defined in the configuration file. Each WebLogic Server maintains an identical ordering, but may be at a different point within the ordering. If weights are assigned to any of the topic members in the set, then those members appear multiple times in the ordering.

• Random - The weight assigned to the topic members is used to compute a weighted distribution for the members of the set. The messaging load is distributed across the topic members by pseudo-randomly accessing the distribution. In the short run, the load will not be directly proportional to the weight. In the long run, the distribution will approach the limit of the distribution. A pure random distribution can be achieved by setting all the weights to the same value, which is typically set to 1.

Sets the "load-balancing-policy" element

Parameters:

loadBalancingPolicy -

Throws:

IllegalArgumentException

Changes take effect after you redeploy the module or restart the server.

Valid Values:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.ROUND_ROBIN,weblogic.j2ee.descriptor.wl.constants.JMSConstants.RANDOM

getUnitOfOrderRouting

String getUnitOfOrderRouting()

Deprecated. 

Gets the "unit-of-order-routing" element.

A WLMessageProducer with Unit of Order uses the "unit-of-order-routing" element rather than the "load-balancing-policy" criteria to select the Distributed Destination Member.

Unit of Order may have been set programmatically with WLProducer, or administratively on the ConnectionFactory or Destination.

• Hash - producers will compute the Distributed Destination Member from the hash code of the Unit of Order.
• PathService - the configured Path Service will determine the Distributed Destination Member.

Default Value:

weblogic.j2ee.descriptor.wl.constants.PathServiceConstants.HASH_POLICY

setUnitOfOrderRouting

void setUnitOfOrderRouting(String unitOfOrderRouting)
                           throws IllegalArgumentException

Deprecated. 

Sets the "unit-of-order-routing" element.

A WLMessageProducer with Unit of Order will use the "unit-of-order-routing" element rather than the "load-balancing-policy" criteria to select the Distributed Destination Member.

Unit of Order may have been set programmatically with WLProducer, or administratively on the ConnectionFactory or Destination.

• Hash - producers will compute the Distributed Destination Member from the hash code of the Unit of Order.
• PathService - the configured Path Service will determine the Distributed Destination Member.

This attribute is not dynamically configurable.

Parameters:

unitOfOrderRouting -

Throws:

IllegalArgumentException

Valid Values:

weblogic.j2ee.descriptor.wl.constants.PathServiceConstants.HASH_POLICY,weblogic.j2ee.descriptor.wl.constants.PathServiceConstants.PATH_SERVICE

getSAFExportPolicy

String getSAFExportPolicy()

Deprecated. 

The SAF Export Policy controls which applications can send JMS messages to this destination through Store-and-Forward.

• All - This destination allows everyone to send JMS messages to it through SAF.
• None - This destination does not allow anyone to send JMS messages from a remote server to it through SAF.

This attribute is dynamically configurable. A dynamic change of this attribute will affect only messages sent after the update has been made.

Returns:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_ALL, or weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_NONE

setSAFExportPolicy

void setSAFExportPolicy(String safExportPolicy)

Deprecated. 

Sets the saf-export-policy for this destination.

• All - This destination allows everyone to send JMS messages to it through SAF.
• None - This destination does not allow anyone to send JMS messages from a remote server to it through SAF.

This attribute is dynamically configurable. A dynamic change of this attribute will affect only messages sent after the update has been made.

Default Value:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_ALL

Valid Values:

weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_ALL, weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_NONE