Developing EJB implementation templates and bindings from a WSDL file

You can develop Enterprise JavaBeans (EJB) implementation deployment descriptor templates and bindings from a Web Services Description Language (WSDL) file for a JAX-RPC application.

Before you begin

To develop EJB implementation templates and bindings from a WSDL file for a Java API for XML-based RPC (JAX-RPC) Web service, you must obtain the Uniform Resource Locator (URL) of the WSDL file to use.

[Windows] If the WSDL file is a local file, the URL looks like the following example: file:drive:\path\file_name.wsdl.

[Linux] [AIX] [HP-UX] [Solaris] If the WSDL file is a local file, the URL looks like the following example: file:/path/file_name.wsdl.

You can also specify local files using the absolute or relative file system path.

About this task

This task is one a required step in developing a Web service from an enterprise bean.

Implementation templates are generated using the -role develop-server option of the WSDL2Java command.

Templates are generated for an EJB implementation for the following components:
  • enterprise bean
  • EJB remote interface
  • EJB Home
The WSDL2Java command also generates bindings and deployment descriptors.
Best practice: It is a best practice to use absolute namespaces within your WSDL or schema. By default, the WSDL2Java tool does not permit the use of relative namespaces. Relative namespaces have been deprecated by the XML Plenary Interest Group and the use of relative namespaces causes the XML Digital Signature to fail as required by the Canonical XML Version 1.0 specification. You can convert any relative namespaces to absolute namespaces. To learn more about the use of namespaces with the WSDL2Java tool, see the WSDL2Java command for JAX-RPC applications documentation. bprac

Procedure

Run the WSDL2Java -verbose -role develop-server -container ejb wsdlURL command. Because the verbose option is specified, a list of all the generated files is displayed when the command runs.

Results

You have templates for the implementation and deployment descriptors required to implement Web services, as well as bindings files. These templates are partially completed with information from the WSDL file.

Example

The following example uses the enterprise bean AddressBook enterprise bean and the AddressBook.wsdl file. After generating the template files from the WSDL2Java -verbose -role develop-server -container EJB AddressBook.wsdl command, the following files are generated:
Parsing XML file:  file:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Info: Parsing XML file:  AddressBook.wsdl
WSWS3282I: Info: Generating addr\Address.java.
WSWS3282I: Info: Generating addr\Phone.java.
WSWS3282I: Info: Generating addr\StateType.java.
WSWS3282I: Info: Generating addr\AddressBook.java.
WSWS3282I: Info: Generating addr\AddressBookSoapBindingImpl.java.
WSWS3282I: Info: Generating addr\AddressBook_RI.java.
WSWS3282I: Info: Generating addr\AddressBookHome.java.
WSWS3282I: Info: Generating META-INF\webservices.xml.
WSWS3282I: Info: Generating META-INF\ibm-webservices-bnd.xmi.
WSWS3282I: Info: Generating META-INF\AddressBook_mapping.xml.
WSWS3282I: Info: Generating META-INF\ibm-webservices-ext.xmi.

What to do next

Complete the EJB implementation. When you complete the EJB implementation, an EJB Java archive (JAR) file that contains an EJB and supporting classes is created from a WSDL file.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 5:25:00 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-base-dist&topic=twbs_devejbbindings
File name: twbs_devejbbindings.html