Skip navigation links

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.2.1)

Part Number E55141-01
P4 Change 1723563 on 2015/10/09


weblogic.j2ee.descriptor.wl
Interface DefaultDeliveryParamsBean

All Superinterfaces:
SettableBean

public interface DefaultDeliveryParamsBean
extends SettableBean

If a client does not specify certain parameters then the values that those parameters will take can be controlled with a default delivery parameters bean.


Method Summary
abstract  int getDefaultCompressionThreshold()
          The number of bytes for the serialized message body so any message exceeds this limit will trigger message compression when the message is sent or received by the JMS message producer or consumer.
abstract  String getDefaultDeliveryMode()
          The default delivery mode used for messages when a delivery mode is not explicitly defined.
abstract  int getDefaultPriority()
          The default priority used for messages when a priority is not explicitly defined.
abstract  long getDefaultRedeliveryDelay()
          The delay time, in milliseconds, before rolled back or recovered messages are redelivered.
abstract  String getDefaultTimeToDeliver()
          The delay time, in milliseconds, between when a message is produced and when it is made visible on its destination.
abstract  long getDefaultTimeToLive()
          The maximum length of time, in milliseconds, that a message exists.
abstract  String getDefaultUnitOfOrder()
          The default Unit-of-Order name for producers that connect using this connection factory.
abstract  long getSendTimeout()
          The maximum length of time, in milliseconds, that a sender will wait when there isn't enough available space (no quota) on a destination to accommodate the message being sent.
abstract  void setDefaultCompressionThreshold(int threshold)
          Sets the value of the CompressionThreshold attribute.
abstract  void setDefaultDeliveryMode(String defaultDeliveryMode)
          Sets the value of the DefaultDeliveryMode attribute.
abstract  void setDefaultPriority(int defaultPriority)
          Sets the value of the DefaultPriority attribute.
abstract  void setDefaultRedeliveryDelay(long defaultRedeliveryDelay)
          Sets the value of the DefaultRedeliveryDelay attribute.
abstract  void setDefaultTimeToDeliver(String defaultTimeToDeliver)
          Sets the value of the DefaultTimeToDeliver attribute.
abstract  void setDefaultTimeToLive(long defaultTimeToLive)
          Sets the value of the DefaultTimeToLive attribute.
abstract  void setDefaultUnitOfOrder(String defaultUnitOfOrder)
          Sets the value of the DefaultUnitOfOrder attribute.
abstract  void setSendTimeout(long sendTimeout)
          Sets the value of the SendTimeout attribute.

 

Method Detail

getDefaultDeliveryMode

String getDefaultDeliveryMode()

The default delivery mode used for messages when a delivery mode is not explicitly defined.

All messages with a DefaultDeliveryMode of null that are produced on a connection created with this factory will receive this value. Message producers can get the delivery mode explicitly by calling the javax.jms.MessageProducer.getDeliveryMode() method.

This attribute is dynamic. It can be changed at any time. However, changing the value does not affect existing connections. It only affects new connections made with this connection factory.

Returns:
The defaultDeliveryMode value

setDefaultDeliveryMode

void setDefaultDeliveryMode(String defaultDeliveryMode)
                            throws IllegalArgumentException

Sets the value of the DefaultDeliveryMode attribute.

Parameters:
defaultDeliveryMode - The new default delivery mode
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultDeliveryMode()

getDefaultTimeToDeliver

String getDefaultTimeToDeliver()

The delay time, in milliseconds, between when a message is produced and when it is made visible on its destination.

All messages produced by a producer created with this factory that have a DefaultTimeToDeliver of -1 will use this value. Message producers can get the Time-to-Deliver explicitly by calling the weblogic.jms.extensions.WLMessageProducer.getTimeToDeliver() method.

This attribute is dynamic. It can be changed at any time. However, changing the value does not affect existing connections. It only affects new connections made with this connection factory.

Returns:
The defaultTimeToDeliver value

setDefaultTimeToDeliver

void setDefaultTimeToDeliver(String defaultTimeToDeliver)
                             throws IllegalArgumentException

Sets the value of the DefaultTimeToDeliver attribute.

Parameters:
defaultTimeToDeliver - The new default time to deliver value
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultTimeToDeliver()

getDefaultTimeToLive

long getDefaultTimeToLive()

The maximum length of time, in milliseconds, that a message exists. This value is used for messages when both the time-to-live is not explicitly set by the sender application that is using this connection factory and the time-to-live is not explicitly overridden by the destination's TimeToLiveOverride attribute . A value of 0 indicates that the message has an infinite amount time to live.

Message producer applications can set the time-to-live explicitly by calling the standard JMS javax.jms.MessageProducer.setTimeToLive(long) method. Note that programmatically setting time-to-live using javax.jms.Message.setJMSExpiration() has no effect - the message setter is ignored by the JMS send call as required by the JMS specification.

This attribute is dynamic. It can be changed at any time. However, changing the value does not affect existing connections. It only affects new connections made with this connection factory.

Returns:
The defaultTimeToLive value

setDefaultTimeToLive

void setDefaultTimeToLive(long defaultTimeToLive)
                          throws IllegalArgumentException

Sets the value of the DefaultTimeToLive attribute.

Parameters:
defaultTimeToLive - The new default time to live value
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultTimeToLive()

getDefaultPriority

int getDefaultPriority()

The default priority used for messages when a priority is not explicitly defined.

All messages with a DefaultPriority of -1 that are produced on a connection created with this factory will receive this value. Message producers can get the priority explicitly by calling the javax.jms.MessageProducer.getPriority() method.

This attribute is dynamic. It can be changed at any time. However, changing the value does not affect existing connections. It only affects new connections made with this connection factory.

Returns:
The defaultPriority value

setDefaultPriority

void setDefaultPriority(int defaultPriority)
                        throws IllegalArgumentException

Sets the value of the DefaultPriority attribute.

Parameters:
defaultPriority - The new default priority value
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultPriority()

getDefaultRedeliveryDelay

long getDefaultRedeliveryDelay()

The delay time, in milliseconds, before rolled back or recovered messages are redelivered.

All messages consumed by a consumer created with this factory that have a DefaultRedeliveryDelay of -1 will use this value.

Message consumers can get the redelivery delay explicitly by calling the weblogic.jms.extensions.WLSession.getRedliveryDelay() method.

This attribute is dynamic. It can be changed at any time. However, changing the value does not affect existing connections. It only affects new connections made with this connection factory.

Returns:
The defaultRedeliveryDelay value

setDefaultRedeliveryDelay

void setDefaultRedeliveryDelay(long defaultRedeliveryDelay)
                               throws IllegalArgumentException

Sets the value of the DefaultRedeliveryDelay attribute.

Parameters:
defaultRedeliveryDelay - The new default redelivery delay
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultRedeliveryDelay()

getSendTimeout

long getSendTimeout()

The maximum length of time, in milliseconds, that a sender will wait when there isn't enough available space (no quota) on a destination to accommodate the message being sent.

The default time is 10 milliseconds. A value of 0 indicates that the sender does not want to wait for space.

This attribute is dynamic. It can be changed at any time. However, changing the value does not affect existing connections or their producers. It only affects new connections made with this connection factory. Producers inherit the setting from the connection factory used to create their session and connection. The value can then be overridden at run time by setting the value on the producer.

Returns:
The sendTimeout value

setSendTimeout

void setSendTimeout(long sendTimeout)
                    throws IllegalArgumentException

Sets the value of the SendTimeout attribute.

Parameters:
sendTimeout - The send timeout value that a sender should wait in milliseconds
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getSendTimeout()

getDefaultCompressionThreshold

int getDefaultCompressionThreshold()

The number of bytes for the serialized message body so any message exceeds this limit will trigger message compression when the message is sent or received by the JMS message producer or consumer.

The compression will occur either:

Returns:
The compression threshold given to new connections

setDefaultCompressionThreshold

void setDefaultCompressionThreshold(int threshold)
                                    throws IllegalArgumentException

Sets the value of the CompressionThreshold attribute.

Parameters:
threshold - The compression threshold new connections should use
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultCompressionThreshold()

getDefaultUnitOfOrder

String getDefaultUnitOfOrder()

The default Unit-of-Order name for producers that connect using this connection factory. A Unit-of-Order allows for messages to be processed in a certain order, even among multiple recipients.

System-generated indicates that WebLogic Server will automatically generate a Unit-of-Order name. User-Generated indicates that the Unit-of-Order name will come from the name specified name in the Unit-of-Order Name field. If None is selected, no message ordering is enforced.

Returns:
The default unit of order name associated with this connection factory

setDefaultUnitOfOrder

void setDefaultUnitOfOrder(String defaultUnitOfOrder)
                           throws IllegalArgumentException

Sets the value of the DefaultUnitOfOrder attribute.

Parameters:
defaultUnitOfOrder - The default unit of order name
Throws:
IllegalArgumentException
See Also:
DefaultDeliveryParamsBean.getDefaultUnitOfOrder()

Skip navigation links

Copyright 1996, 2015, 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
Java API Reference for Oracle WebLogic Server
12c (12.2.1)

Part Number E55141-01
P4 Change 1723563 on 2015/10/09