FreeHEP API
Version current

org.freehep.xml.io
Class XMLIOManager

java.lang.Object
  extended byorg.freehep.xml.io.XMLIOManager

public class XMLIOManager
extends Object

The XMLIOManager is in charge of saving and restoring any object configuration through XML. It internally assigns objects and unique identification string used for cross-reference among xml nodes.

Version:
1.0
Author:
turri
Source Code:
XMLIOManager.java

Constructor Summary
XMLIOManager(String fileName)
           
 
Method Summary
protected  XMLIOFactory getXMLIOFactory(Class objClass)
          Get the XMLIOFactory to restore the xml node param nodeEl the node to be restored
protected  XMLIOProxy getXMLIOProxy(Class objClass)
           
 XMLIORegistry getXMLIORegistry()
          Get the XMLIORegistry.
 XMLIOStreamManager getXMLIOStreamManager()
           
protected  void loadRefTable(org.jdom.Element el)
           
 void resetObjId()
          Reset the stored ids
 Object restore(org.jdom.Element nodeEl)
           
 Object restore(Object obj, org.jdom.Element nodeEl)
          Restore an object from an xml node.
 Object[] restoreFromXML()
          The main method to restore from xml.
 org.jdom.Element save(Object obj)
           
 org.jdom.Element saveAs(Object obj, Class clazz)
          Save an object to an XML node.
 void saveToXML(Object[] objs, org.jdom.Element nodeEl)
          The main method to save an array of objects to XML.
 void setClassId(Class clName, String id)
          Assign to a Class a string identifier.
protected  void setXMLIORegistry(XMLIORegistry xmlioRegistry)
           
 void setXMLIOStreamManager(XMLIOStreamManager xmlioStreamManager)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XMLIOManager

public XMLIOManager(String fileName)
Method Detail

setXMLIORegistry

protected void setXMLIORegistry(XMLIORegistry xmlioRegistry)

getXMLIORegistry

public XMLIORegistry getXMLIORegistry()
Get the XMLIORegistry.

Returns:
the XMLIORegistry

setXMLIOStreamManager

public void setXMLIOStreamManager(XMLIOStreamManager xmlioStreamManager)

getXMLIOStreamManager

public XMLIOStreamManager getXMLIOStreamManager()

restore

public Object restore(Object obj,
                      org.jdom.Element nodeEl)
Restore an object from an xml node.

Parameters:
nodeEl - The node containing the object's information. This method should be used by the user to restore nested objects within the restore method of an object implementing the XMLIO interface.
Returns:
The restored object. The object is first created by invoking the create method on the corresponding XMLIOFactory. Once created the restore method is invoked either on the object itself (if it implements the XMLIO interface) or on the appropriate XMLIOProxy.

restore

public Object restore(org.jdom.Element nodeEl)

saveAs

public org.jdom.Element saveAs(Object obj,
                               Class clazz)
Save an object to an XML node.

Parameters:
obj - The object to be saved.
Returns:
The jdom Element containing the object's unique identification string (in the attribute "objId") and whose name is the object's identifier. The user will have to append to this node all the attributes and other jdom elemets required to save the object's configuration.

save

public org.jdom.Element save(Object obj)

saveToXML

public void saveToXML(Object[] objs,
                      org.jdom.Element nodeEl)
The main method to save an array of objects to XML.

Parameters:
objs - The array of objects to be saved.

restoreFromXML

public Object[] restoreFromXML()
The main method to restore from xml.

Returns:
The array of the restored objects.

setClassId

public void setClassId(Class clName,
                       String id)
Assign to a Class a string identifier.

Parameters:
clName - The Class.
id - The new identifier for the class.

loadRefTable

protected void loadRefTable(org.jdom.Element el)

resetObjId

public void resetObjId()
Reset the stored ids


getXMLIOFactory

protected XMLIOFactory getXMLIOFactory(Class objClass)
Get the XMLIOFactory to restore the xml node param nodeEl the node to be restored

Returns:
the XMLIOFactory

getXMLIOProxy

protected XMLIOProxy getXMLIOProxy(Class objClass)

FreeHEP API
Version current

Copyright © 2000-2004 FreeHEP, All Rights Reserved.