1.1.5.2.2 Configuring Multiple Encoding Support

SALT supports multiple encoding SOAP messages and the encoding mappings between SOAP message and Oracle Tuxedo buffer. SALT supports the following character encoding:

ASCII, BIG5, CP1250, CP1251, CP1252, CP1253, CP1254, CP1255, CP1256, CP1257, CP1258, CP850, CP862, CP866, CP874, EUC-CN, EUC-JP, EUC-KR, GB18030, GB2312, GBK, ISO-2022-JP, ISO-8859-1, ISO-8859-13, ISO-8859-15, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, JOHAB, KOI8-R, SHIFT_JIS, TIS-620, UTF-16, UTF-16BE, UTF-16LE, UTF-32, UTF-32BE, UTF-32LE, UTF-7, UTF-8

To enable the GWWS multiple encoding support, GWWS server-level “enableMultiEncoding” property should be set to “true” as shown in the example below:

Note:

GWWS internally converts non UTF-8 external messages into UTF-8. However, encoding conversion hurts server performance. By default, encoding conversion is turned off and messages that are not UTF-8 encoded are rejected.

Example 1-13 Configuring GWWS Server Multiple Encoding Property

<Deployment ..>
  ...
  <WSGateway>
    <GWInstance id="GWWS1">
      .......
      <Properties>
        <Property name="enableMultiEncoding" value="true"/>
      </Properties>
    </GWInstance>
  </WSGateway>
  ...
</ Deployment>

The following table explains the detailed SOAP message and Oracle Tuxedo buffer encoding mapping rules if the GWWS server level multiple encoding switch is turned on.

Table 1-7 SALT Message Encoding Mapping Rules

Mapping from Mapping to Encoding Mapping Rule
SOAP/XML Oracle Tuxedo Typed Buffer string/mbstring/xml buffer or field character encoding equals to SOAP xml encoding.
STRING Typed Buffer SOAP/XML GWWS sets the target SOAP message in UTF-8 encoding, and assumes the original STRING buffer contains only UTF-8 encoding characters.

Note:

Oracle Tuxedo Developers must ensure the STRING characters are UTF-8 encoded.
MBSTRING/XML Typed Buffer SOAP/XML SOAP xml encoding equals to MBSTRING/XML encoding.
FML/32, VIEW/32 Typed Buffer that containing the same encoding setting for multiple FLD_MBSTRING fields SOAP/XML SOAP xml encoding is set to FLD_MBSTRING encoding, the original Typed buffer field characters are not changed in the SOAP message.

Note:

Oracle Tuxedo Developers must ensure the FLD_STRING characters in the same buffer are consistent.
FML/32, VIEW/32 Typed Buffer that containing the different encoding for multiple FLD_MBSTRING fields SOAP/XML SOAP xml encoding is set to UTF-8, the original Typed buffer FLD_MBSTRINGfield characters in other encoding are converted into UTF-8 in the SOAP message.

Note:

Oracle Tuxedo Developers must ensure the FLD_STRING characters in the same buffer are UTF-8 encoded.

Parent topic: Configuring the GWWS Servers