Juno 新增功能 (JDT)

以下是 Eclipse Juno(3.8 和 4.2)版 Java 開發工具一些比較令人關注或重要的變更說明。它們的分組如下:

另請參閱 Java 7 新增功能,以瞭解新增來支援 Java 7 語言的特性。

另請參閱 Eclipse 平台的新增功能文件,以瞭解「平台」的變更。


Java 編輯器

快速大綱中的 CamelCase Java 編輯器中的快速大綱 (Ctrl+O) 和快速階層 (Ctrl+T) 現在也支援元素名稱上的 camelCase 比對,很類似「開啟檔案」對話框和「內容輔助」。

型樣 'gCa' 的 StyledText 的「快速大綱」

當然,* 和 ? 萬用字元仍可使用。
「快速輔助」轉換加強型 for 迴圈 曾經遇到加強型 for 迴圈而需要存取 Iterator 或迴圈索引嗎? 現在,您可以使用「快速輔助」(Ctrl+1) 來轉換迴圈:

在加強型 'for' 迴圈的 'for' 關鍵字上的「快速輔助」擷取畫面

  • 轉換成索引型 'for' 迴圈適用於陣列和 List 式類型的表示式。
  • 轉換成反覆運算子型 'for' 迴圈適用於 Iterable 類型的表示式。
Java 編輯器中改良的方括弧對稱支援 Java 編輯器現在支援強調顯示含括的方括弧。

含括的方括弧

您可以在 Java > 編輯器喜好設定頁面中配置這個項目。

方括弧強調顯示的喜好設定

另外,檔案中到處都可以使用導覽 > 移至 > 對稱的方括弧動作 (Ctrl+Shift+P)。如果在呼叫動作之前未選取方括弧,則動作會導覽至最近的含括右方括弧。在第二次呼叫動作時,就會導覽至對應的左方括弧。第三次呼叫時,將會還原最初的選取項目。

目前為止,在方括弧後面緊接著輸入脫字符號,可找到對稱的方括弧。現在,緊接在方括弧前面或後面輸入脫字符號,都可找到對稱的方括弧。

對稱的方括弧範例

您可以將滑鼠指標停留在右大括弧上,在浮動說明中查看對稱的左大括弧附近的程式碼。 當您想要查看冗長的程式碼區塊開頭附近的程式碼時,這會很有用。浮動說明也會指出程式碼區塊中的行數。

方括弧浮動說明範例 1

浮動說明也適用於暫時「強調顯示」簡短的程式碼區塊。

方括弧浮動說明範例 2

Javadoc 浮動說明顯示參數註釋 Javadoc 浮動說明現在會呈現方法參數的註釋:

org.eclipse.User.User(@NonNull String name, int uid, @Nullable String email)

'無原始檔的 *.class' 檔案類型 無原始檔的 *.class 檔案類型容許讓內部或外部編輯器與未附加原始檔的類別檔產生關聯。例如,這可讓您在反編譯器中開啟類別檔:

「檔案關聯」喜好設定頁面的擷取畫面

更正提議的預設實作­­­­ JDT 現在為更正提議提供下列預設實作,可用來提供快速修正程式和快速輔助。
  • org.eclipse.jdt.ui.text.java.correction.ChangeCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.CUCorrectionProposal
  • org.eclipse.jdt.ui.text.java.correction.ASTRewriteCorrectionProposal
這樣可以輕鬆實作在 .java 檔上執行的快速修正/輔助,並使用 ASTRewrite。
package-info.java 中的內容輔助 內容輔助 (Ctrl+Space) 現在可以在 package-info.java 中使用,用來宣告套件層次註釋和 Javadoc。

內容輔助蹦現畫面,在套件宣告上新增套件層次註釋

Java 編譯器

選擇性地忽略來源資料夾的錯誤/警告 您現在可以配置 JDT 來忽略某些來源資料夾的選用錯誤/警告。 專案內容 > Java 建置路徑 > 編譯器 > 來源。

強調顯示「忽略選用性編譯問題」的 Java 建置路徑頁面

如果將這個選項設為是,JDT 會暫停喜好設定 > Java > 編譯器 > 錯誤/警告頁面中配置的錯誤/警告。對於包含自動產生的類別或測試的來源資料夾,這可能很適合。

不完整 switch 陳述式偵測的加強型診斷 現在,JDT 對於不完整 switch 陳述式的分析更為加強,並且可以更詳細的配置。請參閱這裡,以取得背景資訊。

