Connection

TRANSACTION_NONE

int TRANSACTION_NONE

表示不支持事务的常量。

常量值：0（0x00000000）

TRANSACTION_READ_COMMITTED

int TRANSACTION_READ_COMMITTED

表示可以防止脏读的常量。 不可重复读取和幻像读取可能发生。 该级别仅禁止事务读取其中未提交更改的行。

常量值：2（0x00000002）

TRANSACTION_READ_UNCOMMITTED

int TRANSACTION_READ_UNCOMMITTED

表示可能发生脏读，不可重复读和幻读的常量。 这个级别允许一个事务改变的行被另一个事务读取，然后该行的任何改变被提交（“脏读”）。 如果任何更改回滚，则第二个事务将检索到无效行。

常数值：1（0x00000001）

TRANSACTION_REPEATABLE_READ

int TRANSACTION_REPEATABLE_READ

一个常量，指示防止脏读和不可重复读取; 幻像读取可能会发生。 该级别禁止事务读取其中有未提交更改的行，并且还禁止一个事务读取一行，第二个事务更改该行并且第一个事务重新读取行，第二次获取不同值的情况一个“不可重复读”）。

常量值：4（0x00000004）

TRANSACTION_SERIALIZABLE

int TRANSACTION_SERIALIZABLE

一个常量表示可以防止脏读，不可重复读取和幻读。 此级别包括在禁止TRANSACTION_REPEATABLE_READ ，并进一步禁止在那里一个事务读取满足所有行的情况WHERE条件，第二个事务插入一行满足该WHERE条件，和第一个事务重新读取为相同的条件下，检索附加的“幻影“排在第二次阅读。

常量值：8（0x00000008）

clearWarnings

void clearWarnings ()

清除为此Connection对象报告的所有警告。 在调用此方法后，方法getWarnings返回null直到为此Connection对象报告新警告为止。

close

void close ()

立即释放此 Connection对象的数据库和JDBC资源，而不是等待它们被自动释放。

在已关闭的 Connection对象上调用方法 close是无操作的。

强烈建议应用程序在调用close方法之前显式提交或回滚活动事务。 如果调用close方法并且存在活动事务，则结果是实现定义的。

commit

void commit ()

自上次提交/回滚之后进行所有更改，并释放此Connection对象当前拥有的任何数据库锁定。 只有在禁用自动提交模式时才应使用此方法。

createArrayOf

Array createArrayOf (String typeName, 
                Object[] elements)

用于创建Array对象的工厂方法。

注意：当使用 createArrayOf创建映射到基元数据类型的数组对象时， Array对象是否为该基元数据类型的数组或 Object的数组是实现定义的。

注意： JDBC驱动程序负责将元素Object数组映射到给定类Object java.sql.Types中定义的默认JDBC SQL类型。 默认映射在JDBC规范的附录B中指定。 如果生成的JDBC类型不是给定typeName的适当类型，那么实现将定义是否引发SQLException或驱动程序是否支持生成的转换。

createBlob

Blob createBlob ()

构造一个实现Blob接口的对象。 返回的对象最初不包含数据。 Blob接口的setBinaryStream和setBytes方法可用于将数据添加到Blob 。

createClob

Clob createClob ()

构造一个实现Clob接口的对象。 返回的对象最初不包含数据。 的setAsciiStream ， setCharacterStream和setString所述的方法Clob接口可用于将数据添加到所述Clob 。

createNClob

NClob createNClob ()

构造一个实现NClob接口的对象。 返回的对象最初不包含数据。 的setAsciiStream ， setCharacterStream和setString所述的方法NClob接口可用于将数据添加到所述NClob 。

createSQLXML

SQLXML createSQLXML ()

构造一个实现SQLXML接口的对象。 返回的对象最初不包含数据。 SQLXML接口的createXmlStreamWriter对象和setString接口的方法可用于将数据添加到SQLXML对象。

createStatement

Statement createStatement (int resultSetType, 
                int resultSetConcurrency)

