3 Web Services

To provide own Web Services to the Enterprise Integration Platform, you have to create an implementation class, add it to the configuration and deploy it to the Web Server's directory.

3.1 Implementation

When implementing the Web Service Java class, you may inherit your class from com.eigner.eai.connector.net.ws.WebService. This abstract base class provides you with a Logger instance and convenience methods for handling the Web Service request.

Basically, your code must do the following:

// The context (name of the web service connector) must be either provided by
// the method call or by a dynamic mapping.WebServiceContext wsc = WebServiceContextFactory.getContext(context);
// Extract the required data from the method call.
// key: Unique key for data// noun: Business Object noun (e.g. ITEM)
// verb: Business Object verb (e.g. CREATE)
// message: XML data
// language: Language code (see Common Section in the Administration Manual)
// synchronous: Flag for synchronous data transmissionString resultString = wsc.process(key, noun, verb, message, language, synchronous);
// Prepare the result XML string for the return value of the method call (if any)

For further information regarding the data, please refer to the chapter about the XDOs in the Enterprise Integration Platform Administration Guide for Agile e6.2.1.0.

3.2 Configuration

Depending on the type of connector, the definition of the Web Service must be added to the synchronous connector's configuration or the asynchronous connector's configuration, although the definition is identical.

Example:

<connector name="ws" version="2.2.0" active="false" class="com.eigner.eai.connector.net.WebServiceConnector">
     <connection name="default" active="true">
           …
           <service name="myservice"
           …
     </connection>
     …
</connector>

3.3 Deployment

For deploying your Web Service into th EIP, copy your WAR file into <eip_root>/data/webapps folder. Once copied, tomcat will automatically deploy and unpack your WebService into EIP. The webapps's directory is also modifiable in the conf/eai_ini.xml under the eai-root/ controller / webserver.

For further information on creating your own JAX-WS WebService, please see

https://docs.oracle.com/cd/E17802_01/webservices/webservices/docs/2.0/tutorial/doc/JAXWS3.html