This document covers the following topics:
Configuring a Client to Call the EntireX XML/SOAP Runtime (Java API)
Configuring a Client to Call the EntireX XML/SOAP Runtime (Listener for XML/SOAP)
The configuration information (which broker to use) is retrieved from the XMM file by default, or the client sets this information explicitly.
For information on available methods, see
XMLRPCService
(EntireX XML/SOAP Runtime); for
available inherited methods, see RPCService
(EntireX Java ACI).
For configuration of the behavior of XML/SOAP Runtime with
setUserProperty
see
XMLRPCService
.
EntireX XML/SOAP Runtime requires correct setting for XML Stream Parser allowing access to JAXP methods. The classpath must contain the required JAR files.
The Java properties are:
javax.xml.stream.XMLInputFactory (default: com.ctc.wstx.stax.WstxInputFactory) javax.xml.stream.XMLOutputFactory (default: com.ctc.wstx.stax.WstxOutputFactory)
These must be set for the client application if they differ from the default settings.
The configuration information (for the EntireX Broker) is retrieved from one of the following sources:
XMM file (lowest priority) by default
configuration xml-init.xml inside the Web service description (AAR file) generated by Packaging Wizard
configuration of EntireX Web service in an external configuration file
HTTP/payload parameters (highest priority)
See also Listener for XML/SOAP.
EntireX XML/SOAP Runtime requires correct setting for the XML Stream Parser to allow access to JAXP methods. The classpath must contain the required JAR files. The Java properties are:
javax.xml.stream.XMLInputFactory (default: com.ctc.wstx.stax.WstxInputFactory) javax.xml.stream.XMLOutputFactory (default: com.ctc.wstx.stax.WstxOutputFactory)
If the settings differ from the default settings, set them in the start script of the Web server.
The RPC Server for XML/SOAP reads configuration data from configuration file (lowest priority), property file and command line (highest priority). You can define location and name of property file and configuration file as command-line parameters. The property file may define the JAXP parameters and the location and name of the configuration file. Default for the properties file is entirex.xmlrpcserver.properties and for configuration file entirex.xmlrpcserver.configuration.xml located in the working directory. The configuration file (in XML format) contains information about EntireX Broker and a list of target servers, including the mapping file associated with them. If a configuration file or a properties file contains non-encrypted or base64-encoded passwords, the passwords are replaced by the encrypted ones.