Class ToOneRelationQueryAdapter

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

All Implemented Interfaces:

Query, RelationQuery

public class ToOneRelationQueryAdapter
extends AbstractRelationQueryAdapter

Maps a to-one hibernate collection the RelationQuery interface

Nested Class Summary

Nested classes/interfaces inherited from interface Query

Query.Mode

Field Summary

Fields inherited from class AbstractRelationQueryAdapter

relationModel, sourceEntity

Fields inherited from class AbstractOrderableQuery

ordering

Constructor Summary

Constructors

Constructor	Description
ToOneRelationQueryAdapter(Entity sourceEntity, RelationModel relationModel, EntityFacadeListenerManager entityFacadeListenerManager, EntityInterceptor entityInterceptor, PropertyAccessorService propertyAccessorService)

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.
protected @Nullable Entity	getValue()
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 AbstractRelationQueryAdapter

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

Methods inherited from class AbstractOrderableQuery

appendOrder, getOrdering, hasOrdering, prependOrder, withOrder

Methods inherited from class Object

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

Methods inherited from interface Query

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

Constructor Details

ToOneRelationQueryAdapter

public ToOneRelationQueryAdapter(Entity sourceEntity,
 RelationModel relationModel,
 EntityFacadeListenerManager entityFacadeListenerManager,
 EntityInterceptor entityInterceptor,
 PropertyAccessorService propertyAccessorService)

Method Details

getValue

@Nullable
protected @Nullable Entity getValue()

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.