kodo.query
Class DelegatingKodoQuerySPI

java.lang.Object
  |
  +--kodo.query.DelegatingKodoQuerySPI

All Implemented Interfaces:

KodoQuery, KodoQuerySPI, Query, Serializable

public class DelegatingKodoQuerySPI

extends Object

implements KodoQuerySPI

See Also:

Serialized Form

Field Summary

protected KodoQuerySPI

_delegate

Fields inherited from interface kodo.query.KodoQuery

FLUSH_FALSE, FLUSH_TRUE, FLUSH_WITH_CONNECTION

Constructor Summary

protected

DelegatingKodoQuerySPI(KodoQuerySPI delegate)

Method Summary

void	addAggregateListener(AggregateListener arg) Register an aggregate listener for the query.
void	addExtension(String arg0, Object arg1) JDO 2.0 Preview.
void	addFilterListener(FilterListener arg) Register a filter listener for the query.
void	close(Object arg)
void	closeAll()
void	closeResources() Close any results that are consuming resources.
void	compile()
void	declareImports(String arg)
void	declareParameters(String arg)
void	declareVariables(String arg)
Object	execute()
Object	execute(Object arg)
Object	execute(Object arg0, Object arg1)
Object	execute(Object arg0, Object arg1, Object arg2)
Object	executeWithArray(Object[] arg)
Object	executeWithMap(Map arg)
ClassMetaData[]	getAccessPathMetaDatas() Return the classes that affect this query.
Collection	getAggregateListeners() Return the aggregate listeners added to this query, or empty collection if none.
String	getAlias() When we're returning standard candidate instances rather than a projection or aggregate, return the alias for the instances in case a result class is set.
String[]	getAliases() Return the aliases for the result expressions.
boolean[]	getAscending() Return wheher each ordering is ascending.
Class	getCandidateClass() Return the class of the objects that this query will return, or null if this information is not available / not relevant.
Collection	getCandidateCollection() Return the candidate collection, or null if an extent was specified instead of a collection.
KodoExtent	getCandidateExtent() Return the candidate extent, or null if a collection was specified instead of an extent.
String[]	getDataStoreActions(Map arg) Returns a description of the commands that will be sent to the datastore in order to execute this query.
long	getEndIndex() Return the 0-based exclusive end index for the returned results, or Long.MAX_VALUE for no limit.
FetchConfiguration	getFetchConfiguration() Return the (mutable) fetch configuration for this query.
String	getFilter() Return the filter that this query has been configured with.
Collection	getFilterListeners() Return the filter listeners added to this query, or empty collection if none.
String	getGrouping() Return the grouping expression for this query.
String[]	getGroupingClauses() Return the grouping expressions.
String	getHaving() Return the having clause.
boolean	getIgnoreCache()
String[]	getImportPackages() Return the import packages.
String	getImports() Return the import declaration.
String	getLanguage() Return the language of this query.
String	getOrdering() Return the ordering expression that this query was configured with.
String[]	getOrderingClauses() Return the ordering criteria.
String	getParameters() Return the declared parameters.
com.solarmetric.apache.commons.collections.map.LinkedMap	getParameterTypes() Return a map of parameter name to type for this query.
PersistenceManager	getPersistenceManager()
String	getQueryString() Return a single-string representation of the query, if applicable.
String	getResult() Return the result expression set for this query.
Class	getResultClass() Returns the result class that has been set through setResultClass(java.lang.Class), or null if none.
String[]	getResultClauses() Return the result expressions.
ResultPackerProvider	getResultPackerProvider() Returns the ResultPackerProvider currently in use by this query.
Class[]	getResultTypes() Return the type of each result clause.
long	getStartIndex() Return the 0-based start index for the returned results.
String	getVariables() Return the declared variables.
Map	getVariableTypes() Return a map of variable name to type for this query.
boolean	hasSubclasses() Whether query results will include subclasses of the candidate class.
boolean	isAggregate() Return true if the query is an aggregate.
boolean	isDistinct() Whether the result specifies that this is a distinct query.
boolean	isQueryStringPreferred() Return true if the preferred style of query representation is with a single query string.
boolean	isUnique() The unique flag.
void	lock() Synchronize on the query's internal lock.
void	removeAggregateListener(AggregateListener arg) Remove an aggregate listener from the query.
void	removeFilterListener(FilterListener arg) Remove a filter listener from the query.
void	setCandidates(Collection arg)
void	setCandidates(Extent arg)
void	setClass(Class arg)
void	setExtensions(Map arg) JDO 2.0 Preview.
void	setFilter(String arg)
void	setGrouping(String arg) JDO 2.0 Preview.
void	setIgnoreCache(boolean arg)
void	setOrdering(String arg)
void	setQuery(Object arg) Fill in query state from a query string or template.
void	setRange(long arg0, long arg1) JDO 2.0 Preview.
void	setResult(String arg) JDO 2.0 Preview.
void	setResultClass(Class arg) JDO 2.0 Preview.
void	setResultPackerProvider(ResultPackerProvider provider) Sets the ResultPackerProvider that this query should use.
void	setUnique(boolean arg) JDO 2.0 Preview.
void	unlock() Unlock the query's internal lock.

