Connect an Existing EntireX RPC Server with an XML-based Client

This document describes how to connect an existing RPC server with an XML-based client, using a Web application that contains the EntireX XML/SOAP Runtime as part of Software AG Common Web Services Stack, or using the Java API of EntireX XML/SOAP Runtime.

Connect RPC Server with XML-based Client, using a Web Application

graphics/xmlClient_webApp.png

Start of instruction setTo generate the application, using a default SOAP mapping for the Web Service

  • Select the IDL file that was used for creating the EntireX RPC server. From the context menu, choose and Web Service > Generate Web Service... and follow the instructions given by the wizard.

Start of instruction setTo generate the application, not using an XML Mapping or a non-Default SOAP Mapping

  1. Select the IDL file that was used for creating the EntireX RPC server and open it with the EntireX XML Mapping Editor.

  2. Select the mapping and press Generate. Save the mapping file.

  3. Depending on the tools used for the generation of the XML-based client, create an XML Schema or WSDL for the generation of the XML-based client.

    Select the IDL file, and from the context menu choose Web Service > Generate Web Service....

    For the generation of the XML Schema file: Select the XMM file and open the context menu. Choose Generate XML Schema (XSD)....

Connect RPC Server with XML-based Client, using the Java API of EntireX XML/SOAP Runtime

graphics/xmlClient_java.png

Start of instruction setTo generate the application

  1. Select the IDL file that was used for creating the EntireX RPC server and open it with the EntireX XML Mapping Editor.

  2. Select the mapping SOAP and press Generate. Save the mapping file.

  3. Depending on the tools used for the generation of the XML-based client, create an XML Schema or WSDL for the generation of the XML-based client.

    Select the IDL file, and from the context menu choose Web Service > Generate Web Service....

    For the generation of the XML Schema file: Select the XMM file and from the context menu choose Generate XML Schema (XSD)....

    Note:
    If this is not possible, write an XML-based client.

  4. Create an XML-based client with a suitable tool. Follow the instructions on the screen, or Generate Web Services from Software AG IDL File.

Running the Application

Start of instruction setTo run the application

  1. Start the EntireX Broker (if required).

  2. Configure and start the EntireX RPC server (if not started already).

  3. Run the client application.