org.firebirdsql.util.SQLExceptionChainBuilder Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of jaybird-jdk15 Show documentation
JDBC Driver for the Firebird RDBMS
The newest version!
/*
 * $Id: SQLExceptionChainBuilder.java 56968 2012-04-30 12:11:30Z mrotteveel $
 * 
 * Firebird Open Source J2EE Connector - JDBC Driver
 *
 * Distributable under LGPL license.
 * You may obtain a copy of the License at http://www.gnu.org/copyleft/lgpl.html
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * LGPL License for more details.
 *
 * This file was created by members of the firebird development team.
 * All individual contributions remain the Copyright (C) of those
 * individuals.  Contributors to this file are either listed here or
 * can be obtained from a CVS history command.
 *
 * All rights reserved.
 */
package org.firebirdsql.util;

import java.sql.SQLException;

/**
 * Helper class for building {@link java.sql.SQLException} chains.
 * 
 * NOTE: This class is not thread-safe; an instance should only be used on
 * a single thread or with proper external synchronisation.
 * 
 *  
 * @param  Type of SQLException (definition: E extends SQLException) 
 * @author Mark Rotteveel
 * @since 2.2
 */
public final class SQLExceptionChainBuilder {

    private E root;
    
    /**
     * Create SQLExceptionChainBuilder
     */
    public SQLExceptionChainBuilder() {
        this(null);
    }
    
    /**
     * Create SQLExceptionChainBuilder with the specified root exception.
     * 
     * @param root Root SQLException
     */
    public SQLExceptionChainBuilder(E root) {
        this.root = root;
    }
    
    /**
     * Appends the passed SQLException to the exception chain.
     * 
     * If this SQLExceptionChainBuilder does not have a root, sqle will be come
     * the root.
     * 
     * 
     * @param sqle SQLException to add to the chain.
     * @return this SQLExceptionChainBuilder
     */
    public SQLExceptionChainBuilder append(E sqle) {
        if (root == null) {
            root = sqle;
        } else {
            root.setNextException(sqle);
        }
        return this;
    }
    
    /**
     * @return true if this SQLExceptionChainBuilder contains at least one SQLException.
     */
    public boolean hasException() {
        return root != null;
    }
    
    /**
     * @return The root SQLException or null if no SQLException was added to this SQLExceptionChainBuilder
     */
    public E getException() {
        return root;
    }
}