Skip navigation links

Oracle® Coherence Java API Reference
v3.5.1

E15583-01


com.tangosol.run.xml
Class MapAdapter

java.lang.Object
  extended by com.tangosol.util.Base
      extended by com.tangosol.util.BitHelper
          extended by com.tangosol.util.ExternalizableHelper
              extended by com.tangosol.run.xml.PropertyAdapter
                  extended by com.tangosol.run.xml.IterableAdapter
                      extended by com.tangosol.run.xml.MapAdapter

All Implemented Interfaces:
java.io.Serializable

public class MapAdapter
extends IterableAdapter

A MapAdapter supports properties whose types implement the java.util.Map interface.


 <property>
   <name>People</name>
   <xml-name>people</xml-name>         <!-- defaults to <name> -->
   <type>java.util.Map</type>          <!-- defaults via reflection -->
   <class>java.util.HashMap</class>    <!-- defaults to <type> -->
   <empty-is-null>true</empty-is-null> <!-- defaults to false -->
   <element>
     <xml-name>person</xml-name>       <!-- required -->
     <key>
       <name>ssn</name>                <!-- defaults to "key" -->
       <xml-name>ssn</xml-name>        <!-- defaults to <name> -->
       <type>String</type>             <!-- required -->
       <adapter>...</adapter>          <!-- optional -->
       <...>                           <!-- for the type-specific adapter -->
     </key>
     <value>
       <name>info</name>               <!-- defaults to "value" -->
       <xml-name>info</xml-name>       <!-- defaults to <name> -->
       <type>com...PersonBean</type>   <!-- required -->
       <adapter>...</adapter>          <!-- optional -->
       <...>                           <!-- for the type-specific adapter -->
     </value>
   </elelemt>  
 </property>

 Example of map nested within collection tags:

   <doc>
     <people>
       <person>
         <ssn>...</ssn>
         <info>...</info>
       </person>
       <person>
         <ssn>...</ssn>
         <info>...</info>
       </person>
       ...
     </people>
   </doc>
 
Version:
1.00 2001.03.18
Author:
cp

Field Summary

 

Fields inherited from class com.tangosol.run.xml.IterableAdapter
m_fEmptyIsNull, m_fSparse, m_sElement

 

Fields inherited from class com.tangosol.run.xml.PropertyAdapter
m_clzType, m_fAttribute, m_infoBean, m_methodClone, m_methodGet, m_methodSet, m_sName, m_sNmsPrefix, m_sNmsUri, m_sXml, NOPARAMS

 

Constructor Summary
MapAdapter(XmlBean.BeanInfo infoBean, java.lang.Class clzType, java.lang.String sName, java.lang.String sXml, XmlElement xml)
          Construct a MapAdapter.

 

Method Summary
 java.lang.Object clone(java.lang.Object o)
          Make a clone of the passed object.
 PropertyAdapter getKeyAdapter()
           
 PropertyAdapter getValueAdapter()
           
protected  java.util.Map instantiateMap()
           
 boolean isEmpty(java.lang.Object o)
          Determine if the specified value is empty.
protected  java.lang.Object readElements(XmlElement xml)
           
 java.lang.Object readExternal(java.io.DataInput in)
          Read a value from the passed DataInput object.
protected  void writeElements(XmlElement xml, java.lang.Object o)
           
 void writeExternal(java.io.DataOutput out, java.lang.Object o)
          Write the specified data to the passed DataOutput object.

 

Methods inherited from class com.tangosol.run.xml.IterableAdapter
findAdapter, fromXml, getElementName, isCloneRequired, isEmptyIsNull, isNested, isSparse, toXml

 

Methods inherited from class com.tangosol.run.xml.PropertyAdapter
equalsValue, findAttribute, findElement, fromUri, get, getAccessor, getBeanInfo, getCloner, getElements, getLocalXmlName, getMutator, getName, getNamespacePrefix, getNamespaceUri, getType, getXmlName, hash, isAnonymous, isAttribute, isElementMatch, readXml, set, setNamespacePrefix, toString, toUri, writeXml

 

Methods inherited from class com.tangosol.util.BitHelper
countBits, countBits, countBits, indexOfLSB, indexOfLSB, indexOfLSB, indexOfMSB, indexOfMSB, indexOfMSB, rotateLeft, rotateLeft, rotateLeft, rotateRight, rotateRight, rotateRight, toBitString, toBitString, toBitString

 

Constructor Detail

MapAdapter

public MapAdapter(XmlBean.BeanInfo infoBean,
                  java.lang.Class clzType,
                  java.lang.String sName,
                  java.lang.String sXml,
                  XmlElement xml)
Construct a MapAdapter.
Parameters:
infoBean - BeanInfo for a bean containing this property
clzType - the type of the property
sName - the property name
sXml - the XML tag name
xml - additional XML information

Method Detail

clone

public java.lang.Object clone(java.lang.Object o)
Make a clone of the passed object.
Overrides:
clone in class PropertyAdapter
Parameters:
o - the object to clone
Returns:
a clone of the passed object

readElements

protected java.lang.Object readElements(XmlElement xml)
Specified by:
readElements in class IterableAdapter
Parameters:
xml - the XML element containing the XML elements to deserialize from
Returns:
the object deserialized from the XML (not null)

writeElements

protected void writeElements(XmlElement xml,
                             java.lang.Object o)
Specified by:
writeElements in class IterableAdapter
Parameters:
xml - the XML element to which the iterable elements are written
o - the object to serialize (not null)

readExternal

public java.lang.Object readExternal(java.io.DataInput in)
                              throws java.io.IOException
Read a value from the passed DataInput object.
Overrides:
readExternal in class PropertyAdapter
Parameters:
in - the DataInput stream to read property data from
Returns:
the data read from the DataInput; never null
Throws:
java.io.IOException - if an I/O exception occurs

writeExternal

public void writeExternal(java.io.DataOutput out,
                          java.lang.Object o)
                   throws java.io.IOException
Write the specified data to the passed DataOutput object.
Overrides:
writeExternal in class PropertyAdapter
Parameters:
out - the DataOutput stream to write to
o - the data to write to the DataOutput; never null
Throws:
java.io.IOException - if an I/O exception occurs

isEmpty

public boolean isEmpty(java.lang.Object o)
Determine if the specified value is empty.
Overrides:
isEmpty in class PropertyAdapter
Parameters:
o - the value
Returns:
true if the object is considered to be empty for persistence and XML-generation purposes

getKeyAdapter

public PropertyAdapter getKeyAdapter()
Returns:
a PropertyAdapter for map entry keys

getValueAdapter

public PropertyAdapter getValueAdapter()
Returns:
a PropertyAdapter for map entry values

instantiateMap

protected java.util.Map instantiateMap()
Returns:
a new Map instance

Skip navigation links

Oracle® Coherence Java API Reference
v3.5.1

E15583-01


Copyright © 2000, 2009, Oracle. All rights reserved.