Creating a Java web service for the IBM WebSphere JAX-WS runtime environment using Ant tasks
You can use an Ant task instead of the web services wizards to generate a Java™ web service for the IBM® WebSphere® JAX-WS runtime environment. Ant tasks support both bottom-up and top-down web services development.
Before you begin
- Create a server and web project for your web service: Creating a JAX-WS-enabled WebSphere server
- Import the Ant task and properties files into your workspace: Importing Ant files for your JAX-WS web service
- Customize the Ant properties files for your web service:
- Create or import files into a folder of the web project that you
created, according to the type of web service that you want to create:
- If you want to create a bottom-up service, create or import a bean into the src folder
- If you want to create a top-down service, locate or create a WSDL file, or import one into the project that you created.
About this task
- If you want to create a bottom-up service, the name of the Ant properties file is was_jaxws_bujava.properties.
- If you want to create a top-down service, the name of the Ant properties file is was_jaxws_tdjava.properties.
- If you want to create a client, the name of the Ant properties file is was_jaxws_client.properties.
Procedure
Run your Ant task:
- If you want to run the task in the product workspace:
- Right-click the imported web services generation XML file and select .
- In the dialog box, click the JRE tab and select Run in the same JRE as the workspace.
- Click Apply and then click Run.
Results
When your web service is generated, the following files
are created depending on the options you selected and the type of
web service generated:
- Top-down: The Service Endpoint Interface (SEI). The SEI is the annotated Java representation of the WSDL file for the web service. This interface is used for implementing JavaBeans endpoints or creating dynamic proxy client instances. Data types references in the SEI.
- Bottom-up: The delegate class. This class is a wrapper that contains all the methods from the bean and the JAX-WS annotation the runtime environment recognizes as a web service. If you already have a bean with the @javax.jws.WebService annotation before you run the Ant task, this bean is used as-is and new annotations are not added.
- Request/Response/Exception wrapper classes.
Tip: The wsant.bat file
is installed in the product's bin directory.
On some systems, this directory might be read-only. In these cases,
the Ant task cannot create the output and the web service creation
fails. There are two ways to correct this problem:
- Set your PATH to point to the bin folder, change to a directory where you have write permission, and run the script from there.
- Copy the wsant.bat file to a writeable directory.