Using Web Services Reliable Messaging 5-33
■
Section 5.7.1, Configuring Reliable Messaging on WebLogic Server
■
Section 5.7.2, Configuring Reliable Messaging on the Web Service Endpoint
2. Set the Non-buffered Destination value, to configure the destination server,
respectively, as required.
5.7.9 Configuring the Acknowledgement Interval
The acknowledgement interval specifies the maximum interval during which the destination endpoint must transmit a stand-alone acknowledgement. You can
configure the acknowledgement interval at the WebLogic Server or Web service endpoint level only, not at the Web service client level.
A destination endpoint can send an acknowledgement on the return message immediately after it has received a message from a source endpoint, or it can send one
separately as a stand-alone acknowledgement. If a return message is not available to send an acknowledgement, a destination endpoint may wait for up to the
acknowledgement interval before sending a stand-alone acknowledgement. If there are no unacknowledged messages, the destination endpoint may choose not to send an
acknowledgement.
The value specified must be a positive value and conform to the XML schema duration lexical format, PnYnMnDTnHnMnS, where nY specifies the number of years, nM
specifies the number of months, nD specifies the number of days, T is the datetime separator, nH specifies the number of hours, nM specifies the number of minutes, and
n
S specifies the number of seconds. This value defaults to P0DT0.2S 0.2 seconds.
Note: On the source server, message buffering should always be
enabled. That is, the Non-buffered Source value should always be disabled.
Note:
A Web service client that uses WebServiceRef to define a reference to the Web service uses the acknowledgement interval value
to control the amount of time that the client’s response handling will wait until acknowledging responses that it receives. In other words,
the client acts like an RM destination when receiving response messages.
The non-buffered destination configuration appears in the weblogic.xml file as follows:
service-reference-description ...
port-info stub-property
nameweblogic.wsee.wsrm.AcknowledgementIntervalname valuePT5Svalue
stub-property ...
port-info service-reference-description
For more information about WebServiceRef, see Defining a Web Service Reference Using the WebServiceRef Annotation in Getting
Started With JAX-WS Web Services for Oracle WebLogic Server.
5-34 Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server
To configure the acknowledgement interval, on WebLogic Server or the Web service endpoint level using the Administration Console, perform the following steps:
1.
Invoke the Administration Console and access the Web service reliable messaging pages at the server-level or Web service endpoint level, as described in the
following sections, respectively:
■
Section 5.7.1, Configuring Reliable Messaging on WebLogic Server
■
Section 5.7.2, Configuring Reliable Messaging on the Web Service Endpoint
2. Set the Acknowledgement Interval value, as required.
