サード・パーティーの Java と .NET の除外管理

デフォルトで、サード・パーティーの Java と .NET コードは IRX ファイルの生成中にスキャンされません。このトピックの手順に従って、除外するサード・パーティーのコードを管理できます。

このタスクについて

お使いのコード用の IRX ファイルを生成するときに、サード・パーティーのコードは除外されます。これは、分析対象として関心のないコードの情報や検出結果が評価に含まれないようにするためです。除外対象を変更するには、このトピックの手順に従います。

手順

  1. 抽出された <SAClientUtil_<version>_<os>.zip ファイルの config ディレクトリーの位置を特定します (ここで、<version> は、コマンド・ ライン・ユーティリティーの現行バージョンです)。
  2. このディレクトリー内で、dot_net.exclusions (.NET) または java.exclusions (Java) ファイルを探します。
    注: その他の .exclusions ファイル (同じディレクトリー内にあるもの) は実験的なもので、それらのファイルを変更してもサード・パーティーの除外に影響はありません。
  3. テキスト・エディターでファイルを開くと、次のフォーマットで XML が表示されています。 
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
                        <Exclusions>
                        <packages>
                        <package name="package_name"/>
                        </packages>
                        ...
                        </Exclusions>
  4. ファイルを編集して除外するパッケージを追加します。
    注:
    • 指定されたパッケージ名は、同じ接頭部を持つすべてのパッケージと一致します (それらのパッケージはワイルドカードが後に続くものとして処理されます)。例えば、<package name="com.mycompany.common"/> を除外対象として追加すると、<package name="com.mycompany.common.action1"/> と <package name="com.mycompany.common.action2"/> が除外されます。
    • <packages> コンテナーに追加されたエントリーのみがサード・パーティーの除外に影響します。クラスとメソッドの追加は除外に影響しません。
  5. ファイルを保存し、お使いのソース・コード用の IRX ファイルを生成します。

次のタスク

除外ファイルを変更する場合は、次のベスト・プラクティスに従ってください。
  • 変更した除外ファイルのバックアップを保持してください。特に、新規バージョンの Static Analyzer コマンド行ユーティリティーにアップグレードする場合は、更新されていないバージョンの除外ファイルがダウンロードされることに注意してください。Static Analyzer コマンド行ユーティリティーを更新するときに、変更済みの除外ファイルのコピーを保持して、新しい Static Analyzer コマンド行ユーティリティーにコピーします。
  • XML エントリーの単一ブロックに変更を保持しておくと、必要なときにそれらの変更を簡単にコピーして貼り付けることができます。