クラスの使用
jakarta.resource.ResourceException
ResourceException を使用するパッケージ パッケージ 説明 jakarta.resource jakarta.resource パッケージは、Jakarta™ Connectors 仕様の最上位パッケージです。jakarta.resource.cci jakarta.resource.cci パッケージには、Common Client Interface(CCI)の API 仕様が含まれています。jakarta.resource.spi jakarta.resource.spi パッケージには、Jakarta Connectors 仕様で定義されているシステム契約の API が含まれています。jakarta.resource.spi.endpoint このパッケージには、サービスエンドポイントインタラクションのシステム契約が含まれています。jakarta.resource.spi.work このパッケージには、作業管理、汎用およびセキュリティ作業コンテキスト契約の API が含まれています。jakarta.resource 内の ResourceException 使用
jakarta.resource 内の ResourceException サブクラス 修飾子と型 クラス 説明 classNotSupportedExceptionNotSupportedExceptionは、操作がサポートされている機能ではないため、呼び出し先(システム契約のリソースアダプターまたはアプリケーションサーバー)が操作を実行できないことを示すためにスローされます。jakarta.resource.cci 内の ResourceException 使用
jakarta.resource.cci 内の ResourceException サブクラス 修飾子と型 クラス 説明 classResourceWarningResourceWarningは、EIS との対話の実行に関連する警告に関する情報を提供します。ResourceException をスローする jakarta.resource.cci のメソッド 修飾子と型 メソッド 説明 voidLocalTransaction. begin()EIS インスタンスでローカルトランザクションを開始します。voidInteraction. clearWarnings()このインタラクションインスタンスによって報告されたすべての警告をクリアします。voidConnection. close()アプリケーションレベルで接続ハンドルのクローズを開始します。voidInteraction. close()現在のインタラクションを閉じ、リソースアダプターによってこのインスタンス用に保持されているすべてのリソースを解放します。voidLocalTransaction. commit()現在のローカルトランザクションをコミットし、基盤となる EIS インスタンスによって保持されているすべてのロックを解放します。<E> IndexedRecord<E>RecordFactory. createIndexedRecord(StringSE recordName)IndexedRecord を作成します。InteractionConnection. createInteraction()この接続に関連付けられたインタラクションを作成します。<K,V>
MappedRecord<K,V>RecordFactory. createMappedRecord(StringSE recordName)MappedRecord を作成します。booleanResultSetInfo. deletesAreDetected(int type)ResultSet.rowDeleted を呼び出して、表示されている行の削除を検出できるかどうかを示します。RecordInteraction. execute(InteractionSpec ispec, Record input)InteractionSpec で表されるインタラクションを実行します。booleanInteraction. execute(InteractionSpec ispec, Record input, Record output)InteractionSpec で表されるインタラクションを実行します。ConnectionConnectionFactory. getConnection()EIS インスタンスへの接続を取得します。ConnectionConnectionFactory. getConnection(ConnectionSpec properties)EIS インスタンスへの接続を取得します。StringSEConnectionMetaData. getEISProductName()このメタデータを生成した接続を介して接続された基盤となる EIS インスタンスの製品名を返します。StringSEConnectionMetaData. getEISProductVersion()基になる EIS インスタンスの製品バージョンを返します。LocalTransactionConnection. getLocalTransaction()コンポーネントが接続上のリソースマネージャーのローカルトランザクションを区別できるようにする LocalTransaction インスタンスを返します。ConnectionMetaDataConnection. getMetaData()アクティブな接続を介して表される、基になる EIS インスタンスに関する情報を取得します。ResourceAdapterMetaDataConnectionFactory. getMetaData()リソースアダプターのメタデータを取得します。RecordFactoryConnectionFactory. getRecordFactory()RecordFactory インスタンスを取得します。ResultSetInfoConnection. getResultSetInfo()接続された EIS インスタンスでサポートされている ResultSet 機能に関する情報を取得します。StringSEConnectionMetaData. getUserName()基になる EIS インスタンスに認識されているアクティブな接続のユーザー名を返します。ResourceWarningInteraction. getWarnings()このインタラクションインスタンスに関連付けられた警告のチェーンから最初の ResourceWarning を取得します。booleanResultSetInfo. insertsAreDetected(int type)ResultSet.rowInserted を呼び出して、表示されている行の挿入を検出できるかどうかを示します。RecordMessageListener. onMessage(Record inputData)このメソッドにより、EIS はリクエスト / レスポンススタイルの通信を使用してメッセージエンドポイントを呼び出すことができます。booleanResultSetInfo. othersDeletesAreVisible(int type)他の人による削除が表示されるかどうかを示します。booleanResultSetInfo. othersInsertsAreVisible(int type)他の人が作成した挿入が表示されるかどうかを示します。booleanResultSetInfo. othersUpdatesAreVisible(int type)他の人が行った更新が表示されるかどうかを示します。booleanResultSetInfo. ownDeletesAreVisible(int type)ResultSet 自身の削除が表示されるかどうかを示します。booleanResultSetInfo. ownInsertsAreVisible(int type)ResultSet 自身のインサートが表示されているかどうかを示します。booleanResultSetInfo. ownUpdatesAreVisible(int type)ResultSet 自体の更新が表示されているかどうかを示します。voidLocalTransaction. rollback()現在のリソースマネージャーのローカルトランザクションをロールバックします。booleanResultSetInfo. supportsResultSetType(int type)リソースアダプターが ResultSet の型をサポートするかどうかを示します。booleanResultSetInfo. supportsResultTypeConcurrency(int type, int concurrency)リソースアダプターが、指定された ResultSet 型と組み合わせて同時実行型をサポートするかどうかを示します。/booleanResultSetInfo. updatesAreDetected(int type)メソッドResultSet.rowUpdatedを呼び出すことにより、表示されている行の更新を検出できるかどうかを示します。jakarta.resource.spi 内の ResourceException 使用
jakarta.resource.spi 内の ResourceException サブクラス 修飾子と型 クラス 説明 classApplicationServerInternalExceptionApplicationServerInternalExceptionはアプリケーションサーバーによってスローされ、アプリケーションサーバーに固有のエラー状態を示します。classCommExceptionこれは、EIS インスタンスとの通信の失敗または中断に関連するエラーを示します。classEISSystemExceptionEISSystemExceptionは、EIS 固有のシステムレベルのエラー状態を示すために使用されます。classIllegalStateExceptionIllegalStateExceptionは、呼び出し先(システム契約のリソースアダプターまたはアプリケーションサーバー)がメソッド呼び出しに対して無効または不適切な状態にある場合に、メソッドからスローされます。classInvalidPropertyExceptionこの例外は、無効な構成プロパティ設定を示すためにスローされます。classLocalTransactionExceptionLocalTransactionExceptionは、ローカルトランザクション管理規約に関連するさまざまなエラー状態を表します。classResourceAdapterInternalExceptionResourceAdapterInternalExceptionは、リソースアダプターに関連するシステムレベルのエラー状態を示します。classResourceAllocationExceptionResourceAllocationExceptionは、アプリケーションサーバーまたはリソースアダプターによってスローされ、システムリソース(例: スレッド、物理接続)の割り当てに失敗したことを示します。classRetryableUnavailableException作業の送信の拒否が一時的であることを示すUnavailableExceptionのサブクラス。classSecurityExceptionSecurityExceptionは、アプリケーションサーバーとリソースアダプター間のセキュリティ契約に関連するエラー状態を示します。classSharingViolationExceptionこれは、接続共有違反を示すためにスローされます。classUnavailableExceptionこれは、サービスが利用できないことを示すためにスローされます。ResourceException をスローする jakarta.resource.spi のメソッド 修飾子と型 メソッド 説明 ObjectSEConnectionManager. allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cxRequestInfo)メソッド allocateConnection は、リソースアダプターの接続ファクトリインスタンスによって呼び出されます。voidLazyAssociatableConnectionManager. associateConnection(ObjectSE connection, ManagedConnectionFactory mcf, ConnectionRequestInfo cxReqInfo)このメソッドは、接続オブジェクトをManagedConnectionインスタンスに遅延的に関連付けるために、リソースアダプター(遅延接続の関連付けの最適化が可能)によって呼び出されます。voidManagedConnection. associateConnection(ObjectSE connection)通常、コンテナーによって使用され、アプリケーションレベルの接続ハンドルと ManagedConnection インスタンスの関連付けを変更します。voidLocalTransaction. begin()ローカルトランザクションを開始するvoidManagedConnection. cleanup()アプリケーションサーバーはこのメソッドを呼び出して、ManagedConnection インスタンスのクリーンアップを強制します。voidLocalTransaction. commit()ローカルトランザクションをコミットするObjectSEManagedConnectionFactory. createConnectionFactory()ConnectionFactory インスタンスを作成します。ObjectSEManagedConnectionFactory. createConnectionFactory(ConnectionManager cxManager)ConnectionFactory インスタンスを作成します。ManagedConnectionManagedConnectionFactory. createManagedConnection(SubjectSE subject, ConnectionRequestInfo cxRequestInfo)基礎となる EIS リソースマネージャーへの新しい物理接続を作成します。voidManagedConnection. destroy()基盤となるリソースマネージャーへの物理接続を破棄します。voidDissociatableManagedConnection. dissociateConnections()このメソッドは、ManagedConnectionインスタンスをそのすべての接続ハンドルから分離するために、アプリケーションサーバー(遅延接続関連付けの最適化が可能)によって呼び出されます。voidResourceAdapter. endpointActivation(MessageEndpointFactory endpointFactory, ActivationSpec spec)これは、メッセージエンドポイントのアクティブ化中に呼び出されます。ObjectSEManagedConnection. getConnection(SubjectSE subject, ConnectionRequestInfo cxRequestInfo)ManagedConnection インスタンスによって表される基礎となる物理接続の新しい接続ハンドルを作成します。StringSEManagedConnectionMetaData. getEISProductName()ManagedConnection を介して接続されている基本的な EIS インスタンスの製品名を返します。StringSEManagedConnectionMetaData. getEISProductVersion()ManagedConnection を介して接続されている、基礎となる EIS インスタンスの製品バージョンを返します。SetSEValidatingManagedConnectionFactory. getInvalidConnections(SetSE connectionSet)このメソッドは、指定されたManagedConnectionオブジェクトのセットから選択された無効なManagedConnectionオブジェクトのセットを返します。LocalTransactionManagedConnection. getLocalTransaction()jakarta.resource.spi.LocalTransactionインスタンスを返します。PrintWriterSEManagedConnection. getLogWriter()この ManagedConnection インスタンスのログライターを取得します。PrintWriterSEManagedConnectionFactory. getLogWriter()この ManagedConnectionFactory インスタンスのログライターを取得します。intManagedConnectionMetaData. getMaxConnections()EIS インスタンスがクライアントプロセス全体でサポートできるアクティブな同時接続数の最大制限を返します。ManagedConnectionMetaDataManagedConnection. getMetaData()この接続の基盤となる EIS リソースマネージャーインスタンスのメタデータ情報を取得します。StringSEManagedConnectionMetaData. getUserName()ManagedConnection インスタンスに関連付けられているユーザーの名前を返します。XAResourceSEManagedConnection. getXAResource()javax.transaction.xa.XAresourceインスタンスを返します。XAResourceSE[]ResourceAdapter. getXAResources(ActivationSpec[] specs)このメソッドは、クラッシュリカバリ中にアプリケーションサーバーによって呼び出されます。voidLazyEnlistableConnectionManager. lazyEnlist(ManagedConnection mc)このメソッドは、XA トランザクションで接続オブジェクトを遅延登録するために、リソースアダプター(遅延トランザクション登録最適化が可能)によって呼び出されます。ManagedConnectionManagedConnectionFactory. matchManagedConnections(SetSE connectionSet, SubjectSE subject, ConnectionRequestInfo cxRequestInfo)接続の候補セットから一致する接続を返します。voidLocalTransaction. rollback()ローカルトランザクションをロールバックするvoidManagedConnection. setLogWriter(PrintWriterSE out)この ManagedConnection インスタンスのログライターを設定します。voidManagedConnectionFactory. setLogWriter(PrintWriterSE out)この ManagedConnectionFactory インスタンスのログライターを設定します。voidResourceAdapterAssociation. setResourceAdapter(ResourceAdapter ra)このオブジェクトをResourceAdapterオブジェクトに関連付けます。jakarta.resource.spi.endpoint 内の ResourceException 使用
ResourceException をスローする jakarta.resource.spi.endpoint のメソッド 修飾子と型 メソッド 説明 voidMessageEndpoint. afterDelivery()これは、メッセージが配信された後にリソースアダプターによって呼び出されます。voidMessageEndpoint. beforeDelivery(MethodSE method)これは、メッセージが配信される前にリソースアダプターによって呼び出されます。jakarta.resource.spi.work 内の ResourceException 使用
jakarta.resource.spi.work 内の ResourceException サブクラス 修飾子と型 クラス 説明 classRetryableWorkRejectedExceptionWorkRejectedExceptionのサブクラスは、サービスの利用不可が一時的であることを示します。classWorkCompletedExceptionこの例外はWorkManagerによってスローされ、送信されたWorkインスタンスが例外を伴って完了したことを示します。classWorkExceptionすべてのWork処理関連の例外の共通の基本クラス。classWorkRejectedExceptionこの例外は、送信されたWorkインスタンスが拒否されたことを示すためにWorkManagerによってスローされます。