hep.aida.ref.tree
Class TreeFactory

java.lang.Object
  hep.aida.ref.tree.TreeFactory

All Implemented Interfaces:

hep.aida.ITreeFactory

public class TreeFactory

extends Object

implements hep.aida.ITreeFactory

Version:

$Id: TreeFactory.java,v 1.12 2005/06/04 00:38:12 turri Exp $

Author:

The AIDA team @ SLAC.

Source Code:

TreeFactory.java

Field Summary

Fields inherited from interface hep.aida.ITreeFactory

AUTO, CREATE, READONLY, RECREATE, UPDATE

Constructor Summary

TreeFactory(hep.aida.IAnalysisFactory analysisFactory)
The default constructor.

Method Summary

hep.aida.ITree	create() Creates a new tree and associates it with a store.
hep.aida.ITree	create(String storeName) Creates a new tree and associates it with a store.
hep.aida.ITree	create(String storeName, String storeType) Creates a new tree and associates it with a store.
hep.aida.ITree	create(String storeName, String storeType, boolean readOnly) Creates a new tree and associates it with a store.
hep.aida.ITree	create(String storeName, String storeType, boolean readOnly, boolean createNew) Creates a new tree and associates it with a store.
hep.aida.ITree	create(String storeName, String storeType, boolean readOnly, boolean createNew, String options) Creates a new tree and associates it with a store.
hep.aida.ITree	createNamedTree(String name, String storeName, String storeType)
hep.aida.ITree	createNamedTree(String name, String storeName, String storeType, int mode)
hep.aida.ITree	createNamedTree(String name, String storeName, String storeType, int mode, String options)
hep.aida.ITree	createTree() Creates a new tree and associates it with a store.
hep.aida.ITree	createTree(String options)
hep.aida.ITree	createTree(String storeName, String storeType)
protected hep.aida.ITree	createTree(String storeName, String storeType, boolean readOnly, boolean createNew, String options, boolean readOnlyUserDefined)
hep.aida.ITree	createTree(String storeName, String storeType, int mode)
hep.aida.ITree	createTree(String storeName, String storeType, int mode, String options)
hep.aida.ITree	createTree(String storeName, String storeType, String options)

Methods inherited from class java.lang.Object

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

Constructor Detail

TreeFactory

public TreeFactory(hep.aida.IAnalysisFactory analysisFactory)

The default constructor.

Method Detail

create

public hep.aida.ITree create()

Creates a new tree and associates it with a store. The store is assumed to be read/write. The store will be created if it does not exist. in memory and therefore will not be associated with a file.

Specified by:

create in interface hep.aida.ITreeFactory

create

public hep.aida.ITree create(String storeName)
                      throws IllegalArgumentException,
                             IOException

Creates a new tree and associates it with a store. The store is assumed to be read/write. The store will be created if it does not exist.

Specified by:

create in interface hep.aida.ITreeFactory

Parameters:

storeName - The name of the store, if empty (""), the tree is created in memory and therefore will not be associated with a file.

Throws:

IOException - if the store already exists

IllegalArgumentException

create

public hep.aida.ITree create(String storeName,
                             String storeType)
                      throws IllegalArgumentException,
                             IOException

Creates a new tree and associates it with a store. The store is assumed to be read/write. The store will be created if it does not exist.

Specified by:

create in interface hep.aida.ITreeFactory

Parameters:

storeName - The name of the store, if empty (""), the tree is created in memory and therefore will not be associated with a file.

storeType - Implementation specific string, may control store type

Throws:

IOException - if the store already exists

IllegalArgumentException

create

public hep.aida.ITree create(String storeName,
                             String storeType,
                             boolean readOnly)
                      throws IllegalArgumentException,
                             IOException

Creates a new tree and associates it with a store. The store is assumed to be read/write. The store will be created if it does not exist.

Specified by:

create in interface hep.aida.ITreeFactory

Parameters:

storeName - The name of the store, if empty (""), the tree is created in memory and therefore will not be associated with a file.

storeType - Implementation specific string, may control store type

readOnly - If true the store is opened readonly, an exception if it does not exist

Throws:

IOException - if the store already exists

IllegalArgumentException

create

