com.mysql.jdbc.jdbc2.optional.JDBC4MysqlPooledConnection Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of mysql-connector-java
MySQL JDBC Type 4 driver
There is a newer version: 8.0.33
/*
  Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.

  The MySQL Connector/J is licensed under the terms of the GPLv2
  , like most MySQL Connectors.
  There are special exceptions to the terms and conditions of the GPLv2 as it is applied to
  this software, see the FOSS License Exception
  .

  This program is free software; you can redistribute it and/or modify it under the terms
  of the GNU General Public License as published by the Free Software Foundation; version 2
  of the License.

  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 GNU General Public License for more details.

  You should have received a copy of the GNU General Public License along with this
  program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth
  Floor, Boston, MA 02110-1301  USA

 */

package com.mysql.jdbc.jdbc2.optional;

import java.sql.SQLException;

import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;

import javax.sql.StatementEvent;
import javax.sql.StatementEventListener;

/**
 * This class is used to wrap and return a physical connection within a logical handle. It also registers and notifies ConnectionEventListeners of any
 * ConnectionEvents
 */
public class JDBC4MysqlPooledConnection extends MysqlPooledConnection {

    private final Map statementEventListeners = new HashMap();

    public JDBC4MysqlPooledConnection(com.mysql.jdbc.Connection connection) {
        super(connection);
    }

    public synchronized void close() throws SQLException {
        super.close();

        this.statementEventListeners.clear();
    }

    /**
     * Registers a StatementEventListener with this PooledConnection object. Components that
     * wish to be notified when PreparedStatements created by the
     * connection are closed or are detected to be invalid may use this method
     * to register a StatementEventListener with this PooledConnection object.
     * 
     * @param listener
     *            an component which implements the StatementEventListener interface that is to be registered with this
     *            PooledConnection object
     * 
     * @since 1.6
     */
    public void addStatementEventListener(StatementEventListener listener) {
        synchronized (this.statementEventListeners) {
            this.statementEventListeners.put(listener, listener);
        }
    }

    /**
     * Removes the specified StatementEventListener from the list of
     * components that will be notified when the driver detects that a PreparedStatement has been closed or is invalid.
     * 
     * @param listener
     *            the component which implements the StatementEventListener interface that was previously
     *            registered with this PooledConnection object
     * 
     * @since 1.6
     */
    public void removeStatementEventListener(StatementEventListener listener) {
        synchronized (this.statementEventListeners) {
            this.statementEventListeners.remove(listener);
        }
    }

    void fireStatementEvent(StatementEvent event) throws SQLException {
        synchronized (this.statementEventListeners) {
            for (StatementEventListener listener : this.statementEventListeners.keySet()) {
                listener.statementClosed(event);
            }
        }
    }
}