hep.aida.dev
Interface IStore

All Known Subinterfaces:

IDevMutableStore, IMutableStore, IOnDemandStore

All Known Implementing Classes:

AidaXMLStore, BasicMutableStore, RemoteMutableStore

public interface IStore

An interface to be implemented by AIDA compatible Store. Store is a Proxy that presents data from some resource to a Tree. Store can be associated with only one Tree during its lifetime. This is an interface to a basic Store that can provide data in one piece only, like XML file.

Version:

$Id: IStore.java,v 1.1 2003/05/06 00:37:35 serbo Exp $

Author:

tonyj

Source Code:

IStore.java

Method Summary

void	close() Close Store and free all resources associated with it.
void	commit(IDevTree tree, Map options) Copy data from Tree to the Store.
boolean	isReadOnly() Returns true if the store only supports reading.
void	read(IDevTree tree, Map options, boolean readOnly, boolean createNew) Populate AIDA Tree: create appropriate AIDA objects in the Tree and fill them with data from the Store.

Method Detail

isReadOnly

public boolean isReadOnly()

Returns true if the store only supports reading. If true, user can not change information in the Store and "commit()" method throws IOException if called.

read

public void read(IDevTree tree,
                 Map options,
                 boolean readOnly,
                 boolean createNew)
          throws IOException

Populate AIDA Tree: create appropriate AIDA objects in the Tree and fill them with data from the Store. This method is called only once, during Tree-Store association, to populate the Tree. Tree relies on IStore calling IDevTree.hasBeenFilled(String path) method, to let Tree know that a particular folder has been filled.

Throws:

IOException - If there are problems reading from the Store

commit

public void commit(IDevTree tree,
                   Map options)
            throws IOException

Copy data from Tree to the Store.

Throws:

IOException - If there are problems writing to the Store or the Store is Read-Only.

close

public void close()
           throws IOException

Close Store and free all resources associated with it. Should be called from ITree.close() method only. After the Store is closed, the Tree associated with it becomes unusable.

Throws:

IOException