Methods inherited from class java.lang.Object

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

Field Detail

_delegate

protected final KodoQuerySPI _delegate

Constructor Detail

DelegatingKodoQuerySPI

protected DelegatingKodoQuerySPI(KodoQuerySPI delegate)

Method Detail

setClass

public void setClass(Class arg)

Specified by:

setClass in interface Query

setCandidates

public void setCandidates(Extent arg)

Specified by:

setCandidates in interface Query

setCandidates

public void setCandidates(Collection arg)

Specified by:

setCandidates in interface Query

setFilter

public void setFilter(String arg)

Specified by:

setFilter in interface Query

declareImports

public void declareImports(String arg)

Specified by:

declareImports in interface Query

declareParameters

public void declareParameters(String arg)

Specified by:

declareParameters in interface Query

declareVariables

public void declareVariables(String arg)

Specified by:

declareVariables in interface Query

setOrdering

public void setOrdering(String arg)

Specified by:

setOrdering in interface Query

setIgnoreCache

public void setIgnoreCache(boolean arg)

Specified by:

setIgnoreCache in interface Query

getIgnoreCache

public boolean getIgnoreCache()

Specified by:

getIgnoreCache in interface Query

compile

public void compile()

Specified by:

compile in interface Query

execute

public Object execute()

Specified by:

execute in interface Query

execute

public Object execute(Object arg)

Specified by:

execute in interface Query

execute

public Object execute(Object arg0,
                      Object arg1)

Specified by:

execute in interface Query

execute

public Object execute(Object arg0,
                      Object arg1,
                      Object arg2)

Specified by:

execute in interface Query

executeWithMap

public Object executeWithMap(Map arg)

Specified by:

executeWithMap in interface Query

executeWithArray

public Object executeWithArray(Object[] arg)

Specified by:

executeWithArray in interface Query

getPersistenceManager

public PersistenceManager getPersistenceManager()

Specified by:

getPersistenceManager in interface Query

close

public void close(Object arg)

Specified by:

close in interface Query

closeAll

public void closeAll()

Specified by:

closeAll in interface Query

closeResources

public void closeResources()

Description copied from interface: KodoQuerySPI

Close any results that are consuming resources. Allow results that are not consuming resources to remain open so that they continue to function normally.

Specified by:

closeResources in interface KodoQuerySPI

getLanguage

public String getLanguage()

Description copied from interface: KodoQuery

Return the language of this query.

Specified by:

getLanguage in interface KodoQuery

getFetchConfiguration

public FetchConfiguration getFetchConfiguration()

Description copied from interface: KodoQuery

Return the (mutable) fetch configuration for this query.

Specified by:

getFetchConfiguration in interface KodoQuery

getFilterListeners

public Collection getFilterListeners()

Description copied from interface: KodoQuery

Return the filter listeners added to this query, or empty collection if none.

Specified by:

getFilterListeners in interface KodoQuery

addFilterListener

public void addFilterListener(FilterListener arg)

Description copied from interface: KodoQuery

Register a filter listener for the query.

Specified by:

addFilterListener in interface KodoQuery

removeFilterListener

public void removeFilterListener(FilterListener arg)

Description copied from interface: KodoQuery

Remove a filter listener from the query.

Specified by:

removeFilterListener in interface KodoQuery

getAggregateListeners

public Collection getAggregateListeners()

Description copied from interface: KodoQuery

Return the aggregate listeners added to this query, or empty collection if none.

Specified by:

getAggregateListeners in interface KodoQuery

addAggregateListener

public void addAggregateListener(AggregateListener arg)

Description copied from interface: KodoQuery

Register an aggregate listener for the query.

Specified by:

addAggregateListener in interface KodoQuery

removeAggregateListener

public void removeAggregateListener(AggregateListener arg)

Description copied from interface: KodoQuery

Remove an aggregate listener from the query.

Specified by:

removeAggregateListener in interface KodoQuery

getDataStoreActions

public String[] getDataStoreActions(Map arg)

Description copied from interface: KodoQuery

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).

Specified by:

getDataStoreActions in interface KodoQuery

Following copied from interface: kodo.query.KodoQuery

Parameters:

params - the named parameter map for the query invocation

getCandidateExtent

public KodoExtent getCandidateExtent()

Description copied from interface: KodoQuery

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

Specified by:

