/*Copyright (c) 2007, Dennis M. SosnoskiAll rights reserved.Redistribution and use in source and binary forms, with or without modification,are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this   list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice,   this list of conditions and the following disclaimer in the documentation   and/or other materials provided with the distribution. * Neither the name of JiBX nor the names of its contributors may be used   to endorse or promote products derived from this software without specific   prior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FORANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.*/package org.jibx.ws.wsdl;import java.util.Collection;import java.util.List;import org.jibx.binding.classes.ClassItem;import org.jibx.binding.generator.ClassCustom;import org.jibx.binding.generator.CustomBase;import org.jibx.runtime.IUnmarshallingContext;import org.jibx.runtime.JiBXException;import org.jibx.runtime.impl.UnmarshallingContext;/** * Method parameter or return value customization information. */public class ValueCustom extends CustomBase{    // value customization information    private boolean m_primitive;    // internal use, not included in binding    private String m_boundType; // internal use, not included in binding    private String m_valueName;    private String m_elementName;    private String m_type;    private String m_createType;    private String m_factoryMethod;    private Boolean m_required;    private List m_documentation;        /**     * Constructor.     *      * @param parent     * @param name     */    protected ValueCustom(NestingBase parent, String name) {        super(parent);        m_valueName = name;    }        /**     * Get value name.     *     * @return name     */    public String getValueName() {        return m_valueName;    }        /**     * Get XML element name.     *     * @return name     */    public String getElementName() {        return m_elementName;    }        /**     * Set XML element name.     *     * @param name     */    public void setElementName(String name) {        m_elementName = name;    }    /**     * Get value type. This method should only be used after the {@link     * #complete(String, List, Boolean)} method is called.     *     * @return value type     */    public String getType() {        return m_type;    }    /**     * Get item type for parameterized list collection. This base class     * implementation always returns <code>null</code>.     *     * @return <code>null</code>     */    public String getItemType() {        return null;    }        /**     * Get value type to be bound. This is the same as the plain value type     * for a simple (non-collection); for an array value, it's just the array     * item type; and for a non-array collection it takes the same form as a     * generic type declaration, with the actual item type enclosed in a     * less-than/greater-than sign pair following the base type.     *     * @return parmaterized type     */    public String getBoundType() {        return m_boundType;    }    /**     * Get name for elements representing items in collection. This base class     * implementation always returns <code>null</code>.     *     * @return <code>null</code>     */    public String getItemElementName() {        return null;    }    /**     * Get member create type.     *     * @return type used for creating new instance (<code>null</code> if none)     */    public String getCreateType() {        return m_createType;    }    /**     * Get factory method.     *     * @return method used for creating new instance (<code>null</code> if none)     */    public String getFactoryMethod() {        return m_factoryMethod;    }        /**     * Check if value is required.     *     * @return <code>true</code> if required, <code>false</code> if not     */    public boolean isRequired() {        if (m_required == null) {            if (m_primitive) {                return getParent().isPrimitiveRequired(m_type);            } else {                return getParent().isObjectRequired(m_type);            }        } else {            return m_required.booleanValue();        }    }        /**     * Get value documentation node list. This method should only be used after     * the {@link #complete(String, List, Boolean)} method is called.     *     * @return list of documentation nodes (<code>null</code> if none)     */    public List getDocumentation() {        return m_documentation;    }    /**     * Complete customization information based on supplied type. If the type     * information has not previously been set, this will set it. It will also     * derive the appropriate XML name, if not previously set.     *     * @param type (<code>null</code> if none available)     * @param docs default documentation text (<code>null</code> if none)     * @param req required member flag (<code>null</code> if unknown)     */    /*package*/ void complete(String type, List docs, Boolean req) {        if (m_type == null) {            if (type == null) {                m_type = "java.lang.Object";            } else {                m_type = type;            }        }        m_primitive = ClassItem.isPrimitive(m_type);        // TODO: check consistency of setting        if (m_required == null) {            m_required = req;        }        if (m_documentation == null) {            m_documentation = docs;        }        String itype = getItemType();        if (itype == null) {            if (type.endsWith("[]")) {                m_boundType = type.substring(0, type.length()-2);            } else {                m_boundType = type;            }        } else {            m_boundType = type + '<' + itype + '>';        }        if (!m_primitive && m_createType == null && m_factoryMethod == null) {            ClassCustom cust = getGlobal().getClassCustomization(type);            if (cust != null) {                m_createType = cust.getCreateType();                m_factoryMethod = cust.getFactoryMethod();            }        }    }        /**     * Parameter value unmarshalling factory. This gets the containing element     * and the name so that the standard constructor can be used.     *     * @param ictx     * @return created instance     * @throws JiBXException     */    private static ValueCustom parameterFactory(IUnmarshallingContext ictx)        throws JiBXException {        UnmarshallingContext uctx = (UnmarshallingContext)ictx;        Object parent = uctx.getStackTop();        int depth = 0;        if (parent instanceof Collection) {            parent = uctx.getStackObject(++depth);        }        return new ValueCustom((OperationCustom)parent,            uctx.attributeText(null, "name"));    }        /**     * Return value unmarshalling factory. This gets the containing element     * so that the standard constructor can be used.     *     * @param ictx     * @return created instance     */    private static ValueCustom returnFactory(IUnmarshallingContext ictx) {        Object parent = ictx.getStackTop();        int depth = 0;        if (parent instanceof Collection) {            parent = ictx.getStackObject(++depth);        }        return new ValueCustom((OperationCustom)parent, "return");    }        /**     * Parameter value unmarshalling factory. This gets the containing element     * and the name so that the standard constructor can be used.     *     * @param ictx     * @return created instance     * @throws JiBXException     */    private static CollectionValueCustom        collectionParameterFactory(IUnmarshallingContext ictx)        throws JiBXException {        UnmarshallingContext uctx = (UnmarshallingContext)ictx;        Object parent = uctx.getStackTop();        int depth = 0;        if (parent instanceof Collection) {            parent = uctx.getStackObject(++depth);        }        return new CollectionValueCustom((OperationCustom)parent,            uctx.attributeText(null, "name"));    }        /**     * Return value unmarshalling factory. This gets the containing element     * so that the standard constructor can be used.     *     * @param ictx     * @return created instance     */    private static CollectionValueCustom        collectionReturnFactory(IUnmarshallingContext ictx) {        Object parent = ictx.getStackTop();        int depth = 0;        if (parent instanceof Collection) {            parent = ictx.getStackObject(++depth);        }        return new CollectionValueCustom((OperationCustom)parent, "return");    }}