Liquid XML Data Binder (C++, Java, VB6) / Reference / Java / Reference / com.liquid_technologies.ltxmllib20 / Base64BinaryCol / Java fromXmlStream - XmlObjectInterface
In This Topic
    Java fromXmlStream - XmlObjectInterface
    In This Topic
    void fromXmlStream(byte[] data)
                   throws LtException, IOException;

    void fromXmlStream(byte[] data, com.liquid_technologies.ltxmllib20.SerializationContext context)
                   throws LtException, IOException;
      Property Description  
        Method Name FromXml  
        Argument - data An array of bytes representing the XML document to be loaded.  
        Argument - context The SerializationContext object controls the way in which XML is serialized/de-serialized. Its main role is to control the way in which validation is performed and which namespaces are output.
    If this is not specified, the a default (SerializationContext.Default global static) instance of the class is used. If you are using several libraries generated from different schemas, or you want to change the way validation is performed for during the lifetime of the application or you are writing multithreaded code, then you should consider creating your own instance(s) of the SerializationContext.
    If you are writing a multithreaded app it is highly recommended that you use a different instance of this class on each thread, as access to the static instance is not synchronized. Although read only operations to the static instance (SerializationContext::Default) of the class are thread safe, if the global instance SerializationContext::Default is modified, then this could potentially cause threading problems.
     
        Description Reads XML from a byte array into the current object  
        Remarks

    This method will only load XML that complies with the XSD schema.
    It will raise an exception if the XML is invalid.

    The root element in the XML held within lpszXMLIn must correspond to the class which this method is being called on. So you have a simple schema.

    <?xml version="1.0" encoding="UTF-8"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
               elementFormDefault="qualified"
               attributeFormDefault="unqualified">
      <xs:element name="Person">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="name" type="xs:string"/>
            <xs:element name="Address">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="HouseNumber" type="xs:string"/>
                  <xs:element name="PostCode" type="xs:string"/>
                </xs:sequence>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:schema>


    This would cause 2 classes to be generated Person & Address.
    So if you had the XML Data.

    <?xml version="1.0" encoding="UTF-8"?>
    <Person>
      <name>Joe Blogs</name>
      <Address>
        <HouseNumber>15</HouseNumber>
        <PostCode>LS5 9PQ</PostCode>
      </Address>
    </Person>


    You would call FromXml on a Person object i.e.

    byte[] xml = ....
    Person person = new Person();
    person.fromXMLStream(xml)
    ;

    Character encoding.
    The default underlying parser supports the following character encodings

    • UTF-8
    • UTF-16
    • UNICODE

    Also See Multi-Language Support