|
Oracle Application Server TopLink API Reference 10g Release 2 (10.1.2) B15903-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
oracle.toplink.queryframework.DatabaseQuery
oracle.toplink.queryframework.ReadQuery
oracle.toplink.queryframework.ObjectLevelReadQuery
Purpose: Abstract class for all read queries using objects.
Description: Contains common behavior for all read queries using objects.
Field Summary | |
static int |
CheckCacheByExactPrimaryKey |
static int |
CheckCacheByPrimaryKey |
static int |
CheckCacheOnly |
static int |
CheckCacheThenDatabase |
static int |
ConformResultsInUnitOfWork |
static int |
DoNotCheckCache |
static short |
DONT_USE_DISTINCT |
InMemoryQueryIndirectionPolicy |
inMemoryQueryIndirectionPolicy Used to determine behaviour of indirection in InMemoryQuerying |
static short |
LOCK |
static short |
LOCK_NOWAIT |
static short |
NO_LOCK |
static short |
UNCOMPUTED_DISTINCT |
static short |
USE_DISTINCT |
static int |
UseDescriptorSetting |
Fields inherited from class oracle.toplink.queryframework.DatabaseQuery |
CascadeAggregateDelete, CascadeAllParts, CascadeDependentParts, CascadePrivateParts, NoCascading, QUERY_PREPARE |
Method Summary | |
void |
acquireLocks() PUBLIC: Set the query to lock, this will also turn refreshCache on. |
void |
acquireLocksWithoutWaiting() PUBLIC: Set the query to lock without waiting (blocking), this will also turn refreshCache on. |
void |
addJoinedAttribute(Expression attributeExpression) PUBLIC: Specify the one-to-one mapped attribute to be optimized in this query. |
void |
addJoinedAttribute(java.lang.String attributeName) PUBLIC: Specify the one-to-one mapped attribute to be optimized in this query. |
void |
addPartialAttribute(Expression attributeExpression) PUBLIC: Specify that only a subset of the class' attributes be selected in this query. |
void |
addPartialAttribute(java.lang.String attributeName) PUBLIC: Specify that only a subset of the class' attributes be selected in this query. |
void |
checkCacheOnly() PUBLIC: The cache will checked completely, if the object is not found null will be returned or an error if the query is too complex. |
void |
conformResultsInUnitOfWork() PUBLIC: The cache will checked completely, if the object is not found the database will be queried, and the database result will be verified with what is in the cache and/or unit of work including new objects. |
void |
dontAcquireLocks() PUBLIC: Set the query not to lock. |
void |
dontCheckCache() PUBLIC: This can be used to explicitly disable the cache hit. |
void |
dontRefreshIdentityMapResult() PUBLIC: When unset means perform read normally and dont do refresh. |
void |
dontRefreshRemoteIdentityMapResult() PUBLIC: When unset means perform read normally and dont do refresh. |
void |
dontUseDistinct() ADVANCED: If a distinct has been set the DISTINCT clause will be printed. |
int |
getCacheUsage() PUBLIC: Return the cache usage. |
short |
getDistinctState() ADVANCED: If a distinct has been set the DISTINCT clause will be printed. |
java.lang.Object |
getExampleObject() PUBLIC: This method returns the current example object. |
ExpressionBuilder |
getExpressionBuilder() REQUIRED: Get the expression builder which should be used for this query. |
InMemoryQueryIndirectionPolicy |
getInMemoryQueryIndirectionPolicy() PUBLIC: Returns the InMemoryQueryIndirectionPolicy for this query |
short |
getLockMode() PUBLIC: Return the current locking mode. |
QueryByExamplePolicy |
getQueryByExamplePolicy() PUBLIC: When using Query By Example, an instance of QueryByExamplePolicy is used to customize the query. |
java.lang.Class |
getReferenceClass() PUBLIC: Return the reference class of the query. |
boolean |
hasJoinedMappings() |
boolean |
isLockQuery() PUBLIC: Return true if query is in any lockMode other than NO_LOCK |
boolean |
isObjectLevelReadQuery() PUBLIC: Return if this is an object level read query. |
void |
refreshIdentityMapResult() PUBLIC: Refresh the attributes of the object(s) resulting from the query. |
void |
refreshRemoteIdentityMapResult() PUBLIC: Refresh the attributes of the object(s) resulting from the query. |
void |
resetDistinct() ADVANCED: If a distinct has been set the DISTINCT clause will be printed. |
void |
setCacheUsage(int cacheUsage) PUBLIC: Set the cache usage. |
void |
setDistinctState(short distinctState) ADVANCED: If a distinct has been set the DISTINCT clause will be printed. |
void |
setExampleObject(java.lang.Object newExampleObject) PUBLIC: Set the example object of the query to be the newExampleObject. |
void |
setInMemoryQueryIndirectionPolicy(InMemoryQueryIndirectionPolicy inMemoryQueryIndirectionPolicy) PUBLIC: Set the InMemoryQueryIndirectionPolicy for this query |
void |
setLockMode(short lockMode) PUBLIC: Set the lock mode of the query NO_LOCK, LOCK, or LOCK_NOWAIT (default=NO_LOCK) |
void |
setQueryByExamplePolicy(QueryByExamplePolicy queryByExamplePolicy) PUBLIC: The QueryByExamplePolicy, is a useful to customize the query when Query By Example is used. |
void |
setReferenceClass(java.lang.Class aClass) REQUIRED: Set the reference class for the query. |
void |
setShouldRefreshIdentityMapResult(boolean shouldRefreshIdentityMapResult) PUBLIC: Set if the attributes of the object(s) resulting from the query should be refreshed. |
void |
setShouldRefreshRemoteIdentityMapResult(boolean shouldRefreshIdentityMapResult) PUBLIC: Set if the attributes of the object(s) resulting from the query should be refreshed. |
boolean |
shouldCheckCacheOnly() PUBLIC: Return if cache should be checked. |
boolean |
shouldCheckDescriptorForCacheUsage() |
boolean |
shouldConformResultsInUnitOfWork() PUBLIC: Return if cache should be checked. |
boolean |
shouldRefreshIdentityMapResult() PUBLIC: Set to a boolean. |
boolean |
shouldRefreshRemoteIdentityMapResult() PUBLIC: Set to a boolean. |
java.lang.String |
toString() |
void |
useDistinct() ADVANCED: If a distinct has been set the DISTINCT clause will be printed. |
Methods inherited from class oracle.toplink.queryframework.ReadQuery |
cacheQueryResults, clearQueryResults, doNotCacheQueryResults, getMaxRows, isReadQuery, setMaxRows, setShouldCacheQueryResults, shouldCacheQueryResults |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final int UseDescriptorSetting
public static final int DoNotCheckCache
public static final int CheckCacheByExactPrimaryKey
public static final int CheckCacheByPrimaryKey
public static final int CheckCacheThenDatabase
public static final int CheckCacheOnly
public static final int ConformResultsInUnitOfWork
public static final short NO_LOCK
public static final short LOCK
public static final short LOCK_NOWAIT
public static final short UNCOMPUTED_DISTINCT
public static final short USE_DISTINCT
public static final short DONT_USE_DISTINCT
public InMemoryQueryIndirectionPolicy inMemoryQueryIndirectionPolicy
Method Detail |
public void acquireLocks()
public void acquireLocksWithoutWaiting()
public void addJoinedAttribute(java.lang.String attributeName)
Note: This cannot be used for objects where it is possible not to have a part, as these objects will be ommited from the result set, unless an outer join is used through passing and expression using "getAllowingNull".
Example: query.addJoinedAttribute("address")
addJoinedAttribute(Expression)
, ReadAllQuery.addBatchReadAttribute(Expression)
public void addJoinedAttribute(Expression attributeExpression)
Note: This cannot be used for objects where it is possible not to have a part, as these objects will be ommited from the result set, unless an outer join is used through passing and expression using "getAllowingNull".
Example: query.addJoinedAttribute(query.getExpressionBuilder().get("teamLeader").get("address"))
ReadAllQuery.addBatchReadAttribute(String)
public void addPartialAttribute(java.lang.String attributeName)
This allows for the query to be optimized through selecting less data.
Partial objects will be returned from the query, where the unspecified attributes will be left null
. The primary key will always be selected to allow re-querying of the whole object.
Note: Because the object is not fully initialized it cannot be cached, and cannot be edited.
Note: You cannot have 2 partial attributes of the same type. You also cannot add a partial attribute which is of the same type as the class being queried.
Example: query.addPartialAttribute("firstName")
addPartialAttribute(Expression)
public void addPartialAttribute(Expression attributeExpression)
This allows for the query to be optimized through selecting less data.
Partial objects will be returned from the query, where the unspecified attributes will be left null
. The primary key will always be selected to allow re-querying of the whole object.
Note: Because the object is not fully initialized it cannot be cached, and cannot be edited.
Note: You cannot have 2 partial attributes of the same type. You also cannot add a partial attribute which is of the same type as the class being queried.
Example: query.addPartialAttribute(query.getExpressionBuilder().get("address").get("city"))
public void checkCacheOnly()
setCacheUsage(int)
public void conformResultsInUnitOfWork()
setCacheUsage(int)
public void dontAcquireLocks()
public void dontCheckCache()
public void dontRefreshIdentityMapResult()
public void dontRefreshRemoteIdentityMapResult()
public void dontUseDistinct()
public int getCacheUsage()
Valid values are:
public short getDistinctState()
public java.lang.Object getExampleObject()
public ExpressionBuilder getExpressionBuilder()
public InMemoryQueryIndirectionPolicy getInMemoryQueryIndirectionPolicy()
public short getLockMode()
public QueryByExamplePolicy getQueryByExamplePolicy()
public java.lang.Class getReferenceClass()
getReferenceClass
in class DatabaseQuery
public boolean hasJoinedMappings()
public boolean isLockQuery()
public boolean isObjectLevelReadQuery()
isObjectLevelReadQuery
in class DatabaseQuery
public void refreshIdentityMapResult()
public void refreshRemoteIdentityMapResult()
public void resetDistinct()
public void setCacheUsage(int cacheUsage)
Valid values are:
public void setDistinctState(short distinctState)
public void setExampleObject(java.lang.Object newExampleObject)
If a query already has a selection criteria this criteria and the generated query by example criteria will be conjuncted.
Once a query is executed you must make an explicit call to setExampleObject if the example object is changed, so the query will know to prepare itself again.
There is a caution to setting both a selection criteria and an example object: Only in this case if you set the example object again after execution you must then also reset the selection criteria. (This is because after execution the original criteria and Query By Example criteria were fused together, and the former cannot be easily recovered from the now invalid result).
public void setInMemoryQueryIndirectionPolicy(InMemoryQueryIndirectionPolicy inMemoryQueryIndirectionPolicy)
public void setLockMode(short lockMode)
public void setQueryByExamplePolicy(QueryByExamplePolicy queryByExamplePolicy)
Once a query is executed you must make an explicit call to setQueryByExamplePolicy when changing the policy, so the query will know to prepare itself again.
There is a caution to setting both a selection criteria and an example object: If you set the policy after execution you must also reset the selection criteria. (This is because after execution the original criteria and Query By Example criteria are fused together, and the former cannot be easily recovered).
public void setReferenceClass(java.lang.Class aClass)
public void setShouldRefreshIdentityMapResult(boolean shouldRefreshIdentityMapResult)
public void setShouldRefreshRemoteIdentityMapResult(boolean shouldRefreshIdentityMapResult)
public boolean shouldCheckCacheOnly()
public boolean shouldCheckDescriptorForCacheUsage()
public boolean shouldConformResultsInUnitOfWork()
public boolean shouldRefreshIdentityMapResult()
public boolean shouldRefreshRemoteIdentityMapResult()
public java.lang.String toString()
toString
in class DatabaseQuery
public void useDistinct()
|
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |