com.heimuheimu.mysql.jdbc.channel

类 MysqlChannel

java.lang.Object

com.heimuheimu.mysql.jdbc.channel.MysqlChannel

所有已实现的接口:

java.io.Closeable, java.lang.AutoCloseable

public class MysqlChannel
extends java.lang.Object
implements java.io.Closeable

基于 Mysql Client/Server 协议与 Mysql 服务进行数据交互的管道。协议定义请参考文档：

Client/Server Protocol

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

作者:

heimuheimu

构造器概要

构造器

构造器和说明
MysqlChannel(ConnectionConfiguration configuration, UnusableServiceNotifier<MysqlChannel> unusableServiceNotifier) 构造一个与 Mysql 服务进行数据交互的管道。

方法概要

限定符和类型	方法和说明
void	close()
ConnectionConfiguration	getConnectionConfiguration() 获得建立 Mysql 数据库连接使用的配置信息，该方法不会返回 null。
ConnectionInfo	getConnectionInfo() 获得 Mysql 数据库连接信息，如果连接未建立或已关闭，将会返回 null。
void	init() 执行 MysqlChannel 初始化操作。
boolean	isAvailable() 判断当前与 Mysql 服务进行数据交互的管道是否可用。
java.util.List<MysqlPacket>	send(Command command, long timeout) 发送一个 Mysql 命令，并返回响应数据列表，如果等待响应数据超时，当前 MysqlChannel 将会被直接关闭。
java.lang.String	toString()

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

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

构造器详细资料

MysqlChannel

public MysqlChannel(ConnectionConfiguration configuration,
                    UnusableServiceNotifier<MysqlChannel> unusableServiceNotifier)
             throws java.lang.IllegalArgumentException,
                    BuildSocketException

构造一个与 Mysql 服务进行数据交互的管道。

参数:

configuration - 建立 Mysql 数据库连接使用的配置信息，不允许 null

unusableServiceNotifier - MysqlChannel 不可用通知器，允许为 null

抛出:

java.lang.IllegalArgumentException - 如果 configuration 为 null，将会抛出此异常

java.lang.IllegalArgumentException - 如果 Mysql 地址不符合规则，将会抛出此异常

BuildSocketException - 如果创建 Socket 过程中发生错误，将会抛出此异常

方法详细资料

getConnectionConfiguration

public ConnectionConfiguration getConnectionConfiguration()

获得建立 Mysql 数据库连接使用的配置信息，该方法不会返回 null。

返回:

Mysql 数据库连接使用的配置信息

getConnectionInfo

public ConnectionInfo getConnectionInfo()

获得 Mysql 数据库连接信息，如果连接未建立或已关闭，将会返回 null。

返回:

Mysql 数据库连接信息

isAvailable

public boolean isAvailable()

判断当前与 Mysql 服务进行数据交互的管道是否可用。

返回:

管道是否可用

send

public java.util.List<MysqlPacket> send(Command command,
                                        long timeout)
                                 throws java.lang.NullPointerException,
                                        java.lang.IllegalStateException,
                                        java.sql.SQLTimeoutException

发送一个 Mysql 命令，并返回响应数据列表，如果等待响应数据超时，当前 MysqlChannel 将会被直接关闭。

参数:

command - Mysql 命令

timeout - 超时时间，单位：毫秒

返回:

该命令对应的响应数据列表，不会返回 null

抛出:

java.lang.NullPointerException - 如果 command 为 null，将会抛出此异常

java.lang.IllegalStateException - 当前 MysqlChannel 未初始化或已被关闭，将抛出此异常

java.lang.IllegalStateException - 等待响应数据过程中，命令被关闭或中断，将抛出此异常

java.sql.SQLTimeoutException - 如果等待响应数据超时，将抛出此异常

init

public void init()

执行 MysqlChannel 初始化操作。

close

public void close()

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

toString

public java.lang.String toString()

覆盖:

toString 在类中 java.lang.Object