public abstract class GenericHandler extends ObjectSE implements Handler
javax.xml.rpc.handler.GenericHandler
クラスは、Handler
インターフェースを実装します。Handler クラスがスーパークラスとして別のクラスを必要としない限り、SOAP メッセージハンドラーの開発者は通常、GenericHandler
クラスをサブクラス化する必要があります。GenericHandler
クラスは、ハンドラーの記述を容易にする便利な抽象クラスです。このクラスは、ライフサイクルメソッド init
および destroy
のデフォルトの実装と、さまざまなハンドルメソッドを提供します。ハンドラー開発者は、派生した Handler
実装クラスの一部として特殊化する必要があるメソッドのみをオーバーライドする必要があります。
修飾子 | コンストラクターと説明 |
---|---|
protected | GenericHandler() デフォルトコンストラクター |
修飾子と型 | メソッドと説明 |
---|---|
void | destroy() destroy メソッドは、Handler インスタンスのライフサイクルの終わりを示します。 |
abstract QNameSE[] | getHeaders() この Handler インスタンスによって処理されるヘッダーブロックを取得します。 |
boolean | handleFault(MessageContext context) handleFault メソッドは、SOAP メッセージ処理モデルに基づいて SOAP エラーを処理します。 |
boolean | handleRequest(MessageContext context) handleRequest メソッドは、リクエスト SOAP メッセージを処理します。 |
boolean | handleResponse(MessageContext context) handleResponse メソッドはレスポンスメッセージを処理します。 |
void | init(HandlerInfo config) Handler インスタンスがそれ自体を初期化できるようにする init メソッド。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public boolean handleRequest(MessageContext context)
handleRequest
メソッドは、リクエスト SOAP メッセージを処理します。このメソッドのデフォルトの実装は true
を返します。これは、ハンドラーチェーンがリクエスト SOAP メッセージの処理を続行する必要があることを示しています。派生した Handler クラスがこのメソッドの実装を特殊化する必要がある場合は、このメソッドをオーバーライドする必要があります。Handler
の handleRequest
context
- MessageContext
パラメーターは、リクエストメッセージへのアクセスを提供します。true
を返し、リクエストハンドラーチェーンの継続処理を示します。HandlerChain
は、次のエンティティを呼び出す責任を負います。次のエンティティは、HandlerChain
の次のハンドラーである場合があります。または、このハンドラーがチェーンの最後のハンドラーである場合、次のエンティティはサービスエンドポイントオブジェクトです。false
を返します。この場合、リクエストハンドラーチェーンの以降の処理はブロックされ、ターゲットサービスエンドポイントはディスパッチされません。Jakarta XML RPC ランタイムシステムは、SOAPMessageContext を使用して次にレスポンスハンドラーチェーンを呼び出す責任を負います。Handler 実装クラスは、handleRequest メソッドと handleResponse メソッドのいずれかで適切なレスポンス SOAP メッセージを設定する責任を負います。デフォルトの処理モデルでは、レスポンスハンドラーチェーンは同じハンドラーインスタンス (false を返したもの) から処理を開始し、実行シーケンスを逆方向に進みます。Handler.handleRequest(javax.xml.rpc.handler.MessageContext)
public boolean handleResponse(MessageContext context)
handleResponse
メソッドはレスポンスメッセージを処理します。このメソッドのデフォルトの実装は true
を返します。これは、ハンドラーチェーンがレスポンス SOAP メッセージの処理を続行する必要があることを示しています。派生した Handler クラスがこのメソッドの実装を特殊化する必要がある場合は、このメソッドをオーバーライドする必要があります。Handler
の handleResponse
context
- MessageContext パラメーターは、レスポンス SOAP メッセージへのアクセスを提供します true
を返し、レスポンスハンドラーチェーンの処理が継続していることを示します。HandlerChain は、ハンドラーチェーンの次の Handler
で handleResponse
メソッドを呼び出します。false
を返し、レスポンスハンドラーチェーンのブロックを示します。この場合、ハンドラーチェーン内の他のレスポンスハンドラーは呼び出されません。Handler.handleResponse(javax.xml.rpc.handler.MessageContext)
public boolean handleFault(MessageContext context)
handleFault
メソッドは、SOAP メッセージ処理モデルに基づいて SOAP 障害を処理します。このメソッドのデフォルトの実装は true
を返します。これは、ハンドラーチェーンが SOAP 障害の処理を続行する必要があることを示しています。派生した Handler クラスがこのメソッドの実装を特殊化する必要がある場合は、このメソッドをオーバーライドする必要があります。Handler
の handleFault
context
- MessageContext パラメーターは SOAP メッセージへのアクセスを提供します true
を返します。HandlerChain は、ハンドラーチェーンの次の Handler
で handleFault
メソッドを呼び出します。false
を返します。この場合、ハンドラーチェーン内の他のハンドラーは呼び出されません。Handler.handleFault(javax.xml.rpc.handler.MessageContext)
public void init(HandlerInfo config)
init
メソッド。派生した Handler クラスがこのメソッドの実装を特殊化する必要がある場合は、このメソッドをオーバーライドする必要があります。Handler
の init
config
- このハンドラーの初期化の構成 Handler.init(javax.xml.rpc.handler.HandlerInfo)
public void destroy()
destroy
メソッドは、Handler インスタンスのライフサイクルの終了を示します。派生した Handler クラスがこのメソッドの実装を特殊化する必要がある場合は、このメソッドをオーバーライドする必要があります。Handler
の destroy
Handler.destroy()
public abstract QNameSE[] getHeaders()
Handler
の getHeaders
QName
は、Header ブロックの最も外側の要素の修飾名です。Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.