Example 137. XML Schema for Encoded Array

<xsd:complexType name="ArrayOfstring">
    <xsd:complexContent>
        <xsd:restriction base="SOAP-ENC:Array">
            <xsd:sequence maxOccurs="unbounded" minOccurs="0">
            <xsd:element name="item" type="xsd:string"/>
            </xsd:sequence>
            <xsd:attribute ref="SOAP-ENC:arrayType"
            wsdl:arrayType="xsd:string[]"/>
        </xsd:restriction>
    </xsd:complexContent>
</xsd:complexType>

Example 138. XML Schema for Literal Array

<xsd:complexType name="ArrayOfstring">
    <xsd:sequence>
        <xsd:element maxOccurs="unbounded" minOccurs="0" name="string"
        nillable="true" type="xsd:string"/> 
    </xsd:sequence>
</xsd:complexType>

Example 139. Generated Java Class

public class Struct { public int field;... }

Example 140. Generated JavaBean

public class Struct { 
    
    protected int field; 
    public int getField() { 
        return field; 
    } 
    public void setField(int field) { 
        this.field = field; 
    }
}

Example 153. <any> Element: XML Schema

<xsd:element name="anyThingInside" type="anyThingInsideType"/>
  ...
    <xsd:complexType name="anyThingInsideType">
        <xsd:sequence>
            <xsd:any/> 
        </xsd:sequence> 
    </xsd:complexType>
  ...
</xsd:element>

Example 154. <any> Element: XML Instance

<anyThingInside>
    <element1> Some additional text </element1> 
</anyThingInside>

Example 155. <any> Element: Java

public class AnyThingInside {
    public org.w3c.dom.Element any;
}

Example 159. Book Class - Java Source Code

package example.processing.serialization.library;


/**
 * Represents a book item in a simple
 * library system.
 */
public class Book {
    /** book name */
    public String name;

    /** book author */
    public String author;

    /**
     * Constructor.
     * @param name book name
     * @param author book author
     * @throws IllegalArgumentException name or author is null
     */
    public Book(
        String name,
        String author) {
        if (name == null) {
            throw new IllegalArgumentException("Name is null!");
        }

        if (author == null) {
            throw new IllegalArgumentException("Author is null!");
        }

        this.name = name;
        this.author = author;
    }

    /**
     * Test for equality.
     * @param object any object
     * @return true if books are equal
     */
    public boolean equals(Object object) {
        if (!(object instanceof Book)) {
            return false;
        }

        Book secondBook = (Book) object;

        return name.equals(secondBook.name) 
	    && author.equals(secondBook.author);
    }
}

Example 160. Book XML Schema

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema
targetNamespace="http://wso2.com/wsdl/example/processing/serialization/library/book"
    xmlns:tns="http://wso2.com/wsdl/example/processing/serialization/library/book" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <!--
      Example of instance:
      <book>
        <name>Robinson Crusoe</name>
        <author>Daniel Defoe</author>
      </book>
    -->
    <xsd:complexType name="Book">
        <xsd:sequence>
            <xsd:element name="name" type="xsd:string"/>
            <xsd:element name="author" type="xsd:string"/>
        </xsd:sequence>
    </xsd:complexType>
</xsd:schema>

Example 161. Book Service Serializer

package example.processing.serialization.library.serializer;


// Helps with common serialization problems
import com.idoox.wasp.serialization.SerializationHelper;

// This class is serialized
import example.processing.serialization.library.Book;

import org.idoox.config.Configurable;

import org.idoox.wasp.serialization.SerializationChain;
import org.idoox.wasp.serialization.SerializationContext;
import org.idoox.wasp.serialization.XMLSerializer;

import org.idoox.xml.TokenWriter;

import org.idoox.xmlrpc.MessageCreatingException;

import javax.xml.namespace.QName;


/**
 * Serializes Book instance. For example: instance
 * new Book("Robinson Crusoe","Daniel Defoe").
 * is serialized to
 *
 *    <book>
 *      <name>Robinson Crusoe</name>
 *      <author>Daniel Defoe</author>
 *    </book>
 *
 */
public class BookSerializer implements XMLSerializer {
    //Default constructor will be generated for this class by Java compiler
    public void init(Configurable configurable) {
        // nothing to do, this serializer has no configuration
    }

    public String getMechanismType() {
        // this always has to be MECHANISM_TYPE,
        // needed for serialization framework
        return MECHANISM_TYPE;
    }

