com.tangosol.run.xml
Class PrimitiveArrayAdapter

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.PrimitiveArrayAdapter

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

PrimitiveArrayAdapter.BooleanArrayAdapter, PrimitiveArrayAdapter.ByteArrayAdapter, PrimitiveArrayAdapter.CharArrayAdapter, PrimitiveArrayAdapter.DoubleArrayAdapter, PrimitiveArrayAdapter.FloatArrayAdapter, PrimitiveArrayAdapter.IntArrayAdapter, PrimitiveArrayAdapter.LongArrayAdapter, PrimitiveArrayAdapter.ShortArrayAdapter

public abstract class PrimitiveArrayAdapter
extends IterableAdapter

A PrimitiveArrayAdapter supports arrays of primitive types, such as "int", "char", etc.

Version:

1.00 2001.03.06

Author:

cp

Nested Class Summary

static class	PrimitiveArrayAdapter.BooleanArrayAdapter A PropertyAdapter supporting boolean[].
static class	PrimitiveArrayAdapter.ByteArrayAdapter A PropertyAdapter supporting byte[].
static class	PrimitiveArrayAdapter.CharArrayAdapter A PropertyAdapter supporting char[].
static class	PrimitiveArrayAdapter.DoubleArrayAdapter A PropertyAdapter supporting double[].
static class	PrimitiveArrayAdapter.FloatArrayAdapter A PropertyAdapter supporting float[].
static class	PrimitiveArrayAdapter.IntArrayAdapter A PropertyAdapter supporting int[].
static class	PrimitiveArrayAdapter.LongArrayAdapter A PropertyAdapter supporting long[].
static class	PrimitiveArrayAdapter.ShortArrayAdapter A PropertyAdapter supporting short[].

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

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

Method Summary

abstract Object	clone(Object o) Make a clone of the passed object.
abstract boolean	equalsValue(Object o1, Object o2) Compare the two passed objects for equality.
Object	fromXml(XmlElement xml) Deserialize an object from an XML element.
Object	fromXmlString(XmlElement xml) Deserialize a primitive array from a single XML element.
abstract int	hash(Object o) Compute a hash code for the passed object.
boolean	isStringable()
abstract Object	readArray(Iterator iter, XmlElement xml, boolean fNested) Read an array of primitive values.
protected Object	readElements(XmlElement xml)
abstract Object	readSparseArray(Iterator iter, int c) Read a sparse array of primitive values.
Object	readXml(XmlElement xml) Deserialize an object from XML.
XmlElement	toXml(Object o) Serialize an object into an XML element.
XmlElement	toXmlString(Object o) Serialize a primitive array into a single XML element.
abstract void	writeArray(XmlElement xml, Object o, String sElement) Write a sparse array of primitive values.
protected void	writeElements(XmlElement xml, Object o)
abstract void	writeSparseArray(XmlElement xml, Object o, String sElement) Write a sparse array of primitive values.
void	writeXml(XmlElement xml, Object o) Serialize an object into an XML element.

Methods inherited from class com.tangosol.run.xml.IterableAdapter

findAdapter, getElementName, isCloneRequired, isEmptyIsNull, isNested, isSparse

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, isEmpty, readExternal, set, setNamespacePrefix, toString, toUri, writeExternal

Methods inherited from class com.tangosol.util.BitHelper

countBits, countBits, countBits, indexOfLSB, indexOfLSB, indexOfLSB, indexOfMSB, indexOfMSB, indexOfMSB, toBitString, toBitString, toBitString

Constructor Detail

PrimitiveArrayAdapter

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

Construct a PrimitiveArrayAdapter.

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

isStringable

public boolean isStringable()

Returns:

true if the adapter can format the array of primitive values to/from a single value (e.g. char[], byte[])

hash

public abstract 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 abstract 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 abstract 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

fromXml

public Object fromXml(XmlElement xml)

Deserialize an object from an XML element.

Overrides:

fromXml in class IterableAdapter

Parameters:

xml - the XML element to deserialize from

Returns:

the object deserialized from the XML element

Throws:

UnsupportedOperationException - if the property cannot be read from a single XML element

toXml

public XmlElement toXml(Object o)

Serialize an object into an XML element.

Overrides:

toXml in class IterableAdapter

Parameters:

o - the object to serialize

Returns:

the XML element representing the serialized form of the passed object

Throws:

UnsupportedOperationException - if the property cannot be written to a single XML element

readXml

public Object readXml(XmlElement xml)

Deserialize an object from XML. Note that the parent element is the one passed to this method; this method is responsible for finding all of the necessarily elements within the parent element. This method is intended to allow collection properties to read their data from multiple XML elements.

Overrides:

readXml in class PropertyAdapter

Parameters:

xml - the XML element containing the XML elements to deserialize from

Returns:

the object deserialized from the XML (may be null)

writeXml

public void writeXml(XmlElement xml,
                     Object o)

Serialize an object into an XML element. Note that the parent element is the one passed to this method; this method is responsible for creating the necessarily elements within the parent element. This method is intended to allow collection properties to write their data to multiple XML elements.

Overrides:

writeXml in class PropertyAdapter

Parameters:

xml - the XML element containing the XML elements to serialize to

o - the object to serialize (may be null)

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)

fromXmlString

public Object fromXmlString(XmlElement xml)

Deserialize a primitive array from a single XML element.

Parameters:

xml - the XML element to deserialize from (not null)

Returns:

the object deserialized from the XML element

Throws:

UnsupportedOperationException - if the property cannot be read from a single XML element

toXmlString

public XmlElement toXmlString(Object o)

Serialize a primitive array into a single XML element.

Parameters:

o - the object to serialize (not null)

Returns:

the XML element representing the serialized form of the passed object

Throws:

UnsupportedOperationException - if the property cannot be written to a single XML element

readSparseArray

public abstract Object readSparseArray(Iterator iter,
                                       int c)

Read a sparse array of primitive values.

Parameters:

iter - the iterator of XmlElement objects

c - the size of the array

Returns:

an array of primitive values

readArray

public abstract Object readArray(Iterator iter,
                                 XmlElement xml,
                                 boolean fNested)

Read an array of primitive values.

Parameters:

iter - the iterator of XmlElement objects

xml - the XmlElement from which the iterator was obtained

fNested - true if the array is nested under an array tag

Returns:

an array of primitive values

writeSparseArray

public abstract void writeSparseArray(XmlElement xml,
                                      Object o,
                                      String sElement)

Write a sparse array of primitive values.

Parameters:

xml - the XmlElement that will contain the array

o - the primitive array

sElement - the name of the element containing an element value

writeArray

public abstract void writeArray(XmlElement xml,
                                Object o,
                                String sElement)

Write a sparse array of primitive values.

Parameters:

xml - the XmlElement that will contain the array elements

o - the primitive array

sElement - the name of the element containing an element value