Using JMS Transport as the Connection Protocol 8-3
See Section 8.8, Invoking a WebLogic Web Service Using JMS Transport
for information about updating your client application to invoke the Web service using
JMS transport.
8.3 Using JMS Transport Starting From WSDL: Main Steps
To use JMS transport when starting from WSDL, you must perform at least one of the following tasks:
■
Update the WSDL to use JMS transport before running the wsdlc Ant task.
■
Update the stubbed-out JWS implementation file generated by the wsdlc Ant task to add the WLJmsTransport annotation.
■
Add a WLJmsTransport child element to the jwsc Ant task used to build the JWS implementation file. This setting overrides the transports defined in the JWS
file.
The following procedure describes the complete set of steps required so that your Web service can be invoked using the JMS transport when starting from WSDL.
4 Build your Web service by
running the target in the build.xml
Ant file that calls the jwsc task.
For example, if the target that calls the jwsc Ant task is called build-service
, then you would run: prompt ant build-service
See Running the jwsc WebLogic Web Services Ant Task in Getting Started With JAX-RPC Web Services for Oracle WebLogic Server.
5 Deploy your Web service to
WebLogic Server. See Deploying and Undeploying WebLogic Web Services in Getting Started
With JAX-RPC Web Services for Oracle WebLogic Server.
Note: Because you might not know at the time that you are coding
the JWS file which transport best suits your needs, it is often better to specify the transport at build-time using the WLJmsTransport
child element.
Note: It is assumed in this procedure that you have an existing
WSDL file.
Table 8–1 Cont. Steps to Use JMS Transport Starting From Java
Step Description
8-4 Programming Advanced Features of JAX-RPC Web Services for Oracle WebLogic Server
See Section 8.8, Invoking a WebLogic Web Service Using JMS Transport
for information about updating your client application to invoke the Web service using
JMS transport.
Table 8–2 Steps to Use JMS Transport Starting From WSDL
Step Description
1 Configure the WebLogic
Server domain for the required JMS components.
See Section 8.4, Configuring the Host WebLogic Server Instance for the JMS
Transport Web Service .
2 Update the WSDL to use JMS
transport. Optional This step is optional. If you do not update the WSDL to use JMS transport,
then you must do at least one of the following:
■
Edit the stubbed out JWS file to add the WLJmsTransport annotation to your JWS file, as described in Step 4.
■
Add a WLJmsTransport child element to the jwsc Ant task, as described in Step 5.
See Section 8.7, Updating the WSDL to Use JMS Transport
. 3
Run the wsdlc Ant task against the WSDL file.
For example, if the target that calls the wsdlc Ant task is called generate-from-wsdl, then you would run:
prompt ant generate-from-wsdl See Running the wsdlc WebLogic Web Services Ant Task in Getting Started
With JAX-RPC Web Services for Oracle WebLogic Server. 4
Update the stubbed-out JWS file.
The wsdlc Ant task generates a stubbed-out JWS file.You need to add your business code to the Web service so it behaves as you want. See Updating
the Stubbed-out JWS Implementation Class File Generated by wsdlc in Getting Started With JAX-RPC Web Services for Oracle WebLogic Server.
If you updated the WSDL to use the JMS transport in Step 2, the JWS file includes the WLJmsTransport annotation that defines the JMS transport. If
the WLJmsTransport annotation is not included in the JWS file, you must do at least one of the following:
■
Edit the JWS file to add the WLJmsTransport annotation to your JWS file, as described in
Section 8.5, Using the WLJmsTransport JWS Annotation
.
■
Add a WLJmsTransport child element to the jwsc Ant task, as described in Step 5.
5 Add a WLJmsTransport
child element to the jwsc Ant task. Optional
Use the WLJmsTransport child element to override the transports defined in the JWS file. This step is required if the JWS file does not include
the WLJmsTransport annotation, as noted in Step 4. Otherwise, this step is optional.
See Section 8.6, Using the WLJmsTransport Child Element of the jwsc Ant
Task for details.
6 Run the jwsc Ant task
against the JWS file to build the Web service.
Specify the artifacts generated by the wsdlc Ant task as well as your updated JWS implementation file, to generate an Enterprise Application that
implements the Web service. See Running the jwsc WebLogic Web Services Ant Task in Getting Started With JAX-RPC Web Services for Oracle WebLogic
Server.
7 Deploy the Web service to
WebLogic Server. See Deploying and Undeploying WebLogic Web Services in Getting Started
With JAX-RPC Web Services for Oracle WebLogic Server.
Using JMS Transport as the Connection Protocol 8-5
8.4 Configuring the Host WebLogic Server Instance for the JMS Transport Web Service
