オプションはコンパイルに対する命令です。オプションは、メソッドに応じた精度を提供します。使用可能なオプションはコンパイラによって異なり、特定の値の型を必要とします。

個々のコンパイラ・ディレクティブは、ディレクティブ・ファイルに記述します。アクティブなディレクティブのスタックに追加できるのはディレクティブ・ファイルのみで、個々のディレクティブは追加できません。

1. .json拡張子を使用してファイルを作成します。ディレクティブ・ファイルは、JSON構文のサブセットを使用して記述し、若干の追加と変更を行います。
2. 作業のベースとなるテンプレートとして次の構文を追加します。

   [  //Array of Directives
       {   //Directive Block
           //Directive 1
       },
       {   //Directive Block
           //Directive 2
       },
   ]

   このテンプレートの構成要素は次のとおりです。

   ディレクティブの配列

   • ディレクティブ・ファイルはディレクティブ・ブロックの配列を格納します。この配列は1対のカッコ([])で示されます。

   • ファイルに含まれるディレクティブ・ブロックが1つのみの場合、カッコはオプションです。

   ディレクティブ・ブロック

   • 1つのブロックは1対のカッコ({})で示されます。

   • 1つのブロックには1つのディレクティブが含まれます。

   • ディレクティブ・ファイルには任意の数のディレクティブ・ブロックを含めることができます。

   • ブロックはカンマ(,)で区切ります。

   • 配列内の最後のブロックに続くカンマはオプションです。

   ディレクティブ

   • 各ディレクティブはディレクティブ・ブロック内に存在する必要があります。

   • ディレクティブ・ファイルに複数のディレクティブ・ブロックが含まれている場合、そのファイルには複数のディレクティブを含めることができます。

   コメント

   • 単一行のコメントの前に2つのスラッシュ(//)を付けます。

   • 複数行のコメントは使用できません。

3. テンプレートでディレクティブ・ブロックを追加または削除して、ディレクティブ・ファイルに含めるディレクティブの数と一致させます。
4. ディレクティブ・ブロックごとに1つのコンパイラ・ディレクティブを記述します。コンパイラ・ディレクティブの記述を参照してください。
5. 必要に応じてディレクティブ・ブロックを整理しなおします。ファイル内のディレクティブの順序は重要です。記述されたディレクティブが配列の先頭に近いほど、優先度が高くなります。詳細は、ディレクティブ・スタック内のディレクティブの順序およびコードへのディレクティブの適用を参照してください。

[  //Array of directives
    {   //Directive Block
        //Directive 1
        match: ["java*.*", "oracle*.*"],
        c1: {
            Enable: true,
            Exclude: true,
            BreakAtExecute: true,
        },
        c2: {
            Enable: false,
            MaxNodeLimit: 1000,
        },
        BreakAtCompile: true,
        DumpReplay: true,
    },
    {   //Directive Block
        //Directive 2
        match: ["*Concurrent.*"],
        c2: {
            Exclude:true,
        },
    },
]

コンパイラ・ディレクティブをディレクティブ・ファイル内に記述する必要があります。ディレクティブ・ファイルに記述する個々のコンパイラ・ディレクティブごとに、次のステップを繰り返します。

1. 作業のベースとなるテンプレートとして次のコード・ブロックを挿入して、個々のコンパイラ・ディレクティブを記述します。このコード・ブロックはディレクティブ・ブロックです。

       {
           match: [],
           c1: {
               //c1 directive options
           },
           c2: {
               //c2 directive options
           },
           //Directive options applicable to all compilers
       },

2. メソッド・パターンの配列にmatch属性を指定します。コンパイラ・ディレクティブのメソッド・パターンの記述を参照してください。
   たとえば:

           match: ["java*.*", "oracle*.*"],

3. カンマで区切られたディレクティブ・オプションのブロックにc1属性を指定します。これらのオプションはc1コンパイラに対して有効になります。
   たとえば:

           c1: {
               Enable: true,
               Exclude: true,
               BreakAtExecute: true,
           },

4. カンマで区切られたディレクティブ・オプションのブロックにc2属性を指定します。このブロックでは、共通のコンパイラ・オプションとc2専用のコンパイラ・オプションを併用できます。
   たとえば:

           c2: {
               Enable: false,
               MaxNodeLimit: 1000,
           },

5. ディレクティブの末尾に、すべてのコンパイラに適用するオプションを指定します。これらのオプションは、共通ブロックの範囲内に記述されているものとみなされます。オプションはカンマで区切ります。
   たとえば:

           BreakAtCompile: true,
           DumpReplay: true,

6. 次のステップを実行して、ファイルをクリーン・アップします。
   1. ディレクティブ・オプションの重複を確認します。競合が発生した場合は、最後に出現するオプションが優先されます。競合は通常、共通ブロックとc1ブロックまたはc2ブロックとの間で発生します(c1ブロックとc2ブロックとの間ではありません)。
   2. c2専用ディレクティブ・オプションを共通ブロックに記述しないようにします。共通ブロックは共通オプションとc2専用オプションの組合せを受け入れることができますが、コマンド・ブロック内のc2専用オプションはc1コンパイラに影響を及ぼさないため、この方法でディレクティブを構成するのは無意味です。かわりに、c2専用オプションをc2ブロック内に記述してください。
   3. c1またはc2属性に対応するディレクティブ・オプションがない場合は、そのコンパイラに対する属性と値の構文を省略します。

    {
        match: ["java*.*", "oracle*.*"],
        c1: {
            Enable: true,
            Exclude: true,
            BreakAtExecute: true,
        },
        c2: {
            Enable: false,
            MaxNodeLimit: 1000,
        },
        BreakAtCompile: true,
        DumpReplay: true,
    },

    {
       "match": "*Concurrent.*",
        c2: {
            "Exclude": true,
        }
    },

ccstrはメソッド・パターンであり、正確に記述することも、ワイルドカード文字で一般化することもできます。一致度の高いどのJavaコードに、付随するディレクティブ・オプションを適用するか、またはどのJavaコードをインライン化するかを指定できます。

1. package/class.method(parameter_list)の構文を使用して、メソッド・パターンを記述します。ワイルドカード文字を使用してメソッド・パターンを一般化する場合は、ステップ2を参照してください。
   次の例は、この構文を使用するメソッド・パターンを示しています。

   java/lang/String.indexOf()

   その他の書式設定スタイルも使用できます。これにより、CompileCommandなどの以前のメソッド照合手段との下位互換性が確保されます。前述の例に代わる有効な書式設定には次のものが含まれます。

   • java/lang/String.indexOf()
   • java/lang/String,indexOf()
   • java/lang/String indexOf()
   • java.lang.String::indexOf()

   最後の書式設定スタイルは、HotSpot出力と一致します。
2. ワイルドカード文字(*)を、メソッド・パターンの一部を一般化する場所に挿入します。
   次の例は、ステップ1のメソッド・パターンの例を適切に一般化したものを示しています。

   • java/lang/String.indexOf*
   • *lang/String.indexOf*
   • *va/lang*.*dex*
   • java/lang/String.*
   • *.*
   一般化の度合いが増すほど、精度が低くなります。より多くのJavaコードが、メソッド・パターンと潜在的に一致するようになります。そのため、ワイルドカード文字(*)は慎重に使用することが重要です。
3. Java仕様に従って、メソッド・パターンのシグニチャ部分を変更します。シグニチャの照合は厳密である必要があります。そうでないと、シグニチャがワイルドカード文字(*)にデフォルト設定されます。省略されたシグニチャもワイルドカード文字にデフォルト設定されます。シグニチャにワイルドカード文字を含めることはできません。
4. オプション: inlineディレクティブ・オプションを伴うメソッド・パターンを記述する場合、追加の文字をメソッド・パターンの前に付ける必要があります。インライン・ディレクティブ・オプションの記述を参照してください。

inlineディレクティブ・オプションの属性は、接頭辞つきの特殊コマンドを使用したメソッド・パターンの配列を必要とします。これにより、インライン化するメソッド・パターンとインライン化しないメソッド・パターンを指定します。

1. ディレクティブの共通ブロック、c1ブロックまたはc2ブロックに、inline: と記述します。
2. 慎重に順序付けたメソッド・パターンの配列を追加します。最初に一致したメソッド・パターンの接頭辞つきコマンドが実行されます。配列内の残りのメソッド・パターンは無視されます。
3. +の接頭辞を付けると、一致するJavaコードのインライン化が強制されます。
4. -の接頭辞を付けると、一致するJavaコードのインライン化が回避されます。
5. オプション: インライン化動作を複数のメソッド・パターンに適用する必要がある場合、ステップ1から4を繰り返して、複数のinline文を記述します。複数のメソッド・パターンが含まれる単一の配列を記述しないでください。

Enableオプションを使用して、ディレクティブの側面を非表示にし、ディレクティブ間の重複を回避できます。

[
    {
        match: ["java*.*"],
        c1: {
            BreakAtExecute: true,
            BreakAtCompile: true,
            DumpReplay: true,
            DumpInline: true,
        },
        c2: {
            MaxNodeLimit: 1000,
        },
    },
    {
        match: ["oracle*.*"],
        c1: {
            BreakAtExecute: true,
            BreakAtCompile: true,
            DumpReplay: true,
            DumpInline: true,
        },
        c2: {
            MaxNodeLimit: 2000,
        },
    },
]

[
    {
        match: ["java*.*"],
        c1: {
            Enable: false,
        },
        c2: {
            MaxNodeLimit: 1000,
        },
    },
    {
        match: ["oracle*.*"],
        c1: {
            Enable: false,
        },
        c2: {
            MaxNodeLimit: 2000,
        },
    },
    {
        match: ["java*.*", "oracle*.*"],
        c1: {
            BreakAtExecute: true,
            BreakAtCompile: true,
            DumpReplay: true,
            DumpInline: true,
        },
        c2: {
            //Unreachable code
        },
    },
]