com.mysema.query.jdo

Class AbstractJDOQuery<Q extends AbstractJDOQuery<Q>>

java.lang.Object

com.mysema.query.support.QueryBase<Q>

com.mysema.query.support.ProjectableQuery<Q>

com.mysema.query.jdo.AbstractJDOQuery<Q>

Type Parameters:

Q -

All Implemented Interfaces:

Projectable

Direct Known Subclasses:

JDOQuery

public abstract class AbstractJDOQuery<Q extends AbstractJDOQuery<Q>>
extends ProjectableQuery<Q>

Abstract base class for custom implementations of the JDOCommonQuery interface.

Author:

tiwe

Field Summary

Fields

Modifier and Type	Field and Description
protected Set<String>	fetchGroups
protected Integer	maxFetchDepth

Fields inherited from class com.mysema.query.support.QueryBase

queryMixin

Constructor Summary

Constructors

Constructor and Description
AbstractJDOQuery(javax.jdo.PersistenceManager persistenceManager)
AbstractJDOQuery(javax.jdo.PersistenceManager persistenceManager, JDOQLTemplates templates, QueryMetadata metadata, boolean detach)

Method Summary

Methods

Modifier and Type	Method and Description
Q	addFetchGroup(String fetchGroupName) Add the fetch group to the set of active fetch groups.
void	close() Close the query and related resources
long	count() return the amount of matched rows
boolean	exists()
Q	from(EntityPath<?>... args)
QueryMetadata	getMetadata()
JDOQLTemplates	getTemplates()
boolean	isDetach()
com.mysema.commons.lang.CloseableIterator<Tuple>	iterate(Expression<?>... args) iterate over the results for the given projection
<RT> com.mysema.commons.lang.CloseableIterator<RT>	iterate(Expression<RT> projection) iterate over the results for the given projection
List<Tuple>	list(Expression<?>... args) list the results for the given projection An empty list is returned for no results.
<RT> List<RT>	list(Expression<RT> expr) list the results for the given projection An empty list is returned for no results.
SearchResults<Tuple>	listResults(Expression<?>... args) list the results for the given projection
<RT> SearchResults<RT>	listResults(Expression<RT> expr) list the results for the given projection
protected void	logQuery(String queryString)
Q	setMaxFetchDepth(int depth) Set the maximum fetch depth when fetching.
String	toString()
Tuple	uniqueResult(Expression<?>... args) return a unique result for the given projection or null if no result is found
<RT> RT	uniqueResult(Expression<RT> expr) return a unique result for the given projection or null if no result is found

Methods inherited from class com.mysema.query.support.ProjectableQuery

countDistinct, iterateDistinct, iterateDistinct, listDistinct, listDistinct, listDistinctResults, map, notExists, singleResult, singleResult, transform, uniqueResult

Methods inherited from class com.mysema.query.support.QueryBase

distinct, equals, groupBy, groupBy, hashCode, having, having, limit, offset, orderBy, orderBy, restrict, set, where, where

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

fetchGroups

protected final Set<String> fetchGroups

maxFetchDepth

@Nullable
protected Integer maxFetchDepth

Constructor Detail

AbstractJDOQuery

public AbstractJDOQuery(@Nullable
                javax.jdo.PersistenceManager persistenceManager)

AbstractJDOQuery

public AbstractJDOQuery(@Nullable
                javax.jdo.PersistenceManager persistenceManager,
                JDOQLTemplates templates,
                QueryMetadata metadata,
                boolean detach)

Method Detail

addFetchGroup

public Q addFetchGroup(String fetchGroupName)

Add the fetch group to the set of active fetch groups.

Parameters:

string -

Returns:

close

public void close()

Close the query and related resources

count

public long count()

Description copied from interface: Projectable

return the amount of matched rows

exists

public boolean exists()

Returns:

true, if rows matching the given criteria exist, otherwise false

logQuery

protected void logQuery(String queryString)

from

public Q from(EntityPath<?>... args)

getMetadata

public QueryMetadata getMetadata()

getTemplates

public JDOQLTemplates getTemplates()

isDetach

public boolean isDetach()

iterate

public com.mysema.commons.lang.CloseableIterator<Tuple> iterate(Expression<?>... args)

Description copied from interface: Projectable

iterate over the results for the given projection

Returns:

iterate

public <RT> com.mysema.commons.lang.CloseableIterator<RT> iterate(Expression<RT> projection)

Description copied from interface: Projectable

iterate over the results for the given projection

Type Parameters:

RT - generic type of the Iterator

Returns:

an Iterator over the projection

list

public List<Tuple> list(Expression<?>... args)

Description copied from interface: Projectable

list the results for the given projection An empty list is returned for no results.

Specified by:

list in interface Projectable

Overrides:

list in class ProjectableQuery<Q extends AbstractJDOQuery<Q>>

Returns:

list

public <RT> List<RT> list(Expression<RT> expr)

Description copied from interface: Projectable

list the results for the given projection An empty list is returned for no results.

Specified by:

list in interface Projectable

Overrides:

list in class ProjectableQuery<Q extends AbstractJDOQuery<Q>>

Type Parameters:

RT - generic type of the List

Returns:

a List over the projection

listResults

public SearchResults<Tuple> listResults(Expression<?>... args)

Description copied from interface: Projectable

list the results for the given projection

Returns:

listResults

public <RT> SearchResults<RT> listResults(Expression<RT> expr)

Description copied from interface: Projectable

list the results for the given projection

Returns:

setMaxFetchDepth

public Q setMaxFetchDepth(int depth)

Set the maximum fetch depth when fetching. A value of 0 has no meaning and will throw a JDOUserException. A value of -1 means that no limit is placed on fetching. A positive integer will result in that number of references from the initial object to be fetched.

Parameters:

maxFetchDepth -

Returns:

toString

public String toString()

Overrides:

toString in class QueryBase<Q extends AbstractJDOQuery<Q>>

uniqueResult

@Nullable
public Tuple uniqueResult(Expression<?>... args)

Description copied from interface: Projectable

return a unique result for the given projection or null if no result is found

There is some ambiguity for missing results and null valued results, for disambiguation use the list or iterate methods instead.

Returns:

uniqueResult

@Nullable
public <RT> RT uniqueResult(Expression<RT> expr)

Description copied from interface: Projectable

return a unique result for the given projection or null if no result is found

There is some ambiguity for missing results and null valued results, for disambiguation use the list or iterate methods instead.

Type Parameters:

RT - return type

Returns:

the result or null for an empty result