要訣和技巧

編輯 搜尋 導覽 視圖 除錯 雜項

編輯程式碼

內容輔助 內容輔助會提供您一個清單,其中列出已有部分輸入之字串的建議完成的清單。 在 Java 編輯器中,按下 Alt + /,或呼叫編輯 > 內容輔助

「選取內容輔助」對話框

Javadoc 註解中的內容輔助 Javadoc 註解中也有可用的內容輔助。

Javadoc 註解的內容輔助

抑制程式碼輔助中的類型

如果要從內容輔助中排除某些類型,請使用視窗 > 喜好設定 > Java > 外觀 > 類型過濾器喜好設定頁面中所配置的類型過濾器特性。只要符合其中一項過濾器型樣的類型, 就不會出現在「開啟類型」對話框中,且不供程式碼輔助、快速修正和組織匯入使用。 這些過濾器型樣不會影響「套件瀏覽器」和「類型階層」視圖。

類型過濾器喜好設定頁面
完成變數、方法參數和欄位名稱的內容輔助

您可以使用內容輔助加速欄位、方法參數和區域變數的建立。 請把游標停在宣告的類型名稱後面,呼叫編輯 > 內容輔助,或者按 Alt + /

建議的欄位名稱

如果您在欄位、區域變數或方法參數使用名稱字首或字尾, 請務必在「程式碼樣式」喜好設定頁面指定它(視窗 > 喜好設定 > Java > 程式碼樣式)

參數提示 當游標位在方法引數時, 您可以看到參數提示的清單。在「Java 編輯器」中, 按下 Ctrl+Shift+Space 或呼叫編輯 > 參數提示

參數提示浮動說明

匿名類別上的內容輔助 當建立匿名類別時,內容輔助也會提供說明。 將游標置於類別實例建立的左方括弧之後, 呼叫編輯 > 內容輔助或按下 Alt + /

匿名類別的內容輔助

這將建立匿名內部類別的主體,其中包括所有需要實作的方法。
在插入和取代程式碼輔助之間切換 如果在現有的 ID 呼叫程式碼輔助, 程式碼輔助便可以把這個 ID 換成您所選擇的完成作業,或者執行插入動作。 預設行為(改寫或插入)是在視窗 > 喜好設定 > Java > 編輯器 > 程式碼輔助加以定義。
您可以在按住 Ctrl 鍵並選取「完成」,於「選取內容輔助」對話框內暫時切換行為。
增量內容輔助 根據預設值,這時內容輔助會自動插入共用字首(與 UNIX Shell 展開類似)。如果要變更這個行為,請取消勾選視窗 > 喜好設定 > Java > 編輯器 > 程式碼輔助喜好設定頁面中的設定。
「建立 Getter 和 Setter」對話框 如果要為欄位建立 getter 和 setter 方法, 請選取欄位的宣告,並呼叫程式碼 > 產生 Getter 和 Setter

「產生 Getter 和	Setter」對話框

如果您使用名稱字首或字尾,請務必在「程式碼樣式」喜好設定頁面(視窗 > 喜好設定 > Java > 程式碼樣式)中指定它。
使用內容輔助來建立 Getter 和 Setter 建立 Getter 和 Setter 的另一個方法,就是使用內容輔助。 您可以將游標放在成員之間的類型主體中,然後按 Alt+/ 以取得建立 Getter 或 Setter 方法 Stub 的提議。
建立 Setter 的程式碼輔助
連同欄位一起刪除 Getters 和 Setter 當您從視圖刪除欄位時,Eclipse 可能會提議連同其 Getter 和 Setter 方法一起刪除。 如果您在欄位使用名稱字首或字尾,請務在「程式碼樣式」喜好設定頁面指定它(視窗 > 喜好設定 > Java > 程式碼樣式)
建立委派方法 如果要對欄位建立委派方法, 請選取欄位的宣告,並呼叫程式碼 > 產生委派方法。 這將新增所選方法至含有至委派的方法之轉遞呼叫的類型。 下面就是一個委派方法的範例:
委派方法範例
使用「拖放」進行重構作業 您可以在套件之間透過「拖放」來移動 Java 編譯單元 - 將新增所有遺漏的匯入並更新參照。
使用「拖放」來移動和複製 Java 程式碼元素 您可以透過「拖放」來移動和複製 Java 元素,如方法和欄位。這將不會觸發重構作業 - 僅複製或移動程式碼。
使用「範本」來建立方法 您可以定義新的範本(視窗 > 喜好設定 > Java > 編輯器 > 範本)來包含方法 Stub。範本會與內容輔助 (Alt + /) 提議一起顯示。
也有現有的範本,如 'private_method'、'public_method'、'protected_method',以及其他等等。
使用 Tab 鍵,在要輸入的值(傳回類型、名稱和引數)之間導覽。

具有新方法範本提議的內容輔助

使用快速修正來建立新方法 從呼叫方法開始, 然後使用快速修正 (Ctrl+1) 來建立方法。

「create 方法」快速修正

利用快速修正來變更方法簽章 您可以在呼叫網站上,把引數加到方法呼叫中。 然後再使用快速修正 (Ctrl+1),把必要的參數加到方法宣告中。

「變更簽章」快速修正

利用內容輔助來建立建構子 Stub 在您要新增建構子的位置,輸入該建構子名稱的第一個字母之後,再使用程式碼輔助。
在程式碼輔助中建立建構子
從參數建立新欄位 您需要建立新欄位來存放傳入建構子中的引數嗎? 您可以對參數使用快速輔助 (Ctrl+1) 來建立指派和欄位宣告, 並讓 Eclipse 根據「「程式碼樣式」喜好設定來提議名稱。
「指派參數給新欄位」快速輔助
使用「內容輔助」來置換方法 在類型主體中應該加入方法的位置, 呼叫內容輔助 (Alt + /)。內容輔助將提供所有可以被置換的方法。 將建立所選方法的方法主體。

「置換方法」內容輔助

使用「快速修正」來新增未實作的方法 如果要實作新的介面, 請先新增 'implements' 宣告至類型。 即使沒有儲存或建置,Java 編輯器也會強調以訊號顯示該類型,表示該方法遺漏,並且顯示快速修正燈泡。 您可以按一下燈炮,或按下 Ctrl+1(編輯 > 快速修正), 選擇要新增未實作的方法,或者讓類別成為 abstract。

