com.mysema.query.jdo.sql

Class JDOSQLQuery

java.lang.Object

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

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

com.mysema.query.jdo.sql.AbstractSQLQuery<JDOSQLQuery>

com.mysema.query.jdo.sql.JDOSQLQuery

All Implemented Interfaces:

FilteredClause<JDOSQLQuery>, Projectable, Query<JDOSQLQuery>, SimpleQuery<JDOSQLQuery>, SQLCommonQuery<JDOSQLQuery>

public final class JDOSQLQuery
extends AbstractSQLQuery<JDOSQLQuery>
implements SQLCommonQuery<JDOSQLQuery>

JDOSQLQuery is an SQLQuery implementation that uses JDO's SQL query functionality to execute queries

Author:

tiwe

Field Summary

Fields inherited from class com.mysema.query.jdo.sql.AbstractSQLQuery

configuration, queryMixin, union, unionAll

Constructor Summary

Constructors

Constructor and Description
JDOSQLQuery(javax.jdo.PersistenceManager persistenceManager, Configuration configuration)
JDOSQLQuery(javax.jdo.PersistenceManager persistenceManager, Configuration configuration, QueryMetadata metadata, boolean detach)
JDOSQLQuery(javax.jdo.PersistenceManager persistenceManager, SQLTemplates templates)

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
long	count() return the amount of matched rows
QueryMetadata	getMetadata()
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
java.util.List<Tuple>	list(Expression<?>... args) list the results for the given projection An empty list is returned for no results.
<RT> java.util.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
java.lang.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.jdo.sql.AbstractSQLQuery

addFlag, addFlag, addFlag, addJoinFlag, addJoinFlag, exists, from, from, from, fullJoin, fullJoin, fullJoin, fullJoin, innerJoin, innerJoin, innerJoin, innerJoin, join, join, join, join, leftJoin, leftJoin, leftJoin, leftJoin, on, on, rightJoin, rightJoin, rightJoin, rightJoin, union, union, union, union, unionAll, unionAll, unionAll, unionAll

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

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

Methods inherited from interface com.mysema.query.sql.SQLCommonQuery

addFlag, addFlag, addFlag, addJoinFlag, addJoinFlag, from, from, fullJoin, fullJoin, fullJoin, fullJoin, innerJoin, innerJoin, innerJoin, innerJoin, join, join, join, join, leftJoin, leftJoin, leftJoin, leftJoin, on, rightJoin, rightJoin, rightJoin, rightJoin

Methods inherited from interface com.mysema.query.Query

groupBy, having

Methods inherited from interface com.mysema.query.SimpleQuery

distinct, limit, offset, orderBy, restrict, set

Methods inherited from interface com.mysema.query.FilteredClause

where

Constructor Detail

JDOSQLQuery

public JDOSQLQuery(@Nullable
           javax.jdo.PersistenceManager persistenceManager,
           SQLTemplates templates)

JDOSQLQuery

public JDOSQLQuery(@Nullable
           javax.jdo.PersistenceManager persistenceManager,
           Configuration configuration)

JDOSQLQuery

public JDOSQLQuery(@Nullable
           javax.jdo.PersistenceManager persistenceManager,
           Configuration configuration,
           QueryMetadata metadata,
           boolean detach)

Method Detail

close

public void close()

count

public long count()

Description copied from interface: Projectable

return the amount of matched rows

Specified by:

count in interface Projectable

Overrides:

count in class AbstractSQLQuery<JDOSQLQuery>

getMetadata

public QueryMetadata getMetadata()

Overrides:

getMetadata in class AbstractSQLQuery<JDOSQLQuery>

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

Specified by:

iterate in interface Projectable

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

Specified by:

iterate in interface Projectable

Type Parameters:

RT - generic type of the Iterator

Returns:

an Iterator over the projection

list

public java.util.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<JDOSQLQuery>

Returns:

list

public <RT> java.util.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<JDOSQLQuery>

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

Specified by:

listResults in interface Projectable

Returns:

listResults

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

Description copied from interface: Projectable

list the results for the given projection

Specified by:

listResults in interface Projectable

Returns:

toString

public java.lang.String toString()

Overrides:

toString in class QueryBase<JDOSQLQuery>

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.

Specified by:

uniqueResult in interface Projectable

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.

Specified by:

uniqueResult in interface Projectable

Type Parameters:

RT - return type

Returns:

the result or null for an empty result