VastbaseG100

JDBC

JDBC接口是一套提供给用户的API方法，本节将对部分常用接口做具体描述，若涉及其他接口可参考JDK1.8（软件包）/JDBC4.0中相关内容。

java.sql.Connection

java.sql.Connection是数据库连接接口。

表7-1 对java.sql.Connection接口的支持情况

接口内部默认使用自动提交模式，若通过setAutoCommit(false)关闭自动提交，将会导致后面执行的语句都受到显式事务包裹，数据库中不支持事务中执行的语句不能在此模式下执行。

java.sql.CallableStatement

java.sql.CallableStatement是存储过程执行接口。

表7-2 对java.sql.CallableStatement的支持情况

• 不允许含有OUT参数的语句执行批量操作。

• 以下方法是从java.sql.Statement继承而来：close，execute，executeQuery，executeUpdate，getConnection，getResultSet，getUpdateCount，isClosed，setMaxRows, setFetchSize。

• 以下方法是从java.sql.PreparedStatement继承而来：addBatch，clearParameters，execute，executeQuery，executeUpdate，getMetaData，setBigDecimal，setBoolean，setByte，setBytes，setDate，setDouble，setFloat，setInt，setLong，setNull，setObject，setString，setTime，setTimestamp。

java.sql.DatabaseMetaData

java.sql.DatabaseMetaData是数据库对象定义接口。

表7-3 对java.sql.DatabaseMetaData的支持情况

java.sql.Driver

java.sql.Driver是数据库驱动接口。

表7-4 对java.sql.Driver的支持情况

java.sql.PreparedStatement

java.sql.PreparedStatement是预处理语句接口。

表7-5 对java.sql.PreparedStatement的支持情况

• addBatch()、execute()必须在clearBatch()之后才能执行。

• 调用executeBatch()方法并不会清除batch。用户必须显式使用clearBatch()清除。

• 在添加了一个batch的绑定变量后，用户若想重用这些值(再次添加一个batch)，无需再次使用set*()方法 。

• 以下方法是从java.sql.Statement继承而来：close，execute，executeQuery，executeUpdate，getConnection，getResultSet，getUpdateCount，isClosed，setMaxRows, setFetchSize。

java.sql.ResultSet

java.sql.ResultSet是执行结果集接口。

表7-6 对java.sql.ResultSet的支持情况

• 一个Statement不能有多个处于”open”状态的ResultSet。

• 用于遍历结果集(ResultSet)的游标(Cursor)在被提交后不能保持”open”的状态。

java.sql.ResultSetMetaData

java.sql.ResultSetMetaData是对ResultSet对象相关信息的具体描述。

表7-7 对java.sql.ResultSetMetaData的支持情况

java.sql.Statement

java.sql.Statement是SQL语句接口。 表7-8 对java.sql.Statement的支持情况

• 通过setFetchSize可以减少结果集在客户端的内存占用情况。它的原理是通过将结果集打包成游标，然后分段处理，所以会加大数据库与客户端的通信量，会有性能损耗。

• 由于数据库游标是事务内有效，所以，在设置setFetchSize的同时，需要将连接设置为非自动提交模式，setAutoCommit(false)。同时在业务数据需要持久化到数据库中时，在连接上执行提交操作。

javax.sql.ConnectionPoolDataSource

javax.sql.ConnectionPoolDataSource是数据源连接池接口。

javax.sql.DataSource

javax.sql.DataSource是数据源接口。

表7-10 对javax.sql.DataSource接口的支持情况

javax.sql.PooledConnection

javax.sql.PooledConnection是由连接池创建的连接接口。

表7-11 对javax.sql.PooledConnection的支持情况

javax.naming.Context

javax.naming.Context是连接配置的上下文接口。

表7-12 对javax.naming.Context的支持情况

javax.naming.spi.InitialContextFactory

javax.naming.spi.InitialContextFactory是初始连接上下文工厂接口。

表7-13 对javax.naming.spi.InitialContextFactory的支持情况

CopyManager

CopyManager是Vastbase JDBC驱动中提供的一个API接口类，用于批量向Vastbase中导入数据。

CopyManager的继承关系

CopyManager类位于org.postgresql.copy Package中，继承自java.lang.Object类，该类的声明如下：

public class CopyManager 
extends Object

构造方法

public CopyManager(BaseConnection connection)

throws SQLException

常用方法

表7-14 CopyManager常用方法