快速修正提供「新增未實作的方法」提議

置換基礎類別的方法 如果要建立一個方法,來置換基礎類別的方法,請執行下列動作:
選取應該新增方法的類型,並且呼叫程式碼 > 置換/實作方法。 這時會開啟一個對話框,讓您選擇要置換的方法。

「置換/實作方法」對話框

在檔案中重新命名如果要快速進行重新命名作業, 可以使用「在檔案中重新命名」快速輔助,而不必在其他檔案完整分析其相依關係。 在 Java 編輯器中,將游標定位在變數、方法或類型的識別碼,然後按下 Ctrl+1 (編輯 > 快速修正)
編輯器會切換至鏈結的編輯模式(如同範本),而且變更識別碼將同時變更該變數、 方法或類型的所有其他參照。

利用「本端重新命名」快速修正來變更多個 ID

使用快速修正來處理異常狀況 要處理擲出的異常狀況並不難。 輸入時,會偵測未處理的異常狀況,並在編輯器中以紅線標示。
  • 按一下燈炮,或按下 Ctrl+1,以 try/catch 區塊包覆呼叫。 如果您想要在 try 區塊中併入多個陳述式, 請選取這些陳述式,然後使用程式碼 > 以 try/catch 區塊包覆。您也可以選取個別陳述式,方法是利用編輯 > 將選項展開為,然後再選取含括下一步上一步
  • 如果已用 try 區塊包覆呼叫,快速修正將建議新增 catch 區塊至現有的區塊。
  • 如果您不想要處理異常狀況,讓快速修正新增擲出異常狀況至含括方法宣告中。

「未捕捉到異常狀況」快速修正提議

您隨時都可以將 catch 區塊轉換為擲出異常狀況。請對 catch 區塊使用 Ctrl+1(編輯 > 快速修正)

「把 catch 子句換成 throws」快速輔助

更少輸入指派 不輸入指派,改為以將指派的表示式開始。

「指派陳述式給區域變數」快速輔助

您可以使用 Ctrl+1(編輯 > 快速修正),再選取「指派陳述式給新區域變數」, 「快速輔助」便會猜測變數名稱。
快速輔助指派
減少使用強制轉型表示式 別花太多時間在輸入強制轉型。先略過它們,等完成陳述式之後,再利用快速輔助加入它們。
比方說,以指派作業為例:
將強制轉型新增到指派作業中
或者在方法引數中:
加入方法引數的強制轉型
或者對方法呼叫目標:
在方法呼叫目標中加入強制轉型
指派已強制轉型的表示式
3.1 的新功能
在 'instanceof' 檢查之後,通常會強制轉型表示式,再將它指派給新的區域變數。請對 'instanceof' 關鍵字呼叫快速輔助 (Ctrl+1) 來節省輸入的時間:
'使用已強制轉型之類型的快速修正,引進新的區域變數
其他快速輔助
3.1 的新功能
查看快速輔助頁面,以取得可用之程式碼轉換的完整清單。其中包括:
  • 反轉 if 陳述式
  • 將 'switch' 轉換成 'if-else'
  • 將 'if-else' 取代為條件式
    ...還有更多
您可於這裡取得快速修正的清單。
快速修正和輔助的快速鍵
3.1 的新功能
某些常用的快速輔助,如:在檔案中重新命名指定給區域,可以直接利用 Ctrl+2 RCtrl+2 L 來呼叫。請查看按鍵喜好設定頁面, 以取得其他支援直接呼叫的快速修正。

含有快速輔助快速鍵的按鍵喜好設定頁面

包覆字行 如果要以 if / while / for 陳述式或區塊包覆陳述式,請選取要包覆的字行,然後按下 Ctrl+1 (編輯 > 快速修正)。這會列出所有含有 ${line_selection} 變數的範本。

「以範本包覆」快速輔助

您可以在視窗 > 喜好設定 > Java > 編輯器 > 範本上配置範本。編輯對應範本, 或定義您自己的範本來自訂出現的程式碼。
建立您自己的範本

如果要建立自己的範本,請移至視窗 > 喜好設定 > Java > 編輯器 > 範本喜好設定頁面,然後按新建按鈕來建立範本。舉例來說,要在陣列中向後疊代的範本如下:

顯示向後疊代的範本
程式碼輔助可以自動插入引數名稱

您可讓程式碼輔助在方法完成時自動插入引數名稱。 您可以在視窗 > 喜好設定 > Java > 編輯器 > 程式碼輔助喜好設定頁面自訂這個行為(請參考完成時填入引數名稱勾選框。)比方說,當您在此處選取第二個項目時,

「程式碼輔助」視窗

程式碼輔助將自動插入引數名稱:

程式碼輔助所插入的引數名稱

您可以使用 Tab 鍵,在插入的名稱之間導覽。

程式碼輔助也可以根據它們所宣告的類型來猜測引數名稱。 您可以利用視窗 > 喜好設定 > Java > 編輯器 > 程式碼輔助喜好設定頁面中的猜測填入的引數名稱勾選框,來配置這個項目。

自動插入類型引數
3.1 的新功能
在 J2SE 5.0 使用參數化的類型時,啟用視窗 > 喜好設定 > Java > 編輯器 > 程式碼輔助喜好設定頁面中的完成時填入引數名稱也很有用。
參數化類型的程式碼輔助
產生
猜測的程式碼輔助和插入的類型引數
移除包覆的陳述式 如果要移除包覆的陳述式或區塊, 請將游標定位在右方括弧,然後按下 Ctrl+1(編輯 > 快速修正)

「移除包覆的陳述式」快速輔助

那個字該怎麼拼? 您可以在一般 > 編輯器 > 文字編輯器 > 拼字檢查喜好設定頁面中,啟用 Java 編輯器中的拼字檢查支援。拼字錯誤會顯示在 Java 編輯器,同時也有對應的快速修正供您使用:

拼字更正提議的範例。

您也可以讓內容輔助使用該字典。 不過,目前 Eclipse 不含任何字典。 所需的格式只是一份以換行區隔的單字清單,且「快速修正」可讓您即時新增單字到字典中。您可以建構字典。

