You can assemble a web services-enabled
enterprise bean Java archive (JAR) file from a Web
Services
Description Language (WSDL) file with an assembly tool.
Before you begin
You can assemble Java-based web services modules
with assembly
tools provided with WebSphere® Application Server.
You
need the following artifacts to complete this task:
- An assembled enterprise bean JAR file that contains the Enterprise JavaBeans (EJB) implementation and all
classes that generate from the WSDL2Java command-line
tool when the role argument is develop-server and
the container argument is EJB.
- A WSDL
file
- The complete webservices.xml, ibm-webservices-bnd.xmi and ibm-webservices-ext.xmi deployment
descriptors, and the Java API
for XML-based remote procedure call (JAX-RPC) mapping file.
About this task
Assemble a web services-enabled enterprise bean JAR file
from a WSDL file by following the actions in the steps for this task
section.
Procedure
- Start an assembly tool. Read about starting
the assembly tool in the Rational® Application Developer documentation.
- If you have not done so already, configure the assembly
tool so that it works on Java EE modules. You need to make sure that
the Java EE and Web categories are enabled. Read
about configuring the assembly tool in the Rational Application Developer documentation.
- Migrate JAR files created with the Assembly Toolkit,
Application
Assembly Tool or a different tool to the Rational Application Developer assembly tool. To migrate
files, import your JAR files to the assembly tool. Read about migrating
code artifacts to an assembly tool in the Rational Application Developer documentation.
Results
You have the artifacts required to web service-enable
an EJB
module for web services. The artifacts are added to the JAR file.
Now you need to configure the deployment descriptors so that you can
deploy the web service into the application server runtime environment.
Example
The
AddressBook.jar JAR file contains
the following files after assembly. The files added in this task are
in bold. These files include the WSDL file, the deployment descriptors,
and the JAX-RPC mapping file.
META-INF/MANIFEST.MF
META-INF/ejb-jar.xml
addr/Address.class
addr/AddressBook_RI.class
addr/AddressBookSoapBindingImpl.class
addr/AddressBookHome.class
addr/Phone.class
addr/StateType.class
addr/AddressBook.class
META-INF/wsdl/AddressBook.wsdl
META-INF/ibm-webservices-bnd.xmi
META-INF/ibm-webservices-ext.xmi
META-INF/webservices.xml
META-INF/AddressBook_mapping.xml
What to do next
For JAX-RPC web services, configure
the
webservices.xml deployment
descriptor . You need to configure the deployment descriptors for
the web service so that WebSphere Application Server
can process the incoming web services requests.