java.sql.connection.doc

public interface Connection一个 Connection 表示与一个特定数据库的会话。在一个 Connection 的上下文中，执行 SQL 语句并返回结果。一个 Connection 的数据库能够提供描述以下内容的信息，它的表，它支持 SQL 语法，它的存储过程，该连接的能力等等。该信息可用 getMetaData 方法获得。注意： 缺省情况下，在执行完每一个语句之后，Connection 自动地提交更改。如果禁止自动提交，必须进行显式的提交，否则将不保存对数据库的更改。参见：getConnection, Statement, ResultSet, DatabaseMetaData-变量索引TRANSACTION_NONE不支持事务。TRANSACTION_READ_COMMITTED防止页面重写读取；但可能发生不可重复的读取和幻象读取。TRANSACTION_READ_UNCOMMITTED可能发生页面重写读取，不可重复的读取和幻象读取。TRANSACTION_REPEATABLE_READ防止页面重写读取和不可重复的读取，但可能发生幻象读取。TRANSACTION_SERIALIZABLE防止页面重写读取，不可重复的读取和幻象读取。-方法索引clearWarnings()此调用完成之后，以后的 getWarnings 将返回 null 直到为该 Connection 报告了一个新的警告。close()在有些情况下，需要立即释放 Connection 的数据库和 JDBC 资源，而不是等待它们被自动释放；close 方法可以进行立即释放。commit()提交从上一次提交 / 回滚操作后所有的更改，使之成为永久的更改，并释放 Connection 当前保持的任何数据库锁。createStatement()不带参数的 SQL 语句通常用 Statement 对象执行。getAutoCommit()获得当前自动提交状态。getCatalog()返回 Connection 的当前分类表名。getMetaData()一个 Connection 的数据库能够提供描述以下内容的信息，它的表，它支持 SQL 语法，它的存储过程，该连接的能力等等。getTransactionIsolation()获得该 Connection 的当前事务隔离模式。getWarnings()返回由该 Connection 的调用报告的第一个警告。isClosed()检测一个 Connection 是否被关闭。isReadOnly()检测该连接是否在只读状态。nativeSQL(String)在发送之前，一个驱动程序把 JDBC sql 语法转换为它的系统本地的 SQL 语法；nativeSQL 将返回驱动程序要发送语句的本地形式。prepareCall(String)通过创建一个 CallableStatement 来处理一个 SQL 存储过程调用语句。prepareStatement(String)一条带有或不带 IN 参数的 SQL 语句可以被预编译并存放在 PreparedStatement 对象中。rollback()回滚撤消从上一次提交 / 回滚操作后的所有更改，并释放 Connection 当前保持的任何数据库锁。setAutoCommit(boolean)如果一个连接处于自动提交状态，它所有的 SQL 语句将被执行并作为单个事务提交。setCatalog(String)通过设置一个分类表名，可以选择该 Connection 的数据库的一个子空间。setReadOnly(boolean)可以把一个连接设置为只读模式，作为启动数据库优化的提示。setTransactionIsolation(int)可以用一个 TRANSACTION_* 值调用该方法，改变事务的隔离级别。-变量TRANSACTION_NONEpublic static final int TRANSACTION_NONE不支持事务。TRANSACTION_READ_UNCOMMITTEDpublic static final int TRANSACTION_READ_UNCOMMITTED可能发生页面重写读取，不可重复的读取和幻象读取。TRANSACTION_READ_COMMITTEDpublic static final int TRANSACTION_READ_COMMITTED防止页面重写读取；可能发生不可重复的读取和幻象读取。TRANSACTION_REPEATABLE_READpublic static final int TRANSACTION_REPEATABLE_READ防止页面重写读取和不可重复的读取，但可能发生幻象读取。TRANSACTION_SERIALIZABLEpublic static final int TRANSACTION_SERIALIZABLE防止页面重写读取，不可重复的读取和幻象读取。-方法createStatementpublic abstract Statement createStatement() throws SQLException不带参数的 SQL 语句通常用 Statement 对象执行。 如果多次执行同一个 SQL 语句，使用一个 PreparedStatement 就更有效。返回值：一个新建的 Statement 对象抛出： SQLException如果发生了数据访问错误。prepareStatementpublic abstract PreparedStatement prepareStatement(String sql) throws SQLException一条带有或不带 IN 参数的 SQL 语句可以被预编译并存放在 PreparedStatement 对象中。 该对象可用于有效地多次执行该语句。注意： 为了处理那些能由预编译得到好处的带参数的 SQL 语句，该方法进行了专门的优化。如果驱动程序支持预编译，prepareStatement 将把该语句发送给数据库进行预编译。有些驱动程序不支持预编译。在这种情况下，在执行 PreparedStatement 语句之前，将不把语句发送到数据库。这对用户没有直接的影响；但是它确实影响某些 SQLExceptions 将由哪个方法抛出 。参数：sql - 一个 SQL 语句，它可以包含一个或多个 ? IN 参数的位置标志符。返回值：一个包含该预编译语句的新建的 PreparedStatement 对象。抛出： SQLException如果发生了数据访问错误。prepareCallpublic abstract CallableStatement prepareCall(String sql) throws SQLException通过创建一个 CallableStatement 来处理一个 SQL 存储过程调用语句。CallableStatement 提供了设置其 IN 和 OUT 参数的方法和执行它的方法。注意： 为了处理存储过程调用语句对该方法进行了优化。当 prepareCall 完成时，有些驱动程序可能把调用语句发送给数据库；其它的语句可能等到执行 CallableStatement 时发送。这对用户没有直接的影响；但是它确实影响到哪个方法抛出一定的 SQLExceptions。参数：sql - 一个 SQL 语句，它可以包含一个或多个 ?，参数的位置标志符。 通常这个语句是一个 JDBC 功能调用转义字符串。返回值：一个包含该预编译的 SQL 语句的新建的 CallableStatement 对象。抛出： SQLException如果发生了数据访问错误。nativeSQLpublic abstract String nativeSQL(String sql) throws SQLException在发送之前，一个驱动程序把 JDBC sql 语法转换为它的系统本地的 SQL 语法；nativeSQL 将返回驱动程序要发送语句的本地形式。参数：sql - 一个 SQL 语句，它可以包含一个或多个 ?，参数的位置标志符返回值：该语句的本地格式抛出： SQLException如果发生了数据访问错误。setAutoCommitpublic abstract void setAutoCommit(boolean autoCommit) throws SQLException如果一个连接处于自动提交状态，它所有的 SQL 语句将被执行并作为单个事务被提交。否则，它的 SQL 语句将被分为事务组，由 commit() 或 rollback() 终止。缺省情况下，新建的连接处于自动提交模式。无论下面两种情况哪个先发生都进行提交：语句完成或执行下一条语句。在语句返回一个 ResultSet 的情况下，语句将在检索完 ResultSet 的最后一行或关闭 ResultSet 时完成。在复杂的情况下，单条语句可能返回多个结果，和多个输出参数值。在此只有当已经取出所有的结果和参数值后才进行提交。参数：autoCommit - 如果为 true 则启动自动提交；否则禁止自动提交。抛出： SQLException如果发生了数据访问错误。getAutoCommitpublic abstract boolean getAutoCommit() throws SQLException获得当前自动提交状态。返回值：自动提交模式的当前状态。抛出： SQLException如果发生了数据访问错误。参见：setAutoCommitcommitpublic abstract void commit() throws SQLException提交从上一次提交 / 回滚操作后的更改，使之成为永久的更改，并释放 Connection 当前保持的任何数据库锁。 只有当禁止自动提交时可以使用该方法。抛出： SQLException如果发生了数据访问错误。参见：setAutoCommitrollbackpublic abstract void rollback() throws SQLException回滚撤消从上一次提交 / 回滚操作后的所有更改，并释放 Connection 当前保持的任何数据库锁。 只有当禁止自动提交时可以使用该方法。抛出： SQLException如果发生了数据访问错误。参见：setAutoCommitclosepublic abstract void close() throws SQLException在有些情况下，需要立即释放 Connection 的数据库和 JDBC 资源，而不是等待它们被自动释放；close 方法可以进行立即释放。注意： 当一个 Connection 由垃圾箱收集时，它被自动关闭。 一定的致命错误也将使 Connection 关闭。抛出： SQLException如果发生了数据访问错误。isClosedpublic abstract boolean isClosed() throws SQLException检测一个 Connection 是否被关闭。返回值：如果连接被关闭则为 true，如果它仍然打开则为 false。抛出： SQLException如果发生了数据访问错误。getMetaDatapublic abstract DatabaseMetaData getMetaData() throws SQLException一个 Connection 的数据库提供了描述以下内容的信息，它的表，它支持 SQL 语法，它的存储过程，该连接的能力等等。通过一个 DatabaxeMetaData 对象可以使用这些信息。返回值：该 Connection 的一个 DatabaseMetaData 对象。抛出： SQLException如果发生了数据访问错误。setReadOnlypublic abstract void setReadOnly(boolean readOnly) throws SQLException可以把一个连接设置为只读模式，作为启动数据库优化的提示。注意： 不能在事务执行的中间调用 setReadOnly。参数：readOnly - 如果为 true 则启动只读模式；如果为 false 则禁止只读模式。抛出： SQLException如果发生了数据访问错误。isReadOnlypublic abstract boolean isReadOnly() throws SQLException检测该连接是否在只读状态。返回值：如果连接是只读的则为 true。抛出： SQLException如果发生了数据访问错误。setCatalogpublic abstract void setCatalog(String catalog) throws SQLException通过设置一个分类表名，可以选择该 Connection 的数据库的一个子空间。 如果该驱动程序不支持分类表，它将忽略该请求。抛出： SQLException如果发生了数据访问错误。getCatalogpublic abstract String getCatalog() throws SQLException返回 Connection 的当前分类表名。返回值：当前分类表名或 null。抛出： SQLException如果发生了数据访问错误。setTransactionIsolationpublic abstract void setTransactionIsolation(int level) throws SQLException可以用一个 TRANSACTION_* 值调用该方法，改变事务的隔离级别。注意： 不能在事务执行的中间调用 setTransactionIsolati