/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *  http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * Other licenses:
 * -----------------------------------------------------------------------------
 * Commercial licenses for this work are available. These replace the above
 * ASL 2.0 and offer limited warranties, support, maintenance, and commercial
 * database integrations.
 *
 * For more information, please visit: http://www.jooq.org/licenses
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */
package org.jooq.exception;

import java.sql.SQLException;

The DataAccessException is a generic RuntimeException indicating that something went wrong while executing a SQL statement from jOOQ. The idea behind this unchecked exception is borrowed from Spring's JDBC's DataAccessException 
Author:
Sergey Epik - Merged into jOOQ from Spring JDBC Support, Lukas Eder/**
 * The <code>DataAccessException</code> is a generic {@link RuntimeException}
 * indicating that something went wrong while executing a SQL statement from
 * jOOQ. The idea behind this unchecked exception is borrowed from Spring's
 * JDBC's DataAccessException
 *
 * @author Sergey Epik - Merged into jOOQ from Spring JDBC Support
 * @author Lukas Eder
 */
public class DataAccessException extends RuntimeException {

    
Generated UID
/**
     * Generated UID
     */
    private static final long serialVersionUID   = 491834858363345767L;

    
Constructor for DataAccessException.
Params:
message – the detail message/**
     * Constructor for DataAccessException.
     *
     * @param message the detail message
     */
    public DataAccessException(String message) {
        super(message);
    }

    
Constructor for DataAccessException.
Params:
message – the detail message
cause – the root cause (usually from using a underlying data access
           API such as JDBC)/**
     * Constructor for DataAccessException.
     *
     * @param message the detail message
     * @param cause the root cause (usually from using a underlying data access
     *            API such as JDBC)
     */
    public DataAccessException(String message, Throwable cause) {
        super(message, cause);
    }

    
Retrieve the SQLException.getSQLState() from Throwable.getCause(), if this DataAccessException was caused by a SQLException. /**
     * Retrieve the {@link SQLException#getSQLState()} from {@link #getCause()},
     * if this <code>DataAccessException</code> was caused by a
     * {@link SQLException}.
     */
    public String sqlState() {
        SQLException e = getCause(SQLException.class);
        if (e != null)
            return e.getSQLState();

        return "00000";
    }

    
Decode the SQLException.getSQLState() from Throwable.getCause() into SQLStateClass, if this DataAccessException was caused by a SQLException. /**
     * Decode the {@link SQLException#getSQLState()} from {@link #getCause()}
     * into {@link SQLStateClass}, if this <code>DataAccessException</code> was
     * caused by a {@link SQLException}.
     */
    public SQLStateClass sqlStateClass() {
        SQLException e = getCause(SQLException.class);
        if (e != null)
            if (e.getSQLState() != null)
                return SQLStateClass.fromCode(e.getSQLState());
            else if (e.getSQLState() == null && "org.sqlite.SQLiteException".equals(e.getClass().getName()))
                return SQLStateClass.fromSQLiteVendorCode(e.getErrorCode());

        return SQLStateClass.NONE;
    }

    
Decode the SQLException.getSQLState() from Throwable.getCause() into SQLStateSubclass, if this DataAccessException was caused by a SQLException. /**
     * Decode the {@link SQLException#getSQLState()} from {@link #getCause()}
     * into {@link SQLStateSubclass}, if this <code>DataAccessException</code> was
     * caused by a {@link SQLException}.
     */
    public SQLStateSubclass sqlStateSubclass() {
        SQLException e = getCause(SQLException.class);
        if (e != null)
            return SQLStateSubclass.fromCode(e.getSQLState());

        return SQLStateSubclass.NONE;
    }

    @Override
    public StackTraceElement[] getStackTrace() {
        return super.getStackTrace();
    }

    
Find a root cause of a given type, or null if no root cause
of that type was found.
/**
     * Find a root cause of a given type, or <code>null</code> if no root cause
     * of that type was found.
     */
    public <T extends Throwable> T getCause(Class<? extends T> type) {
        return ExceptionTools.getCause(this, type);
    }
}