Spec-Zone .ru спецификации, руководства, описания, API

javax.persistence.criteria
Соедините интерфейсом с CriteriaQuery <T>

Введите Параметры:

T - тип определенного результата

Все Суперинтерфейсы:

AbstractQuery <T>

public interface CriteriaQuery<T>
расширяет AbstractQuery <T>

CriteriaQuery интерфейс определяет функциональность, которая является определенной для высокоуровневых запросов.

С тех пор:

Персистентность Java 2.0

Сводка метода

CriteriaQuery<T>	distinct(boolean distinct) Определите, будут ли устранены двойные результаты запроса.
java.util.List<Order>	getOrderList() Возвратите выражения упорядочивания в порядке приоритета.
java.util.Set<ParameterExpression<?>>	getParameters() Возвратите параметры запроса.
CriteriaQuery<T>	groupBy(Expression<?>... grouping) Определите выражения, которые используются, чтобы сформировать группы по результатам запроса.
CriteriaQuery<T>	groupBy(java.util.List<Expression<?>> grouping) Определите выражения, которые используются, чтобы сформировать группы по результатам запроса.
CriteriaQuery<T>	having(Expression<java.lang.Boolean> restriction) Определите ограничение по группам запроса.
CriteriaQuery<T>	having(Predicate... restrictions) Определите ограничения по группам запроса согласно соединению указанных предикатов ограничения.
CriteriaQuery<T>	multiselect(java.util.List<Selection<?>> selectionList) Определите элементы выбора, которые должны быть возвращены в результате запроса.
CriteriaQuery<T>	multiselect(Selection<?>... selections) Определите элементы выбора, которые должны быть возвращены в результате запроса.
CriteriaQuery<T>	orderBy(java.util.List<Order> o) Определите выражения упорядочивания, которые используются, чтобы упорядочить результаты запроса.
CriteriaQuery<T>	orderBy(Order... o) Определите выражения упорядочивания, которые используются, чтобы упорядочить результаты запроса.
CriteriaQuery<T>	select(Selection<? extends T> selection) Определите элемент, который должен быть возвращен в результате запроса.
CriteriaQuery<T>	where(Expression<java.lang.Boolean> restriction) Измените запрос, чтобы ограничить результат запроса согласно указанному булевому выражению.
CriteriaQuery<T>	where(Predicate... restrictions) Измените запрос, чтобы ограничить результат запроса согласно соединению указанных предикатов ограничения.

Методы, наследованные от интерфейса javax.persistence.criteria. AbstractQuery

from, from, getGroupList, getGroupRestriction, getRestriction, getResultType, getRoots, getSelection, isDistinct, subquery

Деталь метода

выбрать

CriteriaQuery<T> select(Selection<? extends T> selection)

Определите элемент, который должен быть возвращен в результате запроса. Заменяет ранее указанный выбор (ы), если любой.

Отметьте: Приложения используя основанный на операция со строками API, возможно, должны определить тип избранного элемента, когда это следует из того, чтобы получать или работы соединения, и тип результата запроса определяется.

     For example:

     CriteriaQuery<String> q = cb.createQuery(String.class);
     Root<Order> order = q.from(Order.class);
     q.select(order.get("shippingAddress").<String>get("state"));
 
     CriteriaQuery<Product> q2 = cb.createQuery(Product.class);
     q2.select(q2.from(Order.class)
                 .join("items")
                 .<Item,Product>join("product"));
 
 

Параметры:

selection - выбор, определяющий элемент, который должен быть возвращен в результате запроса

Возвраты:

измененный запрос

Броски:

IllegalArgumentException - если выбор является составным выбором, и больше чем у одного элемента выбора есть тот же самый присвоенный псевдоним

мультивыбрать

CriteriaQuery<T> multiselect(Selection<?>... selections)

Определите элементы выбора, которые должны быть возвращены в результате запроса. Заменяет ранее указанный выбор (ы), если любой. Тип результата выполнения запроса зависит от спецификации типа создаваемого объекта запроса критериев так же как параметры мультиизбранному методу.

Параметром мультиизбранному методу не должен быть кортеж - или оцененный массивом составной элемент выбора.

Семантика этого метода следующие:

