net.as_development.asdk.db_service.impl

Class DBQueryTemplate<TEntity extends IEntity>

java.lang.Object

net.as_development.asdk.db_service.impl.DBQueryTemplate<TEntity>

public class DBQueryTemplate<TEntity extends IEntity>
extends Object

Because IDBQuery (implemented as class DBQuery) can't be used within multi-threaded environments if it contains both (meta structure and real values) we split those functionality into two pieces: - the template part which contains all meta and static parts of a query - the value part referring the template and adding real query values only Where the template can be cached and used multi-threaded the value part must not be cached.

Constructor Summary

Constructors

Constructor and Description
DBQueryTemplate(String sId, EntityMetaInfo aMeta) create new query instance and bind it to the right set of meta information.

Method Summary

Modifier and Type	Method and Description
void	compile() compile this query.
String	getId()
DynamicArrayList<QueryPart>	getQueryParts()
boolean	isCompiled()
void	setQueryPart(int nPosition, EQueryPartBinding eBinding, EQueryPartOperation eOperation, String sAttribute) see IDBQuery.setQueryPart () ... but it define those part without any value.

Methods inherited from class java.lang.Object

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

Constructor Detail

DBQueryTemplate

public DBQueryTemplate(String sId,
                       EntityMetaInfo aMeta)

create new query instance and bind it to the right set of meta information. Those meta information knows nearly everything about the bound entity class where this query is good for.

Parameters:

sId - [IN] the id for this query. Used outside for identification and might be caching ...

aMeta - [IN] the set of meta information.

Method Detail

compile

public void compile()
             throws Exception

compile this query. It can be called as often you want ... but it compiles these query one times only. The outside code must not track if its worth or needed to call compile or not. He can call this method - we do the right things here - thats it. Compile means - prepare and cache anything needed for later use of this query instance.

Throws:

Exception

setQueryPart

public void setQueryPart(int nPosition,
                         EQueryPartBinding eBinding,
                         EQueryPartOperation eOperation,
                         String sAttribute)
                  throws Exception

see IDBQuery.setQueryPart () ... but it define those part without any value. Here we define the structure of the query ... Values are hold in outside class DBQuery.

Throws:

Exception

getId

public String getId()
             throws Exception

Throws:

Exception

getQueryParts

public DynamicArrayList<QueryPart> getQueryParts()
                                          throws Exception

Throws:

Exception

isCompiled

public boolean isCompiled()
                   throws Exception

Returns:

if this query template was 'compiled' already. What does it mean 'compiled' ? see compile() method for further informations ...

Throws:

Exception