DistributedDestinationBean (Java API Reference for Oracle WebLogic Server)

All Superinterfaces:

NamedEntityBean, SettableBean

All Known Subinterfaces:

DistributedQueueBean, DistributedTopicBean
```
@Deprecated
public interface DistributedDestinationBean
extends NamedEntityBean
```
Deprecated.
10.3.4.0, since Weighted Distributed Destination has been deprecated and replaced by Uniform Distributed Destination

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

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method	Description
`java.lang.String`	`getJNDIName()`	Deprecated. The name used to bind a virtual destination to the JNDI tree.
`java.lang.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.
`java.lang.String`	`getSAFExportPolicy()`	Deprecated. The SAF Export Policy controls which applications can send JMS messages to this destination through Store-and-Forward.
`java.lang.String`	`getUnitOfOrderRouting()`	Deprecated. Gets the "unit-of-order-routing" element.
`void`	`setJNDIName(java.lang.String jndiName)`	Deprecated. Sets the "jndi-name" element
`void`	`setLoadBalancingPolicy(java.lang.String loadBalancingPolicy)`	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.
`void`	`setSAFExportPolicy(java.lang.String safExportPolicy)`	Deprecated. Sets the saf-export-policy for this destination.
`void`	`setUnitOfOrderRouting(java.lang.String unitOfOrderRouting)`	Deprecated. Sets the "unit-of-order-routing" element.

Methods inherited from interface weblogic.j2ee.descriptor.wl.NamedEntityBean
getId, getName, getNotes, setName, setNotes

- Method Detail
  - getJNDIName
```
java.lang.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
    
    Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.
  - setJNDIName
```
void setJNDIName(java.lang.String jndiName)
          throws java.lang.IllegalArgumentException
```
    Deprecated.
    
    Sets the "jndi-name" element
    
    Parameters:
    
    jndiName -
    
    Throws:
    
    java.lang.IllegalArgumentException
  - getLoadBalancingPolicy
```
java.lang.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
    
    Default Value:
    
    weblogic.j2ee.descriptor.wl.constants.JMSConstants.ROUND_ROBIN
    
    Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.
  - setLoadBalancingPolicy
```
void setLoadBalancingPolicy(java.lang.String loadBalancingPolicy)
                     throws java.lang.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:
    
    java.lang.IllegalArgumentException
    
    Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.
    
    Valid Values:
    
    weblogic.j2ee.descriptor.wl.constants.JMSConstants.ROUND_ROBIN,weblogic.j2ee.descriptor.wl.constants.JMSConstants.RANDOM
  - getUnitOfOrderRouting
```
java.lang.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(java.lang.String unitOfOrderRouting)
                    throws java.lang.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:
    
    java.lang.IllegalArgumentException
    
    Changes to this property take effect after you redeploy the module or restart the server. If the resource is in a partition, restart the partition.
    
    Valid Values:
    
    weblogic.j2ee.descriptor.wl.constants.PathServiceConstants.HASH_POLICY,weblogic.j2ee.descriptor.wl.constants.PathServiceConstants.PATH_SERVICE
  - getSAFExportPolicy
```
java.lang.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(java.lang.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
    
    Changes to this property take effect after you redeploy the module or restart the server. If the resource is in a partition, restart the partition.
    
    Valid Values:
    
    weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_ALL, weblogic.j2ee.descriptor.wl.constants.JMSConstants.EXPORT_TO_NONE

Interface DistributedDestinationBean

Method Summary

Methods inherited from interface weblogic.j2ee.descriptor.wl.NamedEntityBean

Method Detail

getJNDIName

setJNDIName

getLoadBalancingPolicy

setLoadBalancingPolicy

getUnitOfOrderRouting

setUnitOfOrderRouting

getSAFExportPolicy

setSAFExportPolicy