oGRAC JDBC总体架构及用法简介 JDBC驱动介绍： JDBC( Java DataBase Connectivity ) 称为Java数据库连接，是一种访问数据库的标准应用程序API 。为什么需要JDBC:不同的数据库通常会有不同的通信协议, 当一个程序使用不同的数据库时，就不得不按照厂商API写出几套连接程序；而厂商API可能在依赖操作系统功能，这将带来严重的跨平台依赖和重复代码问题。 JDBC的出现解决了这个问题，它提供了一致的编码规范，无论是哪一种数据库，在应用程序层面，都是通过一致的API去访问。驱动标准接口介绍：定义了一组标准的接口用于访问数据库，它们分别是数据库连接对象(Connection), 语句(Statement)以及结果集(ResultSet)，常用API如下：驱动工作流程： JDBC定义了一组标准的接口用于访问数据库，它们分别是数据库连接对象(Connection), 语句(Statement)以及结果集(ResultSet)。JDBC所有对象都必须显式的关闭，否则将造成资源泄露。它们之间的关系如下图示：连接创建语句，语句执行返回结果集。连接配置： oGRAC jdbc支持在url连接串配置参数，建连过程中会解析这些参数，目前url连接串支持的参数及各参数功能如下：参数功能取值范围默认值 autoBalance 负载均衡模式 1、roundrobin: 轮询模式，也可取值true、banlace 2、shuffle：随机模式 3、leastconn：最小连接模式 4、priority[n]：带优先级的轮询，表示在前n个节点上轮询，例如priority3表示在前3个节点上轮询 false user 客户端连接数据库的用户名字符串类型 null password 客户端连接数据库的用户密码字符串类型 null ssl 连接方式 1、true，表示以ssl方式连接 2、false，普通连接默认为false false enabledCipherSuites 用于配置SSL的加密算法，指定在SSL连接中用特定的加密算法进行加密弱加密算法包括RC4、3DES等强加密算法：AES-GCM、ChaCha20-Poly1305 null，不指定加密算法，使用默认加密套件组： “TLS_AES_128_GCM_SHA256” “TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384” “TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256” “TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384” “TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256” verifyServerCertificate 是否校验服务端证书 Boolean类型 false isUseEnvForSsl 暂不明确其作用，先不启用 Boolean类型 true isRevocationEnabled 暂不明确其作用，先不启用 Boolean类型 false fetchsize 设置为n后，执行查询，调用resultSet.next()，jdbc会与服务端通信，取n条数据到客户端，然后返回第一条给调用者取值为int类型，1,2,3,4…..n 0，表示不限制 autoCommit 是否开启事务自动提交模式 1、true，每个语句都会自动开启事务，执行后自动事务提交 2、false，自动开启一个事务，需要手动执行sql语句提交事务 true，该参数仅支持通过调connection.setAutoCommit(true)设置 loginTimeout 控制与数据库建连超时时间，超过阈值则退出取值int类型，单位：秒 0，表示无限期等待服务端返回 socketTimeout 控制单个sql最长执行时间，超过该值则报错退出取值int类型，单位：秒 0，表示不设置超时时间，socket一直阻塞等待数据 receiveBufferSize socket读取缓冲区的数据大小取值int类型，单位：字节，默认-1 -1，表示不限制 sendBufferSize socket写入缓冲区的数据大小取值int类型，单位：字节，默认-1 -1，表示不限制驱动工作流程： jdbc的应用层面，对业务sql的执行过程通常分成三个步骤： 1)建立与数据库的连接。建连过程包括：socket连接、TCP握手、鉴权、登录操作，登录数据库并收到正确响应之后即可执行业务sql，在多节点场景下还需根据轮询规则选择节点。 2)执行sql。执行sql包括简单sql文本、预编译sql、存储过程三种模式，三种模式在驱动层对sql的封装逻辑有差异，但与数据库交互方式相同，均需将sql请求封装到outputStream输出流中发送到服务端，对响应包根据参天通信协议进行解码。 3)数据格式化输出。对响应包解码生成字节码数据，特别的，需对select查询结果进行数据转化，实现getXX方法，将字节码按照其字段类型对应的编码算法转成为特定格式，最后应关闭连接资源、会话资源等。命令码 oGRAC服务端目前支持如下客户端命令码：常量值用途 LOGIN 1 登录 FREE_STMT 2 释放语句 PREPARE 3 预编译 EXECUTE 5 已prepare的执行 FETCH 6 分批拉取 COMMIT 7 提交 ROLLBACK 8 回滚 LOGOUT 9 登出 CANCEL 10 取消 QUERY 11 查询（定义） PREP_AND_EXECUTE 12 Statement执行sql READ_LOB_DATA 13 LOB分块读取 HANDLE_SHAKE 19 握手 AUTH_INIT 21 初始化认证多节点负载均衡在多节点的连接场景下，oGRAC jdbc还提供主备模式和负载均衡两种模式连接数据库，通过url设置多个数据库节点，实现对主备的访问，如下： 1. 主备模式。该模式下，业务只能连一个节点进行读写操作，当前节点故障后自动切换下一个节点，不具备负载均衡功能。 2. 负载均衡模式。 jdbc可以在建立连接时，依照特定的负载均衡规则将客户端与主备集群的连接以此建立在URL中的各个节点上，以此实现负载均衡，支持roundrobin、priority roundrobin、leastconn、shuffle四种负载均衡模式，具体如下： 1）roundrobin：轮询模式，即与各候选节点轮流建立连接。取值："roundrobin"、"true"、"balance"。 2）priority roundrobin：带优先级的轮询模式，优先对前n个候选节点做轮询建连，取值："proprity[n]"，n为非负整数。 3）leastconn：最小连接模式，对候选节点依照各节点的有效连接数做优先级排序，优先与连接数少的节点建立连接，该方法只会统计通过当前驱动在当前集群内使用leastconn模式建立的连接。取值："leastconn"。 4）shuffle：随机模式，即随机选择候选节点建立连接，取值："shuffle"。loadBalanceHosts设置为"true"等同于autoBalance设置为"shuffle"。数据类型映射关系驱动将数据库返回的数据类型根据其类型码转换为JDK标准数据类型，再转化为java标准数据类型，返回给客户端，数据类型对应关系如下表：数据库类型类型码 JDBC映射类型 INT 1 INTEGER BIGINT 2 BIGINT REAL 3 REAL / DOUBLE NUMERIC / DECIMAL 4/5 NUMERIC CHAR/VARCHAR/TEXT 8/9/10 CHAR/VARCHAR BINARY/VARBINARY 11/12/23 BINARY/VARBINARY BLOB 14 BLOB REF_CURSOR 15 REF_CURSOR BOOL 17 BOOLEAN TIMESTAMP / TIMESTAMP_TZ / TIME 7/32/113 TIMESTAMP / TIMESTAMP_WITH_TIMEZONE / TIME UINT 25 BIGINT