Stream<T> getResultStream()

Execute a SELECT query and return the query results as an untyped Stream<T>.

By default, this method delegates to getResultList().stream(), however persistence provider may choose to override this method to provide additional capabilities.

Returns:

a stream of the results, or an empty stream if there are no results.

Throws:

IllegalStateException - if called for a Jakarta Persistence query language UPDATE or DELETE statement.

PessimisticLockException - if pessimistic locking fails and the transaction is rolled back.

LockTimeoutException - if pessimistic locking fails and only the statement is rolled back.

PersistenceException - if the query execution exceeds the query timeout value set and the transaction is rolled back.

TransactionRequiredException - if a lock mode other than NONE has been set and there is no transaction or the persistence context has not been joined to the transaction.

QueryTimeoutException - if the query execution exceeds the query timeout value set and only the statement is rolled back.

See Also:

Stream

::getResultList()

Since:

Jakarta Persistence (JPA) 2.2