シーケンス図の生成において、記録する範囲を考慮せずに記録を実施すると、必要以上に情報を取得・記録し、結果的に複雑で意味のないシーケンス図が作成されてしまいます。
こうした問題を回避するために、動作解析の機能では2つの機能で、記録範囲に制約を設けることができます。
- 1つは、解析するスタックの深さの指定です。一定以上の深さのメソッド(関数)呼び出しの情報を記録しないようにすることができます。注目したい範囲から、適切な深さまでの呼び出しにシーケンス図の内容を限定することができます。
- もう一つが、このページで説明するフィルタの指定です。このフィルタの指定は、動作解析の設定として行う必要があります。記録の対象外となるクラス・メソッドなどを指定することができます。
利用手順:
以下のいずれかの方法で動作解析サブウィンドウを開き、対象となる設定について以下の操作を実行し、その後記録タブを開きます。
- 動作解析の設定をダブルクリックする
- 動作解析の設定を右クリックし、編集を選択する
リボン |
|
キーボード |
Shift+F12 |
利用方法
フィルタを有効にするの設定項目が有効な場合には、デバッガの実行時にフィルタの条件に合致する内容は履歴を記録しないようになります。フィルタの条件は大文字小文字を区別します。
フィルタの値を追加するためには、新規のアイコンをクリックします。入力する値は次のような形式になります。
class_name_token::method_name_token
class_name_tokenを指定すると、対象のクラスのすべてのメソッドが記録対象外になります。ワイルドカードの文字 *を利用することができます。クラス名を指定しないことも可能です。
method_name_tokenを指定すると、指定した名前のメソッドが記録対象外になります。ワイルドカードの文字 *を利用することができます。メソッド名を指定しないことも可能です。
クラス名の指定がない場合には、グローバル・パブリックなメソッド(関数)のみが対象になります。クラスに関わらず、指定したメソッドを記録対象外にするという意味ではありませんので注意してください。
例:
Javaについて設定した例が下の画像です。この例では、以下のフィルタが有効です。
- Example.common.draw.DrawPaneクラスのOnDrawメソッド
- Example.source.Collectionで始まるクラスの全てのメソッド
- クラスのコンストラクタ
ネイティブアプリケーションについて設定した例が下の画像です。この例では、以下のフィルタが有効です。:
- STL名前空間の関数
- TObで始まる全てのクラスのメソッド
- CLockクラスのメソッド
- Getではじまるグローバルの関数
- CtrainクラスのGetLocationメソッド
詳細:
フィルタの例 |
処理内容 |
::Get* |
Getで始まる関数を記録対象外にする (例:WindowsAPIのGetClientRect) |
*::Get* |
全てのクラスを対象に、 Get で始まるメソッドを対象外にする |
CClass::Get* |
CClassクラスのGetで始まるメソッドを対象外にする |
CClass::* |
CClassの全てのメソッドを対象外にする |
ATL* std* |
標準テンプレートライブラリ(STL)やActive Template Libraries(ATL)のクラスを対象外にする |
CClass::GetName |
CClassのメソッドGetNameのみを対象外にする |
参照: