com.bea.b2b.protocol.xocp.messaging
Class QualityOfService

java.lang.Object
  |
  +--com.bea.b2b.protocol.messaging.BasicQualityOfService
        |
        +--com.bea.b2b.protocol.xocp.messaging.QualityOfService

public class QualityOfService
extends com.bea.b2b.protocol.messaging.BasicQualityOfService
implements java.lang.Cloneable, java.io.Serializable

The QualityOfService class provides information to BEA's messaging system about the Quality of Service required for the delivery of a message.

Author:
Copyright © 2000 BEA Systems, Inc. All Rights Reserved.
See Also:
Serialized Form

Constructor Summary
QualityOfService()
          Constructs a QualityOfService object.
 
Method Summary
 java.lang.String getCorrelationId()
          Gets the message ID of the correlated business message, which is the business message that corresponds to this business message (for example, the message ID of the request to which this business message is a reply).
 java.util.Hashtable getHopTimestamps()
          Gets timestamps recorded at each system component (c-hub and c-enabler) during the propagation of this business message.
 int getRetryAttempts()
          Gets the maximum number of retries to attempt when trying to send this business message over a network link.
 long getTimeout()
           
 boolean isConfirmedDeliveryToDestination()
          Determines whether the delivery for this business message is confirmed up to its destination (true) or not (false).
 boolean isConfirmedDeliveryToHub()
          Determines whether the delivery of this business message is confirmed up to the c-hub (true) or not (false).
 boolean isConfirmedDeliveryToRouter()
          Determines whether the delivery of this business message is confirmed up to the router in the c-hub (true) or not (false).
 boolean isPersistent()
          Gets the durability setting (persistent or non-persistent) of this business message.
 void setConfirmedDeliveryToDestination(boolean confirm)
          Sets the Quality of Service for this business message, specifying whether to confirm message delivery up to its destination (true) or only up to the c-hub (false).
 void setConfirmedDeliveryToHub(boolean confirm)
          Sets the Quality of Service for this business message, specifying whether to confirm message delivery up to the c-hub (true) or not (false).
 void setConfirmedDeliveryToRouter(boolean confirm)
          Sets the Quality of Service for this business message, specifying whether to confirm message delivery up to the router in the c-hub (true) or only up to the c-hub (false).
 void setCorrelationId(java.lang.String cid)
          Sets the message ID of the correlated business message, which is the business message that corresponds to this business message (for example, the message ID of the request to which this business message is a reply).
 void setPersistent(boolean isPersistent)
          Sets the durability (persistent or non-persistent) of this business message.
 void setRetryAttempts(int ra)
          Sets the maximum number retries to attempt when sending this business message over a network link.
 void setTimeout(long t)
          Sets the timeout value for the business message, in milliseconds.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

QualityOfService

public QualityOfService()
Constructs a QualityOfService object.
Method Detail

isPersistent

public boolean isPersistent()
Gets the durability setting (persistent or non-persistent) of this business message.

Returns:
boolean - true if the business message is persistent, or false if not.
Overrides:
isPersistent in class com.bea.b2b.protocol.messaging.BasicQualityOfService

setPersistent

public void setPersistent(boolean isPersistent)
Sets the durability (persistent or non-persistent) of this business message.

Parameters:
isPersistent - Specify true to make the business message persistent, or false if not.
Overrides:
setPersistent in class com.bea.b2b.protocol.messaging.BasicQualityOfService

getRetryAttempts

public int getRetryAttempts()
Gets the maximum number of retries to attempt when trying to send this business message over a network link.

Returns:
int - Maximum number of retry attempts.

setRetryAttempts

public void setRetryAttempts(int ra)
Sets the maximum number retries to attempt when sending this business message over a network link.

Parameters:
ra - Maximum number of retry attempts.

getTimeout

public long getTimeout()


setTimeout

public void setTimeout(long t)
Sets the timeout value for the business message, in milliseconds. By setting this timeout value, the sender is not expecting any communication in the system for this business message after the specified timeout is exceeded.

Parameters:
t - Timeout, in milliseconds, starting from the time at which the business message was sent.

getCorrelationId

public java.lang.String getCorrelationId()
Gets the message ID of the correlated business message, which is the business message that corresponds to this business message (for example, the message ID of the request to which this business message is a reply).

Returns:
String - Correlation ID.

setCorrelationId

public void setCorrelationId(java.lang.String cid)
Sets the message ID of the correlated business message, which is the business message that corresponds to this business message (for example, the message ID of the request to which this business message is a reply).

Parameters:
cid - Message ID of the correlated business message.

getHopTimestamps

public java.util.Hashtable getHopTimestamps()
Gets timestamps recorded at each system component (c-hub and c-enabler) during the propagation of this business message.

Returns:
Hashtable Hop timestamps: key=location, value=timestamp in java.util.date.

setConfirmedDeliveryToDestination

public void setConfirmedDeliveryToDestination(boolean confirm)
Sets the Quality of Service for this business message, specifying whether to confirm message delivery up to its destination (true) or only up to the c-hub (false).

Confirmation information includes:

1. Complete delivery status from each destination. This includes receipt timestamp, retry attempts (if any), router selected trading partners, and the final list of recipient trading partners.

2. Complete message tracking information (all potential locations) for the c-hub administrator and the sending c-enabler's administrator.

Parameters:
confirm - If true, message delivery is confirmed up to its destination. If false, message delivery is confirmed up to the c-hub only.

isConfirmedDeliveryToDestination

public boolean isConfirmedDeliveryToDestination()
Determines whether the delivery for this business message is confirmed up to its destination (true) or not (false).

Returns:
boolean - true if message delivery is confirmed up to its destination, or false if it is confirmed up to the c-hub only.

setConfirmedDeliveryToRouter

public void setConfirmedDeliveryToRouter(boolean confirm)
Sets the Quality of Service for this business message, specifying whether to confirm message delivery up to the router in the c-hub (true) or only up to the c-hub (false).

Confirmation information includes:

1. Information about the c-hub router selected trading partners scheduled to receive the business message.

2. Message tracking until the business message reaches the c-hub router.

Parameters:
confirm - Specify true to confirm delivery up to the c-hub router, or false to confirm up to the c-hub.

isConfirmedDeliveryToRouter

public boolean isConfirmedDeliveryToRouter()
Determines whether the delivery of this business message is confirmed up to the router in the c-hub (true) or not (false).

Returns:
boolean true if message delivery is confirmed to the c-hub router, or false if not.

setConfirmedDeliveryToHub

public void setConfirmedDeliveryToHub(boolean confirm)
Sets the Quality of Service for this business message, specifying whether to confirm message delivery up to the c-hub (true) or not (false).

Parameters:
confirm - Specify true to confirm message delivery to the c-hub, or false if not.

isConfirmedDeliveryToHub

public boolean isConfirmedDeliveryToHub()
Determines whether the delivery of this business message is confirmed up to the c-hub (true) or not (false).

Returns:
boolean true if message delivery is confirmed to the c-hub, or false if not.