public hep.aida.ITree create(String storeName,
                             String storeType,
                             boolean readOnly,
                             boolean createNew)
                      throws IllegalArgumentException,
                             IOException

Creates a new tree and associates it with a store. The store is assumed to be read/write. The store will be created if it does not exist.

Specified by:

create in interface hep.aida.ITreeFactory

Parameters:

storeName - The name of the store, if empty (""), the tree is created in memory and therefore will not be associated with a file.

storeType - Implementation specific string, may control store type

readOnly - If true the store is opened readonly, an exception if it does not exist

createNew - If false the file must exist, if true the file will be created

Throws:

IOException - if the store already exists

IllegalArgumentException

create

public hep.aida.ITree create(String storeName,
                             String storeType,
                             boolean readOnly,
                             boolean createNew,
                             String options)
                      throws IllegalArgumentException,
                             IOException

Creates a new tree and associates it with a store. The store is assumed to be read/write. The store will be created if it does not exist.

Specified by:

create in interface hep.aida.ITreeFactory

Parameters:

storeName - The name of the store, if empty (""), the tree is created in memory and therefore will not be associated with a file.

storeType - Implementation specific string, may control store type

readOnly - If true the store is opened readonly, an exception if it does not exist

createNew - If false the file must exist, if true the file will be created

options - Other options, currently are not specified

Throws:

IOException - if the store already exists

IllegalArgumentException

createTree

public hep.aida.ITree createTree()

Creates a new tree and associates it with a store.

The definition of the various modes than can be specified are:

• AUTO default case: create of store does not exist
• CREATE: Create a new file (throws an exception if already exists)
• RECREATE: overwrite file if existing
• READONLY: open in read only mode
• UPDATE: read/write mode, overwriting modified objects.

Specified by:

createTree in interface hep.aida.ITreeFactory

Throws:

IOException - if the store already exists

IllegalArgumentException

createTree

public hep.aida.ITree createTree(String options)

Specified by:

createTree in interface hep.aida.ITreeFactory

createTree

public hep.aida.ITree createTree(String storeName,
                                 String storeType)
                          throws IllegalArgumentException,
                                 IOException

Specified by:

createTree in interface hep.aida.ITreeFactory

Throws:

IllegalArgumentException

IOException

createTree

public hep.aida.ITree createTree(String storeName,
                                 String storeType,
                                 String options)
                          throws IllegalArgumentException,
                                 IOException

Throws:

IllegalArgumentException

IOException

createTree

public hep.aida.ITree createTree(String storeName,
                                 String storeType,
                                 int mode)
                          throws IllegalArgumentException,
                                 IOException

Specified by:

createTree in interface hep.aida.ITreeFactory

Throws:

IllegalArgumentException

IOException

createTree

public hep.aida.ITree createTree(String storeName,
                                 String storeType,
                                 int mode,
                                 String options)
                          throws IllegalArgumentException,
                                 IOException

Specified by:

createTree in interface hep.aida.ITreeFactory

Throws:

IllegalArgumentException

IOException

createNamedTree

public hep.aida.ITree createNamedTree(String name,
                                      String storeName,
                                      String storeType)
                               throws IllegalArgumentException,
                                      IOException

Specified by:

createNamedTree in interface hep.aida.ITreeFactory

Throws:

IllegalArgumentException

IOException

createNamedTree

public hep.aida.ITree createNamedTree(String name,
                                      String storeName,
                                      String storeType,
                                      int mode)
                               throws IllegalArgumentException,
                                      IOException

Specified by:

createNamedTree in interface hep.aida.ITreeFactory

Throws:

IllegalArgumentException

IOException

createNamedTree

public hep.aida.ITree createNamedTree(String name,
                                      String storeName,
                                      String storeType,
                                      int mode,
                                      String options)
                               throws IllegalArgumentException,
                                      IOException

Specified by:

createNamedTree in interface hep.aida.ITreeFactory

Throws:

IllegalArgumentException

IOException

createTree

protected hep.aida.ITree createTree(String storeName,
                                    String storeType,
                                    boolean readOnly,
                                    boolean createNew,
                                    String options,
                                    boolean readOnlyUserDefined)
                             throws IllegalArgumentException,
                                    IOException

Throws:

IllegalArgumentException

IOException