Package cc.carm.lib.easysql.api.action.query

Interface QueryAction

All Superinterfaces:

SQLAction<SQLQuery>

All Known Subinterfaces:

PreparedQueryAction

All Known Implementing Classes:

PreparedQueryActionImpl, QueryActionImpl

public interface QueryAction
extends SQLAction<SQLQuery>

SQLQueryAction 是用于承载SQL查询语句并进行处理、返回并自动关闭连接的基本类。

• 同步执行 SQLAction.execute(), SQLAction.execute(SQLFunction, SQLExceptionHandler)
  同步执行方法中有会抛出异常的方法与不抛出异常的方法，
  若选择不抛出异常，则返回值可能为空，需要特殊处理。
• 异步执行 SQLAction.executeAsync(SQLHandler, SQLExceptionHandler)
  异步执行时将提供成功与异常两种处理方式
  可自行选择是否对数据或异常进行处理
  默认的异常处理器为 SQLAction.defaultExceptionHandler()

注意： 无论是否异步，都不需要自行关闭ResultSet，本API已自动关闭

Since:

0.2.6

Author:

CarmJos

Method Summary

Modifier and Type	Method	Description
default <R> R	executeFunction(R defaultResult, @NotNull SQLFunction<SQLQuery,R> function)	执行语句并处理返回值

Methods inherited from interface cc.carm.lib.easysql.api.SQLAction

defaultExceptionHandler, execute, execute, execute, execute, executeAsync, executeAsync, executeAsync, executeFunction, executeFunction, getActionUUID, getCreateTime, getManager, getShortID, getSQLContent, handleException, setExceptionHandler

Method Detail

executeFunction

@Nullable
@Contract("!null, _ -> !null")
default <R> R executeFunction(@Nullable
                              R defaultResult,
                              @NotNull
                              @NotNull SQLFunction<SQLQuery,R> function)
                       throws java.sql.SQLException

执行语句并处理返回值

Type Parameters:

R - 需要返回的内容

Parameters:

defaultResult - 默认结果，若处理后的结果为null，则返回该值

function - 处理方法

Returns:

指定类型数据

Throws:

java.sql.SQLException - 当SQL操作出现问题时抛出