com.cosylab.cdb.client

Class CDBAccess

java.lang.Object

com.cosylab.cdb.client.CDBAccess

public class CDBAccess
extends java.lang.Object

Class managing CDB access (establishing connection to the CDB, observing DAO changes, and providing accessor methods to the user).

It retrieves and caches XML data from the CDB unless property DAO.remote is true.

Author:

Matej Sekoranja (matej.sekoranja@cosylab.com)

Constructor Summary

Constructors

Constructor and Description
CDBAccess(java.util.logging.Logger logger) Constructor used only when setDAL(DAL) is called afterwards.
CDBAccess(org.omg.CORBA.ORB orb, java.util.logging.Logger logger) Constructor.

Method Summary

Modifier and Type	Method and Description
DAL	connectAndGetDAL() Active (connects if necessary) DAL accessor.
DAOProxy	createDAO(java.lang.String curl) Performs the connect of the specified DAO.
void	destroy() Destroys.
DAL	getDAL() DAL accessor.
java.lang.String[]	getSubNodes(DAOProxy proxy) Helper method to get all subnodes of the current proxy, removes ".xml" element from the list.
java.lang.String[]	getSubNodes(DAOProxy proxy, java.lang.String subnode) Helper method to get all subnodes of the current proxy, removes ".xml" element from the list.
boolean	isBypassNameService()
void	readConfiguration() Interprets the configuration delivered by System JVM properties.
void	setBypassNameService(boolean bypassNameService)
void	setDAL(DAL dal) DAL setter.

Methods inherited from class java.lang.Object

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

Constructor Detail

CDBAccess

public CDBAccess(java.util.logging.Logger logger)

Constructor used only when setDAL(DAL) is called afterwards.

Parameters:

logger - logger.

CDBAccess

public CDBAccess(org.omg.CORBA.ORB orb,
                 java.util.logging.Logger logger)

Constructor.

Parameters:

orb - CORBA ORB.

logger - logger.

Method Detail

createDAO

public DAOProxy createDAO(java.lang.String curl)

Performs the connect of the specified DAO.

Parameters:

curl - DAO curl, non-null

Returns:

DAO proxy.

Throws:

java.lang.RuntimeException - on failure

isBypassNameService

public boolean isBypassNameService()

Returns:

the bypassNameService

setBypassNameService

public void setBypassNameService(boolean bypassNameService)

Parameters:

bypassNameService - the bypassNameService to set

getSubNodes

public java.lang.String[] getSubNodes(DAOProxy proxy)
                               throws java.lang.Throwable

Helper method to get all subnodes of the current proxy, removes ".xml" element from the list.

Parameters:

proxy - proxy whose subnodes to return.

Returns:

array of subnodes.

Throws:

java.lang.Throwable - exception on failure (e.g. connection failure, etc.)

getSubNodes

public java.lang.String[] getSubNodes(DAOProxy proxy,
                                      java.lang.String subnode)
                               throws java.lang.Throwable

Helper method to get all subnodes of the current proxy, removes ".xml" element from the list.

Parameters:

proxy - proxy whose subnodes to return.

subnode - proxy subnode to be queried

Returns:

array of subnodes.

Throws:

java.lang.Throwable - exception on failure (e.g. connection failure, etc.)

readConfiguration

public void readConfiguration()

Interprets the configuration delivered by System JVM properties.

destroy

public void destroy()

Destroys.

setDAL

public void setDAL(DAL dal)

DAL setter.

Parameters:

dal - DAL reference.

getDAL

public DAL getDAL()

DAL accessor.

Returns:

DAL reference.

connectAndGetDAL

public DAL connectAndGetDAL()

Active (connects if necessary) DAL accessor.

Returns:

DAL reference, null if failed to connect.