1538      * prior to returning the {@code PooledConnection} back to the cache</li>

  1538      * prior to returning the {@code PooledConnection} back to the cache</li>

  1539      * </ul>

  1539      * </ul>

  1540      * @throws SQLException if an error occurs

  1540      * @throws SQLException if an error occurs

  1541      * @since 1.9

  1541      * @since 1.9

  1542      * @see endRequest

  1542      * @see endRequest

  1544      */

  1544      */

  1545     default void beginRequest() throws SQLException {

  1545     default void beginRequest() throws SQLException {

  1546        // Default method takes no action

  1546        // Default method takes no action

  1547     }

  1547     }

  1548 

  1548 

  1568      *

  1568      *

  1569      * This method is to be used by Connection pooling managers.

  1569      * This method is to be used by Connection pooling managers.

  1570      * <p>

  1570      * <p>

  1571      * The pooling manager should call {@code endRequest} on the underlying connection

  1571      * The pooling manager should call {@code endRequest} on the underlying connection

  1572      * when the applications returns the connection back to the connection pool.

  1572      * when the applications returns the connection back to the connection pool.

  1574      * The pooling manager does not need to call {@code endRequest} if:

  1574      * The pooling manager does not need to call {@code endRequest} if:

  1575      * <ul>

  1575      * <ul>

  1576      * <li>The connection pool caches {@code PooledConnection} objects</li>

  1576      * <li>The connection pool caches {@code PooledConnection} objects</li>

  1577      * <li>Returns a logical connection handle when {@code getConnection} is

  1577      * <li>Returns a logical connection handle when {@code getConnection} is

  1578      * called by the application</li>

  1578      * called by the application</li>

  1580      * prior to returning the {@code PooledConnection} back to the cache</li>

  1580      * prior to returning the {@code PooledConnection} back to the cache</li>

  1581      * </ul>

  1581      * </ul>

  1582      * @throws SQLException if an error occurs

  1582      * @throws SQLException if an error occurs

  1583      * @since 1.9

  1583      * @since 1.9

  1584      * @see beginRequest

  1584      * @see beginRequest

  1586      */

  1586      */

  1587     default void endRequest() throws SQLException {

  1587     default void endRequest() throws SQLException {

  1588             // Default method takes no action

  1588             // Default method takes no action

  1589     }

  1589     }

  1590 }

  1590 }