创建一个Statement对象，该对象将生成具有给定类型和并发性的ResultSet对象。 此方法与createStatement方法createStatement相同，但它允许覆盖默认结果集类型和并发性。 创建的结果集的可保存性可通过调用getHoldability()来确定。

createStatement

Statement createStatement ()

创建一个用于将SQL语句发送到数据库的Statement对象。 不带参数的SQL语句通常使用Statement对象执行。 如果多次执行相同的SQL语句，则使用PreparedStatement对象可能更有效。

使用返回的Statement对象创建的结果集默认为TYPE_FORWARD_ONLY并且级别为CONCUR_READ_ONLY 。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

createStatement

Statement createStatement (int resultSetType, 
                int resultSetConcurrency, 
                int resultSetHoldability)

创建一个Statement对象，该对象将生成具有给定类型，并发性和可保存性的ResultSet对象。 此方法与createStatement方法createStatement相同，但它允许覆盖默认结果集类型，并发性和可保存性。

createStruct

Struct createStruct (String typeName, 
                Object[] attributes)

用于创建Struct对象的工厂方法。

getAutoCommit

boolean getAutoCommit ()

检索此 Connection对象的当前自动提交模式。

getCatalog

String getCatalog ()

获取此 Connection对象的当前目录名称。

getClientInfo

String getClientInfo (String name)

返回按名称指定的客户端信息属性的值。 如果指定的客户端信息属性尚未设置并且没有默认值，则此方法可能会返回null。 如果驱动程序不支持指定的客户端信息属性名称，则此方法也会返回null。

应用程序可以使用 DatabaseMetaData.getClientInfoProperties方法来确定驱动程序支持的客户端信息属性。

getClientInfo

Properties getClientInfo ()

返回包含驱动程序支持的每个客户端信息属性的名称和当前值的列表。 如果属性尚未设置并且没有默认值，则客户端信息属性的值可能为空。

getHoldability

int getHoldability ()

检索使用此 Connection对象创建的 ResultSet对象的当前可保存性。

getMetaData

DatabaseMetaData getMetaData ()

检索DatabaseMetaData对象包含有关哪个这个数据库的元数据Connection对象表示的连接。 元数据包括有关数据库表的信息，其支持的SQL语法，其存储过程，此连接的功能等。

getTransactionIsolation

int getTransactionIsolation ()

检索此 Connection对象的当前事务隔离级别。

getTypeMap

Map<String, Class<?>> getTypeMap ()

检索Map与此相关联的对象Connection对象。 除非应用程序添加了条目，否则返回的类型映射将为空。

你必须调用 setTypeMap在更改后 Map从返回的对象 getTypeMap为JDBC驱动程序可以创建的内部副本 Map传递给对象 setTypeMap ：

      Map<String,Class<?>> myMap = con.getTypeMap();
      myMap.put("mySchemaName.ATHLETES", Athletes.class);
      con.setTypeMap(myMap);
 

getWarnings

SQLWarning getWarnings ()

检索此Connection对象通过调用报告的第一个警告。 如果有多个警告，后面的警告将被链接到第一个警告，并且可以通过调用先前检索到的警告的方法SQLWarning.getNextWarning来检索。

此方法不能在关闭的连接上调用; 这样做会导致SQLException被抛出。

注意：后续警告将被链接到此SQLWarning。

isClosed

boolean isClosed ()

检索此Connection对象是否已关闭。 如果已调用方法close或者发生了某些致命错误，则连接将关闭。 只有在调用方法Connection.close调用此方法，才能保证返回true 。

通常不能调用此方法来确定与数据库的连接是有效还是无效。 典型的客户端可以通过捕获尝试操作时可能抛出的任何异常来确定连接是无效的。

isReadOnly

boolean isReadOnly ()

检索此 Connection对象是否处于只读模式。

isValid

boolean isValid (int timeout)

如果连接尚未关闭并且仍然有效，则返回true。 驱动程序应该提交一个关于连接的查询或者使用一些其他的机制，当这个方法被调用时肯定地验证连接仍然有效。

驱动程序提交的用于验证连接的查询应当在当前事务的上下文中执行。

nativeSQL

String nativeSQL (String sql)

