Query (GORM for Hibernate 5

org.grails.datastore.mapping.query.Query

All Implemented Interfaces and Traits:

java.lang.Cloneable
```
@java.lang.SuppressWarnings({"rawtypes", "unchecked"})
public abstract class Query
extends java.lang.Object
```
Models a query that can be executed against a data store.
Authors:
Graeme Rocher
Since:
1.0

Nested Class Summary

Nested classes
Modifiers	Name	Description
`static class`	`Query.AvgProjection`	Computes the average value of a property
`static class`	`Query.Between`	Criterion used to restrict the result to be between values (range query)
`static class`	`Query.Conjunction`	A Criterion used to combine to criterion in a logical AND
`static class`	`Query.CountDistinctProjection`
`static class`	`Query.CountProjection`	Used to count the results of a query
`static interface`	`Query.Criterion`	Represents a criterion to be used in a criteria query
`static class`	`Query.Disjunction`	A Criterion used to combine to criterion in a logical OR
`static class`	`Query.DistinctProjection`
`static class`	`Query.DistinctPropertyProjection`
`static class`	`Query.Equals`	A criterion that restricts the results based on equality
`static class`	`Query.EqualsAll`	Restricts a value to be equal to all the given values
`static class`	`Query.EqualsProperty`
`static class`	`Query.Exists`	Used for exists subquery
`static class`	`Query.GreaterThan`	Used to restrict a value to be greater than the given value
`static class`	`Query.GreaterThanAll`	Restricts a value to be greater than all the given values
`static class`	`Query.GreaterThanEquals`	Used to restrict a value to be greater than or equal to the given value
`static class`	`Query.GreaterThanEqualsAll`	Restricts a value to be greater than or equal to all the given values
`static class`	`Query.GreaterThanEqualsProperty`
`static class`	`Query.GreaterThanEqualsSome`	Restricts a value to be greater than some of the given values
`static class`	`Query.GreaterThanProperty`
`static class`	`Query.GreaterThanSome`	Restricts a value to be greater than some of the given values
`static class`	`Query.GroupPropertyProjection`
`static class`	`Query.ILike`	Criterion used to restrict the results based on a pattern (likeness)
`static class`	`Query.IdEquals`	A criterion that restricts the results based on the equality of the identifier
`static class`	`Query.IdProjection`	A projection used to obtain the identifier of an object
`static class`	`Query.In`	Criterion used to restrict the results based on a list of values
`static class`	`Query.IsEmpty`	Restricts a property to be empty (such as a blank string)
`static class`	`Query.IsNotEmpty`	Restricts a property to be empty (such as a blank string)
`static class`	`Query.IsNotNull`	Restricts a property to be not null
`static class`	`Query.IsNull`	Models a query that can be executed against a data store.
`static class`	`Query.Junction`
`static class`	`Query.LessThan`	Used to restrict a value to be less than the given value
`static class`	`Query.LessThanAll`	Restricts a value to be less than all the given values
`static class`	`Query.LessThanEquals`	Used to restrict a value to be less than the given value
`static class`	`Query.LessThanEqualsAll`	Restricts a value to be less than or equal to all the given values
`static class`	`Query.LessThanEqualsProperty`
`static class`	`Query.LessThanEqualsSome`	Restricts a value to be less than some of the given values
`static class`	`Query.LessThanProperty`
`static class`	`Query.LessThanSome`	Restricts a value to be less than some of the given values
`static class`	`Query.Like`	Criterion used to restrict the results based on a pattern (likeness)
`static class`	`Query.MaxProjection`	Computes the max value of a property
`static class`	`Query.MinProjection`	Computes the min value of a property
`static class`	`Query.Negation`	A criterion used to negate several other criterion
`static class`	`Query.NotEquals`	A criterion that restricts the results based on equality
`static class`	`Query.NotEqualsAll`	Restricts a value to be not equal to all the given values
`static class`	`Query.NotEqualsProperty`
`static class`	`Query.NotExists`	Used for exists subquery
`static class`	`Query.NotIn`	Criterion used to restrict the results based on a list of values
`static class`	`Query.Order`	The ordering of results.
`static class`	`Query.Projection`	A projection
`static class`	`Query.ProjectionList`	A list of projections
`static class`	`Query.PropertyComparisonCriterion`	A Criterion that compares to properties
`static class`	`Query.PropertyCriterion`	Criterion that applies to a property and value
`static class`	`Query.PropertyNameCriterion`	A Criterion that applies to a property
`static class`	`Query.PropertyProjection`	A projection that obtains the value of a property of an entity
`static class`	`Query.RLike`	Criterion used to restrict the results based on a regular expression pattern
`static class`	`Query.SizeEquals`
`static class`	`Query.SizeGreaterThan`
`static class`	`Query.SizeGreaterThanEquals`
`static class`	`Query.SizeLessThan`
`static class`	`Query.SizeLessThanEquals`
`static class`	`Query.SizeNotEquals`
`static class`	`Query.SubqueryCriterion`	Used to differentiate criterion that require a subquery
`static class`	`Query.SumProjection`	Computes the sum of a property

Field Summary

Fields
Modifiers	Name	Description
`protected Query.Junction`	`criteria`
`protected PersistentEntity`	`entity`
`protected java.util.Map<java.lang.String, javax.persistence.FetchType>`	`fetchStrategies`
`protected javax.persistence.LockModeType`	`lockResult`
`protected int`	`max`
`protected int`	`offset`
`protected java.util.List<Order>`	`orderBy`
`protected Query.ProjectionList`	`projections`
`protected java.lang.Boolean`	`queryCache`
`protected Session`	`session`
`protected boolean`	`uniqueResult`

Constructor Summary

Constructors
Constructor and description
`protected Query (Session session, PersistentEntity entity)`

Methods Summary

Methods
Type	Name and description
`void`	`add(Query.Criterion criterion)` Adds the specified criterion instance to the query
`void`	`add(Query.Junction currentJunction, Query.Criterion criterion)` Adds the specified criterion instance to the given junction
`Query`	`allEq(java.util.Map<java.lang.String, java.lang.Object> values)` Shortcut to restrict the query to multiple given property values
`Query`	`and(Query.Criterion a, Query.Criterion b)` Creates a conjunction using two specified criterion
`Query`	`between(java.lang.String property, java.lang.Object start, java.lang.Object end)` Restricts the results by the given property value range
`Query`	`cache(boolean cache)` Specifies whether the query results should be cached (if supported by the underlying datastore)
`java.lang.Object`	`clone()`
`Query.Junction`	`conjunction()` Creates a conjunction (AND) query
`AssociationQuery`	`createQuery(java.lang.String associationName)` Creates an association query
`Query.Junction`	`disjunction()` Creates a disjunction (OR) query
`Query`	`eq(java.lang.String property, java.lang.Object value)` Restricts the results by the given properties value
`protected java.util.List`	`executeQuery(PersistentEntity entity, Query.Junction criteria)` Subclasses should implement this to provide the concrete implementation of querying
`protected javax.persistence.FetchType`	`fetchStrategy(java.lang.String property)` Obtain the fetch strategy for the given property
`Query`	`firstResult(int offset)` Defines the offset (the first result index) of the query
`protected void`	`flushBeforeQuery()` Default behavior is the flush the session before a query in the case of FlushModeType.AUTO.
`Query`	`ge(java.lang.String property, java.lang.Object value)` Used to restrict a value to be greater than or equal to the given value
`Query.Junction`	`getCriteria()` @return The criteria defined by this query
`PersistentEntity`	`getEntity()` @return The PersistentEntity being query
`java.util.List<Order>`	`getOrderBy()` Gets the Order entries for this query
`Session`	`getSession()` @return The session that created the query
`Query`	`gt(java.lang.String property, java.lang.Object value)` Used to restrict a value to be greater than the given value
`Query`	`gte(java.lang.String property, java.lang.Object value)` Used to restrict a value to be greater than or equal to the given value
`Query`	`idEq(java.lang.Object value)` Restricts the results by the given properties value
`Query`	`ilike(java.lang.String property, java.lang.String expr)` Restricts the results by the given properties value
`Query`	`in(java.lang.String property, java.util.List values)` Restricts the results by the given property values
`Query`	`isEmpty(java.lang.String property)` Used to restrict a value to be empty (such as a blank string or an empty collection)
`Query`	`isNotEmpty(java.lang.String property)` Used to restrict a value to be not empty (such as a blank string or an empty collection)
`Query`	`isNotNull(java.lang.String property)` Used to restrict a property to be not null
`Query`	`isNull(java.lang.String property)` Used to restrict a property to be null
`Query`	`join(java.lang.String property)` Specifies whether a join query should be used (if join queries are supported by the underlying datastore)
`Query`	`le(java.lang.String property, java.lang.Object value)` Used to restrict a value to be less than or equal to the given value
`Query`	`like(java.lang.String property, java.lang.String expr)` Restricts the results by the given properties value
`java.util.List`	`list()` Executes the query returning zero or many results as a list.
`Query`	`lock(boolean lock)` Specifies whether the query should obtain a pessimistic lock
`Query`	`lock(javax.persistence.LockModeType lock)` Specifies whether the query should obtain a pessimistic lock
`Query`	`lt(java.lang.String property, java.lang.Object value)` Used to restrict a value to be less than the given value
`Query`	`lte(java.lang.String property, java.lang.Object value)` Used to restrict a value to be less than or equal to the given value
`Query`	`max(int max)` Defines the maximum number of results to return
`Query`	`maxResults(int max)` Defines the maximum number of results to return
`Query.Junction`	`negation()` Creates a negation of several criterion
`Query`	`offset(int offset)` Defines the offset (the first result index) of the query
`Query`	`or(Query.Criterion a, Query.Criterion b)` Creates a disjunction using two specified criterion
`Query`	`order(Query.Order order)` Specifies the order of results
`static java.lang.String`	`patternToRegex(java.lang.Object value)` Converts a pattern to regex for regex queruies
`Query.ProjectionList`	`projections()`
`protected java.lang.Object`	`resolveIdIfEntity(java.lang.Object value)`
`Query`	`rlike(java.lang.String property, java.lang.String expr)` Restricts the results by the given properties value
`Query`	`select(java.lang.String property)` Specifies whether a select (lazy) query should be used (if join queries are supported by the underlying datastore)
`void`	`setUniqueResult(boolean uniqueResult)` Here purely for compatibility
`java.lang.Object`	`singleResult()` Executes the query returning a single result or null

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class java.lang.Object`	`java.lang.Object#wait(long, int), java.lang.Object#wait(long), java.lang.Object#wait(), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()`

- Field Detail
  - protected Query.Junction criteria
  - protected final PersistentEntity entity
  - protected java.util.Map<java.lang.String, javax.persistence.FetchType> fetchStrategies
  - protected javax.persistence.LockModeType lockResult
  - protected int max
  - protected int offset
  - protected java.util.List<Order> orderBy
  - protected Query.ProjectionList projections
  - protected java.lang.Boolean queryCache
  - protected final Session session
  - protected boolean uniqueResult
- Constructor Detail
  - protected Query(Session session, PersistentEntity entity)
- Method Detail
  - public void add(Query.Criterion criterion)
    
    Adds the specified criterion instance to the query
    Parameters:
    criterion - The criterion instance
  - public void add(Query.Junction currentJunction, Query.Criterion criterion)
    
    Adds the specified criterion instance to the given junction
    Parameters:
    currentJunction - The junction to add the criterion to
    criterion - The criterion instance
  - public Query allEq(java.util.Map<java.lang.String, java.lang.Object> values)
    
    Shortcut to restrict the query to multiple given property values
    Returns:
    This query instance
    Parameters:
    values - The values
  - public Query and(Query.Criterion a, Query.Criterion b)
    
    Creates a conjunction using two specified criterion
    Returns:
    This query instance
    Parameters:
    a - The left hand side
    b - The right hand side
  - public Query between(java.lang.String property, java.lang.Object start, java.lang.Object end)
    
    Restricts the results by the given property value range
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    start - The start of the range
    end - The end of the range
  - public Query cache(boolean cache)
    
    Specifies whether the query results should be cached (if supported by the underlying datastore)
    Returns:
    The query
    Parameters:
    cache - True if caching should be enabled
  - @java.lang.Override public java.lang.Object clone()
  - public Query.Junction conjunction()
    
    Creates a conjunction (AND) query
    Returns:
    The Junction instance
  - public AssociationQuery createQuery(java.lang.String associationName)
    
    Creates an association query
    Returns:
    The Query instance
    Parameters:
    associationName - The assocation name
  - public Query.Junction disjunction()
    
    Creates a disjunction (OR) query
    Returns:
    The Junction instance
  - public Query eq(java.lang.String property, java.lang.Object value)
    
    Restricts the results by the given properties value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - protected java.util.List executeQuery(PersistentEntity entity, Query.Junction criteria)
    
    Subclasses should implement this to provide the concrete implementation of querying
    Returns:
    The results
    Parameters:
    entity - The entity
    criteria - The criteria
  - protected javax.persistence.FetchType fetchStrategy(java.lang.String property)
    
    Obtain the fetch strategy for the given property
    Returns:
    A specific strategy or lazy by default
    Parameters:
    property - The fetch strategy
  - public Query firstResult(int offset)
    
    Defines the offset (the first result index) of the query
    Returns:
    This query instance
    Parameters:
    offset - The offset
  - protected void flushBeforeQuery()
    
    Default behavior is the flush the session before a query in the case of FlushModeType.AUTO. Subclasses can override this method to disable that.
  - public Query ge(java.lang.String property, java.lang.Object value)
    
    Used to restrict a value to be greater than or equal to the given value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - public Query.Junction getCriteria()
    
    Returns:
    The criteria defined by this query
  - public PersistentEntity getEntity()
    
    Returns:
    The PersistentEntity being query
  - public java.util.List<Order> getOrderBy()
    
    Gets the Order entries for this query
    Returns:
    The order entries
  - public Session getSession()
    
    Returns:
    The session that created the query
  - public Query gt(java.lang.String property, java.lang.Object value)
    
    Used to restrict a value to be greater than the given value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - public Query gte(java.lang.String property, java.lang.Object value)
    
    Used to restrict a value to be greater than or equal to the given value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - public Query idEq(java.lang.Object value)
    
    Restricts the results by the given properties value
    Returns:
    This query instance
    Parameters:
    value - The value to restrict by
  - public Query ilike(java.lang.String property, java.lang.String expr)
    
    Restricts the results by the given properties value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    expr - The expression to restrict by
  - public Query in(java.lang.String property, java.util.List values)
    
    Restricts the results by the given property values
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    values - The values to restrict by
  - public Query isEmpty(java.lang.String property)
    
    Used to restrict a value to be empty (such as a blank string or an empty collection)
    Parameters:
    property - The property name
  - public Query isNotEmpty(java.lang.String property)
    
    Used to restrict a value to be not empty (such as a blank string or an empty collection)
    Parameters:
    property - The property name
  - public Query isNotNull(java.lang.String property)
    
    Used to restrict a property to be not null
    Parameters:
    property - The property name
  - public Query isNull(java.lang.String property)
    
    Used to restrict a property to be null
    Parameters:
    property - The property name
  - public Query join(java.lang.String property)
    
    Specifies whether a join query should be used (if join queries are supported by the underlying datastore)
    Returns:
    The query
    Parameters:
    property - The property
  - public Query le(java.lang.String property, java.lang.Object value)
    
    Used to restrict a value to be less than or equal to the given value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - public Query like(java.lang.String property, java.lang.String expr)
    
    Restricts the results by the given properties value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    expr - The expression to restrict by
  - public java.util.List list()
    
    Executes the query returning zero or many results as a list.
    Returns:
    The results
  - public Query lock(boolean lock)
    
    Specifies whether the query should obtain a pessimistic lock
    Returns:
    The query
    Parameters:
    lock - True if a lock should be obtained
  - public Query lock(javax.persistence.LockModeType lock)
    
    Specifies whether the query should obtain a pessimistic lock
    Returns:
    The query
    Parameters:
    lock - True if a lock should be obtained
  - public Query lt(java.lang.String property, java.lang.Object value)
    
    Used to restrict a value to be less than the given value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - public Query lte(java.lang.String property, java.lang.Object value)
    
    Used to restrict a value to be less than or equal to the given value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    value - The value to restrict by
  - public Query max(int max)
    
    Defines the maximum number of results to return
    Returns:
    This query instance
    Parameters:
    max - The max results
  - public Query maxResults(int max)
    
    Defines the maximum number of results to return
    Returns:
    This query instance
    Parameters:
    max - The max results
  - public Query.Junction negation()
    
    Creates a negation of several criterion
    Returns:
    The negation
  - public Query offset(int offset)
    
    Defines the offset (the first result index) of the query
    Returns:
    This query instance
    Parameters:
    offset - The offset
  - public Query or(Query.Criterion a, Query.Criterion b)
    
    Creates a disjunction using two specified criterion
    Returns:
    This query instance
    Parameters:
    a - The left hand side
    b - The right hand side
  - public Query order(Query.Order order)
    
    Specifies the order of results
    Returns:
    The Query instance
    Parameters:
    order - The order object
  - public static java.lang.String patternToRegex(java.lang.Object value)
    
    Converts a pattern to regex for regex queruies
    Returns:
    The pattern
    Parameters:
    value - The value
  - public Query.ProjectionList projections()
  - protected java.lang.Object resolveIdIfEntity(java.lang.Object value)
  - public Query rlike(java.lang.String property, java.lang.String expr)
    
    Restricts the results by the given properties value
    Returns:
    This query instance
    Parameters:
    property - The name of the property
    expr - The expression to restrict by
  - public Query select(java.lang.String property)
    
    Specifies whether a select (lazy) query should be used (if join queries are supported by the underlying datastore)
    Returns:
    The query
    Parameters:
    property - The property
  - @java.lang.Deprecated public void setUniqueResult(boolean uniqueResult)
    
    Here purely for compatibility
    deprecated:
    
    Parameters:
    uniqueResult - Whether it is a unique result
  - public java.lang.Object singleResult()
    
    Executes the query returning a single result or null
    Returns:
    The result

| Detail:
Field
Constructor
Method

[Java] Class Query

Nested Class Summary

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

protected Query.Junction criteria

protected final PersistentEntity entity

protected java.util.Map<java.lang.String, javax.persistence.FetchType> fetchStrategies

protected javax.persistence.LockModeType lockResult

protected int max

protected int offset

protected java.util.List<Order> orderBy

protected Query.ProjectionList projections

protected java.lang.Boolean queryCache

protected final Session session

protected boolean uniqueResult

Constructor Detail

protected Query(Session session, PersistentEntity entity)

Method Detail

public void add(Query.Criterion criterion)

public void add(Query.Junction currentJunction, Query.Criterion criterion)

public Query allEq(java.util.Map<java.lang.String, java.lang.Object> values)

public Query and(Query.Criterion a, Query.Criterion b)

public Query between(java.lang.String property, java.lang.Object start, java.lang.Object end)

public Query cache(boolean cache)

@java.lang.Override public java.lang.Object clone()

public Query.Junction conjunction()

public AssociationQuery createQuery(java.lang.String associationName)

public Query.Junction disjunction()

public Query eq(java.lang.String property, java.lang.Object value)

protected java.util.List executeQuery(PersistentEntity entity, Query.Junction criteria)

protected javax.persistence.FetchType fetchStrategy(java.lang.String property)

public Query firstResult(int offset)

protected void flushBeforeQuery()

public Query ge(java.lang.String property, java.lang.Object value)

public Query.Junction getCriteria()

public PersistentEntity getEntity()

public java.util.List<Order> getOrderBy()

public Session getSession()

public Query gt(java.lang.String property, java.lang.Object value)

public Query gte(java.lang.String property, java.lang.Object value)

public Query idEq(java.lang.Object value)

public Query ilike(java.lang.String property, java.lang.String expr)

public Query in(java.lang.String property, java.util.List values)

public Query isEmpty(java.lang.String property)

public Query isNotEmpty(java.lang.String property)

public Query isNotNull(java.lang.String property)

public Query isNull(java.lang.String property)

public Query join(java.lang.String property)

public Query le(java.lang.String property, java.lang.Object value)

public Query like(java.lang.String property, java.lang.String expr)

public java.util.List list()

public Query lock(boolean lock)

public Query lock(javax.persistence.LockModeType lock)

public Query lt(java.lang.String property, java.lang.Object value)

public Query lte(java.lang.String property, java.lang.Object value)

public Query max(int max)

public Query maxResults(int max)

public Query.Junction negation()

public Query offset(int offset)

public Query or(Query.Criterion a, Query.Criterion b)

public Query order(Query.Order order)

public static java.lang.String patternToRegex(java.lang.Object value)

public Query.ProjectionList projections()

protected java.lang.Object resolveIdIfEntity(java.lang.Object value)

public Query rlike(java.lang.String property, java.lang.String expr)

public Query select(java.lang.String property)

@java.lang.Deprecated public void setUniqueResult(boolean uniqueResult)

public java.lang.Object singleResult()