Class SQLExceptionChainBuilder<E extends java.sql.SQLException>

  • Type Parameters:
    E - type of SQLException (definition: E extends SQLException)

    @InternalApi
    public final class SQLExceptionChainBuilder<E extends java.sql.SQLException>
    extends java.lang.Object
    Helper class for building SQLException chains.

    NOTE: This class is not thread-safe; an instance should only be used on a single thread or with proper external synchronisation.

    Since:
    2.2
    Author:
    Mark Rotteveel
    • Constructor Detail

      • SQLExceptionChainBuilder

        public SQLExceptionChainBuilder()
        Create SQLExceptionChainBuilder
      • SQLExceptionChainBuilder

        public SQLExceptionChainBuilder​(E root)
        Create SQLExceptionChainBuilder with the specified root exception.
        Parameters:
        root - root SQLException
    • Method Detail

      • append

        public SQLExceptionChainBuilder<E> append​(E sqle)
        Appends the passed SQLException to the exception chain.

        If this SQLExceptionChainBuilder does not have a root, sqle will be come the root.

        Parameters:
        sqle - SQLException to add to the chain.
        Returns:
        this SQLExceptionChainBuilder
      • addFirst

        public SQLExceptionChainBuilder<E> addFirst​(E sqle)
        Adds the passed SQLException as the first exception in the chain.

        If this SQLExceptionChainBuilder already has a root, that root will be chained to sqle, and sqle becomes the new root.

        Parameters:
        sqle - SQLException to add to the chain
        Returns:
        this SQLExceptionChainBuilder
        Since:
        5
      • hasException

        public boolean hasException()
        Returns:
        true if this SQLExceptionChainBuilder contains at least one SQLException.
      • getException

        public E getException()
        Returns:
        the root SQLException or null if no SQLException was added to this SQLExceptionChainBuilder