public interface Connection
与特定数据库的连接(会话)。在连接上下文中执行 SQL 语句并返回结果。
Connection
对象的数据库能够提供描述其表、所支持的 SQL 语法、存储过程、此连接功能等等的信息。此信息是使用 getMetaData
方法获得的。
注:在配置 Connection
时,JDBC 应用程序应该使用适当的 Connection
方法,比如 setAutoCommit
或 setTransactionIsolation
。在有可用的 JDBC 方法时,应用程序不能直接调用 SQL 命令更改连接的配置。默认情况下,Connection
对象处于自动提交模式下,这意味着它在执行每个语句后都会自动提交更改。如果禁用了自动提交模式,那么要提交更改就必须显式调用 commit
方法;否则无法保存数据库更改。
使用 JDBC 2.1 核心 API 创建的新 Connection
对象有一个与之关联的最初为空的类型映射。用户可以为此类型映射中的 UDT 输入一个自定义映射关系。在使用 ResultSet.getObject
方法从数据源中获取 UDT 时,getObject
方法将检查该连接的类型映射是否有对应该 UDT 的条目。如果有,那么 getObject
方法将该 UDT 映射到所指示的类。如果没有条目,则使用标准映射关系映射该 UDT。
用户可以创建一个新的类型映射,该映射是一个 java.util.Map
对象,可在其中创建一个条目,并将该条目传递给可以执行自定义映射关系的 java.sql
方法。在这种情况下,该方法将使用给定的类型映射,而不是与连接关联的映射。
例如,以下代码片段指定 SQL 类型 ATHLETES
将被映射到 Java 编程语言中的 Athletes
类。该代码片段为 Connection
对象 con
获取类型映射,并在其中插入条目,然后使用新的条目将该类型映射设置为连接的类型映射。
java.util.Map map = con.getTypeMap(); map.put("mySchemaName.ATHLETES", Class.forName("Athletes")); con.setTypeMap(map);
DriverManager.getConnection(java.lang.String, java.util.Properties)
,
Statement
,
ResultSet
,
DatabaseMetaData
字段摘要 | |
---|---|
static int |
TRANSACTION_NONE 指示事务不受支持的常量。 |
static int |
TRANSACTION_READ_COMMITTED 指示不可以发生脏读的常量;不可重复读和虚读可以发生。 |
static int |
TRANSACTION_READ_UNCOMMITTED 指示可以发生脏读 (dirty read)、不可重复读和虚读 (phantom read) 的常量。 |
static int |
TRANSACTION_REPEATABLE_READ 指示不可以发生脏读和不可重复读的常量;虚读可以发生。 |
static int |
TRANSACTION_SERIALIZABLE 指示不可以发生脏读、不可重复读和虚读的常量。 |
方法摘要 | |
---|---|
void |
clearWarnings() 清除为此 Connection 对象报告的所有警告。 |
void |
close() 立即释放此 Connection 对象的数据库和 JDBC 资源,而不是等待它们被自动释放。 |
void |
commit() 使所有上一次提交/回滚后进行的更改成为持久更改,并释放此 Connection 对象当前持有的所有数据库锁。 |
Array |
createArrayOf(String typeName, Object[] elements) 创建 Array 对象的工厂方法。 |
Blob |
createBlob() 构造实现 Blob 接口的对象。 |
Clob |
createClob() 构造实现 Clob 接口的对象。 |
NClob |
createNClob() 构造实现 NClob 接口的对象。 |
SQLXML |
createSQLXML() 构造实现 SQLXML 接口的对象。 |
Statement |
createStatement() 创建一个 Statement 对象来将 SQL 语句发送到数据库。 |
Statement |
createStatement(int resultSetType, int resultSetConcurrency) 创建一个 Statement 对象,该对象将生成具有给定类型和并发性的 ResultSet 对象。 |
Statement |
createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) 创建一个 Statement 对象,该对象将生成具有给定类型、并发性和可保存性的 ResultSet 对象。 |
Struct |
createStruct(String typeName, Object[] attributes) 创建 Struct 对象的工厂方法。 |
boolean |
getAutoCommit() 获取此 Connection 对象的当前自动提交模式。 |
String |
getCatalog() 获取此 Connection 对象的当前目录名称。 |
Properties |
getClientInfo() 返回一个列表,它包含驱动程序支持的每个客户端信息属性的名称和当前值。 |
String |
getClientInfo(String name) 返回通过名称指定的客户端信息属性的值。 |
int |
getHoldability() 获取使用此 Connection 对象创建的 ResultSet 对象的当前可保存性。 |
DatabaseMetaData |
getMetaData() 获取一个 DatabaseMetaData 对象,该对象包含关于此 Connection 对象所连接的数据库的元数据。 |
int |
getTransactionIsolation() 获取此 Connection 对象的当前事务隔离级别。 |
Map<String,Class<?>> |
getTypeMap() 获取与此 Connection 对象关联的 Map 对象。 |
SQLWarning |
getWarnings() 获取此 Connection 对象上的调用报告的第一个警告。 |
boolean |
isClosed() 查询此 Connection 对象是否已经被关闭。 |
boolean |
isReadOnly() 查询此 Connection 对象是否处于只读模式。 |
boolean |
isValid(int timeout) 如果连接尚未关闭并且仍然有效,则返回 true。 |
String |
nativeSQL(String sql) 将给定的 SQL 语句转换成系统本机 SQL 语法。 |
CallableStatement |
prepareCall(String sql) 创建一个 CallableStatement 对象来调用数据库存储过程。 |
CallableStatement |
prepareCall(String sql, int resultSetType, int resultSetConcurrency) 创建一个 CallableStatement 对象,该对象将生成具有给定类型和并发性的 ResultSet 对象。 |
CallableStatement |
prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) 创建一个 CallableStatement 对象,该对象将生成具有给定类型和并发性的 ResultSet 对象。 |
PreparedStatement |
prepareStatement(String sql) 创建一个 PreparedStatement 对象来将参数化的 SQL 语句发送到数据库。 |
PreparedStatement |
prepareStatement(String sql, int autoGeneratedKeys) 创建一个默认 PreparedStatement 对象,该对象能获取自动生成的键。 |
PreparedStatement |
prepareStatement(String sql, int[] columnIndexes) 创建一个能返回由给定数组指定的自动生成键的默认 PreparedStatement 对象。 |
PreparedStatement |
prepareStatement(String sql, int resultSetType, int resultSetConcurrency) 创建一个 PreparedStatement 对象,该对象将生成具有给定类型和并发性的 ResultSet 对象。 |
PreparedStatement |
prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) 创建一个 PreparedStatement 对象,该对象将生成具有给定类型、并发性和可保存性的 ResultSet 对象。 |
PreparedStatement |
prepareStatement(String sql, String[] columnNames) 创建一个能返回由给定数组指定的自动生成键的默认 PreparedStatement 对象。 |
void |
releaseSavepoint(Savepoint savepoint) 从当前事务中移除指定的 Savepoint 和后续 Savepoint 对象。 |
void |
rollback() 取消在当前事务中进行的所有更改,并释放此 Connection 对象当前持有的所有数据库锁。 |
void |
rollback(Savepoint savepoint) 取消所有设置给定 Savepoint 对象之后进行的更改。 |
void |
setAutoCommit(boolean autoCommit) 将此连接的自动提交模式设置为给定状态。 |
void |
setCatalog(String catalog) 设置给定目录名称,以便选择要在其中进行工作的此 Connection 对象数据库的子空间。 |
void |
setClientInfo(Properties properties) 设置连接的客户端信息属性的值。 |
void |
setClientInfo(String name, String value) 将 name 指定的客户端信息属性的值设置为 value 指定的值。 |
void |
setHoldability(int holdability) 将使用此 Connection 对象创建的 ResultSet 对象的默认可保存性 (holdability) 更改为给定可保存性。 |
void |
setReadOnly(boolean readOnly) 将此连接设置为只读模式,作为驱动程序启用数据库优化的提示。 |
Savepoint |
setSavepoint() 在当前事务中创建一个未命名的保存点 (savepoint),并返回表示它的新 Savepoint 对象。 |
Savepoint |
setSavepoint(String name) 在当前事务中创建一个具有给定名称的保存点,并返回表示它的新 Savepoint 对象。 |
void |
setTransactionIsolation(int level) 试图将此 Connection 对象的事务隔离级别更改为给定的级别。 |
void |
setTypeMap(Map<String,Class<?>> map) 将给定的 TypeMap 对象安装为此 Connection 对象的类型映射。 |
从接口 java.sql.Wrapper 继承的方法 |
---|
isWrapperFor, unwrap |
字段详细信息 |
---|
static final int TRANSACTION_NONE
static final int TRANSACTION_READ_UNCOMMITTED
static final int TRANSACTION_READ_COMMITTED
static final int TRANSACTION_REPEATABLE_READ
static final int TRANSACTION_SERIALIZABLE
TRANSACTION_REPEATABLE_READ
中禁止的事项,同时还禁止出现这种情况:某一事务读取所有满足
WHERE
条件的行,另一个事务插入一个满足
WHERE
条件的行,第一个事务重新读取满足相同条件的行,并在第二次读取时获得额外的“虚”行。
方法详细信息 |
---|
Statement createStatement() throws SQLException
Statement
对象来将 SQL 语句发送到数据库。不带参数的 SQL 语句通常使用
Statement
对象执行。如果多次执行相同的 SQL 语句,使用
PreparedStatement
对象可能更有效。
使用返回的 Statement
对象创建的结果集在默认情况下类型为 TYPE_FORWARD_ONLY
,并带有 CONCUR_READ_ONLY
并发级别。已创建结果集的可保存性可调用 getHoldability()
确定。
Statement
对象
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
PreparedStatement prepareStatement(String sql) throws SQLException
PreparedStatement
对象来将参数化的 SQL 语句发送到数据库。
带有 IN 参数或不带有 IN 参数的 SQL 语句都可以被预编译并存储在 PreparedStatement
对象中。然后可以有效地使用此对象来多次执行该语句。
注:为了处理受益于预编译的带参数 SQL 语句,此方法进行了优化。如果驱动程序支持预编译,则 prepareStatement
方法将该语句发送给数据库进行预编译。一些驱动程序可能不支持预编译。在这种情况下,执行 PreparedStatement
对象之前无法将语句发送给数据库。这对用户没有直接影响;但它的确会影响哪些方法将抛出某些 SQLException
对象。
使用返回的 PreparedStatement
对象创建的结果集在默认情况下类型为 TYPE_FORWARD_ONLY
,并带有 CONCUR_READ_ONLY
并发级别。已创建结果集的可保存性可调用 getHoldability()
确定。
sql
- 可能包含一个或多个 '?' IN 参数占位符的 SQL 语句
PreparedStatement
对象
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
CallableStatement prepareCall(String sql) throws SQLException
CallableStatement
对象来调用数据库存储过程。
CallableStatement
对象提供了设置其 IN 和 OUT 参数的方法,以及用来执行调用存储过程的方法。
注:为了处理存储过程调用语句,此方法进行了优化。某些驱动程序可以在调用 prepareCall
方法后将调用语句发送给数据库;另一些则直到执行了 CallableStatement
对象后才可以发送。这对用户没有直接影响;但它的确会影响哪些方法将抛出某些 SQLException。
使用返回的 CallableStatement
对象创建的结果集在默认情况下类型为 TYPE_FORWARD_ONLY
,并带有 CONCUR_READ_ONLY
并发级别。已创建结果集的可保存性可调用 getHoldability()
确定。
sql
- 可以包含一个或多个 '?' 参数占位符的 SQL 语句。通常此语句是使用 JDBC 调用转义语法指定的。
CallableStatement
对象
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
String nativeSQL(String sql) throws SQLException
sql
- 可以包含一个或多个 '?' 参数占位符的 SQL 语句
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
void setAutoCommit(boolean autoCommit) throws SQLException
commit
方法或
rollback
方法为止。默认情况下,新连接处于自动提交模式。
提交发生在语句完成时。语句完成的时间取决于 SQL 语句的类型:
CallableStatement
对象或者返回多个结果的语句,语句在所有关联结果集关闭并且已获得所有更新计数和输出参数时完成。 注:如果在事务和自动提交模式更改期间调用此方法,则提交该事务。如果调用 setAutoCommit
而自动提交模式未更改,则该调用无操作(no-op)。
autoCommit
- 为
true
表示启用自动提交模式;为
false
表示禁用自动提交模式
SQLException
- 如果发生数据库访问错误,在参与分布式事务的同时调用 setAutoCommit(true),或者在关闭的连接上调用此方法
getAutoCommit()
boolean getAutoCommit() throws SQLException
Connection
对象的当前自动提交模式。
Connection
对象的自动提交模式的当前状态
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
getAutoCommit()
,
setAutoCommit(boolean)
void commit() throws SQLException
Connection
对象当前持有的所有数据库锁。此方法只应该在已禁用自动提交模式时使用。
SQLException
- 如果发生数据库访问错误,在参与分布式事务的同时调用此方法,在关闭的连接上调用此方法,或者此
Connection
对象处于自动提交模式
setAutoCommit(boolean)
void rollback() throws SQLException
Connection
对象当前持有的所有数据库锁。此方法只应该在已禁用自动提交模式时使用。
SQLException
- 如果发生数据库访问错误,在参与分布式事务的同时调用此方法,在关闭的连接上调用此方法,或者此
Connection
对象处于自动提交模式
setAutoCommit(boolean)
void close() throws SQLException
Connection
对象的数据库和 JDBC 资源,而不是等待它们被自动释放。
在已经关闭的 Connection
对象上调用 close
方法无操作 (no-op)。
建议最好在调用 close
方法之前,应用程序显式提交或回滚一个活动事务。如果调用 close
方法并且有一个活动事务,那么结果将由实现定义。
SQLException
- 如果发生数据库访问错误
boolean isClosed() throws SQLException
Connection
对象是否已经被关闭。如果在连接上调用了
close
方法或者发生某些严重的错误,则连接被关闭。只有在调用了
Connection.close
方法之后被调用时,此方法才保证返回
true
。
通常不能调用此方法确定到数据库的连接是有效的还是无效的。通过捕获在试图进行某一操作时可能抛出的异常,典型的客户端可以确定某一连接是无效的。
Connection
对象是关闭的,则返回
true
;如果它仍然处于打开状态,则返回
false
SQLException
- 如果发生数据库访问错误
DatabaseMetaData getMetaData() throws SQLException
DatabaseMetaData
对象,该对象包含关于此
Connection
对象所连接的数据库的元数据。元数据包括关于数据库的表、受支持的 SQL 语法、存储过程、此连接功能等等的信息。
Connection
对象的一个
DatabaseMetaData
对象
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
void setReadOnly(boolean readOnly) throws SQLException
注:此方法不能在事务处理期间调用。
readOnly
- 为
true
表示启用只读模式;为
false
表示禁用只读模式
SQLException
- 如果发生数据库访问错误,在关闭的连接上调用此方法,或者在事务处理期间调用此方法
boolean isReadOnly() throws SQLException
Connection
对象是否处于只读模式。
Connection
对象是只读的,则返回
true
;否则返回
false
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
void setCatalog(String catalog) throws SQLException
Connection
对象数据库的子空间。
如果驱动程序不支持这些目录,那么它将直接忽略此请求。
catalog
- 在其中进行工作的目录(此
Connection
对象的数据库的子空间)的名称
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
getCatalog()
String getCatalog() throws SQLException
Connection
对象的当前目录名称。
null
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
setCatalog(java.lang.String)
void setTransactionIsolation(int level) throws SQLException
Connection
对象的事务隔离级别更改为给定的级别。可能的事务隔离级别是
Connection
接口中定义的常量。
注:如果在事务处理期间调用此方法,则结果由实现定义。
level
- 以下
Connection
常量之一:
Connection.TRANSACTION_READ_UNCOMMITTED
、
Connection.TRANSACTION_READ_COMMITTED
、
Connection.TRANSACTION_REPEATABLE_READ
或
Connection.TRANSACTION_SERIALIZABLE
。(注意,不能使用
Connection.TRANSACTION_NONE
,因为它指定了不受支持的事务。)
SQLException
- 如果发生数据库访问错误,在关闭的连接上调用此方法,或者给定参数不是
Connection
常量之一
DatabaseMetaData.supportsTransactionIsolationLevel(int)
,
getTransactionIsolation()
int getTransactionIsolation() throws SQLException
Connection
对象的当前事务隔离级别。
Connection.TRANSACTION_READ_UNCOMMITTED
、
Connection.TRANSACTION_READ_COMMITTED
、
Connection.TRANSACTION_REPEATABLE_READ
、
Connection.TRANSACTION_SERIALIZABLE
或
Connection.TRANSACTION_NONE
。
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
setTransactionIsolation(int)
SQLWarning getWarnings() throws SQLException
Connection
对象上的调用报告的第一个警告。如果有多个警告,则后续警告将被链接到第一个警告,可以通过对之前获得的警告调用
SQLWarning.getNextWarning
方法获取。
不可以在关闭的连接上调用此方法,这样做将导致抛出 SQLException
。
注:后续警告将被链接到此 SQLWarning。
SQLWarning
对象;如果不存在,则返回
null
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
SQLWarning
void clearWarnings() throws SQLException
Connection
对象报告的所有警告。调用此方法后,在为此
Connection
对象报告新的警告前,
getWarnings
方法将返回
null
。
SQLException
- 如果发生数据库访问错误,或者在关闭的连接上调用此方法
Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException
Statement
对象,该对象将生成具有给定类型和并发性的
ResultSet
对象。此方法与上述
createStatement
方法相同,但它允许重写默认结果集类型和并发性。已创建结果集的可保存性可调用
getHoldability()
确定。
resultSetType
- 结果集类型,它是
ResultSet.TYPE_FORWARD_ONLY
、
ResultSet.TYPE_SCROLL_INSENSITIVE
或
ResultSet.TYPE_SCROLL_SENSITIVE
之一
resultSetConcurrency
- 并发类型;它是
ResultSet.CONCUR_READ_ONLY
或
ResultSet.CONCUR_UPDATABLE
之一
Statement
对象,该对象将生成具有给定类型和并发性的
ResultSet
对象
SQLException
- 如果发生数据库访问错误,在关闭的连接上调用此方法,或者给定参数不是指示类型和并发性的
ResultSet
常量
SQLFeatureNotSupportedException
- 如果 JDBC 驱动程序不支持此方法,或者对于指定的结果集类型和结果集并发性,此方法不受支持。