Logo Search packages:      
Sourcecode: mysql-connector-java version File versions  Download package


 Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.

  The MySQL Connector/J is licensed under the terms of the GPLv2
  <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>, 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 FLOSS 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;

import java.sql.SQLException;

 * An exception to represent communications errors with the database.
 * Attempts to provide 'friendler' error messages to end-users, including last
 * time a packet was sent to the database, what the client-timeout is set to,
 * and whether the idle time has been exceeded.
 * @author Mark Matthews
 * @version $Id: CommunicationsException.java,v 2005/05/13 18:58:37
 *          mmatthews Exp $
00042 public class CommunicationsException extends SQLException implements StreamingNotifiable {

      private String exceptionMessage = null;

      private boolean streamingResultSetInPlay = false;
      private MySQLConnection conn;
      private long lastPacketSentTimeMs;
      private long lastPacketReceivedTimeMs;
      private Exception underlyingException;

      public CommunicationsException(MySQLConnection conn, long lastPacketSentTimeMs,
                  long lastPacketReceivedTimeMs, Exception underlyingException) {
            // store this information for later generation of message
            this.conn = conn;
            this.lastPacketReceivedTimeMs = lastPacketReceivedTimeMs;
            this.lastPacketSentTimeMs = lastPacketSentTimeMs;
            this.underlyingException = underlyingException;
            if (underlyingException != null) {


       * (non-Javadoc)
       * @see java.lang.Throwable#getMessage()
      public String getMessage() {
            // Get the message at last possible moment, but cache it 
            // and drop references to conn, underlyingException
            if(this.exceptionMessage == null){
                  this.exceptionMessage = SQLError.createLinkFailureMessageBasedOnHeuristics(this.conn,
                              this.lastPacketSentTimeMs, this.lastPacketReceivedTimeMs, this.underlyingException, 
                  this.conn = null;
                  this.underlyingException = null;
            return this.exceptionMessage;

       * (non-Javadoc)
       * @see java.sql.SQLException#getSQLState()
      public String getSQLState() {

      /* (non-Javadoc)
       * @see com.mysql.jdbc.StreamingNotifiable#setWasStreamingResults()
      public void setWasStreamingResults() {
            this.streamingResultSetInPlay = true;


Generated by  Doxygen 1.6.0   Back to index