将给定的SQL语句转换为系统的原生SQL语法。 在发送之前，驱动程序可能会将JDBC SQL语法转换为其系统的原生SQL语法。 此方法返回驱动程序将发送的语句的本机形式。

prepareCall

CallableStatement prepareCall (String sql, 
                int resultSetType, 
                int resultSetConcurrency)

创建一个CallableStatement对象，该对象将生成具有给定类型和并发性的ResultSet对象。 此方法与上面的prepareCall方法相同，但它允许覆盖默认结果集类型和并发性。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

prepareCall

CallableStatement prepareCall (String sql)

为调用数据库存储过程创建一个CallableStatement对象。 CallableStatement对象提供了设置其IN和OUT参数的方法，以及执行对存储过程调用的方法。

注意：此方法针对处理存储过程调用语句进行了优化。 当方法prepareCall完成时，某些驱动程序可能会将调用语句发送到数据库; 其他人可能会等到CallableStatement对象被执行。 这对用户没有直接影响; 但是，它会影响哪个方法抛出某些SQLExceptions。

使用返回的CallableStatement对象创建的结果集默认为TYPE_FORWARD_ONLY并且级别为CONCUR_READ_ONLY 。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

prepareCall

CallableStatement prepareCall (String sql, 
                int resultSetType, 
                int resultSetConcurrency, 
                int resultSetHoldability)

创建一个CallableStatement对象，该对象将生成具有给定类型和并发性的ResultSet对象。 此方法与prepareCall方法prepareCall相同，但它允许重写默认结果集类型，结果集并发类型和可保留性。

prepareStatement

PreparedStatement prepareStatement (String sql, 
                String[] columnNames)

创建一个默认的PreparedStatement对象，能够返回给定数组指定的自动生成的键。 该数组包含目标表中包含应该返回的自动生成的键的列的名称。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略数组。

有或没有IN参数的SQL语句可以预先编译并存储在一个PreparedStatement对象中。 然后可以使用此对象多次高效地执行此语句。

注意：此方法针对处理从预编译中受益的参数化SQL语句进行了优化。 如果驱动程序支持预编译，方法prepareStatement会将语句发送到数据库进行预编译。 某些驱动程序可能不支持预编译。 在这种情况下，执行PreparedStatement对象之前，可能不会将语句发送到数据库。 这对用户没有直接影响; 但是，它确实会影响哪些方法会抛出某些SQLException。

使用返回的PreparedStatement对象创建的结果集默认为TYPE_FORWARD_ONLY并且级别为CONCUR_READ_ONLY 。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

prepareStatement

PreparedStatement prepareStatement (String sql, 
                int resultSetType, 
                int resultSetConcurrency, 
                int resultSetHoldability)

创建一个 PreparedStatement对象，该对象将生成具有给定类型，并发性和可保存性的 ResultSet对象。

此方法与 prepareStatement方法 prepareStatement相同，但它允许覆盖默认结果集类型，并发性和可保存性。

prepareStatement

PreparedStatement prepareStatement (String sql, 
                int[] columnIndexes)

创建一个默认的PreparedStatement对象，能够返回给定数组指定的自动生成的键。 此数组包含目标表中包含应该使其可用的自动生成的键的列索引。 如果SQL语句不是INSERT语句，或者SQL语句能够返回自动生成的键（这些语句的列表是特定于供应商的），驱动程序将忽略该数组。

有或没有IN参数的SQL语句可以预先编译并存储在一个PreparedStatement对象中。 然后可以使用此对象多次高效地执行此语句。

注意：此方法针对处理从预编译中受益的参数化SQL语句进行了优化。 如果驱动程序支持预编译，则方法prepareStatement将将语句发送到数据库进行预编译。 某些驱动程序可能不支持预编译。 在这种情况下，执行PreparedStatement对象之前，该语句可能不会发送到数据库。 这对用户没有直接影响; 但是，它确实会影响哪些方法会抛出某些SQLException。

使用返回的PreparedStatement对象创建的结果集默认为TYPE_FORWARD_ONLY并且级别为CONCUR_READ_ONLY 。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

