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