43.7. 障害メッセージの処理

ハンドラーは、メッセージの処理中に ProtocolException 例外が出力されると、障害メッセージを処理するために handleFault() メソッドを使用します。

handleFault() メソッドは、ハンドラーの型に応じて LogicalMessageContext オブジェクトまたは SOAPMessageContext オブジェクトのいずれかを受け取ります。受信したコンテキストは、ハンドラーの実装にメッセージペイロードへのアクセスを提供します。

障害メッセージ処理の継続方法に応じて、handleFault() メソッドは true または false のいずれかを返します。例外を出力することもできます。

handleFault() メソッドで受信されるコンテキストオブジェクトは、handleMessage() メソッドによって受信されるものに似ています。コンテキストの getMessage() メソッドを使用して、同じ方法でメッセージペイロードにアクセスします。唯一の違いは、コンテキストに含まれるペイロードです。

LogicalMessageContext の操作の詳細は、「論理ハンドラーでのメッセージの処理」を参照してください。

SOAPMessageContext の操作の詳細は、「SOAP ハンドラーでのメッセージの処理」を参照してください。

handleFault() メソッドがそのメッセージ処理をどのように完了するかが、メッセージ処理の実施方法に直接的な影響を及ぼします。次のいずれかのアクションを実行することで完了します。

例43.13「メッセージハンドラーでの障害の処理」に、メッセージのボディーを画面に出力する handleFault() の実装を示します。

public final boolean handleFault(LogicalMessageContext messageContext)
{
  System.out.println("handleFault() called with message:");

  LogicalMessage msg=messageContext.getMessage();
  System.out.println(msg.getPayload());

  return true;
}

public final boolean handleFault(LogicalMessageContext messageContext)
{
  System.out.println("handleFault() called with message:");

  LogicalMessage msg=messageContext.getMessage();
  System.out.println(msg.getPayload());

  return true;
}