• Если тип запроса критериев CriteriaQuery<Tuple> (то есть, критерии запрашивают объект, создаваемый любым createTupleQuery метод или передавая a Tuple Параметр class createQuery метод), a Tuple объект, соответствующий параметрам multiselect метод, в указанном порядке, инстанцируют и возвращен для каждой строки, которая следует из выполнения запроса.
• Если тип запроса критериев CriteriaQuery<X> для некоторого определяемого пользователем class X (то есть, критерии запрашивают объект, создаваемый, передавая X параметров class createQuery метод), параметры multiselect метод передадут X конструкторам, и экземпляр типа X будет возвращен для каждой строки.
• Если тип запроса критериев CriteriaQuery<X[]> для некоторого class X, экземпляр типа X [] будет возвращен для каждой строки. Элементы массива будут соответствовать параметрам multiselect метод, в указанном порядке.
• Если тип запроса критериев CriteriaQuery<Object> или если запрос критериев создавался, не определяя тип, и только единственный параметр передают к multiselect метод, экземпляр типа Object будет возвращен для каждой строки.
• Если тип запроса критериев CriteriaQuery<Object> или если запрос критериев создавался, не определяя тип, и больше чем один параметр передают к multiselect метод, экземпляр типа Object[] будет инстанцирован и возвращен для каждой строки. Элементы массива будут соответствовать параметрам multiselect метод, в указанном порядке.

Параметры:

selections - элементы выбора, соответствующие результатам, которые будут возвращены запросом

Возвраты:

измененный запрос

Броски:

IllegalArgumentException - если элемент выбора не допустим или если больше чем у одного элемента выбора есть тот же самый присвоенный псевдоним

мультивыбрать

CriteriaQuery<T> multiselect(java.util.List<Selection<?>> selectionList)

Определите элементы выбора, которые должны быть возвращены в результате запроса. Заменяет ранее указанный выбор (ы), если любой.

Тип результата выполнения запроса зависит от спецификации типа создаваемого объекта запроса критериев так же как параметр multiselect метод. Элемент списка, который передают к multiselect метод не должен быть кортежем - или оцененный массивом составной элемент выбора.

Семантика этого метода следующие:

• Если тип запроса критериев CriteriaQuery<Tuple> (то есть, критерии запрашивают объект, создаваемый любым createTupleQuery метод или передавая a Tuple Параметр class createQuery метод), a Tuple объект, соответствующий элементам списка, который передают к multiselect метод, в указанном порядке, инстанцируют и возвращен для каждой строки, которая следует из выполнения запроса.
• Если тип запроса критериев CriteriaQuery<X> для некоторого определяемого пользователем class X (то есть, критерии запрашивают объект, создаваемый, передавая X параметров class createQuery метод), элементы списка, который передают к multiselect метод передадут X конструкторам, и экземпляр типа X будет возвращен для каждой строки.
• Если тип запроса критериев CriteriaQuery<X[]> для некоторого class X, экземпляр типа X [] будет возвращен для каждой строки. Элементы массива будут соответствовать элементам списка, который передают к multiselect метод, в указанном порядке.
• Если тип запроса критериев CriteriaQuery<Object> или если запрос критериев создавался, не определяя тип, и список, который передают к multiselect метод содержит только единственный элемент, экземпляр типа Object будет возвращен для каждой строки.
• Если тип запроса критериев CriteriaQuery<Object> или если запрос критериев создавался, не определяя тип, и список, который передают к multiselect метод содержит больше чем один элемент, экземпляр типа Object[] будет инстанцирован и возвращен для каждой строки. Элементы массива будут соответствовать элементам списка, который передают к multiselect метод, в указанном порядке.

Параметры:

selectionList - список элементов выбора, соответствующих результатам, которые будут возвращены запросом

Возвраты:

измененный запрос

Броски:

IllegalArgumentException - если элемент выбора не допустим или если больше чем у одного элемента выбора есть тот же самый присвоенный псевдоним

где

CriteriaQuery<T> where(Expression<java.lang.Boolean> restriction)

Измените запрос, чтобы ограничить результат запроса согласно указанному булевому выражению. Заменяет ранее добавленное ограничение (я), если любой. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

where в интерфейсе AbstractQuery<T>

Параметры:

restriction - простое или составное булево выражение

Возвраты:

измененный запрос

где

CriteriaQuery<T> where(Predicate... restrictions)

Измените запрос, чтобы ограничить результат запроса согласно соединению указанных предикатов ограничения. Заменяет ранее добавленное ограничение (я), если любой. Если никакие ограничения не определяются, любые ранее добавленные ограничения просто удаляются. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

