WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Developing Web services deployment descriptor templates for a JavaBeans implementation

Deployment descriptors are standard text files, formatted using XML and packaged in a Web services application. Deployment descriptors are required to deploy Web services that are developed using the Web services for Java 2 Platform, Enterprise Edition (J2EE).

Before you begin

Develop a Web Services Description Language (WSDL) file.

You need a WSDL file to use Web services. You can develop your own WSDL file or get one from a Web services provider through e-mail, downloading, or through a Uniform Resource Locator (URL). This documentation assumes you are creating your own.

Why and when to perform this task

Completing this task creates the deployment descriptors used to describe how to map the service implementation to a JavaBeans component.

To develop the deployment descriptor templates from a WSDL file, you must obtain the Web address of the WSDL file.

If the WSDL file is a local file and you are running on the Windows platform, the Web address looks like this example: file:drive:\path\file_name.wsdl. If you are using the Linux or Unix platform, the Web address looks like this example: file:/path/file_name.wsdl. You can also specify local files using the absolute or relative file system path.

When the Web service is a JavaBeans implementation in a Web module, the 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 are generated in the WEB-INF subdirectory.

Develop deployment descriptor templates by running the designated command:

Step for this task

Run the WSDL2Java -verbose -role develop-server -container web -genJava no wsdlURL command to generate the server deployment descriptor templates and mapping file into the WEB-INF subdirectory. If the -verbose option is specified, a list of all the generated files is displayed when the command runs.

Result

You have deployment descriptor templates that are required to implement or use Web services.

Example

The following example uses a WSDL file named AddressBookJ2WB.wsdl:

Generate the template files:
WSDL2Java -verbose -role develop-server -container web -genJava no AddressBookJ2WB.wsdl 
The deployment descriptor templates and mapping file are generated into the WEB-INF subdirectory:
Parsing XML file: AddressBookJ2WB.wsdl
Generating: WEB-INF\webservices.xml
Generating: WEB-INF\ibm-webservices-bnd.xmi
Generating: WEB-INF\ibm-webservices-ext.xmi
Generating: WEB-INF\AddressBookJ2WB_mapping.xml

What to do next

Now, you need to configure the webservices.xml deployment descriptor and configure the ibm-webservices-bnd.xmi deployment descriptor so that WebSphere Application Server can process the incoming Web services. After you configure the deployment descriptors, you must assemble the Web services application for deployment.



Related tasks
Configuring Web services deployment descriptors
Configuring the webservices.xml deployment descriptor
Configuring the ibm-webservices-bnd.xmi deployment descriptor
Developing a new Web service with an existing WSDL file using JavaBeans technology
Developing a Web service from a Java bean

Related reference
WSDL2Java command

Task topic    

Terms of Use | Feedback

Last updated: Mar 17, 2005 4:28:29 AM CST
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/twbs_beandeploydescriptor.html

© Copyright IBM Corporation 2002, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)