com.heimuheimu.mysql.jdbc.util

类 MysqlConnectionBuildUtil

java.lang.Object

com.heimuheimu.mysql.jdbc.util.MysqlConnectionBuildUtil

public class MysqlConnectionBuildUtil
extends java.lang.Object

数据库 URL 解析工具类。

作者:

heimuheimu

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	PROPERTY_CAPABILITIES_FLAGS JDBC 参数名称：Mysql 连接需要支持的特性数值，每个比特位可代表不同的特性是否支持(需 MYSQL 服务端也支持该属性才可生效)
static java.lang.String	PROPERTY_CHARACTER_ID JDBC 参数名称：Mysql 连接使用的字符集编码 ID，ID 对应的编码可通过数据库表 "information_schema.collations" 进行查询
static java.lang.String	PROPERTY_DATABASE_NAME JDBC 参数名称：Mysql 数据库名称
static java.lang.String	PROPERTY_HOST JDBC 参数名称：Mysql 地址，由主机名和端口组成，":" 符号分割，例如：localhost:3306
static java.lang.String	PROPERTY_PASSWORD JDBC 参数名称：Mysql 数据库密码
static java.lang.String	PROPERTY_PING_PERIOD JDBC 参数名称：Mysql 连接在空闲时，PING 命令发送时间间隔，单位：秒，如果该值小于等于 0，则不进行心跳检测
static java.lang.String	PROPERTY_SLOW_EXECUTION_THRESHOLD JDBC 参数名称：执行 Mysql 命令过慢最小时间，单位：毫秒，不能小于等于 0
static java.lang.String	PROPERTY_SOCKET_CONFIGURATION JDBC 参数名称：Mysql 连接使用的 Socket 配置信息
static java.lang.String	PROPERTY_TIMEOUT JDBC 参数名称：SQL 执行超时时间，单位：毫秒，如果等于 0，则没有超时时间限制，不允许设置小于 0 的值
static java.lang.String	PROPERTY_UNUSABLE_SERVICE_NOTIFIER JDBC 参数名称：MysqlChannel 不可用通知器
static java.lang.String	PROPERTY_USER JDBC 参数名称：Mysql 数据库用户名

方法概要

限定符和类型	方法和说明
static boolean	acceptsURL(java.lang.String url) 判断传入的 JDBC URL 是否符合 Mysql JDBC URL 规则，即以 "jdbc:mysql://" 开头。
static MysqlConnection	build(java.lang.String url, java.util.Map<java.lang.Object,java.lang.Object> connectionInfo) 根据 JDBC URL 和 Mysql 数据库连接参数 Map 生成对应的 Mysql 数据库连接并返回，该方法不会返回 null。
static ConnectionConfiguration	getConnectionConfiguration(java.util.Map<java.lang.Object,java.lang.Object> connectionInfo) 根据 Mysql 数据库连接参数 Map 生成 ConnectionConfiguration 实例后返回，该方法不会返回 null。
static java.util.Map<java.lang.String,java.lang.Object>	parseURL(java.lang.String url) 将 URL 解析成创建 Mysql 数据库连接需要使用的参数 Map 并返回，该方法不会返回 null。

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

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

字段详细资料

PROPERTY_HOST

public static final java.lang.String PROPERTY_HOST

JDBC 参数名称：Mysql 地址，由主机名和端口组成，":" 符号分割，例如：localhost:3306

另请参阅:

常量字段值

PROPERTY_DATABASE_NAME

public static final java.lang.String PROPERTY_DATABASE_NAME

JDBC 参数名称：Mysql 数据库名称

另请参阅:

常量字段值

PROPERTY_USER

public static final java.lang.String PROPERTY_USER

JDBC 参数名称：Mysql 数据库用户名

另请参阅:

常量字段值

PROPERTY_PASSWORD

public static final java.lang.String PROPERTY_PASSWORD

JDBC 参数名称：Mysql 数据库密码

另请参阅:

常量字段值

PROPERTY_CAPABILITIES_FLAGS

public static final java.lang.String PROPERTY_CAPABILITIES_FLAGS

JDBC 参数名称：Mysql 连接需要支持的特性数值，每个比特位可代表不同的特性是否支持(需 MYSQL 服务端也支持该属性才可生效)