為了讓 switch 陳述式變得完整,編譯器現在會個別檢查兩項準則:

  • 列舉的 switch 陳述式應該針對每一個列舉常數定義一個 case 陳述式
  • 與類型無關的每一個 switch 陳述式都應該定義一個 default case。

依預設,編譯器會對違反這兩項準則的 enum switch 發出警告:

列舉的 switch 遺漏 default case 的警告

這個警告由喜好設定 > Java > 編譯器 > 錯誤/警告 > 列舉的 'switch' case 不完整選項控制。 您可以選取新的子選項即使 'default' 案例存在也發出信號來加強這個選項,在此情況下,JDT 會標示列舉類型的 switch 陳述式,可能只透過 default 陳述式涵蓋列舉值,而非直接透過 case 陳述式。新增列舉常數時,這個選項有助於偵測未涵蓋新值的 switch 陳述式。

即使存在 default,列舉值 switch 含遺漏 case 陳述式的警告

強調顯示新的 switch 診斷選項的編譯器「錯誤/警告」頁面

編譯器喜好設定之相同區段中的第二個新增項目 Switch 遺漏 'default' case,控制 JDT 是否標示遺漏 default case 的 switch 陳述式,因為在執行時期如果出現非預期的值,將會完全略過這種 switch 陳述式。

switch 遺漏 default case 的警告

請注意,在上述情況中,警告也有助於瞭解最後敘述的另一項錯誤:
報告「可能尚未起始設定區域變數 printString」,因為用戶端可能以列舉值來呼叫方法 print(Color),但在編譯這個方法時,列舉值未知。

偵測資源洩漏的新選項 編譯器現在可以偵測資源的洩漏,也就是類型 java.lang.AutoCloseable(標準 >= 1.7)和 java.io.Closeable(標準 <= 1.6)的區域變數。 請參閱這裡,以取得背景資訊。

強調顯示「資源洩漏」的錯誤/警告頁面

當 Java > 編譯器 > 錯誤/警告喜好設定頁面的資源洩漏選項已啟用時,如果未在資源的區域範圍內呼叫 close() 方法,編譯器會發出錯誤或警告。

資源洩漏範例

當您在 Java > 編譯器 > 錯誤/警告喜好設定頁面上啟用潛在資源洩漏選項時,如果未在所有執行路徑上的某個資源的區域範圍內呼叫 close() 方法,編譯器會發出錯誤或警告。

潛在資源洩漏範例

如果在方法之間共用資源(可能是透過欄位),其中存取資源的任何一方可能需要呼叫 close(),這項分析會比較保守。 在某些情況下(例如:作為引數來傳遞給另一個方法),警告只會報告潛在洩漏,在其他情況下(儲存在欄位中),分析會完全無聲自動執行。

此外,分析會將特定案例辨識為實際上不重要。缺少 close() 呼叫不會觸發任何錯誤/警告的一些範例如下:

  • Closeable 的無資源實作者,例如 StringReader。

    如果 Closeable 的無資源實作者未關閉,不會報告資源洩漏

  • Closeable 的封裝實作者,例如 BufferedReader,直接或間接封裝無資源的 Closeable。

    當 Closeable 的無資源實作者未關閉時,不會報告資源洩漏

  • 封裝的資源,鏈結中的任何資源(可能)已關閉。

    當封套資源鏈中的任何資源在某些執行路徑上已關閉時,報告潛在資源洩漏。

新的批次編譯器警告選項 現在有兩個新的批次編譯器選項可用來配置編譯時期警告:
  • -warn:all 可用來啟用所有編譯器警告
  • -warn:resource 可用來啟用資源洩漏警告
新的建置路徑選項,警告來源資源夾的輸出位置與另一個來源資料夾重疊 當來源資料夾的輸出位置與另一個來源資料夾重疊時,JDT 現在會顯示建置路徑錯誤。 Java > 編譯器 > 建置 > 輸出位置與來源位置重疊喜好設定頁面上可以配置這個錯誤。

當來源資料夾的輸出位置與另一個來源資料夾重疊時的建置路徑錯誤

註釋型空值分析 JDT 現在可以配置成使用指定為空值註釋的註釋,以執行加強型程序間空值分析。在喜好設定 > Java > 編譯器 > 錯誤/警告 > 空值分析中可以啟用這個特性:

強調顯示「啟用註釋型空值分析」的「錯誤/警告」喜好設定頁面