prepareStatement

PreparedStatement prepareStatement (String sql)

创建一个用于将参数化SQL语句发送到数据库的 PreparedStatement对象。

有或没有IN参数的SQL语句可以预先编译并存储在一个PreparedStatement对象中。 然后可以使用此对象多次高效地执行此语句。

注意：此方法针对处理从预编译中受益的参数化SQL语句进行了优化。 如果驱动程序支持预编译，则方法prepareStatement会将语句发送到数据库进行预编译。 某些驱动程序可能不支持预编译。 在这种情况下，执行PreparedStatement对象之前，语句可能不会发送到数据库。 这对用户没有直接影响; 但是，它确实会影响哪些方法会抛出某些SQLException对象。

使用返回的创建结果集PreparedStatement对象将被默认类型TYPE_FORWARD_ONLY ，并有并发级别CONCUR_READ_ONLY 。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

prepareStatement

PreparedStatement prepareStatement (String sql, 
                int autoGeneratedKeys)

创建一个能够检索自动生成的键的默认PreparedStatement对象。 给定的常量告诉驱动程序是否应该使自动生成的密钥可供检索。 如果SQL语句不是INSERT语句或能够返回自动生成键的SQL语句（这些语句的列表是特定于供应商的），则忽略此参数。

注意：此方法针对处理从预编译中受益的参数化SQL语句进行了优化。 如果驱动程序支持预编译，方法prepareStatement会将语句发送到数据库进行预编译。 某些驱动程序可能不支持预编译。 在这种情况下，执行PreparedStatement对象之前，可能不会将语句发送到数据库。 这对用户没有直接影响; 但是，它确实会影响哪些方法会抛出某些SQLException。

使用返回的PreparedStatement对象创建的结果集默认为TYPE_FORWARD_ONLY并且级别为CONCUR_READ_ONLY 。 创建的结果集的可保存性可以通过调用getHoldability()来确定。

prepareStatement

PreparedStatement prepareStatement (String sql, 
                int resultSetType, 
                int resultSetConcurrency)

创建一个PreparedStatement对象，该对象将生成具有给定类型和并发性的ResultSet对象。 此方法与prepareStatement方法prepareStatement相同，但它允许覆盖默认结果集类型和并发性。 创建结果集的可保存性可通过调用getHoldability()来确定。

releaseSavepoint

void releaseSavepoint (Savepoint savepoint)

从当前事务中删除指定的Savepoint和随后的Savepoint对象。 在保存点被删除后对它的任何引用都会导致SQLException被引发。

rollback

void rollback ()

取消当前事务中所做的所有更改并释放当前由此Connection对象持有的任何数据库锁定。 只有在禁用自动提交模式时才应使用此方法。

rollback

void rollback (Savepoint savepoint)

取消给定的 Savepoint对象设置后所做的所有更改。

只有在自动提交被禁用时才应使用此方法。

setAutoCommit

void setAutoCommit (boolean autoCommit)

将此连接的自动提交模式设置为给定状态。 如果连接处于自动提交模式，则其所有SQL语句将作为单个事务执行并提交。 否则，它的SQL语句会被分组为通过调用方法commit或方法rollback终止的事务。 默认情况下，新连接处于自动提交模式。

语句完成时发生提交。 语句完成的时间取决于SQL语句的类型：

• For DML statements, such as Insert, Update or Delete, and DDL statements, the statement is complete as soon as it has finished executing.
• For Select statements, the statement is complete when the associated result set is closed.
• For CallableStatement objects or for statements that return multiple results, the statement is complete when all of the associated result sets have been closed, and all update counts and output parameters have been retrieved.

注意：如果在事务期间调用此方法并且更改了自动提交模式，则事务将被提交。 如果setAutoCommit且自动提交模式未更改，则该调用为空操作。

setCatalog

void setCatalog (String catalog)

为了选择这个的子空间设置给定目录名称 Connection对象在其中工作的数据库。

如果驱动程序不支持目录，它将默默忽略此请求。