where в интерфейсе AbstractQuery<T>

Параметры:

restrictions - нуль или больше предикатов ограничения

Возвраты:

измененный запрос

groupBy

CriteriaQuery<T> groupBy(Expression<?>... grouping)

Определите выражения, которые используются, чтобы сформировать группы по результатам запроса. Заменяет предыдущие определенные группирующиеся выражения, если любой. Если никакие выражения группировки не определяются, любой ранее добавил, что группирующиеся выражения просто удаляются. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

groupBy в интерфейсе AbstractQuery<T>

Параметры:

grouping - нуль или больше группирующихся выражений

Возвраты:

измененный запрос

groupBy

CriteriaQuery<T> groupBy(java.util.List<Expression<?>> grouping)

Определите выражения, которые используются, чтобы сформировать группы по результатам запроса. Заменяет предыдущие определенные группирующиеся выражения, если любой. Если никакие выражения группировки не определяются, любой ранее добавил, что группирующиеся выражения просто удаляются. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

groupBy в интерфейсе AbstractQuery<T>

Параметры:

grouping - список нуля или большего количества группирующихся выражений

Возвраты:

измененный запрос

наличие

CriteriaQuery<T> having(Expression<java.lang.Boolean> restriction)

Определите ограничение по группам запроса. Заменяет предыдущее ограничение (я) наличия, если любой. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

having в интерфейсе AbstractQuery<T>

Параметры:

restriction - простое или составное булево выражение

Возвраты:

измененный запрос

наличие

CriteriaQuery<T> having(Predicate... restrictions)

Определите ограничения по группам запроса согласно соединению указанных предикатов ограничения. Заменяет ранее добавленное ограничение (я) наличия, если любой. Если никакие ограничения не определяются, любые ранее добавленные ограничения просто удаляются. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

having в интерфейсе AbstractQuery<T>

Параметры:

restrictions - нуль или больше предикатов ограничения

Возвраты:

измененный запрос

orderBy

CriteriaQuery<T> orderBy(Order... o)

Определите выражения упорядочивания, которые используются, чтобы упорядочить результаты запроса. Заменяет предыдущие выражения упорядочивания, если любой. Если никакие выражения упорядочивания не определяются, предыдущее упорядочивание, если таковые вообще имеются, просто удаляется, и результаты будут возвращены без определенного порядка. Слева направо последовательность выражений упорядочивания определяет приоритет, посредством чего у крайнего левого есть наивысший приоритет.

Параметры:

o - нуль или больше выражений упорядочивания

Возвраты:

измененный запрос

orderBy

CriteriaQuery<T> orderBy(java.util.List<Order> o)

Определите выражения упорядочивания, которые используются, чтобы упорядочить результаты запроса. Заменяет предыдущие выражения упорядочивания, если любой. Если никакие выражения упорядочивания не определяются, предыдущее упорядочивание, если таковые вообще имеются, просто удаляется, и результаты будут возвращены без определенного порядка. Порядок выражений упорядочивания в списке определяет приоритет, посредством чего у первого элемента в списке есть наивысший приоритет.

Параметры:

o - список нуля или большего количества выражений упорядочивания

Возвраты:

измененный запрос

отличный

CriteriaQuery<T> distinct(boolean distinct)

Определите, будут ли устранены двойные результаты запроса. Истинное значение заставит копии быть устраненными. Ложное значение заставит копии быть сохраненными. Если отличный не был определен, двойные результаты должны быть сохранены. Этот метод только переопределяет тип возврата соответствия AbstractQuery метод.

Определенный:

distinct в интерфейсе AbstractQuery<T>

Параметры:

distinct - булево значение, определяющее, должны ли двойные результаты быть устранены из результата запроса или должны ли они быть сохранены

Возвраты:

измененный запрос.

getOrderList

java.util.List<Order> getOrderList()

Возвратите выражения упорядочивания в порядке приоритета. Пустой список возвратов, если никакие выражения упорядочивания не были определены. Модификации к списку не влияют на запрос.

Возвраты:

список упорядочивания выражений

getParameters

java.util.Set<ParameterExpression<?>> getParameters()

Возвратите параметры запроса. Пустое множество возвратов, если нет никаких параметров. Модификации к набору не влияют на запрос.

Возвраты:

параметры запроса