How LEIF Performs Character Conversions for Non-UTF-8 Encodings

LEIF User's Guide
Rogue Wave web site: Home Page | Main Documentation Page

9.2 How LEIF Performs Character Conversions for Non-UTF-8 Encodings

This section discusses how LEIF's code generator and data parser deal with non-UTF-8 character encodings.

9.2.1 Character Encoding in XML Schemas and WSDLs

For XML schemas and WSDLs with a character encoding other than UTF-8, the Xerces-J parser used internally by LEIF automatically converts the string data to UTF-8 from the encoding specified in the document's prolog (See Section 9.5.3).

When providing non-UTF-8 schemas and WSDLs to LEIF, ensure that all characters in the document match the encoding stated in the document's prolog.

NOTE -- When providing non-UTF-8 schemas and WSDLs to LEIF, ensure that all characters in the document match the encoding stated in the document's prolog.

LEIF also supports non-ASCII XML element and attribute names. These names are handled in one of two ways:

If a customized mapping is defined to map the non-ASCII names to ASCII values, and this mapping is provided in a LEIF project file to the code generator, the binding uses the mapped element and attribute names. Here is an example mapping:

<leif-project>  
  <options>
    <option name='project-name' value='MyMapping'/>
    ...
    </options>
  <mappings>
    <name xsdtype="element" xsdname="ãf³" 
         name="i18nElement"/>
    <name xsdtype="attribute" xsdname="èç3"
         name="i18nAttribute"/>
  </mappings>
</leif-project>

If no specialized mapping is supplied, the binding assigns element and attribute names based on the pattern Member<number>. The number assigned to any given element or attribute seems arbitrary, a result of the limitations of XSLT, which is used to generate the code. However, these names are just placeholders within the binding, so this issue does not affect the quality of the processed XML document.

Non-ASCII element and attribute names are preserved when an XML instance document is unmarshaled and later marshaled back into an XML document.

9.2.2 Character Encoding in Generated Classes

Classes created by LEIF parse XML using class LEIF::XmlReader. An instance of LEIF::XmlReader converts XML source to UTF-8, regardless of the original encoding. For details on the encodings that the reader supports, see the entry for LEIF::XmlReader in the LEIF Core Library Reference Guide.

LEIF produces XML documents in UTF-8.

©2003-2005 Copyright Quovadx, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.