另请参阅:

常量字段值

PROPERTY_CHARACTER_ID

public static final java.lang.String PROPERTY_CHARACTER_ID

JDBC 参数名称：Mysql 连接使用的字符集编码 ID，ID 对应的编码可通过数据库表 "information_schema.collations" 进行查询

另请参阅:

常量字段值

PROPERTY_PING_PERIOD

public static final java.lang.String PROPERTY_PING_PERIOD

JDBC 参数名称：Mysql 连接在空闲时，PING 命令发送时间间隔，单位：秒，如果该值小于等于 0，则不进行心跳检测

另请参阅:

常量字段值

PROPERTY_SOCKET_CONFIGURATION

public static final java.lang.String PROPERTY_SOCKET_CONFIGURATION

JDBC 参数名称：Mysql 连接使用的 Socket 配置信息

另请参阅:

常量字段值

PROPERTY_TIMEOUT

public static final java.lang.String PROPERTY_TIMEOUT

JDBC 参数名称：SQL 执行超时时间，单位：毫秒，如果等于 0，则没有超时时间限制，不允许设置小于 0 的值

另请参阅:

常量字段值

PROPERTY_SLOW_EXECUTION_THRESHOLD

public static final java.lang.String PROPERTY_SLOW_EXECUTION_THRESHOLD

JDBC 参数名称：执行 Mysql 命令过慢最小时间，单位：毫秒，不能小于等于 0

另请参阅:

常量字段值

PROPERTY_UNUSABLE_SERVICE_NOTIFIER

public static final java.lang.String PROPERTY_UNUSABLE_SERVICE_NOTIFIER

JDBC 参数名称：MysqlChannel 不可用通知器

另请参阅:

常量字段值

方法详细资料

build

public static MysqlConnection build(java.lang.String url,
                                    java.util.Map<java.lang.Object,java.lang.Object> connectionInfo)
                             throws java.net.MalformedURLException,
                                    java.lang.IllegalArgumentException,
                                    BuildSocketException

根据 JDBC URL 和 Mysql 数据库连接参数 Map 生成对应的 Mysql 数据库连接并返回，该方法不会返回 null。

注意：参数 Map 中定义的参数值优先级高于 JDBC URL 中定义的参数值。

参数:

url - JDBC URL，例如：jdbc:mysql://localhost:3306/demo，允许为 null

connectionInfo - Mysql 数据库连接参数 Map，允许为 null

返回:

Mysql 数据库连接，不会为 null

抛出:

java.net.MalformedURLException - 如果 JDBC URL 解析失败，将抛出此异常

java.lang.IllegalArgumentException - 如果 timeout 存在且值小于 0，将会抛出此异常

java.lang.IllegalArgumentException - 如果 slowExecutionThreshold 存在且值小于等于 0，将会抛出此异常

BuildSocketException - 如果创建与 Mysql 服务器的 Socket 连接失败，将会抛出此异常

acceptsURL

public static boolean acceptsURL(java.lang.String url)

判断传入的 JDBC URL 是否符合 Mysql JDBC URL 规则，即以 "jdbc:mysql://" 开头。

参数:

url - JDBC URL

返回:

是否符合 Mysql JDBC URL 规则

getConnectionConfiguration

public static ConnectionConfiguration getConnectionConfiguration(java.util.Map<java.lang.Object,java.lang.Object> connectionInfo)

根据 Mysql 数据库连接参数 Map 生成 ConnectionConfiguration 实例后返回，该方法不会返回 null。

参数:

connectionInfo - Mysql 数据库连接参数 Map，不允许为 null

返回:

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

parseURL

public static java.util.Map<java.lang.String,java.lang.Object> parseURL(java.lang.String url)
                                                                 throws java.net.MalformedURLException

将 URL 解析成创建 Mysql 数据库连接需要使用的参数 Map 并返回，该方法不会返回 null。

参数:

url - JDBC URL，例如：jdbc:mysql://localhost:3306/demo，允许为 null

返回:

Mysql 数据库连接参数 Map，不会为 null

抛出:

java.net.MalformedURLException - 如果 JDBC URL 解析失败，将抛出此异常