com.heimuheimu.mysql.jdbc.command

类 SQLCommand

java.lang.Object

com.heimuheimu.mysql.jdbc.command.AbstractCommand

com.heimuheimu.mysql.jdbc.command.SQLCommand

所有已实现的接口:

Command

public class SQLCommand
extends AbstractCommand

Mysql SQL 命令，用于执行任何合法的 SQL 语句。

注意：SQLCommand 不支持 "LOAD DATA INFILE" 语句。

说明：SQLCommand 类是线程安全的，可在多个线程中使用同一个实例。

作者:

heimuheimu

另请参阅:

CommandQueryPacket

构造器概要

构造器

构造器和说明
SQLCommand(java.lang.String sql, ConnectionInfo connectionInfo) 构造一个 Mysql SQL 命令，用于执行任何合法的 SQL 语句。

方法概要

限定符和类型	方法和说明
long	getAffectedRows() 获得 SQL 语句变更的记录行数，如果 SQL 为查询语句，将返回 0。
ErrorPacket	getErrorPacket() 获得 SQL 语句执行出错返回的错误响应包数据，如果执行成功，将会返回 null。
long	getLastInsertId() 获得 INSERT SQL 语句执行后，最后插入的主键 ID，如果 SQL 为查询语句，将返回 -1。
byte[]	getRequestByteArray() 获得该命令对应的请求数据包。
MysqlServerStatusInfo	getServerStatusInfo() Mysql 命令执行完后，返回的 Mysql 服务端状态信息，该方法允许返回 null。
boolean	hasTextResultSet() 判断 SQL 语句执行完成后，返回的是否为 TextResultsetResponsePacket 数据包。
protected boolean	isLastPacket(MysqlPacket responsePacket) 判断收到的响应数据包是否为该命令的最后一个数据包。
java.lang.String	toString()

从类继承的方法 com.heimuheimu.mysql.jdbc.command.AbstractCommand

close, getResponsePacketList, hasResponsePacket, isCompleted, receiveResponsePacket

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

SQLCommand

public SQLCommand(java.lang.String sql,
                  ConnectionInfo connectionInfo)
           throws java.lang.IllegalArgumentException

构造一个 Mysql SQL 命令，用于执行任何合法的 SQL 语句。

参数:

sql - SQL 语句，不允许为 null 或空字符串

connectionInfo - 执行 SQL 语句的 Mysql 数据库连接信息，不允许为 null

抛出:

java.lang.IllegalArgumentException - 如果 sql 为 null 或空字符串

java.lang.IllegalArgumentException - 如果 connectionInfo 为 null

方法详细资料

getRequestByteArray

public byte[] getRequestByteArray()

从接口复制的说明: Command

获得该命令对应的请求数据包。

返回:

该命令对应的请求数据包

hasTextResultSet

public boolean hasTextResultSet()
                         throws java.lang.IllegalStateException

判断 SQL 语句执行完成后，返回的是否为 TextResultsetResponsePacket 数据包。

返回:

是否为 TextResultsetResponsePacket 数据包

抛出:

java.lang.IllegalStateException - 如果 SQL 语句尚未执行完成，将会抛出此异常

getAffectedRows

public long getAffectedRows()
                     throws java.lang.IllegalStateException

获得 SQL 语句变更的记录行数，如果 SQL 为查询语句，将返回 0。

返回:

SQL 语句变更的记录行数

抛出:

java.lang.IllegalStateException - 如果 SQL 语句尚未执行完成，将会抛出此异常

getLastInsertId

public long getLastInsertId()
                     throws java.lang.IllegalStateException

获得 INSERT SQL 语句执行后，最后插入的主键 ID，如果 SQL 为查询语句，将返回 -1。

返回:

最后插入的主键 ID

抛出:

java.lang.IllegalStateException - 如果 SQL 语句尚未执行完成，将会抛出此异常

getErrorPacket

public ErrorPacket getErrorPacket()
                           throws java.lang.IllegalStateException

获得 SQL 语句执行出错返回的错误响应包数据，如果执行成功，将会返回 null。

返回:

错误响应包数据，可能为 null

抛出:

java.lang.IllegalStateException - 如果 SQL 语句尚未执行完成，将会抛出此异常

isLastPacket

protected boolean isLastPacket(MysqlPacket responsePacket)
                        throws java.lang.IllegalStateException

从类复制的说明: AbstractCommand

判断收到的响应数据包是否为该命令的最后一个数据包。

指定者:

isLastPacket 在类中 AbstractCommand

参数:

responsePacket - 收到的响应数据包

返回:

是否为该命令的最后一个响应数据包

抛出:

java.lang.IllegalStateException - 当接收到非预期响应包时，将抛出此异常

getServerStatusInfo

public MysqlServerStatusInfo getServerStatusInfo()

从接口复制的说明: Command

Mysql 命令执行完后，返回的 Mysql 服务端状态信息，该方法允许返回 null。

指定者:

getServerStatusInfo 在接口中 Command

覆盖:

getServerStatusInfo 在类中 AbstractCommand

返回:

Mysql 服务端状态信息，允许返回 null

toString

public java.lang.String toString()

覆盖:

toString 在类中 java.lang.Object