net.as_development.asdk.db_service.impl.backend.cache

Class CacheProvider

java.lang.Object

net.as_development.asdk.db_service.impl.backend.cache.CacheProvider

All Implemented Interfaces:

IDBBackend

public class CacheProvider
extends Object
implements IDBBackend

Wrap another IDBBackendImplementation and combine it with a cache. Those cache can exist local (in memory) or remote (e.g. memcache). The cache will be preferred if it is still working but ignored if it shows errors.

Constructor Summary

Constructors

Constructor and Description
CacheProvider()

Method Summary

Modifier and Type	Method and Description
void	createTable(Row aRow) back end should create a new table.
void	deleteAllRows(Row aRow) must be overwritten by derived class to support deletion of all entities (Means whole table of one entity type!)
void	deleteRows(List<Row> lRows) must be overwritten by derived class to support delete operation.
String	getAllRows(Row aMeta, String sNextToken, List<Row> lResults) must be overwritten by derived class to support get-all operation.
void	getRowById(Row aRow) must be overwritten by derived class to support get-by-id operation.
void	insertRows(List<Row> lRows) must be overwritten by derived class to support insert operation.
String	queryRows(Row aMetaRow, String sNextToken, List<Row> lResults, IDBBackendQuery iQuery) must be overwritten by derived class to support generic queries.
void	removeTable(Row aRow) back end should remove an existing table.
void	setEntityMetaInfoProvider(EntityMetaInfoProvider aProvider) Set the meta information provider to this implementation.
void	updateRows(List<Row> lRows) must be overwritten by derived class to support update operation.

Methods inherited from class java.lang.Object

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

Constructor Detail

CacheProvider

public CacheProvider()

Method Detail

setEntityMetaInfoProvider

public void setEntityMetaInfoProvider(EntityMetaInfoProvider aProvider)
                               throws Exception

Description copied from interface: IDBBackend

Set the meta information provider to this implementation. Meta informations knows nearly anything about entities to be load/saved by this DB backend as e.g. attribute and column names, tables, types.

Specified by:

setEntityMetaInfoProvider in interface IDBBackend

Parameters:

aProvider - [IN] the meta information provider.

Throws:

Exception

createTable

public void createTable(Row aRow)
                 throws Exception

Description copied from interface: IDBBackend

back end should create a new table.

Specified by:

createTable in interface IDBBackend

Parameters:

aRow - [IN] describe the structure of the table more in detail.

Throws:

Exception

removeTable

public void removeTable(Row aRow)
                 throws Exception

Description copied from interface: IDBBackend

back end should remove an existing table. Note Do nothing in case table do not exists. Don't throw an exception in that special case.

Specified by:

removeTable in interface IDBBackend

Parameters:

aRow - [IN] describe the structure of the table more in detail.

Throws:

Exception

insertRows

public void insertRows(List<Row> lRows)
                throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support insert operation.

Specified by:

insertRows in interface IDBBackend

Parameters:

lRows - [IN] contains all information about the new rows. (meta info and values)

Throws:

Exception - in case operation failed (by any reason).

updateRows

public void updateRows(List<Row> lRows)
                throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support update operation.

Specified by:

updateRows in interface IDBBackend

Parameters:

lRows - [IN] contains all information about all rows for updating. (meta info and values)

Throws:

Exception - in case operation failed (by any reason).

deleteRows

public void deleteRows(List<Row> lRows)
                throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support delete operation.

Specified by:

deleteRows in interface IDBBackend

Parameters:

lRows - [IN] contains all information about all rows to be deleted. (meta info and values)

Throws:

Exception - in case operation failed (by any reason).

deleteAllRows

public void deleteAllRows(Row aRow)
                   throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support deletion of all entities (Means whole table of one entity type!)

Specified by:

deleteAllRows in interface IDBBackend

Parameters:

aRow - [IN] describe the table (one row of it) more in detail.

Throws:

Exception - in case operation failed (by any reason).

getRowById

public void getRowById(Row aRow)
                throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support get-by-id operation.

Specified by:

getRowById in interface IDBBackend

Parameters:

aRow - [IN/OUT] contains all information about the queried entity. (meta info and id) return row filled with all values retrieved from DB.

Throws:

Exception - in case operation failed (by any reason).

getAllRows

public String getAllRows(Row aMeta,
                         String sNextToken,
                         List<Row> lResults)
                  throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support get-all operation.

Specified by:

getAllRows in interface IDBBackend

Parameters:

aMeta - [IN] describe the table (one row of it) more in detail.

sNextToken - [IN] points to the last iterator of last query where this query should start. It depends from the real back end implementation how such token is generated and used.

lResults - [OUT] here we have to fill in our results. Was cleared already outside. We have to add something here only .-)

Returns:

return the next possible token to be used for a sub sequential query. An empty or null token means: no further query results available.

Throws:

Exception - in case operation failed (by any reason).

queryRows

public String queryRows(Row aMetaRow,
                        String sNextToken,
                        List<Row> lResults,
                        IDBBackendQuery iQuery)
                 throws Exception

Description copied from interface: IDBBackend

must be overwritten by derived class to support generic queries.

Specified by:

queryRows in interface IDBBackend

Parameters:

aMetaRow - [IN] describe the table (one row of it) more in detail.

sNextToken - [IN] points to the last iterator of last query where this query should start. It depends from the real back end implementation how such token is generated and used.

lResults - [OUT] here we have to fill in our results. Was cleared already outside. We have to add something here only .-)

iQuery - [IN] the query itself.

Returns:

return the next possible token to be used for a sub sequential query. An empty or null token means: no further query results available.

Throws:

Exception - in case operation failed (by any reason).