ResultHandler接口

回调接口，用于将查询结果从协议特定层传递到与协议无关的JDBC实现代码。

getException

功能描述

返回第一个遇到的异常。其余的通过SQLException.setNextException(SQLException)链接。

语法格式

SQLException getException()

参数说明

无。

返回值

第一次遇到的异常。

getWarning

功能描述

返回第一个遇到的警告。其余的通过SQLException.setNextException(SQLException)链接。

语法格式

SQLWarning getWarning()

参数说明

无。

返回值

第一次遇到的警告。

handleCommandStatus

功能描述

当一个没有返回结果集的查询完成时调用。

语法格式

void handleCommandStatus(String status,             
long updateCount,             
long insertOID)

参数说明

status：命令状态字符串(例如“SELECT”)由后端返回。

updateCount：受INSERT、UPDATE、DELETE、FETCH或MOVE命令影响的行数，如果没有为-1。

insertOID：对于单行INSERT查询，新插入行的OID，如果没有为0。

返回值

无。

handleCompletion

功能描述

在QueryExecutor方法返回之前调用。如果需要，此方法可以抛出SQLException；如果确实如此，QueryExecutor方法将把该异常传播到原始调用方。

语法格式

void handleCompletion()        
throws SQLException

参数说明

无。

返回值

无。

handleError

功能描述

发生错误时调用，放弃后续查询；通常，handleError调用和后续handleCompletion调用之间的唯一调用是handleError或handleWarning。

语法格式

void handleError(SQLException error)

参数说明

error： 发生的错误。

返回值

无。

handleResultRows

功能描述

当从查询接收到结果行时调用。

语法格式

void handleResultRows(Query fromQuery,           
Field[] fields,           
List<byte[][]> tuples,           
ResultCursor cursor)

参数说明

fromQuery： 生成这些结果的基础查询；这可能不是很具体（例如，它可能是一个包含多个语句的查询）。

fields：结果集的列元数据。可能为空，当指定QUERY_NO_METADATA时。

tuples：实际的数据。

cursor：用来取额外数据的游标，如果没有进一步的结果，则为空。

返回值

无。

handleWarning

功能描述

在发出警告时调用。

语法格式

void handleWarning(SQLWarning warning)

参数说明

warning：发生的警告。

返回值

无。

secureProgress

功能描述

批处理语句的回调。如果批处理语句是在autocommit==true模式下执行的，那么执行器可能会“按最佳方式”提交，因此结果处理程序应该跟踪哪些语句成功执行，哪些语句未成功执行。

语法格式

void secureProgress()

参数说明

无。

返回值

无。