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