建立探測

若要建立探測,請先建立 Probekit 程式檔(probe 檔案)。然後,在 Probekit 來源檔中,建立探測並新增內容來定義探測如何運作。

若要建立 Probekit 程式檔,您必須使用「Probekit 程式檔」精靈。 您可以繼續以精靈來建立探測及撰寫大部分的探測定義,或直接進入 Probekit 編輯器。 無論何者,皆必須使用 Probekit 編輯器來撰寫程式碼的 Java 程式碼片段。

如需探測各部分的詳細資訊,請參閱探測定義

  1. 建立 Probekit 程式檔:
    1. 在「導覽器」或「套件瀏覽器」視圖中, 用滑鼠右鍵按一下您要包含程式檔的 Java 專案,再按一下新建 > 其他
    2. 選取精靈頁面,展開側寫和記載,再選取 Probekit 程式檔
    3. 下一步
    4. 在「建立新的探測檔」精靈中,在檔案名稱欄位輸入新探測程式檔的名稱。 Probekit 程式檔的副檔名必須是 .probe
    5. 來源資料夾欄位中,輸入含有新 Probekit 程式檔的專案來源資料夾。
      附註:Probekit 程式檔必須位於專案來源資料夾的最上層;不能放在子資料夾中。
  2. 如果要立即結束精靈,使用 Probekit 編輯器來建立探測和定義:
    1. 選取無內容
    2. 接著按一下完成。 專案來源資料夾中會新增 Probekit 來源檔,且依預設會自動在 Probekit 編輯器中開啟。
    3. 繼續步驟 4
  3. 如果要繼續使用精靈來協助您建立探測定義:
    1. 選取 Method 探測Callsite 探測
    2. 對於希望精靈建立的片段,選取片段類型值。
    3. 下一步
    4. 使用新增編輯按鈕,定義您要的所有資料項目。 新增或選取項目時,精靈會顯示項目的說明。
      附註:如果返回變更正在建立的探測類型或要插入的片段類型,編輯器會提示您捨棄任何已不適用的項目。
    5. 接著按一下完成。 專案來源資料夾中會新增 Probekit 來源檔,且依預設會自動在 Probekit 編輯器中開啟。
  4. 選用:在 Probekit 編輯器的「一般」頁面上, 在 ID 欄位中輸入探測的唯一 ID 字串,在版本欄位中輸入版本號碼,並輸入標籤的值。 這項資料只是供您在側寫配置中識別探測。
  5. 按一下探測標籤。
  6. 如果未使用精靈來建立探測,請用滑鼠右鍵按一下 Probekit 編輯器左邊,選取新增探測 頁面左邊的樹狀窗格中會建立新的探測。
  7. 在樹狀窗格中用滑鼠右鍵按一下探測,再按一下新建 > 片段 在樹狀窗格中,新的片段會顯示為探測的子項,且頁面右邊的編輯窗格中會顯示片段的內容欄位。
  8. 在編輯窗格中,選取片段類型值,然後輸入探測片段的 Java 程式碼。 如需具體的資訊,請參閱探測片段類型
  9. 在樹狀結構中用滑鼠右鍵按一下項目,利用蹦現功能表來新增/移除子項目,並於編輯窗格中輸入新項目的值,繼續定義您的探測。 蹦現功能表只列出樹狀結構中選取的位置上適用的項目。 如果項目有效,但無法在選取的位置上新增,功能表會停用此項目。
    附註:Import 指引內容欄位中輸入值時,只要輸入您要匯入的套件或類別的名稱即可。 請勿輸入 import 關鍵字或句尾分號 (;)。
  10. 探測定義完成時,請按一下檔案 > 儲存
    附註:儲存 Probekit 程式檔時,Probekit 編輯器會檢查檔案中所有 Java 元素的語法,並報告任何 javac 問題。 如果項目出現錯誤或警告,樹狀結構中相對應的圖示會變成錯誤或警告圖示。 「探測」頁面底端的表格會顯示 Javac 問題。 按兩下此表格中的項目可針對此項目來編輯。
相關概念
收集探測資料:基本用法
相關參照
Probekit 編輯器
Probekit 範例