Skip navigation links

com.tangosol.run.xml
Class ArrayAdapter

java.lang.Object
com.tangosol.util.Base
com.tangosol.util.BitHelper
com.tangosol.util.ExternalizableHelper
com.tangosol.run.xml.PropertyAdapter
com.tangosol.run.xml.IterableAdapter
com.tangosol.run.xml.ArrayAdapter

All Implemented Interfaces:

Serializable

public class ArrayAdapter

extends IterableAdapter

An ArrayAdapter supports properties of Java array types (not including arrays of primitive types).

 <property>
   <name>People</name>
   <xml-name>people</xml-name>         <!-- defaults to <name> -->
   <type>com...Person[]</type>         <!-- defaults via reflection -->
   <class>com...Person[]</class>       <!-- defaults from <type> -->
   <sparse>true</sparse>               <!-- defaults to false -->
   <empty-is-null>true</empty-is-null> <!-- defaults to false -->
   <element>                           <!-- optional -->
     <xml-name>person</xml-name>       <!-- optional, nests the elements -->
     <type>com...Person</type>         <!-- auto-set from <property><class> -->
     <adapter>...</adapter>            <!-- optional -->
     <...>                             <!-- for the type-specific adapter -->
   </element>
 </property>
 

Example of collection nested within collection tags:

   <doc>
     <people>
       <person>
         <...>
       </person>
       <person>
         <...>
       </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

ArrayAdapter(XmlBean.BeanInfo infoBean, Class clzType, String sName, String sXml, XmlElement xml)
Construct a ArrayAdapter.

Method Summary

Object	clone(Object o) Make a clone of the passed object.
boolean	equalsValue(Object o1, Object o2) Compare the two passed objects for equality.
int	hash(Object o) Compute a hash code for the passed object.
boolean	isEmpty(Object o) Determine if the specified value is empty.
protected Object	readElements(XmlElement xml)
Object	readExternal(DataInput in) Read a value from the passed DataInput object.
protected void	writeElements(XmlElement xml, Object o)
void	writeExternal(DataOutput out, 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

findAttribute, findElement, fromUri, get, getAccessor, getBeanInfo, getCloner, getElements, getLocalXmlName, getMutator, getName, getNamespacePrefix, getNamespaceUri, getType, getXmlName, 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

ArrayAdapter

public ArrayAdapter(XmlBean.BeanInfo infoBean,
                    Class clzType,
                    String sName,
                    String sXml,
                    XmlElement xml)

Construct a ArrayAdapter.

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

hash

public int hash(Object o)

Compute a hash code for the passed object.

Overrides:

hash in class PropertyAdapter

Parameters:

o - the object to compute a hash code for

Returns:

an integer hash code

equalsValue

public boolean equalsValue(Object o1,
                           Object o2)

Compare the two passed objects for equality.

Overrides:

equalsValue in class PropertyAdapter

Parameters:

o1 - the first object

o2 - the second object

Returns:

true if the two objects are equal

clone

public Object clone(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 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,
                             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 Object readExternal(DataInput in)
                    throws 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:

IOException - if an I/O exception occurs

writeExternal

public void writeExternal(DataOutput out,
                          Object o)
                   throws 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:

IOException - if an I/O exception occurs

isEmpty

public boolean isEmpty(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

Skip navigation links