net.aerith.misao.database
Class CatalogTreeManager

java.lang.Object
  |
  +--net.aerith.misao.util.OperationObservable
        |
        +--net.aerith.misao.database.CatalogTreeManager
Direct Known Subclasses:
CatalogDBManager, MagnitudeDBManager

public abstract class CatalogTreeManager
extends OperationObservable

The CatalogTreeManager is an interface to the catalog tree.


Field Summary
static int EXCLUDE_SUBFOLDERS
          The method number which indicates to exclude the sub folders.
static int INCLUDE_SUBFOLDERS
          The method number which indicates to include the sub folders.
 
Fields inherited from class net.aerith.misao.util.OperationObservable
observer_list
 
Constructor Summary
CatalogTreeManager()
           
 
Method Summary
 java.util.Hashtable getCatalogHierarchy(int method)
          Gets the folder hierarchy of the catalog tree in the database.
 java.util.Vector getCatalogSubfolders(java.lang.String category_name, java.lang.String catalog_name, java.util.Vector sub_folders)
          Gets the sub folders in the specified path.
protected abstract  java.util.Vector getCatalogSubfolders(java.util.Vector folder_list)
          Gets the sub folders in the specified path.
protected abstract  java.util.Hashtable getHierarchy(int method)
          Gets the folder hierarchy of the database.
 java.util.Vector getStars(java.lang.String category_name, java.lang.String catalog_name, java.util.Vector sub_folders)
          Gets the stars in the specified path.
protected abstract  java.util.Vector getStars(java.util.Vector folder_list)
          Gets the stars in the specified path.
 
Methods inherited from class net.aerith.misao.util.OperationObservable
addObserver, deleteObserver, notifyEnd, notifyFailed, notifyStart, notifySucceeded, notifyWarned
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 

Field Detail

INCLUDE_SUBFOLDERS

public static final int INCLUDE_SUBFOLDERS
The method number which indicates to include the sub folders.

EXCLUDE_SUBFOLDERS

public static final int EXCLUDE_SUBFOLDERS
The method number which indicates to exclude the sub folders.
Constructor Detail

CatalogTreeManager

public CatalogTreeManager()
Method Detail

getCatalogHierarchy

public java.util.Hashtable getCatalogHierarchy(int method)
                                        throws java.io.IOException
Gets the folder hierarchy of the catalog tree in the database.
Parameters:
method - the method.
Returns:
the hash table which contains the folder hierarchy.
Throws:
java.io.IOException - if I/O error occurs.

getHierarchy

protected abstract java.util.Hashtable getHierarchy(int method)
                                             throws java.io.IOException
Gets the folder hierarchy of the database.
Parameters:
method - the method.
Returns:
the hash table which contains the folder hierarchy.
Throws:
java.io.IOException - if I/O error occurs.

getCatalogSubfolders

public java.util.Vector getCatalogSubfolders(java.lang.String category_name,
                                             java.lang.String catalog_name,
                                             java.util.Vector sub_folders)
                                      throws java.io.IOException
Gets the sub folders in the specified path.
Parameters:
category_name - the name of category.
catalog_name - the name of catalog.
sub_folders - the folder hierarchy under the catalog folder.
Returns:
the list of sub folders.
Throws:
java.io.IOException - if I/O error occurs.

getCatalogSubfolders

protected abstract java.util.Vector getCatalogSubfolders(java.util.Vector folder_list)
                                                  throws java.io.IOException
Gets the sub folders in the specified path.
Parameters:
folder_list - the list of folders.
Returns:
the list of sub folders.
Throws:
java.io.IOException - if I/O error occurs.

getStars

public java.util.Vector getStars(java.lang.String category_name,
                                 java.lang.String catalog_name,
                                 java.util.Vector sub_folders)
                          throws java.io.IOException,
                                 java.lang.ClassNotFoundException,
                                 java.lang.IllegalAccessException,
                                 java.lang.InstantiationException
Gets the stars in the specified path.
Parameters:
category_name - the name of category.
catalog_name - the name of catalog.
sub_folders - the folder hierarchy under the catalog folder.
Returns:
the list of stars.
Throws:
java.io.IOException - if I/O error occurs.
java.lang.ClassNotFoundException - if the star class recorded in the XML document is not found.
java.lang.IllegalAccessException - if the class or initializer is not accessible.
java.lang.InstantiationException - if an application tries to instantiate an abstract class or an interface, or if the instantiation fails for some other reason.

getStars

protected abstract java.util.Vector getStars(java.util.Vector folder_list)
                                      throws java.io.IOException,
                                             java.lang.ClassNotFoundException,
                                             java.lang.IllegalAccessException,
                                             java.lang.InstantiationException
Gets the stars in the specified path.
Parameters:
folder_list - the list of folders.
Returns:
the list of stars.
Throws:
java.io.IOException - if I/O error occurs.
java.lang.ClassNotFoundException - if the star class recorded in the XML document is not found.
java.lang.IllegalAccessException - if the class or initializer is not accessible.
java.lang.InstantiationException - if an application tries to instantiate an abstract class or an interface, or if the instantiation fails for some other reason.