mysql-connector-java-5.0.3.jar Bug之 Statement.setQueryTimeout(int seconds)

gdx

　　    我们都知道在java.sql.Statement接口规范中有这么一个方法，如下代码片段：

    /**
* Sets the number of seconds the driver will wait for a
* <code>Statement</code> object to execute to the given number of seconds.
* If the limit is exceeded, an <code>SQLException</code> is thrown. A JDBC
* driver must apply this limit to the <code>execute</code>,
* <code>executeQuery</code> and <code>executeUpdate</code> methods. JDBC driver
* implementations may also apply this limit to <code>ResultSet</code> methods
* (consult your driver vendor documentation for details).
*
* @param seconds the new query timeout limit in seconds; zero means
*        there is no limit
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>
*            or the condition seconds >= 0 is not satisfied
* @see #getQueryTimeout
*/
void setQueryTimeout(int seconds) throws SQLException;

　　
　　    从这段代码中我们能看到“@param seconds the new query timeout limit in seconds; zero means there is no limit”，也就是说“seconds”设置查询的超时“秒”数，如果为0则无超时。
　　 
　　    然而在mysql-connector-java-5.0.3.jar的实现中却不是这么按照接口规范做的（但符合JAVA接口规则），请看下面的代码片段： 

/**
* 这里是com.mysql.jdbc.Statement类中设置查询超时时长的实现
*/
public void setQueryTimeout(int seconds)  throws SQLException  {
if (seconds < 0) {
throw SQLError.createSQLException(Messages.getString("Statement.21"), "S1009");
}
this.timeout = seconds;
}
// 这一段是在com.mysql.jdbc.Statement类中使用超时时长的代码
if ((this.timeout != 0) && (locallyScopedConn.versionMeetsMinimum(5, 0, 0))) {
timeoutTask = new CancelTask(this);
Connection.getCancelTimer().schedule(timeoutTask, this.timeout);
}
　　 
　　    从以上的代码可以看出setQueryTimeout方法设置的this.timeout 的值被Connection.getCancelTimer().schedule(timeoutTask, this.timeout);直接应用，而没进行任何的单位转换。
　　 
　　    于是我们如果设置想设置10秒的查询超时就必需写成setQueryTimeout(10000)，而之前我一直是按照接口的规范写成setQueryTimeout(10) 。
　　 
　　    起初我数据库的数据量非常少，而随着时间的推移，数据量会越来越多，这时数据库查询的响应速度就会随之变慢，所以经过一段时间后，我就发现【com.mysql.jdbc.exceptions.MySQLTimeoutException: Statement cancelled due to timeout or client】这种错误越来越多，大家应该很清楚是什么原因造成的吧？之前的数据库响应在10毫秒内没问题，因为数据量小，但数据量多了，于是响应就慢了，这时这种异常就多了，甚至到最后根本无法返回正常的查询结果。
　　 
　　    经过分析得出结论：这是mysql-connector-java-5.0.3.jar的严重BUG。
　　 
　　    对于这个BUG的解决方法就是使用mysql-connector-java-5.0.8-bin.jar或更高版本的JAR包。