この章では、PersonQueryサンプル・アプリケーションで使用するために設計されている、次の2つのサンプル・インターセプタについて説明します。
ここでは、各インターセプタのしくみについて説明し、次にそれらをPersonQueryサンプル・アプリケーションでビルドして実行する方法を示します。
InterceptorDataClientインターセプタは、各クライアント・アプリケーションのリクエスト・パラメータと応答パラメータをインターセプトしてログに記録します。このインターセプタはまた、PersonQueryサーバー・アプリケーションに対するある特定のオペレーションを、クライアント・アプリケーションの特定の基準に一致するユーザーが呼び出せるようにします。InterceptorDataClientインターセプタは、ClientRequestInterceptor
クラスから継承されるInterceptorDataClient
インタフェースを実装します。
InterceptorDataClientクラスは、次のメソッドを実装します。
id()
このメソッドは、文字列InterceptorDataClient
を返します。
shutdown()
このメソッドはtracker
オブジェクトからのリクエストを削除します。
exception_occurred()
このメソッドは、ORBによって呼び出されると、tracker
オブジェクトからリクエストを削除します。
client_invoke()
このメソッドは、インタフェースおよびオペレーションが関心の対象であるかどうかを判断します。クライアント・リクエストが関心の対象である場合、このメソッドはリクエスト・パラメータを解析して、パラメータをログ・ファイルに出力します。クライアント・リクエストが関心の対象ではない場合、メソッドは単に復帰します。
client_response()
このメソッドは、リクエスト内のインタフェースおよびオペレーションが関心の対象であるかどうかを判断します。インタフェースおよびオペレーションが関心の対象である場合、メソッドはCORBA DataInputStream
パラメータの中から応答パラメータを取得して、それをログ・ファイルに書き込みます。リクエスト内のインタフェースおよびオペレーションが関心の対象ではない場合、メソッドは単に復帰します。
さらに、データ・インターセプタがInterceptorDataClientInit
メソッドを提供して、クライアント・インターセプタ・クラスを初期化します。
InterceptorDataTargetインターセプタはリクエストおよび応答データのパラメータをインターセプトしてログに記録します。このインターセプタはまた、x
の文字でデータをマスキングして特定の応答パラメータから、機密データを削除します。InterceptorDataTargetインターセプタは、InterceptorDataTarget
クラスから継承されるInterceptorDataTarget
インタフェースを実装します。
InterceptorDataTarget
クラスは、次のメソッドを実装します。
id()
このメソッドは、文字列InterceptorDataTarget
を返します。
shutdown()
exception_occurred()
このメソッドはtracker
オブジェクトからのリクエストを削除します。
target_invoke()
このメソッドは、インタフェースおよびオペレーションが関心の対象であるかどうかを判断します。関心の対象である場合、このメソッドはリクエスト・パラメータを解析して、そのデータをログ・ファイルに出力します。リクエスト内のインタフェースおよびオペレーションが関心の対象ではない場合、メソッドは単に復帰します。リクエスト内のオペレーションがexit
である場合、このメソッドはステータス値INVOKE_NO_EXCEPTION
を戻します。
target_response()
このメソッドは、インタフェースおよびオペレーションが関心の対象であるかどうかを判断します。関心の対象である場合、このメソッドはDataInputStream
パラメータの中から、レスポンス・パラメータを取得してログ・ファイルに出力します。機密データは、ログ内では置換されます。たとえば、個人の社会保障番号は、ログには出力されません。リクエスト内のインタフェースおよびオペレーションが関心の対象ではない場合、メソッドは単に復帰します。
さらに、データ・インターセプタがInterceptorDataTargetInit
メソッドを提供して、ターゲット・インターセプタ・クラスを初期化します。
InterceptorDataインターセプタを実装するために使用されるコードについては、「CORBAリクエスト・レベルのインターセプタの開発」で示しています。以下の方法の詳細は、この章を参照してください。
「PersonQueryサンプル・アプリケーション」で説明したPersonQueryサンプル・アプリケーションをビルドするmakefileを実行すると、InterceptorDataインターセプタを含むサンプル・インターセプタ一式全部が、同様にビルドされます。この項では、実行時にPersonQueryアプリケーションと共に機能するようにInterceptorDataインターセプタを登録する方法を説明します。
InterceptorDataクライアント・インターセプタおよびサーバー・インターセプタを登録して実行するには、次の手順に従います。
workdirectory
は、「PersonQueryサンプル・アプリケーション」に示す手順でインターセプタのサンプル・アプリケーションをコピーしたディレクトリの名前を表します。> cd <workdirectory
>\cxx\data_cxx
$ cd <workdirectory
>/cxx/data_cxx
> nmake -f makefile.nt config
$ make -f makefile.mk config
> cd <workdirectory
>\cxx\app_cxx
> tmboot -y
> PersonQueryClient
> cd <workdirectory
>/cxx/app_cxx
> tmboot -y
> PersonQueryClient
> tmshutdown -y
InterceptorDataクライアント・インターセプタおよびターゲット・インターセプタは、各呼出しをログに記録します。PersonQueryアプリケーションの各セッションについて、クライアント・インターセプタはInterceptorDataClient
xxx
.out
という名前のファイルを作成し、ターゲット・インターセプタはInterceptorDataTarget
xxx
.out
という名前のファイルを作成します。ここでは、各インターセプタのログ・ファイルのサンプルを示します。
InterceptorDataClientInit called
ClientInterceptorData::id called
ClientInterceptorData::client_invoke called
ClientInterceptorData::client_response called
Request Id: 1
unable to find request for this reply (must not be one we care about)
ClientInterceptorData::client_invoke called
Request Id: 2
Interface: IDL:beasys.com/PersonQuery:1.0
Operation: findPerson
Parameters:
name: ALISTER LANCASHIRE
address: 3 PENNY LANE
LONDON GB UK
ss: 999-99-9999
sex: can't tell
age(yrs.): 85
marital status: single
hobby: stamp collecting
date-of-birth: 11/25/1913
height(in.): 32
weight(lbs.): 57
hair color: unknown
eye color: blue
skin color: white
other markings: missing limb
InterceptorDataTargetInit called
TargetInterceptorData::id called
TargetInterceptorData::target_response called
Request Id: 2
ReplyStatus: GIOP::NO_EXCEPTION
Interface: IDL:beasys.com/PersonQuery:1.0
Operation: findPerson
Method Result: TRUE
Parameters:
Maximum: 8
Length: 8
Item 0
name: ALISTER LANCASHIRE
address: 3 PENNY LANE
LONDON GB UK
ss: NO PRIVILEDGE
sex: NO PRIVILEDGE
age (years): NO PRIVILEDGE
marital status: NO PRIVILEDGE
hobby: stamp collecting
date-of-birth: NO PRIVILEDGE
height (in.): 32
weight (lbs.): 57
hair color: unknown
eye color: blue
skin color: NO PRIVILEDGE
other markings: missing limb
InterceptorDataサンプル・インターセプタでPersonQueryサンプル・アプリケーションを実行後に、次の手順でこれらのインターセプタの登録を解除できます。
> tmshutdown -y
workdirectory
は、「PersonQueryサンプル・アプリケーション」に示す手順でインターセプタのサンプル・アプリケーションをコピーしたディレクトリの名前を表します。> cd <workdirectory
>\cxx\data_cxx
$ cd <workdirectory
>/cxx/data_cxx
> nmake -f makefile.nt unconfig
$ make -f makefile.mk unconfig