getCandidateExtent in interface KodoQuery

getCandidateCollection

public Collection getCandidateCollection()

Description copied from interface: KodoQuery

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

Specified by:

getCandidateCollection in interface KodoQuery

getCandidateClass

public Class getCandidateClass()

Description copied from interface: KodoQuery

Return the class of the objects that this query will return, or null if this information is not available / not relevant.

Specified by:

getCandidateClass in interface KodoQuery

hasSubclasses

public boolean hasSubclasses()

Description copied from interface: KodoQuery

Whether query results will include subclasses of the candidate class.

Specified by:

hasSubclasses in interface KodoQuery

getQueryString

public String getQueryString()

Description copied from interface: KodoQuery

Return a single-string representation of the query, if applicable.

Specified by:

getQueryString in interface KodoQuery

getFilter

public String getFilter()

Description copied from interface: KodoQuery

Return the filter that this query has been configured with.

Specified by:

getFilter in interface KodoQuery

getOrdering

public String getOrdering()

Description copied from interface: KodoQuery

Return the ordering expression that this query was configured with.

Specified by:

getOrdering in interface KodoQuery

getImports

public String getImports()

Description copied from interface: KodoQuery

Return the import declaration.

Specified by:

getImports in interface KodoQuery

getParameters

public String getParameters()

Description copied from interface: KodoQuery

Return the declared parameters.

Specified by:

getParameters in interface KodoQuery

getVariables

public String getVariables()

Description copied from interface: KodoQuery

Return the declared variables.

Specified by:

getVariables in interface KodoQuery

setUnique

public void setUnique(boolean arg)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Specify that the query will return only 1 result, rather than a collection. The execute method will return null if the query result size is 0.

Specified by:

setUnique in interface KodoQuery

isUnique

public boolean isUnique()

Description copied from interface: KodoQuery

The unique flag.

Specified by:

isUnique in interface KodoQuery

setResult

public void setResult(String arg)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Configures what type of data this query should return. If this is unset or set to null, this query will return a list of the query's candidate class. Otherwise, this query will return aggregate function results and / or individual field values (projections).

Specified by:

setResult in interface KodoQuery

Following copied from interface: kodo.query.KodoQuery

Parameters:

result - optional "distinct" keyword, followed by a comma-delimited list of fields, functions on fields, or aggregate functions to return from this query

getResult

public String getResult()

Description copied from interface: KodoQuery

Return the result expression set for this query.

Specified by:

getResult in interface KodoQuery

setResultClass

public void setResultClass(Class arg)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Specify the type of object in which the result of invoking Query.execute() or one of its siblings. The behavior of this method depends the nature of the query being executed. In particular, if used in conjunction with KodoQuery.setResult(java.lang.String), the argument to this method should be Object[].class, a class with bean-like setters for each of the items listed in the result specification, or a class with a method called put with two Object arguments.

Specified by:

setResultClass in interface KodoQuery

getResultClass

public Class getResultClass()

Description copied from interface: KodoQuery

Returns the result class that has been set through KodoQuery.setResultClass(java.lang.Class), or null if none.

Specified by:

getResultClass in interface KodoQuery

setGrouping

public void setGrouping(String arg)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Set the grouping expressions, optionally including a "having" clause. When grouping is specified, each result expression must either be an expression contained in the grouping, or an aggregate evaluated once per group.

Specified by:

setGrouping in interface KodoQuery

Following copied from interface: kodo.query.KodoQuery

Parameters:

group - a comma-delimited list of expressions, optionally followed by the "having" keyword and a boolean expression

getGrouping

public String getGrouping()

Description copied from interface: KodoQuery

Return the grouping expression for this query.

Specified by:

getGrouping in interface KodoQuery

setRange

public void setRange(long arg0,
                     long arg1)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Set the range of results to return.

Specified by:

setRange in interface KodoQuery

Following copied from interface: kodo.query.KodoQuery

Parameters:

start - 0-based inclusive start index

end - 0-based exclusive end index, or Long.MAX_VALUE for no limit

getStartIndex

public long getStartIndex()

Description copied from interface: KodoQuery

Return the 0-based start index for the returned results.

Specified by:

getStartIndex in interface KodoQuery

getEndIndex

public long getEndIndex()

Description copied from interface: KodoQuery

Return the 0-based exclusive end index for the returned results, or Long.MAX_VALUE for no limit.

Specified by:

getEndIndex in interface KodoQuery

addExtension

public void addExtension(String arg0,
                         Object arg1)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Add an extension this query. Kodo recognizes the following extension keys; others will be ignored:

• kodo.FilterListener: Register a filter listener for this query; analogous to invoking KodoQuery.addFilterListener(kodo.query.FilterListener).
• kodo.AggregateListener: Register an aggregate listener for this query; analogous to invoking KodoQuery.addAggregateListener(kodo.query.AggregateListener).
• kodo.FetchPlan.<property>: Set the bean property of this query's fetch plan to the supplied value.

