org.hibernate.engine.spi.ExceptionConverter.java Source code

Introduction

Here is the source code for org.hibernate.engine.spi.ExceptionConverter.java

Source

/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.engine.spi;

import java.sql.SQLException;

import org.hibernate.HibernateException;
import org.hibernate.JDBCException;
import org.hibernate.LockOptions;

/**
 * @author Andrea Boriero
 */
public interface ExceptionConverter {
    /**
     * Converts the exception thrown during the transaction commit phase
     *
     * @param e The exception being handled
     *
     * @return The converted exception
     */
    RuntimeException convertCommitException(RuntimeException e);

    /**
     * Converts a Hibernate-specific exception into a JPA-specified exception; note that the JPA sepcification makes use
     * of exceptions outside its exception hierarchy, though they are all runtime exceptions.
     * <p/>
     *
     * @param e The Hibernate excepton.
     * @param lockOptions The lock options in effect at the time of exception (can be null)
     *
     * @return The JPA-specified exception
     */
    RuntimeException convert(HibernateException e, LockOptions lockOptions);

    /**
     * Converts a Hibernate-specific exception into a JPA-specified exception; note that the JPA sepcification makes use
     * of exceptions outside its exception hierarchy, though they are all runtime exceptions.
     * <p/>
     *
     * @param e The Hibernate excepton.
     *
     * @return The JPA-specified exception
     */
    RuntimeException convert(HibernateException e);

    RuntimeException convert(RuntimeException e);

    RuntimeException convert(RuntimeException e, LockOptions lockOptions);

    JDBCException convert(SQLException e, String message);
}