JDBC 4.2 Specifications 中文翻译 -- 第九章 连接
一个 Connection
对象,表示了与某个数据源的一条连接,数据源的种类可以是关系型数据库,文件系统等等之类,只要有对应的 JDBC 驱动,都可以称之为数据源。应用程序使用 JDBC API 来维护多条连接,这些连接可能访问的是多个数据源,也可能访问的只是一个数据源。从 JDBC 驱动的角度来看,一个 Connection
对象就意味着一个客户端会话,一个会话会保持许多状态,例如用户 ID,一系列的 SQL Statement 以及结果集,也保存了当前使用的事务处理策略。
可以通过以下两种方式之一来获取一条连接:
- 使用
DriverManager
这个类以及各种各样的驱动实现 - 使用
DataSource
类
更推荐使用 DataSource
对象来获取连接,因为这增强了应用的可移植性,使得代码更容易维护了,并且使得对连接池和分布式事务的使用更加地透明。所有的 Java EE 组件,都会使用 DataSource 对象来获取连接。
这一章将会介绍各种不同的 JDBC 驱动以及如何使用 Driver
接口、DriverManager
类以及基本的 DataSource
接口。关于连接池和分布式事务的介绍分别在第11章和第12章做介绍。
9.1 驱动的种类
- Type 1
这种类型的 JDBC 驱动是对另外一种访问 API 的映射,比如说 ODBC,一般需要依赖本地库,这就导致了它的可移植性不行。JDBC-ODBC 桥就是这种类型的驱动。 - Type 2
这种类型的 JDBC 驱动一部分是用 Java 语言写的,一部分是用本地代码写的。这种驱动使用一个本地的客户端库来连接数据源。由于对本地代码的使用,可移植性也不行。 - Type 3
这种类型的驱动使用纯 Java 语言编写,但是通信的时候需要经过一个中间件,使用的是与数据库具体协议无关的独立协议。这个中间件转发客户端的请求给后面的数据源。 - Type 4
这种类型的驱动使用纯 Java 语言编写,并且使用网络协议或者文件 IO 与具体的数据源通信,客户端直接与数据源连接。
9.2 Driver 接口
编写 JDBC 驱动,必须实现 Driver 接口,并且实现类中必须包含一个静态初始化块,当驱动被加载时,这块代码会被调用。这块代码的主要工作是讲自己注册给 DriverManager,如下代码所示:
public class AcmeJdbcDriver implements java.sql.Driver {static {java.sql.DriverManager.registerDriver(newAcmeJdbcDriver());}
}
驱动的实现类必须提供一个无参构造函数,当 DriverManager 想要与 Driver 交互时,它会直接调用它的方法,Driver 接口包含了一个 acceptsURL 方法,DriverManager 可以调用这个方法来判断该驱动是否能处理对应的 JDBC URL。
当 DriverManager 想要建立一条数据库连接时,它会调用驱动实现类的 connect 方法,并把 URL 作为参数穿给它,这个方法会返回一个 Connection 对象,或者是当无法建立数据库连接时,抛出一个 SQLException。如果驱动实现类无法解析 URL,这个方法将会返回 null。
## 9.2.1 加载一个实现了 java.sql.Driver 接口的驱动类
DriverManager 初始化的时候,会先通过 “java.drivers” 这个系统属性来尝试加载驱动,如以下例子:
java -Djdbc.drivers=com.acme.jdbc.AcmeJdbcDriver Test
DriverManager 的 getConnection 方法能够支持 Java SE 的 SPI 服务发现机制,JDBC 4.0 的驱动必须包含以下文件 “META-INF/services/java.sql.Driver”,这个文件会包含实现了 Driver 接口的类名
9.3 DriverAction 接口
当 DriverManager 的 deregisterDriver 方法被调用时,如果想要被通知到,那么 JDBC 驱动就得有对应的实现了 DriverAction 接口的类,DriverAction 的具体实现类并不希望直接被上层应用拿来使用,所以实现 JDBC 驱动的时候,应该将这个类定义为私有的类,以防止被直接使用。
JDBC 驱动的静态初始化块里面,必须调用 DriverManager.registerDriver(java.sql.Driver, java.sql.DriverAction) 方法,这样当一个 JDBC 驱动被 DriverManager 注销的时候,才能被通知到,如下所示:
public class AcmeJdbcDriver implements java.sql.Driver {static DriverAction da;static {java.sql.DriverManager.registerDriver(newAcmeJdbcDriver(), da);}
}
9.4 DriverManager 类
DriverManager 类与 Driver 接口一起协作,维护所有可用的 JDBC 驱动。当应用程序通过一个 URL 来获取一个连接的时候, DriverManager 负责找到一个适用该 URL 的驱动,用这个驱动来获取对应的数据源的连接。
DriverManager 的关键方法如下所示:
- registerDriver
这个方法会将某个驱动加进可用驱动的集合里,它在一个驱动被装载的时候隐式地调用,一般情况下是驱动的静态代码块里调用这个方法。 - getConnection
这个方法用来获取一个连接,要调用这个方法,必须提供一个 JDBC URL,DriverManager 会使用这个 URL 来轮询所有已经注册的驱动,并找到一个可以识别这个 URL 的驱动,驱动会返回一个 Connection 给 DriverManager,然后再把它交给应用程序。
JDBC URL 的格式如下所示:
jdbc:<subprotocol>:<subname>
subprotocol 定义是要连接的是哪种类型的数据库,subname 则会根据 subprotoco 的不同而不同。
以下代码示范了如何从 DriverManager 获取一个连接:
String url = "jdbc:derby:sample";
String user = "SomeUser";
String passwd = "SomePwd";Connection con = DriverManager.getConnection(url, user, passwd);
DriverManager 类也提供了另外一些获取连接的方法:
- getConnection(String url)
这个方法适用于不需要提供用户名和密码的情况 - getConnection(String url, java.util.Properties prop)
这个方法允许在 prop 参数里加入用户名和密码,以及其它属性
DriverPropertyInfo 这个类提供了一个驱动可以理解的所有的属性,详见 Java JDBC API DOC
9.5 SQLPermission 类
这个类代表了一个代码基所拥有的权限。当前唯一定义的权限是 setLog 权限。当一个 Applet 调用了 DriverManager 的 setLogWriter 或者 setLogStream 方法时,SecurityManager 将会检查是否有权限。如果没有权限,将会抛出一个 java.lang.SecurityException 异常
9.6 DataSource 接口
DataSource 这个接口是在 JDBC2.0 的可选属性里引进的,这是 JDBC 规范推荐的用来获取数据源连接的方式。实现了 DataSource 接口的 JDBC 驱动会返回和通过 DriverManager 获取的相同的 Connection 实例,使用 DataSource 接口使应用程序更加具有可移植性,因为应用程序不需要为某个特定的驱动提供相关的连接信息,仅仅需要提供一个逻辑的数据源名。逻辑数据源名用来映射到 JNDI 提供的 DataSource 实例。这个 DataSource 实例代表了一个物理上的数据源,并提供获取相应连接的方法。如果关于数据源的属性或者信息发生了变化,DataSource 对象可以感知到对应的变化,完全不需要改变应用代码。
实现 DataSource 接口时,应该透明地提供以下功能:
- 通过连接的池化来提高性能和可扩展性
- 通过 XADataSource 接口来支持分布式事务
还需要注意的是,DataSource 的实现类必须提供一个无参构造函数
接下来的3个小节主要讨论:
- 基本的 DataSource 属性
- 使用 JNDI API 如何提供应用的可移植性以及可维护性
- 如果获取一个连接
9.6.1 DataSource 的属性
JDBC API 定义了一系列的属性来描述 DataSource 的实现,具体的属性有哪些,取决于具体的 DataSource 实现,也就是说,取决于该实现是一个基本的 DataSource 对象,还是 ConnectionPoolDataSource,或者是 XADataSource,无论什么实现,它们都会有共同的属性 description,以下是标准的 DataSource 属性:
属性名 | 数据类型 | 描述 |
---|---|---|
databaseName | String | 数据库名 |
dataSourceName | String | 数据源名,用来命名底层的 XADataSource 或者是 ConnectionPoolDataSource |
description | String | 对此 DataSource 的描述信息 |
networkProtocol | String | 网络协议 |
password | String | 数据库密码 |
portNumber | int | 数据库监听端口 |
roleName | String | 初始 SQL roleName |
serverName | String | 数据库服务器名 |
user | String | 数据库用户名 |
DataSource 的属性遵循 JavaBean 1.01 规范。具体 DataSource 实现可以添加属性,但是不能与原有的有冲突。这些属性必须提供对应的 setter 和 getter 方法,当一个新的 DataSource 初始化的时候,这些属性也应该相应进行初始化,如以下代码所示,这里的实现是一个 VendorDataSource:
VendorDataSource vds = new VendorDataSource();
vds.setServerName("my_database_server");
String name = vds.getServerName();
DataSource 的属性,设计的初衷是不应该直接被应用代码获取,应该在具体的实现类里提供获取的方法,而不是在 DataSource 上定义 public 的属性,想要获取属性值,可以通过“自省”的方式(反射)来获取。
9.6.2 JNDI API 以及应用可移植性
Java Naming and Directory Interface (JNDI) API 提供让应用通过网络访问远程服务的统一方式,本小节将描述如何使用 JNDI 来注册并访问一个 JDBC 数据源对象。更详细的信息可以查阅 JNDI 规范。
使用 JNDI API,应用可以通过指定一个逻辑名来访问一个数据源,在这里 JNDI 需要使用到命名服务,来将逻辑名映射到对应的数据源。这个特性极大地增强了应用的可移植性,因为很多数据源的配置,可以在不修改应用层代码的情况下进行修改,例如端口号和服务器名。事实上,应用可以透明地访问另一个完全不同的数据源,只需要修改对应的配置。在三层架构的环境中,这个特性很重要,应用服务器会将访问不同数据源的细节隐藏起来,不需要对应用开放。
以下代码实例了如何使用 JNDI 来注册一个数据源对象:
// Create a VendorDataSource object and set some properties
VendorDataSource vds = new VendorDataSource();
vds.setServerName("my_database_server");
vds.setDatabaseName("my_database");
vds.setDescription("data source for inventory and personnel");// Use the JNDI API to register the new VendorDataSource object.
// Reference the root JNDI naming context and then bind the
// logical name "jdbc/AcmeDB" to the new VendorDataSource object.
Context ctx = new InitialContext();
ctx.bind("jdbc/AcmeDB", vds);
9.6.3 通过 DataSource 实例获取连接
一旦一个 DataSource 注册在 JNDI 的命名服务后,应用可以使用它来获取一条到物理数据源的连接,如下代码所示:
// Get the initial JNDI naming context
Context ctx = new InitialContext();
// Get the DataSource object associated with the logical name
// "jdbc/AcmeDB" and use it to obtain a database connection
DataSource ds = (DataSource)ctx.lookup("jdbc/AcmeDB");
Connection con = ds.getConnection("user", "pwd");
9.6.4 关闭连接
Connection.close(), Connection.isclosed() 和 Connection.isValid() 这些方法可以用来关闭一条连接和判断一条连接是否还处于活跃状态。
9.6.4.1 Connection.close
An application calls the method当应用使用完一条连接后,可以调用 Connection.close() 来关闭这条连接,在这条连接上所有的 Statement 对象也会被关闭。
一条连接关闭后,除了 close(), isClosed() 和 isValid() 方法外,调用其它的方法将会抛出一个 SQLException。
9.6.4.2 Connection.isClosed
这个方法用来判断一条连接的 close() 方法是否已经被调用过,这个方法不能用来判断连接是否还可用。
但是有写 JDBC 驱动可能会增强 isClosed() 方法,使得可以利用这个方法来判断一条连接是否还可用。在这里,为了最大的可移植性,应用应该通过 Connection.isValid() 来判断一条连接是否还可用。
9.6.4.3 Connection.isValid
这个方法用来标识一条连接是否还可用,如果不可用,那么除了 close(),isClosed() 和isValid() 方法之外,调用其它方法将会抛出 SQLException
JDBC 4.2 Specifications 中文翻译 -- 第九章 连接相关推荐
- jBPM3.12用户指南中文翻译----第一章 绪论
这是Jboss 的jBPM3.12框架的用户指南的中文翻译.其中第一章的译文,是我在网上找到的.其他几章都是我自己做的翻译.我的翻译是中英文对照,只翻译部分我认为重要的,不翻译简单的英文,以免浪费你我 ...
- jBPM3.12用户指南中文翻译----第二章 起步
这是Jboss 的jBPM3.12框架的用户指南的中文翻译.我的翻译风格是中英文对照,只翻译部分我认为重要的,不翻译简单的英文,以免浪费你我的时间. 同时,对于其中的部分内容,我会在翻译 ...
- Lisp-Stat翻译 —— 第九章 统计绘图窗体
2019独角兽企业重金招聘Python工程师标准>>> 第九章 统计绘图窗体 除了前几章略述的绘图窗体原型提供的基本绘图工具之外,Lisp-Stat里的统计绘图还需要用来管理数据和将 ...
- 建筑信息化模型BIM经典《BIM Handbook》中文翻译第一章第二节(持续更新)
1.2 现代AEC商业模式 目前,设备交付过程仍然是分散的,它依赖于基于纸张的信息传递方式.文件文档中的错误和遗漏经常会导致项目团队中各方之间意想不到的现场成本.延迟和最终的诉讼.这些问题会引起摩擦. ...
- 【NVMe】NVMe 1.3协议中文翻译——第一章简介
一.简介 1.1概述 NVMe协议(以前也叫NVMHCI)接口允许主机软件与非易失性存储器子系统通信. 此接口针对企业和客户端固态驱动器进行了优化,通常作为寄存器级接口连接到PCI Express接口 ...
- 《Linux 高级路由与流量控制手册(2012)》第九章
更多奇技淫巧欢迎订阅博客:https://fuckcloudnative.io 译者序 本文内容来自 Linux Advanced Routing & Traffic Control HOWT ...
- 《英文观止》第一章~第九章笔记和翻译
前言 我在暑假的时候开始尝试翻译英语一的阅读句子,emmmmm--翻译了一张卷子后感觉糟糕透了,因为大部分单词我都能看懂,但翻译起来就是语句不通,翻译完看译文更是对自己产生深深的怀疑,然后我就想办法解 ...
- 《Introduction to Tornado》中文翻译计划——第五章:异步Web服务
http://www.pythoner.com/294.html 本文为<Introduction to Tornado>中文翻译,将在https://github.com/alioth3 ...
- 【机器学习实战 第九章】树回归 CART算法的原理与实现 - python3
本文来自<机器学习实战>(Peter Harrington)第九章"树回归"部分,代码使用python3.5,并在jupyter notebook环境中测试通过,推荐c ...
最新文章
- 8、显示程序占用内存多少.txt
- 【CSS】选择器优先级
- Android官方开发文档Training系列课程中文版:使用Fragment构建动态UI之构建灵活的UI
- 大型JavaScript应用程序架构模式
- C#算法设计查找篇之03-插值查找
- 【读书札记】《怦然心动——情感化交互设计指南》
- 执行文件mysql使用source 命令乱码问题
- java HTableDescriptor类解析
- LINUX SHELL命令ls只列出目录名
- matlab求任意输入响应曲线,3.6 用Matlab进行动态响应分析
- 解决关于WPS插入公式后显示不全的问题
- 集线器工作原理简要说明
- BiDi单纤双向光模块全解析
- 正确认识形势 提升信心 增强斗志
- 阿里云轻量和云服务器ECS区别对比大全(很详细)
- js中jquery鼠标事件(点击替换、鼠标移入、移出)
- 蘑菇模拟器TV版 for Android,真实采集蘑菇模拟器
- PAT 1046 划拳
- yum 命令使用详解
- maven 指令之package 和install的区别
热门文章
- 标定板标定和九点标定的区别_射频导纳物位计的标定方法
- 原始尺寸_螺母尺寸检测,螺丝螺母外观检测设备
- JavaWeb:CSS层叠样式表
- RuntimeException: Package manager has died
- oracle用户权限的基本查询
- 小派(PiMax)vr Artisan固件升级失败,没反应了
- php aws s3查看所有文件_国内AWS没有文件系统服务,快来看如何通过EC2挂载S3存储桶替代...
- Axure中推动拉动元件不生效_单线图标元件库SVG矢量图标 纯净无干扰的Axure元件库...
- 如何关闭win10自动更新_如何关闭win10系统自动更新
- w3wp进程发生死锁ISAPI aspnet