com.tangosol.run.xml.QNameAdapter Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of coherence Show documentation
Oracle Coherence Community Edition
There is a newer version: 24.09
/*
 * Copyright (c) 2000, 2020, Oracle and/or its affiliates.
 *
 * Licensed under the Universal Permissive License v 1.0 as shown at
 * http://oss.oracle.com/licenses/upl.
 */

package com.tangosol.run.xml;


import com.tangosol.util.LiteMap;

import java.util.Iterator;
import java.util.Map;

/**
* A property adapter for
* QName
* primitive datatype.
* * <adapter>com.tangosol.run.xml.QNameAdapter</adapter>
* <value-space>
*   <xmlns>
*     <uri>Uri-1</uri>
*     <prefix>prefix-1</prefix>
*   </xmlns>
*   <xmlns>
*     <uri>Uri-2</uri>
*     <prefix>prefix-2</prefix>
*   </xmlns>
*   ...
* </value-space>
* 
* @see 
*       XML Schema Part 2: Datatypes
* @version 1.00  2002.07.02
* @author gg
*/
public class QNameAdapter
        extends SimpleAdapter.StringAdapter
    {
    // ----- constructors ---------------------------------------------------

    /**
    * Construct a QNameAdapter.
    *
    * @param infoBean BeanInfo for a bean containing this property
    * @param clzType  the type of the property
    * @param sName    the property name
    * @param sXml     the XML tag name
    * @param xml      additional XML information
    */
    public QNameAdapter(XmlBean.BeanInfo infoBean, Class clzType, String sName, String sXml, XmlElement xml)
        {
        super(infoBean, clzType, sName, sXml, xml);

        XmlElement xmlVS = xml.getElement("value-space");
        if (xmlVS != null)
            {
            Map mapNms = m_mapNms;
            for (Iterator iter = xmlVS.getElements("xmlns"); iter.hasNext();)
                {
                XmlElement xmlNms = (XmlElement) iter.next();

                String sNmsPrefix = xmlNms.getSafeElement("prefix").getString(null);
                String sNmsUri    = xmlNms.getSafeElement("uri")   .getString(null);

                mapNms.put(sNmsPrefix, sNmsUri);
                }
            }
        }


    // ----- XmlSerializable helpers ----------------------------------------

    /**
    * Deserialize an object from an XML element.
    *
    * @param xml  the XML element to deserialize from
    *
    * @return the object deserialized from the XML element
    */
    public Object fromXml(XmlElement xml)
        {
        String sValue = (String) super.fromXml(xml);
        int    of     = sValue.indexOf(':');
        if (of > 0)
            {
            String sPrefix = sValue.substring(0, of);
            String sUri    = XmlHelper.getNamespaceUri(xml, sPrefix);
            if (sUri != null)
                {
                // TODO: store the "runtime" values on the bean itself
                m_mapNms.put(sPrefix, sUri);
                }
            }
        return sValue;
        }

    /**
    * Serialize an object into an XML element.
    *
    * @param o  the object to serialize
    *
    * @return the XML element representing the serialized form of the
    *         passed object
    */
    public XmlElement toXml(Object o)
        {
        XmlElement xml = super.toXml(o);

        String sValue = xml.getString();
        int    of     = sValue.indexOf(':');
        if (of > 0)
            {
            String sPrefix = sValue.substring(0, of);
            String sUri    = (String) m_mapNms.get(sPrefix);
            if (sUri != null)
                {
                XmlHelper.ensureNamespace(xml, sPrefix, sUri);
                }
            }
        return xml;
        }


    // ----- validation helpers ---------------------------------------------

    /**
    * Specifies whether or not the specified QName value is associated with a
    * known namespace declaration.
    *
    * @param sValue  the specified QName value
    *
    * @return true is the specified QName value is associated with a known
    *         namespace declaration; false otherwise
    */
    public boolean isValidQName(String sValue)
        {
        int of = sValue.indexOf(':');
        if (of > 0)
            {
            String sPrefix = sValue.substring(0, of);
            return m_mapNms.containsKey(sPrefix);
            }
        return true;
        }


    // ----- data fields ----------------------------------------------------

    /**
    * Map of valid namespaces for the property values keyed by the namespace
    * prefix with a corresponding value being the namespace URI.
    */
    private Map m_mapNms = new LiteMap();
    }