結構化選項 您可以使用「結構化選項」特性,以語法方式,迅速選取 Jav 程式碼。
強調顯示該文字,然後按 Alt+Shift+上移鍵, 或者從功能表列選取編輯 > 將選項展開為 > 含括元素 - 該選項便會展開成含有該選項的最小 Java 語法元素。 然後,您可以再次呼叫動作,來進一步展開選項。
尋找對稱的括弧 如果要尋找對稱的括弧,請選取左或右括弧, 然後按下 Ctrl+Shift+P(「導覽」>「移至」> 「對稱的括弧」)。您也可以在左方括弧之前,或是右方括弧之後按兩下滑鼠,選取這兩個方括弧之間的文字。

使用「按兩下」,選取兩個方括弧之間的文字

智慧型 Javadoc 輸入 '/**',然後按 Enter 鍵。 這會自動新增包含標準 @param、@return 和 @exception 標示的 Javadoc 註解 Stub。

「智慧型 Javadoc」的結果

您可以在視窗 > 喜好設定 > Java > 程式碼樣式 > 程式碼範本,配置新註解的範本。
使用本端歷程來回復至先前方法的版本 每當您編輯檔案時, 它的先前內容會保存在本端歷程中。Java Tooling 會使得本端歷程可供 Java 元素使用, 以便您可以回復至先前編輯的單一方法的前版本,而非完整檔案。

選取一個元素並使用取代為 > 本端歷程, 來回復至先前編輯的元素。

從本端歷程取代對話框

使用本端歷程來還原已移除的方法 每當您編輯檔案時, 它的先前內容會保存在本端歷程中。Java Tooling 會使得本端歷程可供 Java 元素使用, 以便您可以選擇性還原已刪除的方法。

您可以選取一個儲存器,然後利用從本端歷程還原,還原任何已移除的成員。

從本端歷程對話框還原

產生可自訂的程式碼 視窗 > 喜好設定 > Java > 程式碼樣式 > 程式碼範本喜好設定頁面可讓您以類似一般範本的方式,自訂產生的程式碼和註解。 只要一產生程式碼,就會用到這些程式碼範本。
「程式碼範本」喜好設定頁面

從 3.1 開始,即可以有專案專屬的程式碼範本,且如果專案是共用的,該範本也可以在團隊中共用。請對專案開啟內容來啟用專案專屬的設定。
在程式碼中建立註解 您可以利用原始檔 > 新增註解 (Ctrl+Shift+J) 來明確地新增註解,或由各種不同的精靈、重構作業或快速修正來自動新增。
請在視窗 > 喜好設定 > Java > 程式碼樣式 > 程式碼範本喜好設定頁面中配置註解範本。
您可以直接在精靈中啟用或停用自動產生註解(比方說,在「新建 Java 類型」精靈中使用產生註解勾選框), 或透過視窗 > 喜好設定 > Java > 程式碼樣式頁面的自動新增新方法和類型的新註解勾選框來執行。
所有這些設定也都可以依每一專案來配置。請對專案開啟內容來啟用專案專屬的設定。
排序成員 您可以根據視窗 > 喜好設定 > Java > 外觀 > 成員排序順序喜好設定頁面中所定義的種類順序,來對 Java 編譯單元進行排序成員
您將在程式碼 > 排序成員下找到動作
字串折行

當編輯「字串」文字時,您可以讓它們折行。比方說,如果您的程式碼如下所示:

String message= "This is a very long message.";

請將脫字符號 (^) 放在 "very" 這個字的後面,然後按 Enter 鍵。 這個程式碼將自動改為:

String message= "This is a very" +
           " long message.";

您可以在視窗 > 喜好設定 > Java > 編輯器 > 輸入喜好設定頁面中自訂這項行為。

智慧型輸入以及控制它的方法 Java 編輯器的智慧型輸入特性,可以減輕日常工作的負擔。 您可以在 Java > 編輯器 > 輸入喜好設定頁面中配置它們。

Java 編輯器的「輸入」喜好設定頁面

如果您啟用在正確的位置自動插入分號,輸入分號時會在插入分號之前,自動將游標定位在陳述式尾端。如此可以節省一些額外的游標導覽。
如果要復原這個自動定位作業,可以在這之後立刻按倒退鍵。

以一個按鍵修正程式碼縮排 一個非常有用的特性是程式碼 > 更正縮排Ctrl+I。請選取縮排不正確的程式碼,然後呼叫該動作。
程式碼和重構動作的快速功能表

您可以透過快速功能表,來存取重構和程式碼動作。 在 Java 編輯器或在 Java 視圖中選取要操作的元素,然後按 Alt+Shift+S 取得快速程式碼功能表, 或按 Alt+Shift+T 取得快速重構功能表。

快速重構功能表
尋找未用的程式碼 Java 編譯器會偵測無法呼叫到的程式碼、未使用的變數、 參數、匯入項目和未使用的私密類型、方法和欄位。 該設定位於視窗 > 喜好設定 > Java > 編譯器 > 錯誤/警告喜好設定頁面(或利用專案 > 內容 > Java 編譯器 > 錯誤/警告,針對個別專案設定)。

編譯器喜好設定頁面

當輸入時也會偵測這些設定,並提供一個快速修正以移除不必要的程式碼。
處理 Javadoc 註解 Eclipse Java 編譯器可以處理 Javadoc 註解。 搜尋報告會參照 doc 註解,而重構會更新這些參照。 這項特性是從視窗 > 喜好設定 > Java > 編譯器 > Javadoc 喜好設定頁面加以控制(或是利用專案 > 內容 > Java 編譯器 > Javadoc,針對個別專案設定)。

Javadoc 喜好設定頁面

如果開啟,Java 編輯器中就會標示形態異常的 Javadoc 註解,且可以利用編輯 > 快速修正 (Ctrl+1) 來修正:

Javadoc 偵測到的問題

抑制警告
3.1 的新功能
在 J2SE 5.0 中,您可以利用 'SuppressWarnings' 註釋來抑制所有選用的編譯器警告。
在本例中,'addAll()' 會標示成未使用的方法。您可使用快速修正 (Ctrl+1) 來新增 SuppressWarnings 註釋,如此即不會顯示這個方法的警告。
新增 SuppressWarning 註釋的快速修正

