Using Web Services Reliable Messaging 5-23
You can configure properties for a reliable Web service and client at the WebLogic Server, Web service endpoint, or Web service client level.
The properties that you define at the WebLogic Server level apply to all reliable Web services and clients on that server. For information about configuring reliable
messaging at the WebLogic Server level, see Section 5.7.1, Configuring Reliable
Messaging on WebLogic Server .
If desired, you can override the reliable message configuration options defined at the server level, as follows:
■
At the Web service endpoint level by updating the application deployment plan. The deployment plan associates new values with specific locations in the descriptors
for your application, and is stored in the weblogic-webservices.xml descriptor. At deployment time, a deployment plan is merged with the descriptors
in the application by applying the values in its variable assignments to the locations in the application descriptors to which the variables are linked. For more
information, see
Section 5.7.2, Configuring Reliable Messaging on the Web Service Endpoint
■
At the Web service client level, as described in Section 5.7.3, Configuring Reliable
Messaging on Web Service Clients The following sections describe how to configure reliable messaging at the WebLogic
Server, Web service endpoint, and Web service client levels.
■
Section 5.7.1, Configuring Reliable Messaging on WebLogic Server
■
Section 5.7.2, Configuring Reliable Messaging on the Web Service Endpoint
■
Section 5.7.3, Configuring Reliable Messaging on Web Service Clients
■
Section 5.7.4, Configuring the Base Retransmission Interval
■
Section 5.7.5, Configuring the Retransmission Exponential Backoff
■
Section 5.7.6, Configuring the Sequence Expiration
■
Section 5.7.7, Configuring Inactivity Timeout
■
Section 5.7.8, Configuring a Non-buffered Destination for a Web Service
■
Section 5.7.9, Configuring the Acknowledgement Interval
■
Section 5.8, Implementing the Reliability Error Listener
5.7.1 Configuring Reliable Messaging on WebLogic Server
You can configure reliable messaging on WebLogic Server using the Administration Console or WLST, as described in the following sections.
■
Section 5.7.1.1, Using the Administration Console
■
Section 5.7.1.2, Using WLST
5.7.1.1 Using the Administration Console
To configure reliable messaging for WebLogic Server using the Administration Console:
1.
Invoke the Administration Console, as described in Using the WebLogic Server Administration Console in Getting Started With JAX-WS Web Services for Oracle
WebLogic Server.
2. In the left navigation pane, select Environment, then Servers.
5-24 Programming Advanced Features of JAX-WS Web Services for Oracle WebLogic Server
3. Select the Configuration tab and in the Server tables, click on the name of the
server for which you want to configure reliable messaging.
4. Click the Configuration tab, then the Web Services tab, then the Reliable
Message tab.
5.
Edit the reliable messaging properties, as described in the following sections:
■
Section 5.7.4.1, Configuring the Base Retransmission Interval on WebLogic Server or the Web Service Endpoint
■
Section 5.7.5.1, Configuring the Retransmission Exponential Backoff on WebLogic Server or Web Service Endpoint
■
Section 5.7.6.1, Configuring the Sequence Expiration on WebLogic Server or Web Service Endpoint
■
Section 5.7.7.1, Configuring the Inactivity Timeout on WebLogic Server or Web Service Endpoint
■
Section 5.7.8, Configuring a Non-buffered Destination for a Web Service
■
Section 5.7.9, Configuring the Acknowledgement Interval
6. Click Save.
For more information, see Web Service Reliable Messaging in the Oracle WebLogic Server Administration Console Help.
5.7.1.2 Using WLST
Alternatively, you can use WLST to configure reliable messaging. For information about using WLST to extend the domain, see Configuring Existing Domains in Oracle
WebLogic Scripting Tool.
5.7.2 Configuring Reliable Messaging on the Web Service Endpoint
By default, Web service endpoints use the reliable messaging configuration defined for the server. You can override the reliable messaging configuration used by the Web
service endpoint using the Administration Console, as follows:
1.
Invoke the Administration Console, as described in Invoking the Administration Console in Getting Started With JAX-WS Web Services for Oracle WebLogic Server.
2. In the left navigation pane, select Deployments.
3.
Click the name of the Web service in the Deployments table.
4. Select the Configuration tab, then the Port Components tab.
5.
Click the name of the Web service endpoint in the Ports table.
6. Select the Reliable Message tab.
7. Click Customize Reliable Message Configuration and follow the instructions to
save the deployment plan, if required.
8.
Edit the reliable messaging properties, as described in the following sections:
Note: Alternatively, you can use WLST to configure reliable
messaging. For information about using WLST to extend the domain, see Configuring Existing Domains in Oracle WebLogic Scripting Tool.
Using Web Services Reliable Messaging 5-25
■
Section 5.7.4.1, Configuring the Base Retransmission Interval on WebLogic Server or the Web Service Endpoint
■
Section 5.7.5.1, Configuring the Retransmission Exponential Backoff on WebLogic Server or Web Service Endpoint
■
Section 5.7.6.1, Configuring the Sequence Expiration on WebLogic Server or Web Service Endpoint
■
Section 5.7.7.1, Configuring the Inactivity Timeout on WebLogic Server or Web Service Endpoint
■
Section 5.7.8, Configuring a Non-buffered Destination for a Web Service
■
Section 5.7.9, Configuring the Acknowledgement Interval
9. Click Save.
