3.9. Jakarta XML Web Services のロギング


Jakarta XML Web Services ハンドラー または Apache CXF ロギングインターセプター を使用して、インバウンドおよびアウトバウンドメッセージのロギングを処理できます。

3.9.1. Jakarta XML Web Services ハンドラーの使用

Jakarta XML Web Services ハンドラーを設定して、渡されたメッセージをログに記録できます。このアプローチは、@HandlerChain Jakarta XML Web Services アノテーションを使用して、ハンドラーを目的のクライアントとエンドポイントにプログラムで追加できるため、移植可能です。

事前定義されたクライアントおよびエンドポイント設定メカニズムにより、ロギングハンドラーを任意のクライアントおよびエンドポイントの組み合わせに追加したり、一部のクライアントおよびエンドポイントのみに追加したりできます。ロギングハンドラーを一部のクライアントまたはエンドポイントのみに追加するには、@EndpointConfig アノテーションと JBossWS API を使用します。

org.jboss.ws.api.annotation.EndpointConfig アノテーションは、エンドポイント設定を Jakarta XML Web Services エンドポイント実装に割り当てるために使用されます。webservices サブシステムに定義された設定を割り当てる場合、設定名のみが指定されます。アプリケーションに定義されている設定を割り当てる場合は、デプロイメント記述子への相対パスと設定名を指定する必要があります。

3.9.2. Apache CXF ロギングインターセプターの使用

Apache CXF には、コンソール、クライアントのログファイル、またはサーバーのログファイルにメッセージをログに記録するために使用できるロギングインターセプターが同梱されています。これらのインターセプターは、以下を含む複数の方法でクライアント、エンドポイント、およびバスに追加できます。

  • システムプロパティー

    org.apache.cxf.logging.enabled システムプロパティーを true に設定すると、ロギングインターセプターが、JVM で作成されるバスインスタンスに追加されます。システムプロパティーを pretty に設定して、きれいな形式の XML 出力を出力することもできます。以下の管理 CLI コマンドを使用すると、このシステムプロパティーを設定できます。

    /system-property=org.apache.cxf.logging.enabled:add(value=true)
  • 手動インターセプターの追加

    ロギングインターセプターは、Apache CXF アノテーション @org.apache.cxf.interceptor.InInterceptors および @org.apache.cxf.interceptor.OutInterceptors を使用してエンドポイントに選択的に追加できます。プログラムでロギングインターセプターの新しいインスンタスをクライアントまたはバスに追加することにより、クライアント側の同じ結果が得られます。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る