gov.lanl.Database
Class OJBDatabaseMgr

java.lang.Object
  |
  +--gov.lanl.Database.OJBDatabaseMgr

All Implemented Interfaces:

DatabaseMgr

public class OJBDatabaseMgr

extends java.lang.Object

implements DatabaseMgr

An implmentation of DatabaseMgr interface based on ObJectBridge (http://objectbridge.sourceforge.net)

Version:

$Revision: 1.24 $ $Date: 2002/12/31 16:27:41 $

Author:

koenig

Field Summary

static int	DEEP
static int	SHALLOW

Constructor Summary

OJBDatabaseMgr()
Constructor

Method Summary

java.util.Vector	accessElements(PersistentObject obj, java.lang.String element, java.lang.String subelement) obtain a Vector of elements from the Object obj already obtained (via shallow copy)
void	deleteElement(PersistentObject obj) Delete object completely
long	getNextSeq(java.lang.Class clazz, java.lang.String fieldName) return next number in a persistent sequence
PersistentObjectFactory	getObjectFactory() return persistent object factory
void	init(java.lang.String databaseURL) Initialize the DatabaseMgr
void	insertElement(PersistentObject obj, java.lang.String name) input an object into database
PersistentObject	retrieveElement(java.lang.Object obj, java.lang.String elementName, java.lang.String value) get single element (DEEP) with simple query returns the first element (if there is one)
PersistentObject	retrieveElement(java.lang.Object obj, java.lang.String elementName, java.lang.String value, int deep) get a single element (SHALLOW) with simple query
java.util.Vector	retrieveElements(java.lang.Object obj, SearchFilter query, int deep) Retrieve elements of type Object with SearchFilter query and depth flag
java.util.Vector	retrieveElements(java.lang.Object obj, java.lang.String[] elements, java.lang.String[] name) retrieve elements with multiple constraints Objects to be retrieved elements String array of elements to be filtered on name String array of values of the elements desired
java.util.Vector	retrieveElements(java.lang.Object obj, java.lang.String operator, java.lang.String element, int[] values, int deep) retrieve elements with complext query
java.util.Vector	retrieveElements(java.lang.Object obj, java.lang.String operator, java.lang.String element, java.lang.String[] values, int deep) retrieve elements with complext query
void	setDebug(boolean flag) turns the debug mode on/off (default is off)
void	setObjectFactory(java.lang.String objectPackage) Create Persistent Object Factory
void	txn_abort() Cancel transaction
void	txn_begin() set Transaction context
void	txn_commit() complete transaction
void	updateElement(PersistentObject obj) update object fully
void	updateElement(PersistentObject obj, int deep) update object optionally shallowly

Methods inherited from class java.lang.Object

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

Field Detail

SHALLOW

public static int SHALLOW

DEEP

public static int DEEP

Constructor Detail

OJBDatabaseMgr

public OJBDatabaseMgr()

Constructor

Method Detail

setDebug

public void setDebug(boolean flag)

turns the debug mode on/off (default is off)

Specified by:

setDebug in interface DatabaseMgr

Parameters:

flag -

init

public void init(java.lang.String databaseURL)

Description copied from interface: DatabaseMgr

Initialize the DatabaseMgr

Specified by:

init in interface DatabaseMgr

Parameters:

databaseURL -

txn_begin

public void txn_begin()
               throws DBException

set Transaction context

Specified by:

txn_begin in interface DatabaseMgr

Throws:

DBException

txn_commit

public void txn_commit()
                throws DBException

complete transaction

Specified by:

txn_commit in interface DatabaseMgr

Throws:

DBException

retrieveElement

public PersistentObject retrieveElement(java.lang.Object obj,
                                        java.lang.String elementName,
                                        java.lang.String value)
                                 throws DBException

get single element (DEEP) with simple query returns the first element (if there is one)

Specified by:

retrieveElement in interface DatabaseMgr

Parameters:

obj - is the input object being requested

elementName - is the element desired

value - is the value of the element desired

Returns:

Throws:

DBException

retrieveElement

public PersistentObject retrieveElement(java.lang.Object obj,
                                        java.lang.String elementName,
                                        java.lang.String value,
                                        int deep)
                                 throws DBException

Description copied from interface: DatabaseMgr

get a single element (SHALLOW) with simple query

Specified by:

retrieveElement in interface DatabaseMgr

Parameters:

obj -

elementName -

value -

deep -

Returns:

Throws:

DBException

updateElement

public void updateElement(PersistentObject obj,
                          int deep)
                   throws DBException

update object optionally shallowly

Specified by:

updateElement in interface DatabaseMgr

Parameters:

obj -

deep -

Throws:

DBException

updateElement

public void updateElement(PersistentObject obj)
                   throws DBException

update object fully

Specified by:

updateElement in interface DatabaseMgr

Parameters:

obj -

Throws:

DBException

deleteElement

public void deleteElement(PersistentObject obj)
                   throws DBException

Delete object completely

Specified by:

deleteElement in interface DatabaseMgr

Parameters:

obj -

Throws:

DBException

insertElement

public void insertElement(PersistentObject obj,
                          java.lang.String name)
                   throws DBException

input an object into database

Specified by:

insertElement in interface DatabaseMgr

Parameters:

obj - is the input object

name - of the object

Throws:

DBException

accessElements

public java.util.Vector accessElements(PersistentObject obj,
                                       java.lang.String element,
                                       java.lang.String subelement)
                                throws DBException

obtain a Vector of elements from the Object obj already obtained (via shallow copy)

Specified by:

accessElements in interface DatabaseMgr

Parameters:

obj - is the input Object

element - is the name of the element to be returned

subelement -

Returns:

Throws:

DBException

retrieveElements

public java.util.Vector retrieveElements(java.lang.Object obj,
                                         java.lang.String[] elements,
                                         java.lang.String[] name)
                                  throws DBException

retrieve elements with multiple constraints Objects to be retrieved elements String array of elements to be filtered on name String array of values of the elements desired

Specified by:

retrieveElements in interface DatabaseMgr

Parameters:

obj -

elements -

name -

Returns:

Throws:

DBException

retrieveElements

public java.util.Vector retrieveElements(java.lang.Object obj,
                                         SearchFilter query,
                                         int deep)
                                  throws DBException

Retrieve elements of type Object with SearchFilter query and depth flag

Specified by:

retrieveElements in interface DatabaseMgr

Parameters:

obj -

query -

deep -

Returns:

Throws:

DBException

retrieveElements

public java.util.Vector retrieveElements(java.lang.Object obj,
                                         java.lang.String operator,
                                         java.lang.String element,
                                         java.lang.String[] values,
                                         int deep)
                                  throws DBException

retrieve elements with complext query

Specified by:

retrieveElements in interface DatabaseMgr

Parameters:

obj - object to be retrieved

operator - operator in query

element - element in query

values - array of elements in query

deep -

Returns:

Throws:

DBException

retrieveElements

public java.util.Vector retrieveElements(java.lang.Object obj,
                                         java.lang.String operator,
                                         java.lang.String element,
                                         int[] values,
                                         int deep)
                                  throws DBException

retrieve elements with complext query

Specified by:

retrieveElements in interface DatabaseMgr

Parameters:

obj - object to be retrieved

operator - operator in query

element - element in query

values - array of elements in query

deep -

Returns:

Throws:

DBException

txn_abort

public void txn_abort()

Cancel transaction

Specified by:

txn_abort in interface DatabaseMgr

getNextSeq

public long getNextSeq(java.lang.Class clazz,
                       java.lang.String fieldName)

return next number in a persistent sequence

Specified by:

getNextSeq in interface DatabaseMgr

Parameters:

clazz -

fieldName -

setObjectFactory

public void setObjectFactory(java.lang.String objectPackage)

Create Persistent Object Factory

Specified by:

setObjectFactory in interface DatabaseMgr

getObjectFactory

public PersistentObjectFactory getObjectFactory()

return persistent object factory

Specified by:

getObjectFactory in interface DatabaseMgr