搜尋

尋找變數及其讀寫權 您可以選取一個 ID(變數、方法、類型參照或宣告), 呼叫搜尋 > 檔案中的搜尋結果, 來尋找變數,看看它們的讀寫狀態。 此舉會標示同一檔案中該識別碼的所有參照。 結果也會顯示在搜尋視圖中,以及有圖示會顯示變數的讀取權或寫入權。

欄位的讀寫權

另外,您也可以使用標示出現項目特性,來動態強調顯示出現項目。 您可以使用一般搜尋特性來搜尋數個檔案(搜尋 > 參照)。

搜尋具有特定傳回類型的方法

如果要搜尋具有特定傳回類型的方法,請使用 "* <return type>",如下所示:

  • 開啟搜尋對話框,再按一下 Java 搜尋標籤。
  • 搜尋字串中輸入以空格隔開的 '*' 和傳回類型。
  • 選取區分大小寫勾選框。
  • 選取方法宣告,然後按一下搜尋。

以給定的傳回類型來搜尋方法

從 Java 搜尋移除 Javadoc 結果 依預設,Java 搜尋會在 Java 程式碼和 Javadoc 中尋找參照。 如果您不要在 Javadoc 內尋找參照,您可以啟用「搜尋」視圖之「檢視」功能表中的「過濾 Javadoc」(三角形符號),來過濾這些相符項目。
以呼叫階層來追蹤方法呼叫鏈

您有沒有發覺自己曾經不斷的搜尋方法參照? 現在有一種新的呼叫階層,可以讓您跟著又長又複雜的呼叫鏈,又不會遺漏原始的環境定義: 只要選取一個方法,然後呼叫導覽 > 開啟呼叫階層 (Ctrl+Alt+H) 即可。

「呼叫階層」視圖

程式碼導覽和讀取

在 Java 編輯器中依據選項開啟 在 Java 編輯器中,有兩種方法, 可讓您從元素的參照中開啟元素。
  • 選取程式碼中的參照,並按下 F3(導覽 > 開啟宣告)
  • 按住 Ctrl 鍵,將滑鼠指標移到參照之上
超鏈結樣式導覽
您可以在喜好設定 > 一般 > 編輯器 > 文字編輯器 > 支援超鏈結樣式導覽中配置超鏈結樣式導覽。
原位概要 在 Java 編輯器中按下 Ctrl+F3, 以在現行游標位置蹦現元素的原位概要。或者按 Ctrl+O(導覽 > 快速概要),以蹦現現行程式檔的原位概要。

原位概要

原位概要會顯示繼承的成員 再按一次 Ctrl+OCtrl+F3, 把繼承的成員加到一個開啟的原位概要中。 繼承的成員附有一個灰色標籤。 您可以利用右上角的功能表來過濾和排列概要。

「快速概要」視圖

原位階層 利用「快速階層」,找出哪些是虛擬呼叫可能的接收端。 然後把游標放在方法呼叫裡面,按 Ctrl+T(導覽 > 快速階層)。 這個視圖會以完整的圖示,顯示所有實作方法的類型。

「快速階層」視圖

再按一次 Ctrl+T,切換至「Super 類型」階層。

進階強調顯示 Java 編輯器可以根據程式碼的語意,來強調顯示程式碼(例如:Static 欄位、區域變數、static 方法呼叫)。 您可在視窗 > 喜好設定 > Java > 編輯器 > 語法著色喜好設定頁面,查看各種不同的選項。

進階強調顯示的範例。

最初的摺疊區域 您可以指定當編輯器開啟時,依預設會摺疊哪些區域。請查看視窗 > 喜好設定 > Java > 編輯器 > 摺疊喜好設定頁面,來自訂這個項目。

摺疊喜好設定頁面

標示搜尋結果 在編輯器中作業時, 請開啟工具列中的標示出現項目「標示出現項目」工具列按鈕的圖片),或按 Alt+Shift+O。您會在檔案內看到參照某個變數、方法或類型的位置。
標示 'info' 搜尋結果的編輯器
當您選取一個傳回類型之後,畫面便會出現方法的結束點。 請選取一個異常狀況,看看擲出它的地方。
標示方法結束點的編輯器
您可以選取 super 類別或介面來查看被置換的方法,或從選定的超類型來實作方法。
您可以在視窗 > 喜好設定 > Java > 編輯器 > 標示出現項目中細部調整「標示出現項目」。
移至下一個 / 上一個方法 如果要快速導覽至下一個或上一個方法或欄位,請使用
Ctrl+Shift+上移鍵(導覽 > 移至 > 上一個成員), 或 Ctrl+Shift+下移鍵(導覽 > 移至 > 下一個成員)
註釋導覽控制 您可以使用「下一個/上一個註釋」工具列按鈕或是導覽 > 下一個註釋 (Ctrl+.) 和導覽 > 上一個註釋 (Ctrl+,),在 Java 程式檔中的註釋之間導覽。 您可以利用按鈕下拉功能表,來配置您要停在哪些註釋:

下一個/上一個註釋下拉功能表。

Java 程式碼中的提示 當您在 Java 程式碼中以 "TODO" 標示註解時,Java 編譯器就會自動建立一個對應作業,作為提示。 開啟作業可讓您導覽回程式碼中的 "TODO"。您可以使用視窗 > 喜好設定 > Java 編譯器 > 作業標示喜好設定頁面, 來配置您要在作業清單中追蹤的任何其他特殊標示(如 "FIXME")。

編輯器和作業視圖中的作業標示

「開啟類型」對話框中的秘訣
3.1 的新功能
  • 如果要快速尋找類型,您只需要輸入類型名稱的大寫字母:IOOBE 可找出 IndexOutOfBoundsException
  • 如果要查看以給定字尾結尾的所有類型,比方說,所有的 Tests,請使用 '*Test<' 才不會看到在類型名稱的其他位置含有 'Test' 的所有類型。
含有褐色字體之相符項目的「開啟類型」對話框
使浮動說明重複複製 您可以按下 F2(編輯 > 顯示工具提示說明), 在可捲動的視窗中從浮動說明開啟文字。您可以從這個視窗選取和複製內容。

含有浮動說明內容的視窗