您可以使用 JDT 隨附的預設註釋,或使用您自己的註釋作為空值註釋。 除了啟用空值分析,註釋也必須在專案的 Java 建置路徑上。 註釋預設位於 plugins 目錄的 org.eclipse.jdt.annotation JAR 中,這個 JAR 可當作 OSGi 軟體組或一般 JAR 使用。

啟用註釋型空值分析時,JDT 會依空值註釋指定,根據變數或方法傳回類型的空值性質,發出新的診斷。

	public void foo(@NonNull Object o1) {¶		System.out.println(o1.toString()); // OK: o1 不能是空值¶	}¶	¶	@NonNull Object bar(@Nullable String s1) {¶		foo(null); // 不能傳遞 null 引數¶		@NonNull String s= null; // 不能指派 null 值 ¶		@NonNull String t= s1; // 不能指派可能為 null 的值 ¶		return null; // 不能傳回 null 值¶	}

當指派/傳回的值可能是空值或有不明空值時,也會誘發類似的診斷。

也會檢查置換方法的正確性:

class Base {¶	@NonNull Object method(@Nullable Object o) {¶		return new Object();¶	}¶}¶¶class Sub extends Base {¶	@Override            // method 參數必須容許空值¶	@Nullable Object method(@NonNull Object o) {¶		return new Object();¶	}¶}

您也可以使用 @NonNullByDefault 註釋來設定某個元素(套件、類型、方法)在所有括住元素上的廣域預設值。

@NonNullByDefault¶class MyClass {¶	// 冗餘 @NonNull 註釋:¶	public @NonNull Object foo(@NonNull Object o) {¶		return o;¶	}¶	¶	@NonNullByDefault(false) // 取消預設值¶	Object bar(@NonNull Object o) {¶		return o;¶	}¶}

由於標註方法簽章,現有程序內空值分析因為使用者指定的註解而會有更多資訊,因此提供較佳的結果。 在下列範例中,如果沒有空值註釋,編譯器就無法評估參數 'obj' 的空值狀態(必須啟用冗餘空值檢查選項才能看到警告)。

public void foo(@NonNull Object obj) {¶		if (obj == null) { }¶	}

新的診斷程式分類於下列三個種類中:

  • 空值規格的違規
    這個選項會產生¶「空值類型不符:需要 '@NonNull String',但提供的值指定為 @Nullable」警告

    在這裡,'in' 不是合法的回覆值,因為其宣告中有 @Nullable 註釋。

  • 空值註釋與空值推斷之間發生衝突
    這個選項會產生¶「空值類型不符:需要 '@NonNull String',但提供的值推斷為 @Nullable」警告

    在這裡,'local' 不是合法的回覆值,因為未標註的變數 'local' 的流程分析推斷它在某些路徑上可能為空值。

  • 未檢查從非標註類型轉換成 @NonNull 類型
    這個選項產生¶			「空值類型安全:String 類型的表示式需要未檢查的轉換,才能符合 @NonNull String」警告

    在這裡,'getLegacyValue()' 的回覆值可能相容或可能不相容於 '@NonNull String'。 類似於將舊式原始類型轉換成通用類型,這裡也遺漏基本類型資訊,因為 'getLegacyValue()' 沒有 @NonNull 或 @Nullable 註釋。

附註:這是這項特性的第一個版本。我們正設法讓 Java 專案設定中更容易使用這項特性。 實作的特性已完成且通過測試,但目前沒有支援標註協力廠商程式庫的欄位或 API。目前已加入一組起始快速修正程式,未來將會進一步改良。

另請參閱這裡,以取得背景資訊。

使用空值註釋的批次編譯器選項 您現在可以配置批次編譯器來傳遞記號 nullAnnot(nullable|nonnull|nonnullbydefault) 給 -warn 選項,讓空值分析使用註釋,其中 nullable、nonnull 及 nonnullbydefault 是要用於空值分析的註解類型的完整名稱。您可以單獨使用 nullAnnot 來使用 JDT 的預設註釋。

此外,您也可以使用 -nonNullByDefault 記號,以在整體上使用 nonnull 作為啟用註釋型空值分析時的預設值。 這表示方法簽章中沒有空值註釋的所有類型,都視為指定的非空值。

偵測遺漏預設空值註釋 如果要針對方法簽章中未標註的類型將非空值設為預設值,您可以對所有套件使用 '@NonNullByDefault' 註釋。 為了確保完全涵蓋所有套件,您可以配置 JDT 來偵測遺漏的預設空值註釋。 如果啟用喜好設定 > Java > 編譯器 > 錯誤/警告 > 空值分析 > 套件遺漏 '@NonNullByDefault' 註釋,JDT 會在下列情況發出錯誤/警告:
  • 當套件在 package-info.java 中未包含 '@NonNullByDefault' 註釋時:

    套件遺漏 @NonNullByDefault 註釋的警告

  • 當預設套件內的類型不含預設空值註釋時。

    類型遺漏 @NonNullByDefault 註釋的警告

空值分析將 org.​eclipse.​core.​runtime.​Assert 視同 Java assert 因為 org.eclipse.core.runtime.Assert 常當作 Java assert 關鍵字來使用,JDT 的空值分析會將傳給前者的布林表示式在 Assert 參照之後視為一律為 true,因為如果條件未變成 false,則控制流程永不超過 org.eclipse.core.runtime.Assert 參照。

程式碼片段,顯示傳給 org.eclipse.core.runtime.Assert.isLegal(..) 的布林表示式在呼叫之後視為 true

使用預先建置的索引加速搜尋 附註:這項特性主要用於實作自己的類別路徑儲存器的外掛程式,而不適用於一般使用者。

當 JAR 第一次新增至類別路徑時,您現在可以告知 JDT 搜尋使用預先建置的索引,而非讓編譯器產生索引。這會避免在使用者機器上編製索引,因而可讓使用者更快地取得第一個搜尋結果。

您可以使用程式庫的類別路徑屬性 IClasspathAttribute.INDEX_LOCATION_ATTRIBUTE_NAME 來指定索引檔。

如需詳細資料,請參閱說明 > JDT 外掛程式開發人員手冊 > 程式設計師手冊 > JDT 核心 > Java 搜尋的索引。

Java 視圖與對話框

程式碼附件的編碼 您現在可以指定程式庫的程式碼附件編碼,例如,在建置路徑 > 程式庫 >中,展開程式庫 > 程式碼附件 > 編輯...

指定程式碼附件編碼的對話框

「錯誤/警告」喜好設定頁面上的強調顯示 在「錯誤/警告」喜好設定頁面,有時很難看到選取哪些項目,尤其是當您透過「配置問題嚴重性」按鈕開啟對話框時。

「Java 編輯器」問題浮動說明中的「配置問題嚴重性」按鈕

現在,有一個箭頭會強調顯示選取的項目,有另一個箭頭會強調顯示滑鼠下方的項目。

喜好設定頁面中的強調顯示

強調顯示也適用於「PDE 工具」和「API 工具」喜好設定頁面。

內容檔編輯器

「快速輔助」重組內容索引鍵 如果您使用 Eclipse 樣式的提出字串,下列新的快速輔助可讓您輕鬆重組內容檔案編輯器內的索引鍵:
  • 在工作區中重新命名 - 重新命名內容檔中的索引鍵並更新所有參照
  • 在 '...' 中建立欄位 - 在資源軟體組存取元類別中建立對應的欄位
  • 移除內容 - 從內容檔中刪除內容,以及從資源軟體組存取元類別中刪除欄位
  • 移除多個內容 - 從內容檔中刪除選取的多個內容,以及從資源軟體組存取元類別中刪除多個欄位

除錯

匯出詳細資料格式製作程式 現在,可以將詳細資料格式製作程式(例如,用來在「變數」視圖中呈現物件)匯出成個別的喜好設定。先前,共用詳細資料格式製作程式的唯一方法就是匯出所有工作區設定。

匯出對話框中的詳細資料格式製作程式

依預設顯示監視器 在除錯視圖中顯示監視器資訊的預設值現在設為開。 這項變更只影響新的工作區,不會變更現有的設定。

在除錯視圖中使用 Java > 顯示監視器檢視動作,可以指定是否顯示監視器資訊。

切換岔斷點修正鍵 在 Java 編輯器中切換岔斷點時,現在支援修正鍵:
  • 按住 Ctrl 鍵並按兩下(切換)岔斷點,將會顯示該岔斷點的「內容」對話框(在 Mac 上,使用 Command)

  • 按住 Alt 鍵並按兩下(切換)岔斷點會啟用/停用該岔斷點
如果沒有現有的岔斷點,則按下修正鍵,也會發生一般的岔斷點切換。

JUnit

JUnit 4.10 Eclipse 隨附的 JUnit 第 4 版已更新為 4.10。