    /**
     * Serialization method.
     * @param tokenWriter: the writer to which the object is serialized
     * @param o: the data being serialized
     * @param serializationContext: a schema context, drives the
     *    serialization process
     * @param serializationChain: a serialization chain, holds other
     *    possible serializers
     * @throws MessageCreatingException if something goes wrong
     */
    public void serialize(
        TokenWriter tokenWriter,
        Object o,
        SerializationContext serializationContext,
        SerializationChain serializationChain) throws MessageCreatingException {
        try {
            // we know that 'o' is non-null and it is a 'Book' type,
            // because we configure this serializer based upon the
            // BasicConstruct serializer, which handles null values
            // properly
            Book book = (Book) o;

            // get information about construct in XML
            QName schemaTypeName =
                serializationContext.getCurrentConstructSchemaType()
                                    .getName();
            QName memberName = serializationContext.getCurrentConstructName();

            // write start of a 'Book' structure
            tokenWriter.enter(
                memberName.getNamespaceURI(),
                memberName.getLocalPart());
            SerializationHelper.writeXsiType(tokenWriter, schemaTypeName);

            // enter a 'Book' construct in XML Schema
            SerializationContext.State state;
            state = serializationContext.enterCurrentMember();
            serializationContext.nextSchemaConstruct();

            // serialize member 'String name'
            SerializationHelper.serialize(tokenWriter, book.name,
                serializationContext);

            // serialize member 'String author'
            SerializationHelper.serialize(tokenWriter, book.author,
                serializationContext);

            // leave 'Book' construct in XML Schema
            serializationContext.leave(state);

            // write end of 'Book' structure
            tokenWriter.leave();
        } catch (MessageCreatingException e) {
            e;
        } catch (Exception e) {
            throw new MessageCreatingException("Failed while serializing Book",
                e);
        }
    }

    public void grabReferences(
        Object o,
        SerializationContext serializationContext,
        SerializationChain serializationChain) throws MessageCreatingException {
        // in literal (XMLSerializer interface) this does not matter,
        // this method is intended for encoded serialization
    }
}

Example 162. Deserializer for Book Instances

package example.processing.serialization.library.deserializer;

import org.idoox.wasp.serialization.XMLDeserializer;
import org.idoox.wasp.serialization.DeserializationContext;
import org.idoox.wasp.serialization.DeserializationChain;
import org.idoox.xml.Tokenizer;
import org.idoox.xml.Token;
import org.idoox.xmlrpc.MessageProcessingException;
import org.idoox.config.Configurable;

// Book objects are deserialized
import example.processing.serialization.library.Book;

// Helps with common serialization problems
import com.idoox.wasp.serialization.SerializationHelper;

/**
 * Deserializes XML structure to Book instance.
 * For example: input
 *
 *    <book>
 *      <name>Robinson Crusoe</name>
 *      <author>Daniel Defoe</author>
 *    </book>
 *
 * id deserialized class ten equals to
 * new Book("Robinson Crusoe","Daniel Defoe").
 */

public class BookDeserializer implements XMLDeserializer {
//Default constructor will be generated for this class by Java compiler
    public void init(Configurable configurable) {
        // nothing to do, this deserializer has no configuration
    }

    public String getMechanismType() {
        // this have to be always MECHANISM_TYPE,
        // needed for serialization framework
        return MECHANISM_TYPE;
    }

    public Object deserialize(Tokenizer tokenizer,
                              Token token,
                              Class targetClass,
                              DeserializationContext deserializationContext,
                              DeserializationChain deserializationChain)
            throws MessageProcessingException {
        try {
            // skip start of a 'Book' structure
            SerializationHelper.nextNonWhitespace(tokenizer);
            // enter a 'Book' construct in XML Schema
            DeserializationContext.State state;
            state = deserializationContext.enterCurrentMember();
            deserializationContext.nextSchemaConstruct();
            // deserialize member 'String name'
            String name = (String) SerializationHelper.deserialize(tokenizer,
                    token, String.class, deserializationContext);
            // go to next XML element
            SerializationHelper.nextNonWhitespace(tokenizer);
            // deserialize member 'String author'
            String author = (String) SerializationHelper.deserialize(tokenizer,
                    token, String.class, deserializationContext);
            // go to next XML element
             SerializationHelper.nextNonWhitespace(tokenizer);
            //  leave 'Book' construct in XML Schema
            deserializationContext.leave(state);
            // return deserialized object
            return new Book(name, author);
        } catch (MessageCreatingException e) {
            throw e;
        }  catch (Exception e) {
            throw new MessageProcessingException("Failed while deserializing Book", e);
        }
    }
}

Example 163. Deployment Descriptor for Configuration of Book Serialization

<?xml version="1.0" encoding="UTF-8"?>
<package client-package="true" name="BookSerializers"
    targetNamespace="http://wso2.com/example/library/book" version="1.0"
    xmlns="http://wso2.com/wasp/package/1.1"
    xmlns:book=
      "http://wso2.com/wsdl/example/processing/serialization/library/book"
    xmlns:tns="http://wso2.com/example/library/book" 
    xmlns:wasp="http://wso2.com/wasp/app/builtin_serialization">
    <dependency ref="wasp:builtin_serialization" version="1.0"/>
    <processing name="BookProcessing">
        <use ref="wasp:XmlSerialization"/>
        <schema location="Book.xsd" 
          namespaceURI=
            "http://wso2.com/wsdl/example/processing/serialization/library/book"/>
        <type-mapping name="BookMapping">
            <type maps-to="example.processing.serialization.library.Book" 
              name="book:Book"/>
        </type-mapping>
        <serialization
            deserializer-class=
               "example.processing.serialization.library.deserializer.BookDeserializer"
            following-parts="wasp:XMLReflectionSerializer"
            name="BookSerizalization"
            preceding-parts="wasp:XMLBasicConstructSerializer"
            serialized-type="book:Book" 
            serializer-class=
              "example.processing.serialization.library.serializer.BookSerializer"/>
    </processing>
    <export push="true">
        <use ref="tns:BookProcessing"/>
    </export>
</package>