Java 編輯器中的浮動說明 您可以使用修正鍵(Shift、Ctrl、Alt),在 Java 編輯器看到不同的浮動說明。
當您將滑鼠在 Java 編輯器中的識別碼上移動時, 依預設,將顯示一個浮動說明,其中含有從這個元素的對應程式檔擷取的 Javadoc。 按住 Ctrl 鍵將顯示程式碼。

在浮動說明內顯示元素程式碼的浮動說明

您可以在視窗 > 喜好設定 > Java > 編輯器 > 浮動說明中變更這個行為,以及定義其他修飾元按鍵的浮動說明。
一般方法推斷的簽章
3.1 的新功能
您可以使用浮動說明來顯示一般方法推斷的簽章。

顯示一般方法推斷簽章的浮動說明

開啟和配置外部 Javadoc 文件 如果您想要 利用 Shift+F2(導覽 > 開啟外部 Javadoc),來開啟類型、方法或欄位的 Javadoc 文件, 必須先指定元素母項程式庫(JAR、類別資料夾)或專案(來源資料夾)的文件位置。
對於程式庫,請開啟建置路徑頁面(專案 > 內容 > Java 建置路徑)、移至程式庫,展開您可以在其中編輯 'Javadoc 位置' 節點的程式庫節點。 文件可以放在本端檔案系統上的一個資料夾中,也可以放在保存檔或 Web 伺服器中。

在「Java 建置路徑」對話框配置 Javadoc 位置

對於來源資料夾中的類型、方法或欄位,請移至(專案 > 內容 > Javadoc 位置)。

Java 視圖

組織含有許多專案的工作區
3.1 的新功能
您可以使用「套件瀏覽器」之「檢視」功能表中的顯示 > 工作集, 來啟用將工作集顯示為最上層元素的新模式。這個模式會使得管理含有許多專案的工作區更加容易。

「工作集」模式下的套件瀏覽器

您可以從「套件瀏覽器」的「檢視」功能表中使用選取工作集, 來配置要顯示哪些工作集。這個對話框可讓您建立新的 Java 工作集、 定義要顯示哪些工作集,以及顯示的順序。您也可以在「套件瀏覽器」中利用拖放和複製/貼上, 來直接重新排列工作集。

「宣告」視圖 「宣告」視圖(視窗 > 顯示視圖 > 其他 > Java > 宣告)會顯示 Java 編輯器或 Java 視圖中選定元素的程式碼。

「宣告」視圖

Javadoc 視圖 Javadoc 視圖(視窗 > 顯示視圖 > 其他 > Java > Javadoc)會顯示您在 Java 編輯器或 Java 視圖所選元素的 Javadoc。Javadoc 視圖會使用 SWT 瀏覽器小組件,在支援它的平台上顯示 HTML。

Javadoc 視圖

「類型階層」視圖和方法實作/定義 如果要瞭解階層中哪些類型會置換方法,請使用「顯示階層中的成員」功能。
  • 選取要查看的方法,然後按下 F4(導覽 > 開啟類型階層)。 這將根據方法的宣告類型開啟類型階層視圖。
  • 如果「階層」視圖已經選取該方法,請按「鎖定視圖及顯示階層中的成員」工具列按鈕。
  • 階層視圖現在僅顯示實作或定義 '已鎖定' 方法的類型。 舉例來說,您可以看到 'isEmpty()' 在 'List' 中定義,且在 'ArrayList' 和 'Vector',但不在 'AbstractList' 中實作。

鎖定視圖並且顯示階層中的成員

類型階層視圖支援按定義類型進行分組 類型階層方法視圖可讓您依照其定義的類型, 排序所選類型的方法。 舉例來說,對於 AbstractList,您可以看到它含有已在 Object、Collection 和 List 中定義的方法:

根據類型階層中的定義類型,對成員排序

類型階層中的秘訣
  • 在元素或所選名稱上按 F4(導覽 > 開啟類型階層),將類型階層的焦點放在新類型。
  • 您不單可以開啟「階層」視圖以顯示類型, 也可以顯示套件、來源資料夾、JAR 保存檔與 Java 專案。
  • 您可以將元素拖放到「階層」視圖中, 以便將它的焦點放在該元素上。
  • 您可以從視圖的工具列, 變更「階層」視圖的擺放方式(從預設的垂直方向到水平方向)。
Java 程式檔的結構比較 Java 程式檔的結構比較會忽略 Java 元素(如方法和欄位)的文字次序, 而更清楚的顯示哪些元素已經變更、新增或是移除。
您可以選擇下列一種方法,來起始 Java 檔的結構比較:
  • 選取兩個 Java 編譯單元,然後從視圖的快速功能表選取相互比較 > 彼此。 如果檔案不一樣,將以「比較編輯器」開啟它們。 窗格頂端會顯示不同的 Java 元素;如果按兩下其中一個元素,便會在窗格底端顯示該元素的程式檔。
  • 在任何包含檔案比較的環境定義中(如 CVS 同步化) 按兩下 Java 檔,不僅可以文字比較檢視器顯示檔案內容, 還會執行結構比較,並且開啟新窗格來顯示結果。

Java 程式碼的結構比較

在執行結構比較時,甚至可以忽略註解和格式化變更:透過「比較編輯器」的工具列按鈕, 或「CVS 同步化視圖」的下拉功能表,來開啟忽略空格選項。
內容檔的結構比較 Java 內容檔(副檔名:.properties)的結構比較會忽略內容的文字次序, 而更清楚的顯示哪些內容已經變更、新增或是移除。
您可以選擇下列一種方法,來起始內容檔的結構比較:
  • 在「套件瀏覽器」或「導覽器」中選取兩個檔案,然後從視圖的快速功能表選取相互比較 > 彼此
  • 在任何包含檔案比較的環境定義中(如 CVS 同步化),按兩下內容檔不僅可以在文字比較檢視器顯示檔案內容, 還會執行結構比較,並且開啟新窗格來顯示結果。

內容檔的結構比較

