All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface edu.cmu.owl.so.database.DatabaseServer

public interface interface DatabaseServer

Version:

$Id:$

SERVER_NAME

bind(Object, String)

This method is similiar to that provided by the ODMG Java bindings.

checkpoint()

This method forces the database server to write its contents to disk.

getByName(String)

This method returns all objects which are an instance of the named class.

getNewObject(String)

This is a factory for creating new objects.

loadObjects(String)

This method instructs the database server to call upon FillDatabase to load objects from a flat file into the database.

lookup(String)

This method retrieves an object from the database by name.

ping()

This method prints a debugging message on the console of the machine running the database server.

shutdown()

This method performs a checkpoint(), unbinds that server from the RMI Registry and forces the server to exit.

 public static final String SERVER_NAME

 public abstract void loadObjects(String urlString) throws RemoteException, DatabaseException

This method instructs the database server to call upon FillDatabase to load objects from a flat file into the database.

 public abstract void shutdown() throws RemoteException

This method performs a checkpoint(), unbinds that server from the RMI Registry and forces the server to exit. It will only return after the checkpoint has returned. (This may require the server to spawn a thread which will wait before shutting down the server.)

 public abstract void checkpoint() throws RemoteException

This method forces the database server to write its contents to disk. It is similiar to a filesystem sync() commmand except that it is synchronized.

 public abstract void bind(Object obj,
                           String name) throws RemoteException, DatabaseException

This method is similiar to that provided by the ODMG Java bindings. If a non-zero length, unique string is provided as an argument, then that string will be mapped to that object for future use. One use for that string is to retrieve the object using the lookup() method.

 public abstract Object lookup(String name) throws RemoteException, DatabaseException

This method retrieves an object from the database by name. If no such object exists, a DatabaseException is thrown.

 public abstract Vector getByName(String name) throws RemoteException, DatabaseException

This method returns all objects which are an instance of the named class. If no objects exist, an empty (length zero) vector will be returned. If the name is null, this method will return all objects in the database.

 public abstract void ping() throws RemoteException

This method prints a debugging message on the console of the machine running the database server.

 public abstract Remote getNewObject(String classname) throws RemoteException, DatabaseException

This is a factory for creating new objects. This method does not bind the objects or imply any kind of persistence. The bind() method should be used to ensure persistence.

All Packages  Class Hierarchy  This Package  Previous  Next  Index