Package org.hibernate

Class QueryException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

jakarta.persistence.PersistenceException

org.hibernate.HibernateException

org.hibernate.QueryException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

IllegalNamedQueryOptionsException, IllegalQueryOperationException, InterpretationException, QueryParameterException, SemanticException, UnknownNamedQueryException

public class QueryException
extends HibernateException

A problem occurred translating a Hibernate query to SQL due to invalid query syntax, or some similar problem.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
QueryException(Exception cause)	Constructs a QueryException using the specified cause.
QueryException(String message)	Constructs a QueryException using the specified exception message.
QueryException(String message, Exception cause)	Constructs a QueryException using the specified exception message and cause.
QueryException(String message, String queryString)	Constructs a QueryException using the specified exception message and query string.
QueryException(String message, String queryString, Exception cause)	Constructs a QueryException using the specified exception message and query string.

Method Summary

Modifier and Type	Method	Description
protected QueryException	generateQueryException(String queryString)	Called from wrapWithQueryString(String) when we really need to generate a new QueryException (or subclass).
String	getMessage()
protected String	getOriginalMessage()
String	getQueryString()	Retrieve the query being evaluated when the exception occurred.
QueryException	wrapWithQueryString(String queryString)	Deprecated, for removal: This API element is subject to removal in a future version. This method is no longer used

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

QueryException

public QueryException(String message)

Constructs a QueryException using the specified exception message.

Parameters:

message - A message explaining the exception condition

QueryException

public QueryException(String message,
                      Exception cause)

Constructs a QueryException using the specified exception message and cause.

Parameters:

message - A message explaining the exception condition

cause - The underlying cause

QueryException

public QueryException(String message,
                      String queryString)

Constructs a QueryException using the specified exception message and query string.

Parameters:

message - A message explaining the exception condition

queryString - The query being evaluated when the exception occurred

QueryException

public QueryException(String message,
                      String queryString,
                      Exception cause)

Constructs a QueryException using the specified exception message and query string.

Parameters:

message - A message explaining the exception condition

queryString - The query being evaluated when the exception occurred

cause - The underlying cause

QueryException

public QueryException(Exception cause)

Constructs a QueryException using the specified cause.

Parameters:

cause - The underlying cause

Method Detail

getQueryString

public String getQueryString()

Retrieve the query being evaluated when the exception occurred. May be null, but generally should not be.

Returns:

The query string

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getOriginalMessage

protected final String getOriginalMessage()

wrapWithQueryString

@Deprecated(since="6.2",
            forRemoval=true)
public final QueryException wrapWithQueryString(String queryString)

Deprecated, for removal: This API element is subject to removal in a future version.

This method is no longer used

Wraps this exception with another, of same kind, with the specified query string. If this exception already has a query string defined, the same exception (this) is returned. Otherwise, the protected generateQueryException(String) is called, to allow subclasses to properly create the correct subclass for return.

Parameters:

queryString - The query string that led to the QueryException

Returns:

this, if this has null for getQueryString(); otherwise a new QueryException (or subclass) is returned.

generateQueryException

protected QueryException generateQueryException(String queryString)

Called from wrapWithQueryString(String) when we really need to generate a new QueryException (or subclass).

Parameters:

queryString - The query string

Returns:

The generated QueryException (or subclass)

See Also:

getOriginalMessage()

Implementation Note:

implementors should take care to use getOriginalMessage() for the message, not getMessage()