EGL Reference Guide for iSeries

EGL Web Service Wizard

The task of creating an EGL Web service is separate from the task of writing EGL programs. When you create the Web service Java bean, you can reference any EGL program. The script in the EGL program may be incomplete, but the program parameters must be fully specified.

The EGL Web Service Wizard guides you through the steps needed to create and use a Web service:

  1. Collects the name and operations of the Web service; and (optionally) creates a Web service definition file to retain that information
  2. Creates the Web service Java bean, as well as any wrappers, BeanInfo classes, and Return Value Java beans used at run time
  3. Creates Web services description language (WSDL) that specifies both the operations that a Web service client can access and the parameters required to invoke those operations
  4. Optionally, creates a Java proxy based on the WSDL
  5. Optionally, creates a sample Web service client
  6. Optionally, publishes the Web service to a Universal Description, Discovery, and Integration (UDDI) registry
  7. Optionally, launches the WebSphere Test Environment so you can confirm that the Web service works correctly

The name of the Web service becomes the name of the Web service Java bean. Also, the name of each operation become the name of a method in the Java bean.

The following restrictions apply:

Web service definition file

The EGL Web service wizard lets you produce a Web service definition file, but does not require that you do so. (You can create this kind of file outside of the wizard, too, either by hand or as described in Creating an EGL Web service definition file. In particular, if you want to associate multiple operations with a single EGL program, you must create the file outside of the wizard.)

When you invoke the EGL Web Service Wizard, you can use an existing Web service definition file as input and so can avoid re-stating the following information, which is provided in the file:

The following Web service definition file associates each of three operations with the appropriate EGL program:

  <?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE EGLWebServiceDefinition PUBLIC "-//IBM//DTD EGLWSD 5.0//EN" "">
  <EGLWebServiceDefinition name="TimeAndDate"
    package="com.ibm.timedate.service">
 
    <operation name="GetDate" 
      programName="GetDate" 
      programPath="/TimeDateWeb/EGL Source/GetDate.egl"/> 
      <parameter name="DateRecord" input="NO" output="YES" />
    </operation>
 
    <operation name="GetTime"
      programName="GetTime"
      programPath="/TimeDateWeb/EGL Source/GetTime.egl"/>
      parameter name="Time" input="NO" output="YES"/>
    </operation>
 
    <operation name="GetTimeAndDate"
      programName="GetTimeAndDate"
      programPath="/TimeDateWeb/EGL Source/GetTimeAndDate.egl"/>
      <parameter name="Time" input="NO" output="YES"/>
      <parameter name="DateRecord" input="NO" output="YES" />
    </operation>
 
  <EGLWebServiceDefinition>

The name of the Web service definition file is the name of the Web service followed by the extension .eglwsd.

Java wrappers and BeanInfo classes

The EGL Web Service Wizard allows you to select either of two ways to generate Java wrappers and (if appropriate) BeanInfo classes. (The BeanInfo classes are necessary only if the EGL-generated program receives data as an EGL record or structure.)

Your choices are as follows:

The following rules apply for each build descriptor you specify (if any):

Test choices

You can use the EGL Web service wizard to create any of three Web service clients for use in testing the Web service:

You must use the Universal Test Client if a parameter in any of the EGL programs includes either of these:


Related concepts
Java wrapper
Linkage options part


Application testing and publishing
Tools for Web services development
Web services overview


Related tasks
Adding a build descriptor part
Adding a linkage options part
Creating an EGL Web service definition file
Creating an EGL Web service
Editing an EGL Web service definition file


Related reference
enableJavaWrapperGen
Java wrapper classes
linkage
Naming conventions


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]