Package ch.tocco.nice2.persist.core.impl.hibernate.pojo.relation

Class ToManyRelationQueryAdapter

java.lang.Object

ch.tocco.nice2.persist.core.spi.entity.query.ql.AbstractOrderableQuery

ch.tocco.nice2.persist.core.impl.hibernate.pojo.relation.AbstractRelationQueryAdapter

ch.tocco.nice2.persist.core.impl.hibernate.pojo.relation.ToManyRelationQueryAdapter

All Implemented Interfaces:

Query, RelationQuery

public class ToManyRelationQueryAdapter
extends AbstractRelationQueryAdapter

Maps a to-many hibernate collection the RelationQuery interface

Nested Class Summary

Nested classes/interfaces inherited from interface ch.tocco.nice2.persist.core.api.query.Query

Query.Mode

Field Summary

Fields inherited from class ch.tocco.nice2.persist.core.impl.hibernate.pojo.relation.AbstractRelationQueryAdapter

relationModel, sourceEntity

Fields inherited from class ch.tocco.nice2.persist.core.spi.entity.query.ql.AbstractOrderableQuery

ordering

Constructor Summary

Constructors

Constructor	Description
ToManyRelationQueryAdapter(Entity sourceEntity, RelationModel relationModel, Set<Entity> entities, EntityInterceptor entityInterceptor, EntityContext sourceEntityContext)

Method Summary

Modifier and Type	Method	Description
int	count()	Currently badly implemented! Count the results.
Relation	execute(Pagination pagination, Query.Mode mode)	Execute the query using the specified pagination parameters in the specified Query.Mode.
Entity	firstResult()	Executes and returns the first selected Entity by this query, or throws.
@Nullable Entity	firstResultOrNull()	Executes and returns the first selected Entity by this query, or null if none.
Entity	getOnlyResult()	Executes and returns the single selected Entity by this query, or throws.
@Nullable Entity	getOnlyResultOrNull()	Executes and returns the single selected Entity by this query, or null if none, or throws.
Entity	uniqueResult()	Executes and returns the single selected Entity by this query, or throws.
@Nullable Entity	uniqueResultOrNull()	Executes and returns the single selected Entity by this query, or null if none, or throws.

Methods inherited from class ch.tocco.nice2.persist.core.impl.hibernate.pojo.relation.AbstractRelationQueryAdapter

execute, execute, execute, execute, execute, getManager, getOnlyResult, getOnlyResultOrNull, getRelationModel, getSource, setParameter, toQueryDefinition

Methods inherited from class ch.tocco.nice2.persist.core.spi.entity.query.ql.AbstractOrderableQuery

appendOrder, getOrdering, hasOrdering, prependOrder, withOrder

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.tocco.nice2.persist.core.api.query.Query

appendOrder, getKeys, getKeys, getOrdering, hasOrdering, prependOrder, withOrder

Constructor Details

ToManyRelationQueryAdapter

public ToManyRelationQueryAdapter(Entity sourceEntity,
 RelationModel relationModel,
 Set<Entity> entities,
 EntityInterceptor entityInterceptor,
 EntityContext sourceEntityContext)

Method Details

execute

public Relation execute(Pagination pagination,
 Query.Mode mode)

Description copied from interface: Query

Execute the query using the specified pagination parameters in the specified Query.Mode.

Parameters:

pagination - The offset and limit of the query.

mode - The mode.

Returns:

The result of the query.

uniqueResult

public Entity uniqueResult()

Description copied from interface: Query

Executes and returns the single selected Entity by this query, or throws.

Returns:

The single selected Entity.

See Also:

• Query.uniqueResultOrNull()

uniqueResultOrNull

@Nullable
public @Nullable Entity uniqueResultOrNull()

Description copied from interface: Query

Executes and returns the single selected Entity by this query, or null if none, or throws.

Returns:

The single selected Entity, or null if none.

See Also:

• Query.uniqueResult()

firstResult

public Entity firstResult()

Description copied from interface: Query

Executes and returns the first selected Entity by this query, or throws.

Returns:

The first selected Entity.

See Also:

• Query.firstResultOrNull()

firstResultOrNull

@Nullable
public @Nullable Entity firstResultOrNull()

Description copied from interface: Query

Executes and returns the first selected Entity by this query, or null if none.

Returns:

The first selected Entity, or null if none.

See Also:

• Query.firstResult()

getOnlyResult

public Entity getOnlyResult()

Description copied from interface: Query

Executes and returns the single selected Entity by this query, or throws.

Returns:

The single selected Entity.

See Also:

• Query.uniqueResultOrNull()

getOnlyResultOrNull

@Nullable
public @Nullable Entity getOnlyResultOrNull()

Description copied from interface: Query

Executes and returns the single selected Entity by this query, or null if none, or throws.

Returns:

The single selected Entity, or null if none.

See Also:

• Query.uniqueResult()

count

public int count()

Description copied from interface: Query

Currently badly implemented! Count the results.

WARNING: This method does not behave as "SELECT count()" in SQL does! In fact it is temporarily implemented as a chaining of execute().size() only. No query modification is done etc. ALSO, the default query limit is used and thus if there would be more records, only the default limit is returned. The impl may be rewritten to be what one would expect; until then users may only use this method if they can live with today's limits: small counts.

Speed of "SELECT count()" greatly depends on the underlying db table impl. An example are the two MySQL table types MyISAM and InnoDB. A query-less count on the former returns instantly because it keeps track of the number, whereas the latter needs to iterate over all records (at least in case of non-fixed length record tables) and can take minutes depending on the size.

Returns:

The count.