org.planx.xmlstore.stores
Class WriteCacheXMLStore

java.lang.Object
  org.planx.xmlstore.stores.AbstractXMLStore
      org.planx.xmlstore.stores.WriteCacheXMLStore

All Implemented Interfaces:

XMLStore

public class WriteCacheXMLStore
extends AbstractXMLStore

Author:

Kasper Bøgebjerg, Henning Niss

Field Summary

Fields inherited from class org.planx.xmlstore.stores.AbstractXMLStore

xmlstore

Constructor Summary

WriteCacheXMLStore(XMLStore xmlstore)

Method Summary

void	close() The method is used to let the XMLStore properly commit all data to the underlying ressource, release resources, and so forth.
Node	load(Reference vref) Resolves any RelativeReferences and calls AbstractXMLStore.resolvedLoad(org.planx.xmlstore.Reference).
Reference	save(Node n) Saves the XML data represented by the specified Node.

Methods inherited from class org.planx.xmlstore.stores.AbstractXMLStore

checkClosed, resolvedLoad, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

WriteCacheXMLStore

public WriteCacheXMLStore(XMLStore xmlstore)

Method Detail

save

public Reference save(Node n)
               throws IOException

Description copied from interface: XMLStore

Saves the XML data represented by the specified Node. The method returns a unique location independent reference, which can be used to load the node, when needed.

Specified by:

save in interface XMLStore

Overrides:

save in class AbstractXMLStore

Parameters:

n - representing XML data in the form of semi-structured tree data

Returns:

a reference to the saved node/tree

Throws:

IOException - if an error occurs during disk, network, etc access

load

public Node load(Reference vref)
          throws IOException,
                 UnknownReferenceException

Description copied from class: AbstractXMLStore

Resolves any RelativeReferences and calls AbstractXMLStore.resolvedLoad(org.planx.xmlstore.Reference).

Specified by:

load in interface XMLStore

Overrides:

load in class AbstractXMLStore

Parameters:

vref - the Reference to the data

Returns:

node representing the loaded XML data

Throws:

IOException - if an error occurs during disk, network, etc access

UnknownReferenceException - if the data referenced is not stored in the XMLStore or the Reference is of a type not supported by the XMLStore

close

public void close()
           throws IOException

Description copied from interface: XMLStore

The method is used to let the XMLStore properly commit all data to the underlying ressource, release resources, and so forth. Once close has been issued on an XMLStore, the store is no longer available for handling requests. Any subsequent request to the store will result in an exception being thrown. An XMLStore implementation has to ensure that this happens.

Specified by:

close in interface XMLStore

Overrides:

close in class AbstractXMLStore

Throws:

IOException - if it is not possible to properly close the store