org.apache.cayenne.xml
Class XMLEncoder

java.lang.Object
  extended by org.apache.cayenne.xml.XMLEncoder

public class XMLEncoder
extends java.lang.Object

A helper class to encode objects to XML.

Since:
1.2
Author:
Kevin J. Menard, Jr., Andrus Adamchik

Constructor Summary
XMLEncoder()
          Creates new XMLEncoder.
XMLEncoder(java.lang.String mappingUrl)
          Creates new XMLEncoder that will use a mapping descriptor loaded via provided URL.
 
Method Summary
 java.lang.String encode(java.lang.Object object)
          Encodes an object using "root" as a root tag.
 java.lang.String encode(java.lang.String rootTag, java.lang.Object object)
          Encodes using provided root XML tag.
 void encodeProperty(java.lang.String xmlTag, java.lang.Object value)
          A callback method for XMLSerializable objects to encode an object property.
 void setRoot(java.lang.String xmlTag, java.lang.String type)
          A callback for XMLSerializable objects to add a node to an encoding tree.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XMLEncoder

public XMLEncoder()
Creates new XMLEncoder.


XMLEncoder

public XMLEncoder(java.lang.String mappingUrl)
Creates new XMLEncoder that will use a mapping descriptor loaded via provided URL.

Method Detail

setRoot

public void setRoot(java.lang.String xmlTag,
                    java.lang.String type)
A callback for XMLSerializable objects to add a node to an encoding tree.


encodeProperty

public void encodeProperty(java.lang.String xmlTag,
                           java.lang.Object value)
A callback method for XMLSerializable objects to encode an object property. Note that the object must call "setRoot" prior to encoding its properties.

Parameters:
xmlTag - The name of the XML element used to represent the property.
value - The object's property value to encode.

encode

public java.lang.String encode(java.lang.Object object)
                        throws CayenneRuntimeException
Encodes an object using "root" as a root tag.

Throws:
CayenneRuntimeException

encode

public java.lang.String encode(java.lang.String rootTag,
                               java.lang.Object object)
                        throws CayenneRuntimeException
Encodes using provided root XML tag.

Throws:
CayenneRuntimeException


Copyright © 2001-2006 Apache.org All Rights Reserved.