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

Specify the item that is to be returned in the query result. Replaces the previously specified selection(s), if any.

Note: Applications using the string-based API may need to specify the type of the select item when it results from a get or join operation and the query result type is specified.

For example:

CriteriaQuery q = cb.createQuery(String.class);
Root order = q.from(Order.class);
q.select(order.get("shippingAddress").get("state"));

CriteriaQuery q2 = cb.createQuery(Product.class);
q2.select(q2.from(Order.class)
            .join("items")
            .join("product"));

Parameters:

selection - selection specifying the item that is to be returned in the query result

Returns:

the modified query.

Throws:

IllegalArgumentException - if the selection is a compound selection and more than one selection item has the same assigned alias.

Since:

Jakarta Persistence (JPA) 1.0