BaseConnection接口

驱动内置的连接接口。

addTimerTask

功能描述

为以后的执行计划一个TimerTask。该任务将使用此连接的共享计时器进行调度。

语法格式

void addTimerTask(TimerTask timerTask,         
long milliSeconds)

参数说明

timerTask：要调度的定时器任务。

milliSeconds：延迟毫秒。

返回值

无。

binaryTransferSend

功能描述

如果给定oid的值应该使用二进制传输方式发送，则返回true。如果值应该使用文本传输发送，则为False。

语法格式

boolean binaryTransferSend(int oid)

参数说明

oid：要检查的oid。

返回值

二进制传输为True，文本传输为false。

cancelQuery

功能描述

取消在此连接上执行的当前查询。

语法格式

void cancelQuery()     
throws SQLException

参数说明

无。

返回值

无。

createQuery

功能描述

获取一个query对象。

语法格式

CachedQuery createQuery(String sql,            
boolean escapeProcessing,            
boolean isParameterized,            
String... columnNames)         
throws SQLException

参数说明

sql：sql语句。

escapeProcessing：转义处理。

isParameterized：是否参数化。

columnNames： 列名。

返回值

返回一个query对象。

encodeString

功能描述

使用数据库的客户端编码（通常是UTF8，但在较旧的服务器版本上可能有所不同）编码一个字符串。这在构造合成结果集时使用（例如，在元数据方法中）。

语法格式

byte[] encodeString(String str)       
throws SQLException

参数说明

str：待编码的字符串。

返回值

字符串的编码表示。

escapeString

功能描述

转义一个字符串，作为SQL命令中的字符串字面值使用。该方法根据该值选择适用的转义规则的 getStandardConformingStrings()。

方法原型

String escapeString(String str)       
throws SQLException

参数说明

str：一个字符串值

返回值

字符串的转义表示。

execSQLQuery(String s)

功能描述

执行一个返回单个结果集的SQL查询。无论是否设置了自动提交，都不要启动一个新事务。

语法格式

ResultSet execSQLQuery(String s)        
throws SQLException

参数说明

s：待执行的查询

返回值

返回的（非空）结果集。

execSQLQuery(String s, int resultSetType, int resultSetConcurrency)

功能描述

执行一个返回单个结果集的SQL查询。

语法格式

ResultSet execSQLQuery(String s,            
int resultSetType,            
int resultSetConcurrency)        
throws SQLException

参数说明

s：待执行的查询。

resultSetType：结果集类型。

resultSetConcurrency：结果集并发。

返回值

返回的（非空）结果集。

execSQLUpdate

功能描述

执行一个不返回结果的SQL查询。无论是否设置了自动提交，都不要启动一个新事务。

语法格式

void execSQLUpdate(String s)      
throws SQLException

参数说明

s：待执行的查询。

返回值

无。

getEncoding

功能描述

执行一个不返回结果的SQL查询。无论是否设置了自动提交，都不要启动一个新事务。

语法格式

Encoding getEncoding()          
throws SQLException

参数说明

无。

返回值

无。

getFieldMetadataCache

功能描述

返回给定连接的元数据缓存。

方法原型

LruCache<FieldMetadata.Key,FieldMetadata> getFieldMetadataCache()

参数说明

无。

返回值

元数据缓存。

getLogger

功能描述

获取连接记录器。

方法原型

Logger getLogger()

参数说明

无。

返回值

连接记录器。

getObject

功能描述

为给定的类型和值构造并返回一个适当的对象。这只考虑通过PGConnection.addDataType(String, Class)和 PGConnection.addDataType(String, String)注册的类型。

语法格式

Object getObject(String type,         
String value,         
byte[] byteValue)     
throws SQLException

参数说明

type：后端类型名。

value：值的特定于类型字符串表示形式。

byteValue：值的特定于类型二进制表示形式。

返回值

一个合适的对象，非空。

getQueryExecutor

功能描述

获取此连接的QueryExecutor实现。

语法格式

QueryExecutor getQueryExecutor()

参数说明

无。

返回值

执行器（非空）。

getReplicationProtocol

功能描述

用于物理和逻辑复制的内部协议。

语法格式

ReplicationProtocol getReplicationProtocol()

参数说明

无。

返回值

非空复制协议。

getSocketAddress

功能描述

获取套接字地址。

方法原型

String getSocketAddress()

参数说明

无。

返回值

套接字地址。

getStandardConformingStrings

功能描述

返回服务器是根据SQL标准还是使用传统的Vastbase转义规则来处理字符串字面值。

语法格式

boolean getStandardConformingStrings()

参数说明

无。

返回值

如果服务器根据SQL标准处理字符串字面量，则为true。

getStringVarcharFlag

功能描述

获取bind_string_as_varchar配置标志。

语法格式

boolean getStringVarcharFlag()

参数说明

无。

返回值

bind_string_as_varchar配置标志。

getTimestampUtils

功能描述

获取访问特定连接的UTIL实现。

语法格式

TimestampUtils getTimestampUtils()

参数说明

无。

返回值

时间戳的UTIL实现。

getTransactionState

功能描述

获取该连接的当前事务状态。

语法格式

TransactionState getTransactionState()

参数说明

无。

返回值

该连接的当前事务状态。

getTypeInfo

功能描述

获取类型信息。

语法格式

TypeInfo getTypeInfo()

参数说明

无。

返回值

类型信息。

getXmlFactoryFactory

功能描述

检索工厂以实例化XML处理工厂。

语法格式

PGXmlFactoryFactory getXmlFactoryFactory()                 
throws SQLException

参数说明

无。

返回值

用于实例化XML处理工厂的工厂。

haveMinimumServerVersion(int ver)

功能描述

检查我们是否至少有一个特定的服务器版本。

方法原型

boolean haveMinimumServerVersion(int ver)

参数说明

ver：要检查的服务器版本，格式为xxyyzz，如：90401。

返回值

如果服务器版本至少是ver，则为true。

haveMinimumServerVersion(Version ver)

功能描述

检查我们是否至少有一个特定的服务器版本。

语法格式

boolean haveMinimumServerVersion(Version ver)

参数说明

ver： 要检查的服务器版本。

返回值

如果服务器版本至少是ver，则为true。

isColumnSanitiserDisabled

功能描述

返回是否禁用列名清理。

语法格式

boolean isColumnSanitiserDisabled()

参数说明

无。

返回值

若列名清理被禁用则返回true。

purgeTimerTasks

功能描述

在底层共享计时器上调用purge()，以便释放内部资源。

语法格式

void purgeTimerTasks()

参数说明

无。

返回值

无。

setFlushCacheOnDeallocate

功能描述

默认情况下，如果观察到deallocate/discard消息，连接将重置语句缓存。这个API允许出于测试目的禁用该特性。

语法格式

void setFlushCacheOnDeallocate(boolean flushCacheOnDeallocate)

参数说明

flushCacheOnDeallocate：如果观察到“deallocate/discard”消息时应重置语句缓存，则为true。

返回值

无。