net.as_development.asdk.db_service

Class DBItemBase

java.lang.Object

net.as_development.asdk.db_service.DBItemBase

public abstract class DBItemBase
extends Object

A base class for all DB related implementations. It handle creating the right DB instance and provide them to the derived class. Further it supports a set of helper functions as e.g. naming queries unique.

Constructor Summary

Constructors

Constructor and Description
DBItemBase()

Method Summary

Modifier and Type	Method and Description
protected abstract String	getPersistenceUnitName()
protected IDB	mem_DB()
static String	namePersistenceUnit(Class<?> aImplClass)
static String	nameQuery(Class<?> aImplClass, String sQuery)

Methods inherited from class java.lang.Object

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

Constructor Detail

DBItemBase

public DBItemBase()

Method Detail

namePersistenceUnit

public static String namePersistenceUnit(Class<?> aImplClass)

Parameters:

aImplClass - [IN] the class using this DB base class.

Returns:

a persistence unit ID suitable for the given class.

nameQuery

public static String nameQuery(Class<?> aImplClass,
                               String sQuery)

Parameters:

aImplClass - [IN] the class using DB queries.

sQuery - [IN] your internal query name.

Returns:

an unique (but stable/fix) query name. Because such name is used for caching also it's important to have and unique name first but a stable name too. We use a combination of class and 'internal query name' you provide. Of course you must make sure your internal query name is unique within the area of your implementation class .-)

getPersistenceUnitName

protected abstract String getPersistenceUnitName()
                                          throws Exception

Returns:

the name of the persistence unit bound to that DB instance. Must be overwritten by the derived class and is called from this base class on creating the internal DB instance.

Throws:

Exception

mem_DB

protected IDB mem_DB()
              throws Exception

Returns:

the internal DB instance to be used here.

Throws:

Exception