NonStop SOAP 4.1 User's Manual

<parameter name=”hotupdate” locked="false”>true< /parameter>
NOTE: The Hot-Update feature is applicable only for services and not for modules or the
axis2.xml configuration.
Internationalization and Encoding
The NonStop SOAP 4 server supports encoding for SOAP messages. You can specify the encoding
for incoming request XML, outgoing response XML and for the TS/MP service data. The encoding
module manages the encoding, and is distributed with the NonStop SOAP 4 server. The default
encoding is UTF-8, unless otherwise specified. By default, this module is enabled by specifying the
following entry in the axis2.xml configuration file:
<module ref=”encoding”/>
NOTE: For specifying an encoding other than UTF-8, set the ICU_DATA environment variable to
point to installed ICU data location in the itp_axis2.config file:
Server $Axis2c {
...
Env ICU_DATA=/usr/tandem/xml/T0563H01/lib/icu/data/
...
}
The NonStop SOAP 4 server supports the following encodings:
• UTF-8 (default encoding)
• ISO-2022-JP
• Other single byte encodings supported by the ICU library
NOTE: The NonStop SOAP 4 server does not support UTF-16 or any multi byte encoding as the
target service encoding or response encoding. They can still be specified as a SOAP request
encoding. A request or response message with an encoding other than UTF-8 has an XML
declaration node (< ?xml version="1.0" encoding="encoding-name"?> ) as the first
node in the SOAP XML document.
Configuring the request encoding
To specify a request encoding other than UTF-8, set the encoding attribute of the XML declaration
element to the desired encoding.
For example, the following sample specifies a request XML encoding as Shift_JIS:
<?xml version="1.0" encoding=”Shift_JIS” ?>
<SOAP_ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body
xmlns:admin="urn:compaq_nsk_oss_soapquery">
<admin:ListServices serviceType="all"/>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Configuring the response encoding
To set the encoding for SOAP response messages, use one of the following options.
1. Specify the encoding of individual responses in the encoding element of the SOAP request
message header. For example, the following SOAP header specifies ISO-2022-jp as the
response message encoding:
<SOAP_ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header xmlns:nskhdr="urn:compaq_nsk_oss_EncodingHeader">
230 NonStop SOAP 4 Features