階層式對平面式套件佈置 「Java 套件」視圖(和「套件瀏覽器」視圖)上, 有一個選項可讓您變更套件的顯示方式。階層式會以樹狀結構顯示套件, 在套件之下有子套件;平面式會以標準排列來顯示它們, 讓這個平面式清單的所有套件和子套件像同層級一樣。
平面式套件佈置 階層式套件佈置
邏輯套件 「Java 套件」視圖 (「Java 瀏覽」視景)會在專案內跨來源資料夾聯合同名的套件。 這會顯示含有邏輯套件的「套件」視圖。

含有邏輯套件的 Java 瀏覽視景

壓縮套件名稱 如果您的套件名稱很長,可以配置一個在檢視器顯示的壓縮名稱。 壓縮型樣的配置是在 > 視窗 > 喜好設定 > Java > 外觀中完成

Java 外觀喜好設定頁面中的壓縮型樣配置

使用這個範例,將以下列方式展現套件:

壓縮的套件名稱

在套件瀏覽器中直接操作 Java 建置路徑
3.1 的新功能
您可以使用套件瀏覽器之快速功能表中的動作,而不需在專案 > 內容 > Java 建置路徑中操作 Java 建置路徑。
比方說,您可以新增來源資料夾、保存檔和程式庫到建置路徑中,或是從來源資料夾併入/排除檔案和資料夾。
「建置路徑」快速功能表

雜項

專案專屬的喜好設定
3.1 的新功能

所有程式碼樣式和編譯器選項現在都可以依個別專案定義。
請對專案以專案 > 內容開啟專案內容頁,或使用工作區喜好設定的鏈結(例如:視窗 > 喜好設定 > Java > 程式碼樣式)來開啟專案內容頁,然後啟用專案專屬的設定。
含有「啟用專案專屬設定」勾選框的專案內容頁
專案專屬的設定係儲存在專案內的配置檔中(於 '.settings' 資料夾中)。當您在團隊中共用專案時,團隊成員也會取得這些專案專屬的設定。
存取規則
3.1 的新功能
存取規則讓您能夠從參照的程式庫強制實施類型的 API 規則。您可以在「Java 建置路徑」頁面(專案 > 內容 > Java 建置路徑)中,編輯可用於被參照之專案、保存檔、類別資料夾和程式庫的「存取規則」節點。
這些參照中的套件或類型可分類為:
  • 可存取
  • 不建議
  • 禁止
根據視窗 > 喜好設定 > Java > 編譯器 > 錯誤/警告中的設定,編譯器會以警告或錯誤標示不建議和禁止的參照。
存取規則配置對話框
JUnit 在視圖選取 JUnit 測試方法,然後從快速功能表選取執行 > JUnit 測試; 或者從主功能表選取執行 > 執行為 > JUnit 測試。 這會建立一個啟動配置來執行所選測試。
隱藏 JUnit 視圖直到發生錯誤或失敗 您可以使用 JUnit 視圖僅在發生錯誤或失敗時才開啟。 如此一來,您可以讓這個視圖設成快速視圖,且在沒有失敗測試時從不查看它。如果測試沒有問題,那麼在執行它們時, 您會看到這個圖示執行成功 (小綠色方塊的數目會隨之增加,指出進度),而且在完成它們之後, 也會看到這個圖示 已經順利完成。 不過,如果發生錯誤或失敗,圖示就會變成 發生失敗或錯誤 (如果已經完成測試,則會變成已經完成但發生失敗或錯誤), 而且會出現 JUnit 視圖。 您可以透過視窗 > 喜好設定 > Java > JUnit 喜好設定頁面來配置這項行為。
對話框欄位中的內容輔助 內容輔助 (Alt + /) 現在也可以在各種 Java 對話框的輸入欄位中使用。 請尋找焦點所在的欄位旁的小燈泡圖示。

「新建類別」對話框

舉個例說,內容輔助是在「新建 Java 類別」、「新建 Java 介面」和「新建 JUnit 測試」精靈, 以及在變更方法簽章和移動 Static 成員的重構對話框中實作。

「擷取區域變數」、「將區域變數轉換為欄位」以及「引進參數」重構,會提供內容輔助提議給新元素名稱使用。

定義欄位、參數和區域變數的字首或字尾 除了配置欄位的字首或字尾之外, 您還可以指定 Static 欄位、參數和區域變數的字首或字尾。 視窗 > 喜好設定 > Java > 程式碼樣式喜好設定頁面中的這些設定, 可以用於內容輔助、快速修正,以及計算變數名稱時的重構作業。

「程式碼樣式」喜好設定頁面中的命名慣例

組織匯入不僅可以在單一檔案上運作 您可以在一組編譯單元、套件、來源資料夾或 Java 專案上, 呼叫「組織匯入」。
製作多個檔案的格式 您可以選取所有的 Java 檔來製作格式, 並且選取「程式碼 > 製作格式」,製作所有程式碼的格式。 製作格式動作也可以用在套件、來源資料夾或 Java 專案。
使用專案特有的編譯器設定 每一個專案都可以決定要使用廣域編譯器設定, 還是定義專案特有的設定。選取專案並在專案內容中開啟 Java 編譯器頁面 (專案 > 內容 > Java 編譯器)

專案特定的 Java 編譯器設定

對專案使用特定的 JRE 在建立新專案時依預設會加入的 JRE, 就是您在視窗 > 喜好設定 > Java > 安裝的 JRE 中所選的 JRE。 如果要設定專案特定的 JRE,請開啟專案的「Java 建置路徑」內容頁面(專案 > 內容 > Java 建置路徑)、開啟程式庫頁面、選取「JRE 系統程式庫」,然後按編輯。 您可以在「編輯程式庫」對話框中,選取要採用預設的 JRE,還是在新專案加入專案特有的 JRE。

編輯 JRE 系統程式庫

「延伸棄用」標示 您可以利用 視窗 > 喜好設定 > Java > 編譯器 > 進階頁面中的選項,配置 Java 編譯器來診斷棄用項目。

編譯器喜好設定頁面

如果使用這項配置,其結果如下:

I.java

X.java

Y.java

如果無法修正即將棄用之建構的用法,建議您把含括的方法、欄位或類型,標示為即將棄用。 這麼一來,您就可以確認您已經置換一個即將棄用的建構, 而棄用旗標也會延伸到更進一步的相依項。

X.java

Y.java

