(Quick Reference)
find
Purpose
Finds and returns the first result for the given query or
null
if no instance was found
Examples
// Dan brown's first book
Book.find("from Book as b where b.author='Dan Brown'")
// with a positional parameter
Book.find("from Book as b where b.author=?",['Dan Brown'])
// with a named parameter (since 0.5)
Book.find("from Book as b where b.author=:author",[author:'Dan Brown'])
// use the query cache
Book.find("from Book as b where b.author='Dan Brown'", [cache: true])
Book.find("from Book as b where b.author=:author",[author:'Dan Brown'], [cache: true])
Book.find("from Book as b where b.author=:author",
[author: 'Dan Brown'],
[cache: true])// query by example
def b = new Book(author:"Dan Brown")
Book.find(b)
Description
The
find
method allows querying with Hibernate's query language
HQL and querying by example. The basic syntax is:
Book.find(String query)
Book.find(String query, Collection positionalParams)
Book.find(String query, Collection positionalParams, Map queryParams)
Book.find(String query, Map namedParams)
Book.find(String query, Map namedParams, Map queryParams)
Book.find(Book example)
Parameters:
query
- An HQL query
positionalParams
- A List of parameters for a positional parametrized HQL query
namedParams
- A Map of named parameters a HQL query
queryParams
- A Map of query parameters. Currently, only cache
is supported
example
- An instance of the domain class for query by example