Specified by:

addExtension in interface KodoQuery

setExtensions

public void setExtensions(Map arg)

Description copied from interface: KodoQuery

JDO 2.0 Preview. Set multiple extensions, or use null to clear extensions. This includes removing added listeners and returning fetch configuration properties to their previous values.

Specified by:

setExtensions in interface KodoQuery

Following copied from interface: kodo.query.KodoQuery

See Also:

KodoQuery.addExtension(java.lang.String, java.lang.Object)

setQuery

public void setQuery(Object arg)

Description copied from interface: KodoQuerySPI

Fill in query state from a query string or template.

Specified by:

setQuery in interface KodoQuerySPI

isQueryStringPreferred

public boolean isQueryStringPreferred()

Description copied from interface: KodoQuerySPI

Return true if the preferred style of query representation is with a single query string.

Specified by:

isQueryStringPreferred in interface KodoQuerySPI

isAggregate

public boolean isAggregate()

Description copied from interface: KodoQuerySPI

Return true if the query is an aggregate.

Specified by:

isAggregate in interface KodoQuerySPI

getAccessPathMetaDatas

public ClassMetaData[] getAccessPathMetaDatas()

Description copied from interface: KodoQuerySPI

Return the classes that affect this query.

Specified by:

getAccessPathMetaDatas in interface KodoQuerySPI

getImportPackages

public String[] getImportPackages()

Description copied from interface: KodoQuerySPI

Return the import packages.

Specified by:

getImportPackages in interface KodoQuerySPI

getParameterTypes

public com.solarmetric.apache.commons.collections.map.LinkedMap getParameterTypes()

Description copied from interface: KodoQuerySPI

Return a map of parameter name to type for this query. The returned map will iterate in the order that the parameters were declared or, if they're implicit, used.

Specified by:

getParameterTypes in interface KodoQuerySPI

getVariableTypes

public Map getVariableTypes()

Description copied from interface: KodoQuerySPI

Return a map of variable name to type for this query.

Specified by:

getVariableTypes in interface KodoQuerySPI

getOrderingClauses

public String[] getOrderingClauses()

Description copied from interface: KodoQuerySPI

Return the ordering criteria.

Specified by:

getOrderingClauses in interface KodoQuerySPI

getAscending

public boolean[] getAscending()

Description copied from interface: KodoQuerySPI

Return wheher each ordering is ascending.

Specified by:

getAscending in interface KodoQuerySPI

getResultClauses

public String[] getResultClauses()

Description copied from interface: KodoQuerySPI

Return the result expressions.

Specified by:

getResultClauses in interface KodoQuerySPI

getResultTypes

public Class[] getResultTypes()

Description copied from interface: KodoQuerySPI

Return the type of each result clause.

Specified by:

getResultTypes in interface KodoQuerySPI

getAliases

public String[] getAliases()

Description copied from interface: KodoQuerySPI

Return the aliases for the result expressions.

Specified by:

getAliases in interface KodoQuerySPI

getAlias

public String getAlias()

Description copied from interface: KodoQuerySPI

When we're returning standard candidate instances rather than a projection or aggregate, return the alias for the instances in case a result class is set.

Specified by:

getAlias in interface KodoQuerySPI

isDistinct

public boolean isDistinct()

Description copied from interface: KodoQuerySPI

Whether the result specifies that this is a distinct query.

Specified by:

isDistinct in interface KodoQuerySPI

getGroupingClauses

public String[] getGroupingClauses()

Description copied from interface: KodoQuerySPI

Return the grouping expressions.

Specified by:

getGroupingClauses in interface KodoQuerySPI

getHaving

public String getHaving()

Description copied from interface: KodoQuerySPI

Return the having clause.

Specified by:

getHaving in interface KodoQuerySPI

lock

public void lock()

Description copied from interface: KodoQuerySPI

Synchronize on the query's internal lock.

Specified by:

lock in interface KodoQuerySPI

unlock

public void unlock()

Description copied from interface: KodoQuerySPI

Unlock the query's internal lock.

Specified by:

unlock in interface KodoQuerySPI

setResultPackerProvider

public void setResultPackerProvider(ResultPackerProvider provider)

Description copied from interface: KodoQuerySPI

Sets the ResultPackerProvider that this query should use.

Specified by:

setResultPackerProvider in interface KodoQuerySPI

getResultPackerProvider

public ResultPackerProvider getResultPackerProvider()

Description copied from interface: KodoQuerySPI

Returns the ResultPackerProvider currently in use by this query.

Specified by:

getResultPackerProvider in interface KodoQuerySPI