调用setCatalog对先前创建或准备的Statement对象没有影响。 实现定义了在调用Connection方法prepareStatement或prepareCall时是否立即发生DBMS准备操作。 为了获得最大的可移植性， setCatalog应该在之前被称为Statement创建或准备。

setClientInfo

void setClientInfo (Properties properties)

设置连接的客户端信息属性的值。 Properties对象包含要设置的客户端信息属性的名称和值。 属性列表中包含的一组客户端信息属性将替换连接上的当前客户端信息属性集。 如果当前在连接上设置的属性不在属性列表中，则该属性将被清除。 指定一个空的属性列表将清除连接上的所有属性。 有关更多信息，请参阅setClientInfo (String, String) 。

如果在设置任何客户端信息属性时发生错误，则会引发SQLClientInfoException 。 SQLClientInfoException包含指示哪些客户端信息属性未设置的信息。 客户端信息的状态是未知的，因为有些数据库不允许以原子方式设置多个客户端信息属性。 对于这些数据库，在发生错误之前可能已经设置了一个或多个属性。

setClientInfo

void setClientInfo (String name, 
                String value)

将名称指定的客户端信息属性的值设置为值指定的值。

应用程序可以使用 DatabaseMetaData.getClientInfoProperties方法来确定驱动程序支持的客户端信息属性以及可以为每个属性指定的最大长度。

驱动程序将指定的值存储在数据库的合适位置。 例如在特殊的寄存器，会话参数或系统表列中。 为了提高效率，驱动程序可以推迟设置数据库中的值直到下一次执行或准备好语句。 除了将客户端信息存储在数据库中的适当位置之外，这些方法不应该改变连接的行为。 提供给这些方法的值仅用于记帐，诊断和调试目的。

如果驱动程序无法识别指定的客户端信息名称，驱动程序将生成警告。

如果为此方法指定的值大于属性的最大长度，则驱动程序可能会截断该值并生成警告或生成SQLClientInfoException 。 如果驱动程序生成SQLClientInfoException ，则指定的值未在连接上设置。

以下是标准客户端信息属性。 不需要驱动程序来支持这些属性，但是如果驱动程序支持可以由其中一个标准属性描述的客户端信息属性，则应该使用标准属性名称。

• ApplicationName - The name of the application currently utilizing the connection
• ClientUser - The name of the user that the application using the connection is performing work for. This may not be the same as the user name that was used in establishing the connection.
• ClientHostname - The hostname of the computer the application using the connection is running on.

setHoldability

void setHoldability (int holdability)

将使用此Connection对象创建的ResultSet对象的默认可保存性更改为给定的可保存性。 ResultSet对象的默认可保存性可通过调用getResultSetHoldability()来确定。

setReadOnly

void setReadOnly (boolean readOnly)

将此连接置于只读模式，作为驱动程序启动数据库优化的提示。

注意：在交易过程中不能调用此方法。

setSavepoint

Savepoint setSavepoint (String name)

使用当前事务中的给定名称创建一个保存点，并返回表示它的新对象 Savepoint 。

如果在活动事务之外调用setSavepoint，则将在此新创建的保存点上启动事务。

setSavepoint

Savepoint setSavepoint ()

在当前事务中创建一个未命名的保存点，并返回表示它的新对象 Savepoint 。

如果在活动事务之外调用setSavepoint，则将在此新创建的保存点上启动事务。

setTransactionIsolation

void setTransactionIsolation (int level)

尝试将此Connection对象的事务隔离级别更改为给定的对象。 界面Connection中定义的常量是可能的事务隔离级别。

注意：如果在事务期间调用此方法，则结果是实现定义的。

setTypeMap

void setTypeMap (Map<String, Class<?>> map)

安装给定TypeMap对象的类型映射此Connection对象。 类型映射将用于SQL结构化类型和不同类型的自定义映射。

你必须设置的值 TypeMap到callng前 setMap为JDBC驱动程序可以创建的内部副本 TypeMap ：

      Map myMap<String,Class<?>> = new HashMap<String,Class<?>>();
      myMap.put("mySchemaName.ATHLETES", Athletes.class);
      con.setTypeMap(myMap);