JEUS JAX-RPC web services define the settings related to instantiating web services module in an XML file called 'service-config.xml'.

<?xml version="1.0" encoding="UTF-8"?>
<web-services-config xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <service>
        <service-name>DocLitEchoService</service-name>
        <target-namespace>urn:DocLitService</target-namespace>
        <output-wsdl-file>DocLitEchoService.wsdl</output-wsdl-file>
        <output-jaxrpc-mapping-file>
            DocLitEchoService-mapping.xml
        </output-jaxrpc-mapping-file>
        <style>wrapped</style>
        <interface>
            <endpoint-interface-class>
                jeustest.webservices.java2wsdl.doclit.Echo
            </endpoint-interface-class>
        </interface>
    </service>
</web-services-config>

The previous configuration instantiates a web service called DocLitEchoService, which is configured with the <servicename> element. The generated WSDL and mapping files are 'DocLitEchoService.wsdl' and 'DocListEchoService-mapping.xml' respectively. Service style is set to 'WRAPPED', and the web service endpoint is set to the Java class file 'jeustest.webservices.java2wsdl.doclit.Echo'.

JEUS JAX-RPC web services provide a command-line tool and Ant Task for instantiating web services. Either tool can be used depending on preference.

JAX-RPC web services provide the command-line tool for creating a web service.

Usage: java2wsdl [options] configuration_file
where [options] include:
-classpath <path>           specify where to find input class files
-cp <path>                  same as -classpath <path>
-d <directory>              specify where to place generated output files
-verbose                    [optional] turn verbose mode on

JEUS JAX-RPC web services provide an Ant Task called 'java2wsdl'. It takes the service configuration file path as an input and generates the WSDL file and JAX-RPC mapping file.

Compile the Java class files with the following command.

ant compile

The WSDL file and JAX-RPC mapping file are created in the './build' directory.

The compile Ant Task is internally processed in the order of '-pre-compile', 'do-compile', and '-postcompile'. The '-post-compile' process creates the WSDL file and JAX-RPC mapping file as shown in the following.

<target name="-post-compile">
    <mkdir dir="${build.war.dir}/WEB-INF/wsdl"/>
    <antcall target="java2wsdl">
        <param name="java2wsdl.option" 
               value="-classpath ${build.classes.dir}
               -d ${build.war.dir}/WEB-INF ${src.conf}/service-config.xml" />
    </antcall>
</target>

The name of the Java EE web services DD file must be 'webservices.xml'.

The name of the JEUS web services DD file must be 'jeus-webservices-dd.xml'.

Java web services package Java classes and web service DD files like web modules. Web service modules are packaged into an EAR (Enterprise Application Archive) file that contains the web application WAR and EJB JAR files.

The following is a sample configuration file called 'service-config.xml'.

The previous configuration instantiates a web service called AddressBookService which is configured in the <service-name> element and the generated WSDL and mapping files are 'AddressBookService.wsdl' and 'AddressBookService-mapping.xml' respectively. Service style is configured to 'WRAPPED' and web service endpoint is set to the Java class file called 'address.AddressBookIF'.

JEUS JAX-RPC web services provide a command-line tool and Ant Task for instantiating web services. Either tool can be used depending on preference.

JEUS JAX-RPC web services provide a command-line tool for creating web services.

Usage: java2wsdl [options] configuration_file

where [options] include:
-classpath <path>   specify where to find input class files
-cp <path>          same as -classpath <path>
-d <directory>      specify where to place generated output files
-level <log-level>  specify a log level
-verbose            [optional] turn verbose mode on

To instantiate the web service by using the service-config.xml file shown in the previous section, execute the following command, assuming that the compiled Java class back-end files exist in the 'JEUS_HOME/sample/classes' folder.

JEUS_HOME/sample$java2wsdl -cp ./classes ejb-service-config.xml

When you execute the previous command, WSDL file (AddressBookService.wsdl) and JAX-RPC mapping file (AddressBookService-mapping.xml) are created.

JEUS JAX-RPC web services provide an Ant Task called 'java2wsdl' for creating web services. It takes the service configuration file path as an input and generates the WSDL file and JAX-RPC mapping file.

Compile the Java class files with the following command.

ant compile

The WSDL file and JAX-RPC mapping file are created under the './build' directory.

The compile Ant Task is internally processed in the order of '-pre-compile', 'do-compile', and '-postcompile'. The '-post-compile' process that creates the WSDL file and JAX-RPC mapping file shown in the following.

<target name="-post-compile">
    <mkdir dir="${build.classes.dir}/META-INF/wsdl"/>
    <antcall target="java2wsdl">
        <param name="java2wsdl.option" 
               value="-classpath ${build.classes.dir}
        -d ${build.classes.dir}/META-INF ${src.conf}/ejb-service-config.xml" />
    </antcall>
</target>

Enter the file path of the service configuration file by using the 'configufilepath' attribute of the <java2wsdl> element, and enter the file path of the compiled Java class files by using the 'refid' attribute of the <classpath> element. After executing these commands, a WSDL file and JAX-RPC mapping file are created.

Web services DD (Deployment Descriptor) file is an XML file that contains the deployment configurations. The file provides the web service engine with information about web service deployment and web service back-end search methods.

There are two kinds of web services DD file. First one is the webservices.xml file, a standard web service DD file defined by the Java EE web services specification. The other one is the 'jeus-webservicesdd. xml' file, a JEUS specific deployment descriptor file.

The name of the Java EE web service DD file must be 'webservices.xml'.

In order to connect to the service, the port named 'AddressBookIFPort' in the WSDL must be used and an SEI and EJB must be created for this port.

The name of the JEUS web services DD file must be 'jeus-webservices-dd.xml'.

The following is the actual URL for invoking the web service.

http://host:port/webservice/AddressBookService

An EJB-based web service is packaged with the web services DD and WSDL into an EJB JAR package. The EJB JAR package is then packaged into a standard enterprise application EAR file with other web application WAR and EJB JAR packages.