weblogic.j2ee.descriptor.wl
Interface UniformDistributedDestinationBean

All Superinterfaces:

DestinationBean, NamedEntityBean, SettableBean, TargetableBean

All Known Subinterfaces:

UniformDistributedQueueBean, UniformDistributedTopicBean

public interface UniformDistributedDestinationBean
extends DestinationBean

A uniform distributed destination is a distributed destination whose members are configured as part of its configuration; since members share the same configuration, they are uniform. There is one member on each JMS Server that conforms to the targeting criteria of the uniform distributed destination. For example, if a uniform distributed destination is targeted to a cluster, then one member will be created on each JMS server in the cluster. Members are created and destroyed as the targeting is changed.

getLoadBalancingPolicy

String getLoadBalancingPolicy()

Determines how messages are distributed to the members of this destination.

Choose from the following distribution techniques:

• 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 instance 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

Sets the value of the LoadBalancingPolicy attribute.

Parameters:

loadBalancingPolicy -

Throws:

IllegalArgumentException

See Also:

UniformDistributedDestinationBean.getLoadBalancingPolicy()

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()

Determines how a distributed destination member is selected as the destination for a message that is part of a unit-of-order. Hash, indicates that a message producer computes the member destination from the hashCode of the unit-of-order. PathService indicates that the configured Path Service determines the member destination.

Unit-of-Order Routing can be set programmatically with WLProducer, or administratively on the connection factory or destination.

Unit of Order Routing is not dynamically configurable.

Default Value:

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

setUnitOfOrderRouting

void setUnitOfOrderRouting(String unitOfOrderRouting)
                           throws IllegalArgumentException

Sets the value of the UnitOfOrderRouting attribute.

Parameters:

unitOfOrderRouting -

Throws:

IllegalArgumentException

See Also:

UniformDistributedDestinationBean.getUnitOfOrderRouting()