從異常不一致回復 在發生罕見的功能不良事件時,JDT 可能會發生一些不一致的情況,例如:
  • Java 搜尋開啟類型漏掉結果
  • 套件瀏覽器中的項目無效

如果要讓它們回復一致,必須完全依照下列順序,執行下列動作:
  1. 利用導覽器關閉專案功能表動作,關閉所有的專案
  2. 結束和重新啟動 Eclipse
  3. 利用導覽器開啟專案功能表動作,開啟所有的專案
  4. 以手動方式觸發重新建置整個工作區(專案 > 清除...

除錯

從快速功能表啟動

您可以從快速功能表執行及除錯 Java 應用程式。 您可以從視圖或編輯器中的快速功能表選擇執行為(或除錯為 > Java 應用程式,來啟動程式檔、套件、方法、類型等等。 另外,您也可以使用 Java 應用程式啟動快速鍵連結 (Alt-Shift-D,J)。 最上層執行為(或除錯為)動作對目前所選的項目或作用中的編輯器也有影響。

具有啟動選項的快速功能表

在除錯器中評估

您可以從除錯器的許多地方,使用片段評估。 如果從編輯器或「變數」視圖的快速功能表選擇顯示視察, 則結果會顯示在蹦現畫面中,而結果也會傳到顯示「表示式」視圖

蹦現畫面中的視察結果

在非除錯視景中管理視圖

「除錯」視圖會根據您所選的視圖(例如,顯示 Java 堆疊框的 Java 視圖,以及 C 堆疊框的 C 視圖), 自動管理與除錯相關的視圖。 依預設,這個自動視圖管理只會發生在「除錯」視景中, 不過您可以透過「除錯」視圖工具列下拉畫面的視圖管理喜好設定頁,在其他視景啟用它。

環境變數

現在您就可以透過環境標籤,指定啟動 Java 應用程式所用的環境。

「啟動配置」對話框中的環境標籤

代換字串

現在 Java 應用程式啟動配置有許多參數,都支援變數。 支援變數的大部分欄位旁都有變數... 按鈕, 如:程式和 VM 引數欄位。主要類型欄位也支援變數;${java_type_name} 變數可讓您建立配置,執行您所選的類型。

「啟動配置」對話框中的「引數」標籤

邏輯結構

「變數」視圖工具列上的邏輯結構切換,會顯示共用類型的其他替代結構。 JDT 可以提供對映、集合和 SWT 複合項的邏輯表示法。 您可以從邏輯結構喜好設定頁面中定義其他類型的邏輯結構。

在「變數」視圖中,向量是顯示為邏輯結構

預設的 VM 引數

如果您經常指定同樣的引數給特定的 VM,則可以在安裝的 JRE 喜好設定頁面,配置預設的 VM 引數。 比起每採用一個啟動配置都要指定一次引數,這樣要方便得多。

有指定預設引數的 JRE 喜好設定頁面

在 Main 中停止

您可以在「Java 應用程式」啟動配置中使用在 main 中停止, 使得您的程式在除錯模式下執行時,將在 main 方法的第一行執行行中停止。

有勾選「在 main 中停止」選項的 Main 標籤

條件式岔斷點 您可以在岔斷點內容... 中使用條件式岔斷點, 來控制岔斷點何時真正地中止執行。您可以指定是否僅在條件為 True 時, 或僅在條件值變更時,才想要岔斷點暫停執行。

「岔斷點內容」對話框中的岔斷點條件式編輯器

停用岔斷點

如果您發現自己經常在同一位置新增和移除岔斷點, 不妨考慮在不需要岔斷點時停用它,等到需要時再重新啟用。 您可以使用岔斷點快速功能表的停用岔斷點,或者在「岔斷點」視圖中,取消選取岔斷點。

您也可以使用「岔斷點」視圖工具列的跳過所有的岔斷點動作,暫時停用所有的岔斷點。 此舉可以讓除錯器,在維護目前啟用狀態時,跳過所有的岔斷點。

尺規快速功能表的「停用岔斷點」動作

變更變數值

在除錯器中暫停執行緒時,您可以在變數視圖中,變更 Java 基本元素和「字串」的值。 從變數的快速功能表選取變更變數值。 您也可以在「詳細資料」窗格中輸入新值,並且使用快速功能表中的指派值動作(CTRL-S 快速鍵連結),來變更該值。

從詳細資料窗格變更變數值

浮動說明中的變數值 當執行緒暫停, 當將游標放在 Java 編輯器中的某個變數上時, 會以浮動說明方式來顯示變數的值。

編輯器中的變數值浮動說明

放到頁框

當逐步執行您的程式碼時, 您偶爾會逐步執行過多的副程序,或跳過原先要進入以進行副程序除錯的一行。 您不需重新啟動您的除錯階段作業,您可以使用放到頁框動作,來迅速地回到方法的開頭。 您可以選取對應於您想要重新啟動之 Java 方法的堆疊框,然後從「除錯」視圖工具列或堆疊框的快速功能表,選取放至頁框。 現行指示指標將重設為方法中第一個可執行的陳述式。 這個方法也適用於非頂層的堆疊框。

請注意,只有在利用 1.4 或更新版本的 VM,或 J9 VM 除錯時,才能使用「放至頁框」。 JVM 不見得都能從堆疊顯示您所要的頁框。 比方說,要放到堆疊的最下方頁框,或是放到原始方法下的任何頁框,都是不太可能的事情。

快速程式碼取代 當利用 1.4 或更高的 VM,或 J9 VM 除錯時,除錯器支援「快速程式碼取代」。 這可讓您變更目前正在除錯的程式碼。請注意,根據某個特定 VM 所提供的支援而定, 有的變更(例如新方法或是被刪除的方法、類別變數或是內部類別)是無法快速切換的。
進入選擇項進行副程序除錯

Java 除錯器可讓您進入一系列鏈結的或巢狀的方法呼叫內的單一方法, 進行副程序除錯。僅強調顯示要進入以進行副程序除錯的方法, 然後從 Java 編輯器快速功能表選取進入選擇項進行副程序除錯

這項特性也適用於非目前執行行。 您可以除錯到岔斷點,然後進入方法的目前指令指標下面幾行。

進入副程序選項

控制
您的主控台
主控台所顯示的輸出, 可以透過「主控台」視圖工具列中的 Pin 主控台動作,鎖定至特定程序。 另外還有一個捲動鎖定動作,可以停止主控台在附加新輸出時自動捲動。

具有程序下拉功能表的「主控台」視圖

建立監視項目 監視項目是表示式視圖中的表示式, 當您除錯時,其值就會更新。您可以從 Java 編輯器建立監視項目,方法是選取表示式或變數,然後從快速功能表或最上層的執行功能表選取監視
監視點

監視點就是每當存取或修改指定的變數時暫停執行的岔斷點。 如果要設定監視點,請在「概要」視圖選取一個變數,然後從快速功能表選取切換監視點。 如果要配置監視點,請在岔斷點視圖中選取監視點,然後從它的快速功能表選取內容...。 這類岔斷點的最重要內容是存取修改勾選框,因為它們控制岔斷點何時可以暫停執行。

「岔斷點內容」對話框

執行緒和監視器

Java 除錯器可選擇性地在除錯視圖中顯示監視器資訊。您可以使用「除錯」視圖下拉功能表中的顯示監視器動作, 來顯示哪些執行緒中在鎖定中,以及哪些執行緒在等待取得鎖定。處於死鎖的執行緒會以紅色呈現。

顯示死鎖循環的「除錯」視圖

逐行過濾器 逐行過濾器可以避免除錯器在進入程式碼進行副程序除錯時,在指定的類別和套件中暫停執行。 逐行過濾器是在視窗 > 喜好設定 > Java > 除錯 > 逐行過濾中建立的。 當您開啟使用逐行過濾器切換項目(位於除錯工具列和功能表)時, 逐行過濾器即會套用到所有的步驟動作。在「除錯」視圖中,所選堆疊框的套件或宣告類型可以迅速地新增至過濾器清單,方法為從堆疊框的快速功能表選取過濾器類型過濾器套件
使用即時運算簿

如果您想要實驗 API 或測試新的演算法, 使用 Java 即時運算簿頁面經常比建立新類別來得容易得多。 即時運算簿頁面是程式碼隨機片段的儲存器,您可以隨時執行這些片段, 而不需環境定義。如果要建立即時運算簿頁面,請建立一個副檔名為 .jpage 的新檔案 (或者使用新建精靈 - Java > Java 執行/除錯 > 即時運算簿頁面)。 接著輸入任何要執行的程式碼,然後選取它。 執行程式碼的方法有下列三種:

  • 執行所選程式碼並將傳回的結果置於「表示式」視圖中
  • 執行所選程式碼並將「字串」結果直接置於即時運算簿頁面中

    顯示結果的即時運算簿頁面

  • 執行所選程式碼(並忽略任何傳回的結果)

這些動作位在工作台工具列中,也位在即時運算簿頁面的快速功能表中。

編輯
啟動
配置
按住 Ctrl 鍵並從執行除錯下拉功能表進行選擇,將開啟相關聯的啟動配置以進行編輯。啟動配置也可以從與「除錯」視圖中任何項目相關聯的快速功能表開啟。
我的最愛啟動配置

啟動配置會按最近啟動的次序出現在「執行/除錯」下拉功能表中。 然而,有可能迫使某個啟動配置恆出現在下拉功能表的頂端, 方法為讓這個配置成為 '我的最愛'。您可以在適當的下拉功能表, 使用組織我的最愛...動作,來配置您最喜歡的啟動配置。

詳細資料格式製作器

變數表示式視圖中,詳細資料窗格會顯示目前選取之變數的已展開表示法。 依預設,這個已展開之表示法是對所選物件呼叫 toString() 所得的結果, 但是您可以從變數的快速功能表選取新建詳細資料格式製作器, 來建立一個將改用的自訂詳細資料格式製作器。所有同類型的物件都將使用這個詳細資料格式製作器。 您可以在視窗 > 喜好設定 > Java > 除錯 > 詳細資料格式製作器喜好設定頁面中,檢視及編輯所有的詳細資料格式製作器。

「詳細資料格式製作器」對話框

執行有編譯錯誤的程式碼

您可以執行和除錯並未清楚地編譯的程式碼。執行有和沒有編譯錯誤的程式碼之間的唯一差異, 就是如果執行一行有編譯錯誤的程式碼,將發生下列兩種情況之一:

  • 如果在視窗 > 喜好設定 > Java > 除錯喜好設定頁面設定了「於編譯錯誤時暫停執行」喜好設定,則在進行除錯時,除錯階段作業會暫停,如同觸及岔斷點一樣。請注意, 如果您的 VM 支援「快速程式碼取代」,您將可以修正編譯錯誤並回復除錯
  • 否則,執行將終止,並出現 '未解決編譯' 錯誤

有一點必須注意,只要您的執行路徑避開有編譯錯誤的程式碼行, 您就可以執行並除錯,正如同您平常所做一般。

「變數」視圖中的自動換行 除錯器的變數表示式視圖的詳細資料區域支援自動換行, 可從檢視下拉功能表取得它。

「變數」視圖下拉功能表中的自動換行動作

除錯器中的程式碼輔助

除了在 Java 編輯器中撰寫程式碼之外,程式碼輔助還可以在許多環境定義中使用:

  • 於輸入岔斷點條件
  • 變數 & 表示式視圖的詳細資料窗格
  • 於輸入詳細資料格式製作器程式碼片段時
  • 於輸入邏輯結構程式碼片段時
  • 即時運算簿頁面中輸入程式碼時
  • 顯示視圖中

「顯示」視圖程式碼輔助蹦現畫面

指令行詳細資料 您恆可以在執行或除錯模式中, 看到用來啟動程式的確切指令行,方法為從程序或除錯目標的快速功能表選取內容, 即使啟動已終止,也是可以。

指令行詳細資料

堆疊追蹤
超鏈結

主控台中會出現含超鏈結的 Java 堆疊追蹤。當您將滑鼠放在堆疊追蹤中的某一行時, 指標會變成手狀。 按下滑鼠按鈕將開啟相關聯的 Java 程式檔, 並且會將游標定位在對應行中。如果您在堆疊追蹤頂端的異常狀況名稱上按一下滑鼠按鈕,就會建立一個異常狀況岔斷點。

具有超鏈結之「主控台」視圖中的堆疊追蹤