org.apache.openjpa.kernel
Interface Query

All Superinterfaces:
QueryContext, QueryFlushModes, QueryOperations, Serializable
All Known Implementing Classes:
DelegatingQuery, QueryImpl

public interface Query
extends Serializable, QueryContext, QueryOperations, QueryFlushModes

OpenJPA query interface.

Since:
0.3.0
Author:
Patrick Linskey, Abe White

Field Summary
 
Fields inherited from interface org.apache.openjpa.kernel.QueryOperations
OP_DELETE, OP_SELECT, OP_UPDATE
 
Fields inherited from interface org.apache.openjpa.kernel.QueryFlushModes
FLUSH_FALSE, FLUSH_TRUE, FLUSH_WITH_CONNECTION
 
Method Summary
 void addAggregateListener(AggregateListener listener)
          Register an aggregate listener for the query.
 void addFilterListener(FilterListener listener)
          Register a filter listener for the query.
 void assertNotReadOnly()
          Assert that the query is not read-only.
 void assertNotSerialized()
          Check that the query has not been serialized, which causes it to lose its association with its Broker.
 void assertOpen()
          Assert that the query's broker is still open.
 void closeAll()
          Close all open query results.
 void closeResources()
          Close query results that are consuming resources.
 void compile()
          Compile the query.
 long deleteAll()
          Deletes all of the instances that are satisfied by the query.
 long deleteAll(Map parameterMap)
          Deletes all of the instances that are satisfied by the query.
 long deleteAll(Object[] parameters)
          Deletes all of the instances that are satisfied by the query.
 Object execute()
          Execute.
 Object execute(Map params)
          Execute with parameter map.
 Object execute(Object[] params)
          Execute with parameter array.
 Broker getBroker()
          The broker that generated this query.
 Extent getCandidateExtent()
          Return the candidate extent, or null if a collection was specified instead of an extent.
 String[] getDataStoreActions(Map params)
          Returns a description of the commands that will be sent to the datastore in order to execute this query.
 void removeAggregateListener(AggregateListener listener)
          Remove an aggregate listener from the query.
 void removeFilterListener(FilterListener listener)
          Remove a filter listener from the query.
 void setCandidateCollection(Collection coll)
          Set a collection of candidates.
 void setCandidateExtent(Extent extent)
          Set the candidate extent.
 void setIgnoreChanges(boolean ignore)
          Whether to ignore changes in the current transaction.
 boolean setQuery(Object query)
          The query string or template.
 long updateAll()
          Performs an update of the instances that are satisfied by the query.
 long updateAll(Map parameterMap)
          Performs an update of the instances that are satisfied by the query.
 long updateAll(Object[] parameters)
          Performs an update of the instances that are satisfied by the query.
 
Methods inherited from interface org.apache.openjpa.kernel.QueryContext
classForName, declareParameters, deleteInMemory, getAccessPathMetaDatas, getAggregateListener, getAggregateListeners, getAlias, getCandidateCollection, getCandidateType, getCompilation, getEndRange, getFetchConfiguration, getFilterListener, getFilterListeners, getIgnoreChanges, getLanguage, getOperation, getParameterDeclaration, getParameterTypes, getProjectionAliases, getProjectionTypes, getQuery, getQueryString, getResultMappingName, getResultMappingScope, getResultType, getStartRange, getStoreContext, getUpdates, hasGrouping, hasSubclasses, isAggregate, isReadOnly, isUnique, lock, setCandidateType, setRange, setReadOnly, setResultMapping, setResultType, setUnique, unlock, updateInMemory
 

Method Detail

getBroker

Broker getBroker()
The broker that generated this query.


setQuery

boolean setQuery(Object query)
The query string or template.


setIgnoreChanges

void setIgnoreChanges(boolean ignore)
Whether to ignore changes in the current transaction.


addFilterListener

void addFilterListener(FilterListener listener)
Register a filter listener for the query.


removeFilterListener

void removeFilterListener(FilterListener listener)
Remove a filter listener from the query.


addAggregateListener

void addAggregateListener(AggregateListener listener)
Register an aggregate listener for the query.


removeAggregateListener

void removeAggregateListener(AggregateListener listener)
Remove an aggregate listener from the query.


getCandidateExtent

Extent getCandidateExtent()
Return the candidate extent, or null if a collection was specified instead of an extent.


setCandidateExtent

void setCandidateExtent(Extent extent)
Set the candidate extent.


setCandidateCollection

void setCandidateCollection(Collection coll)
Set a collection of candidates.


compile

void compile()
Compile the query.


execute

Object execute()
Execute.


execute

Object execute(Map params)
Execute with parameter map.


execute

Object execute(Object[] params)
Execute with parameter array.


deleteAll

long deleteAll()
Deletes all of the instances that are satisfied by the query.

Returns:
the number of instances that were deleted

deleteAll

long deleteAll(Object[] parameters)
Deletes all of the instances that are satisfied by the query.

Parameters:
parameters - the poitional parameters for the query
Returns:
the number of instances that were deleted

deleteAll

long deleteAll(Map parameterMap)
Deletes all of the instances that are satisfied by the query.

Parameters:
parameterMap - the named parameter map
Returns:
the number of instances that were deleted

updateAll

long updateAll()
Performs an update of the instances that are satisfied by the query.

Returns:
the number of instances that were update

updateAll

long updateAll(Object[] parameters)
Performs an update of the instances that are satisfied by the query.

Parameters:
parameters - the positional parameter array
Returns:
the number of instances that were update

updateAll

long updateAll(Map parameterMap)
Performs an update of the instances that are satisfied by the query.

Parameters:
parameterMap - the named parameter map
Returns:
the number of instances that were update

closeAll

void closeAll()
Close all open query results.


closeResources

void closeResources()
Close query results that are consuming resources. Allow results that are not consuming resources to remain open so that they continue to function normally.


getDataStoreActions

String[] getDataStoreActions(Map params)
Returns a description of the commands that will be sent to the datastore in order to execute this query. This will typically be in the native query language of the database (e.g., SQL).

Parameters:
params - the named parameter map for the query invocation
Since:
0.3.2

assertOpen

void assertOpen()
Assert that the query's broker is still open.


assertNotReadOnly

void assertNotReadOnly()
Assert that the query is not read-only.


assertNotSerialized

void assertNotSerialized()
Check that the query has not been serialized, which causes it to lose its association with its Broker.



Copyright © 2006-2008 Apache Software Foundation. All Rights Reserved.