DynamicFinder (GORM for Hibernate 5

org.grails.datastore.gorm.finders.DynamicFinder

All Implemented Interfaces and Traits:: QueryBuildingFinder

@java.lang.SuppressWarnings({"rawtypes", "unchecked"})
public abstract class DynamicFinder
extends AbstractFinder
implements QueryBuildingFinder

Abstract base class for dynamic finders.

Authors:: Graeme Rocher

Since:: 1.0

Field Summary

Fields
Modifiers	Name	Description
`static java.lang.String`	`ARGUMENT_CACHE`
`static java.lang.String`	`ARGUMENT_FETCH`
`static java.lang.String`	`ARGUMENT_FETCH_SIZE`
`static java.lang.String`	`ARGUMENT_FLUSH_MODE`
`static java.lang.String`	`ARGUMENT_IGNORE_CASE`
`static java.lang.String`	`ARGUMENT_LOCK`
`static java.lang.String`	`ARGUMENT_MAX`
`static java.lang.String`	`ARGUMENT_OFFSET`
`static java.lang.String`	`ARGUMENT_ORDER`
`static java.lang.String`	`ARGUMENT_READ_ONLY`
`static java.lang.String`	`ARGUMENT_SORT`
`static java.lang.String`	`ARGUMENT_TIMEOUT`
`static java.lang.String`	`ORDER_ASC`
`static java.lang.String`	`ORDER_DESC`
`protected MappingContext`	`mappingContext`
`protected java.util.regex.Pattern`	`pattern`

Inherited fields
Fields inherited from class	Fields
`class AbstractFinder`	`datastore`

Constructor Summary

Constructors
Constructor and description
`protected DynamicFinder(java.util.regex.Pattern pattern, java.lang.String[] operators, Datastore datastore)`
`protected DynamicFinder(java.util.regex.Pattern pattern, java.lang.String[] operators, MappingContext mappingContext)`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public static void`	`applyDetachedCriteria(Query query, AbstractDetachedCriteria detachedCriteria)` Applies the given detached criteria to the given query
	`public static void`	`applySortForMap(Query query, java.util.Map sortMap, boolean ignoreCase)` Applies sorting logic to the given query from the given map
	`public static MatchSpec`	`buildMatchSpec(java.lang.String prefix, java.lang.String methodName, int parameterCount)` Builds a match specification that can be used to establish information about a dynamic finder compilation for the purposes of compilation etc.
	`protected void`	`configureQueryWithArguments(java.lang.Class clazz, Query query, java.lang.Object[] arguments)`
	`public Criterion`	`createCriterion()`
	`public DynamicFinderInvocation`	`createFinderInvocation(java.lang.Class clazz, java.lang.String methodName, groovy.lang.Closure additionalCriteria, java.lang.Object[] arguments)`
	`protected abstract java.lang.Object`	`doInvokeInternal(DynamicFinderInvocation invocation)`
	`protected MethodExpression`	`findMethodExpression(java.lang.Class clazz, java.lang.String expression)`
	`protected static MethodExpression`	`findMethodExpression(java.lang.String expression)`
	`public java.lang.Object[]`	`getArguments()`
	`public int`	`getArgumentsRequired()`
	`public static javax.persistence.FetchType`	`getFetchMode(java.lang.Object object)` Retrieves the fetch mode for the specified instance; otherwise returns the default FetchMode.
	`public java.lang.Object`	`invoke(java.lang.Class clazz, java.lang.String methodName, groovy.lang.Closure additionalCriteria, java.lang.Object[] arguments)`
	`public java.lang.Object`	`invoke(java.lang.Class clazz, java.lang.String methodName, DetachedCriteria detachedCriteria, java.lang.Object[] arguments)`
	`public java.lang.Object`	`invoke(java.lang.Class clazz, java.lang.String methodName, java.lang.Object[] arguments)`
	`public boolean`	`isMethodMatch(java.lang.String methodName)` Checks whether the given method is a match
	`public static void`	`populateArgumentsForCriteria(BuildableCriteria query, java.util.Map argMap)` Populates arguments for the given query form the given map
	`public static void`	`populateArgumentsForCriteria(java.lang.Class<? extends java.lang.Object> targetClass, Query query, java.util.Map argMap)`
	`public static void`	`registerNewMethodExpression(java.lang.Class methodExpression)` Registers a new method expression.
	`public void`	`setArguments(java.lang.Object[] arguments)`
	`public void`	`setPattern(java.lang.String pattern)` Sets the pattern to use for this finder

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class AbstractFinder`	`applyAdditionalCriteria, execute, execute`

- Field Detail
  - public static final java.lang.String ARGUMENT_CACHE
  - public static final java.lang.String ARGUMENT_FETCH
  - public static final java.lang.String ARGUMENT_FETCH_SIZE
  - public static final java.lang.String ARGUMENT_FLUSH_MODE
  - public static final java.lang.String ARGUMENT_IGNORE_CASE
  - public static final java.lang.String ARGUMENT_LOCK
  - public static final java.lang.String ARGUMENT_MAX
  - public static final java.lang.String ARGUMENT_OFFSET
  - public static final java.lang.String ARGUMENT_ORDER
  - public static final java.lang.String ARGUMENT_READ_ONLY
  - public static final java.lang.String ARGUMENT_SORT
  - public static final java.lang.String ARGUMENT_TIMEOUT
  - public static final java.lang.String ORDER_ASC
  - public static final java.lang.String ORDER_DESC
  - protected final MappingContext mappingContext
  - protected java.util.regex.Pattern pattern
- Constructor Detail
  - protected DynamicFinder(java.util.regex.Pattern pattern, java.lang.String[] operators, Datastore datastore)
  - protected DynamicFinder(java.util.regex.Pattern pattern, java.lang.String[] operators, MappingContext mappingContext)
- Method Detail
  - public static void applyDetachedCriteria(Query query, AbstractDetachedCriteria detachedCriteria)
    
    Applies the given detached criteria to the given query
    Parameters:
    query - The query
    detachedCriteria - The detached criteria
  - public static void applySortForMap(Query query, java.util.Map sortMap, boolean ignoreCase)
    
    Applies sorting logic to the given query from the given map
    Parameters:
    query - The query
    sortMap - The sort map
    ignoreCase - Whether toi ignore case
  - public static MatchSpec buildMatchSpec(java.lang.String prefix, java.lang.String methodName, int parameterCount)
    
    Builds a match specification that can be used to establish information about a dynamic finder compilation for the purposes of compilation etc.
    Parameters:
    prefix - The dynamic finder prefix. For example 'findBy'
    methodName - The full method name
    parameterCount - The number of parameters
    Returns:
    The match specification
  - protected void configureQueryWithArguments(java.lang.Class clazz, Query query, java.lang.Object[] arguments)
  - @java.lang.Override
    public Criterion createCriterion()
  - public DynamicFinderInvocation createFinderInvocation(java.lang.Class clazz, java.lang.String methodName, groovy.lang.Closure additionalCriteria, java.lang.Object[] arguments)
  - protected abstract java.lang.Object doInvokeInternal(DynamicFinderInvocation invocation)
  - protected MethodExpression findMethodExpression(java.lang.Class clazz, java.lang.String expression)
  - protected static MethodExpression findMethodExpression(java.lang.String expression)
  - @java.lang.Override
    public java.lang.Object[] getArguments()
  - @java.lang.Override
    public int getArgumentsRequired()
  - public static javax.persistence.FetchType getFetchMode(java.lang.Object object)
    
    Retrieves the fetch mode for the specified instance; otherwise returns the default FetchMode.
    Parameters:
    object - The object, converted to a string
    Returns:
    The FetchMode
  - public java.lang.Object invoke(java.lang.Class clazz, java.lang.String methodName, groovy.lang.Closure additionalCriteria, java.lang.Object[] arguments)
  - public java.lang.Object invoke(java.lang.Class clazz, java.lang.String methodName, DetachedCriteria detachedCriteria, java.lang.Object[] arguments)
  - public java.lang.Object invoke(java.lang.Class clazz, java.lang.String methodName, java.lang.Object[] arguments)
  - public boolean isMethodMatch(java.lang.String methodName)
    
    Checks whether the given method is a match
    Parameters:
    methodName - The method name
    Returns:
    True if it is
  - public static void populateArgumentsForCriteria(BuildableCriteria query, java.util.Map argMap)
    
    Populates arguments for the given query form the given map
    Parameters:
    query - The query
    argMap - The query arguments
  - public static void populateArgumentsForCriteria(java.lang.Class<? extends java.lang.Object> targetClass, Query query, java.util.Map argMap)
  - public static void registerNewMethodExpression(java.lang.Class methodExpression)
    
    Registers a new method expression. The Class must extends from the class MethodExpression and provide a constructor that accepts a Class parameter and a String parameter.
    Parameters:
    methodExpression - A class that extends from MethodExpression
  - @java.lang.Override
    public void setArguments(java.lang.Object[] arguments)
  - public void setPattern(java.lang.String pattern)
    
    Sets the pattern to use for this finder
    Parameters:
    pattern - A regular expression

Summary:
Field
Constructor
Method

| Detail:
Field
Constructor
Method

Groovy Documentation

[Java] Class DynamicFinder

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final java.lang.String ARGUMENT_CACHE

public static final java.lang.String ARGUMENT_FETCH

public static final java.lang.String ARGUMENT_FETCH_SIZE

public static final java.lang.String ARGUMENT_FLUSH_MODE

public static final java.lang.String ARGUMENT_IGNORE_CASE

public static final java.lang.String ARGUMENT_LOCK

public static final java.lang.String ARGUMENT_MAX

public static final java.lang.String ARGUMENT_OFFSET

public static final java.lang.String ARGUMENT_ORDER

public static final java.lang.String ARGUMENT_READ_ONLY

public static final java.lang.String ARGUMENT_SORT

public static final java.lang.String ARGUMENT_TIMEOUT

public static final java.lang.String ORDER_ASC

public static final java.lang.String ORDER_DESC

protected final MappingContext mappingContext

protected java.util.regex.Pattern pattern

Constructor Detail

protected DynamicFinder(java.util.regex.Pattern pattern, java.lang.String[] operators, Datastore datastore)

protected DynamicFinder(java.util.regex.Pattern pattern, java.lang.String[] operators, MappingContext mappingContext)

Method Detail

public static void applyDetachedCriteria(Query query, AbstractDetachedCriteria detachedCriteria)

public static void applySortForMap(Query query, java.util.Map sortMap, boolean ignoreCase)

public static MatchSpec buildMatchSpec(java.lang.String prefix, java.lang.String methodName, int parameterCount)

protected void configureQueryWithArguments(java.lang.Class clazz, Query query, java.lang.Object[] arguments)

@java.lang.Overridepublic Criterion createCriterion()

public DynamicFinderInvocation createFinderInvocation(java.lang.Class clazz, java.lang.String methodName, groovy.lang.Closure additionalCriteria, java.lang.Object[] arguments)

protected abstract java.lang.Object doInvokeInternal(DynamicFinderInvocation invocation)

protected MethodExpression findMethodExpression(java.lang.Class clazz, java.lang.String expression)

protected static MethodExpression findMethodExpression(java.lang.String expression)

@java.lang.Overridepublic java.lang.Object[] getArguments()

@java.lang.Overridepublic int getArgumentsRequired()

public static javax.persistence.FetchType getFetchMode(java.lang.Object object)

public java.lang.Object invoke(java.lang.Class clazz, java.lang.String methodName, groovy.lang.Closure additionalCriteria, java.lang.Object[] arguments)

public java.lang.Object invoke(java.lang.Class clazz, java.lang.String methodName, DetachedCriteria detachedCriteria, java.lang.Object[] arguments)

public java.lang.Object invoke(java.lang.Class clazz, java.lang.String methodName, java.lang.Object[] arguments)

public boolean isMethodMatch(java.lang.String methodName)

public static void populateArgumentsForCriteria(BuildableCriteria query, java.util.Map argMap)

public static void populateArgumentsForCriteria(java.lang.Class<? extends java.lang.Object> targetClass, Query query, java.util.Map argMap)

public static void registerNewMethodExpression(java.lang.Class methodExpression)

@java.lang.Overridepublic void setArguments(java.lang.Object[] arguments)

public void setPattern(java.lang.String pattern)

@java.lang.Override
public Criterion createCriterion()

@java.lang.Override
public java.lang.Object[] getArguments()

@java.lang.Override
public int getArgumentsRequired()

@java.lang.Override
public void setArguments(java.lang.Object[] arguments)