実行環境
ExecutionEnvironmentは、カスタムプロシージャとTDVサーバー間のインターフェイスを提供します。
public interface ExecutionEnvironment
メソッドサマリー |
void |
|
ExecutionEnvironement |
|
java.sql.ResultSet |
|
int |
|
String |
|
void |
|
ProcedureReference |
|
ProcedureReference |
|
void |
|
メソッドの詳細
専念
public void commit()
このメソッドは、開いているトランザクションをコミットします。
スロー
このメソッドは、親トランザクションに対して呼び出された場合、
CustomProcedureExceptionを送出します。コミット中にエラーが発生した場合、SQLExceptionがスローされます。
createTransaction
public ExecutionEnvironment createTransaction(int flags)
このメソッドは独立したトランザクションを開始し、カスタムプロシージャで複数の独立したトランザクションを同時に開くことができます。
パラメータ
フラグ-補正モード、回復モード、および回復レベルのトランザクションオプションを渡すために使用されます。
有効なフラグ値は次のとおりです。
COMPENSATE* | NO_COMPENSATE
ROLLBACK* | BEST_EFFORT
IGNORE_INTERRUPT* | LOG_INTERRUPT | FAIL_INTERRUPT
アスタリスクは、フラグが指定されていない場合に使用されるデフォルト値を示します。
executeQuery
public java.sql.ResultSet executeQuery (String sql, Object[] args)
このメソッドは、ストアード・プロシージャー内からSELECTステートメントを実行するために使用されます。 NULLを返さないようにする必要があります。
パラメーター
sql-SQLステートメント。
args-クエリの引数。引数がない場合はNULLになる可能性があります。
argsオブジェクトは、
タイプにリストされているJavaからSQLへの入力規則に準拠している必要があります。入力カーソルは、
CustomCursorおよびjava.sql.ResultSetとして受け入れられます。
スロー
このメソッドは、
CustomProcedureExceptionまたはSQLExceptionを送出します。
executeUpdate
public int executeUpdate (String sql)
このメソッドは、ストアード・プロシージャー呼び出し内からINSERT、UPDATE、またはDELETEステートメントを実行します。
パラメータ
sql-実行するSQLステートメント。
戻り値
影響を受ける行の数。影響を受ける行数が不明な場合は-1。
スロー
SQLの実行に問題がある場合、このメソッドは
CustomProcedureExceptionを送出します。
getProperty
public String getProperty(String name)
このメソッドは環境特性を取得します。
パラメータ
name-取得するプロパティ。
userName、userDomain、caseSensitive、ignoreTrailingSpacesの4つのプロパティオプションを使用できます。プロパティ名では大文字と小文字は区別されません。
戻り値
プロパティが定義されていない場合、このメソッドはNULLを返します。
ログ
public void log(int level, String log_message)
このメソッドは、システムログにエントリを送信します。
パラメーター
レベル-ERROR、INFO、またはDEBUG
log_message-ログエントリ。
lookupNextHook
public ProcedureReference lookupNextHook()
このメソッドは、リスト内の次のフックを呼び出すためにフックプロシージャによって使用されます。 NULLを返さないようにする必要があります。
スロー
lookupProcedure
public lookupProcedure (String procedureName)
このメソッドは、クエリからプロシージャ参照を検索します。
返されたプロシージャが不要になったら、
closeメソッドを呼び出します。このメソッドはNULLを返しません。
パラメータ
procedureName-検索するプロシージャの名前。
スロー
プロシージャが見つからない場合、このメソッドは
CustomProcedureExceptionを送出します。
ロールバック
public void rollback()
このメソッドは、開いているトランザクションをロールバックします。
スロー
このメソッドは、親トランザクションに対して呼び出された場合は
CustomProcedureExceptionをスローし、エラーが発生した場合はSQLExceptionを送出します。