Juno の新機能 (JDT)

ここでは、Eclipse リリース Juno (3.8 および 4.2) において Java 開発ツールに加えられた変更内容のうち、特筆すべきものおよび重要なものの一部について説明します。 以下のようにグループ化して説明します。

Java 7 言語をサポートするために追加されたフィーチャーについては、Java 7 の新機能も参照してください。

同様に、プラットフォーム内の変更について、Eclipse プラットフォームの新機能の資料も参照してください。


Java エディター

クイック・アウトラインのキャメル・ケース Java エディターのクイック・アウトライン (Ctrl+O) およびクイック階層 (Ctrl+T) は、エレメント名に対するキャメル・ケース・マッチングもサポートするようになりました。これは、「型を開く」ダイアログおよびコンテンツ・アシストによく似た機能です。

パターンが「gCa」である StyledText のクイック・アウトライン

もちろん、ワイルドカード * および ? もまだ有効です。
拡張 for ループを変換するクイック・アシスト 拡張 for ループがあり、Iterator またはループ・インデックスにアクセスすることが必要になったことはありませんか? クイック・アシスト (Ctrl+1) を使用するだけで、ループを変換することができるようになりました。

拡張「for」ループの「for」キーワードに対するクイック・アシストのスクリーン・ショット

  • インデックスによる「for」ループへの変換が、配列ベースの型と List ベースの型の式で使用できます。
  • イテレーター・ベースの「for」ループへの変換は、Iterable 型の式で使用できます。
Java エディターでの大括弧マッチング・サポートの向上 Java エディターは、両側を囲む大括弧を強調表示する機能をサポートするようになりました。

両側を囲む大括弧

これは、「Java」>「エディター」設定ページで構成することができます。

大括弧強調表示の設定

また、「ナビゲート」>「ジャンプ」>「対応する大括弧」アクション (Ctrl+Shift+P) は、ファイル内のどこでも機能するようになりました。 このアクションを呼び出す前に大括弧が選択されていない場合、アクション実行時に、両側を囲む大括弧のうち最も近い終了大括弧にナビゲートされます。 このアクションを 2 回目に呼び出すと、対応する開始大括弧にナビゲートされます。 3 回目の呼び出しでは、元の選択に戻ります。

これまで、対応する大括弧が検出されたのは、大括弧の直後にキャレットが置かれていた場合でした。 これからは、大括弧の直前または直後のいずれかにキャレットが置かれていれば、対応する大括弧が検出されるようになります。

対応する大括弧の例

右中括弧の上にマウスを移動すると、対応する左中括弧の近くのソースが吹き出しに表示されます。 これは、長いコード・ブロックの始まり付近のコードを表示する際に役立ちます。 吹き出しには、コード・ブロック内の行数も示されます。

括弧の吹き出し例 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 でのコンテンツ・アシスト package-info.java (パッケージ・レベルの注釈および Javadoc を宣言するために使用される) の内部でコンテンツ・アシスト (Ctrl+Space) を使用できるようになりました。

パッケージ宣言でパッケージ・レベルの注釈を追加するためのコンテンツ・アシスト・ポップアップ

Java コンパイラー

ソース・フォルダーからのエラー/警告の選択的な無視 特定のソース・フォルダーからのオプションのエラー/警告を無視するように JDT を構成することができるようになりました。 「プロジェクト・プロパティー」>「Java のビルド・パス」>「コンパイラー」>「ソース」。

「Java のビルド・パス」ページ。「オプションのコンパイルの問題を無視」が強調表示されている

このオプションを「はい」に設定すると、JDT は、「設定」>「Java」>「コンパイラー」>「エラー/警告」ページで構成されたエラー/警告を抑止します。 このようにすると、自動生成されたクラスまたはテストが含まれるソース・フォルダーに対する操作に役立つ場合があります。

不完全な switch ステートメントの検出における拡張された診断 不完全な switch ステートメントに関する JDT の分析がより強力になり、詳細な項目まで構成できるようになりました。背景については、ここを参照してください。

コンパイラーは、switch ステートメントが完全なものとなるように以下の 2 つの基準を別個にチェックするようになりました。

  • 列挙型の switch ステートメントでは、列挙型定数それぞれに関して 1 つの case ステートメントを定義する必要があります。
  • それぞれのタイプの switch ステートメントごとに、default ケースを定義する必要があります。

デフォルトでは、両方の基準に違反している列挙型 switch に関してコンパイラーは警告を出します。

列挙型の switch で default ケースが欠落している場合の警告

この警告は、オプション「設定」>「Java」>「コンパイラー」>「エラー/警告」>「列挙型での不完全な 'switch' case」で制御します。 このオプションは、「'default' ケースが存在する場合でもシグナル」という新しいサブオプションを選択すると拡張できます。この場合、JDT は、列挙型に対する switch ステートメントに関して、その列挙型値が直接 case ステートメントによってカバーされるのではなく、default ステートメントを介してのみカバーされる可能性がある場合にフラグを立てます。新しい列挙型定数が追加されると、このオプションは、新しい値をカバーしていない switch ステートメントの検出に役立ちます。

列挙型値の switch で default は存在していても case ステートメントが欠落している場合の警告

コンパイラーの「エラー/警告」設定ページの新しい switch 診断オプションが強調表示されている

コンパイラー設定の同じセクションに追加された 2 つ目の点である「Switch で 'default' ケースが欠落」によって、default ケースが欠落している switch ステートメントに対して JDT がフラグを立てるかどうかを制御します。 こうした switch ステートメントが予期しない値に対して実行されると、実行時に全体がスキップされることになるからです。

switch で default ケースが欠落している場合の警告

上記のような場合には、この警告は、最後のステートメントに対する別のエラーである、
「ローカル変数 printString が初期化されていない可能性があります」が報告される理由を理解する助けにもなります。 つまり、クライアントは、メソッド print(Color) のコンパイル時には分からなかった列挙型値でこのメソッドを呼び出す可能性があるので、このエラーが出されます。

リソース・リークを検出するための新しいオプション コンパイラーは、リソース (java.lang.AutoCloseable 型 (>= 1.7 で準拠) と java.io.Closeable 型 (<= 1.6 で準拠) のローカル変数) のリークを検出できるようになりました。 背景情報については、ここを参照してください。

「エラー/警告」ページの「リソース・リーク」が強調表示されている

「Java」>「コンパイラー」>「エラー/警告」設定ページの「リソース・リーク」オプションを有効にすると、リソース上でローカルに close() メソッドが呼び出されるわけではない場合に、コンパイラーはエラーまたは警告を発行します。

リソース・リークの例

「Java」>「コンパイラー」>「エラー/警告」設定ページの「潜在的なリソース・リーク」オプションを有効にすると、すべての実行パスのリソースでローカルに close() メソッドが呼び出されるわけではない場合に、コンパイラーはエラーまたは警告を発行します。

潜在的なリソース・リークの例

リソースがメソッド間で共有される 場合 (フィールドを介するなどの方法で共有される場合)、そのリソースへのアクセス元のいずれかから、必要な close() 呼び出しが実行される可能性があると、この分析の基準が緩くなります。 場合によっては (例えば、別のメソッドに引数として渡される場合など)、警告は潜在的な リークだけをレポートするように基準が緩くなったり、他の場合には (フィールドに格納される場合) 分析でまったく何も報告されなくなったりします。

また、分析では特に重要ではない 特定のケースを認識します。close() 呼び出しがない場合にエラー/警告がトリガーされないいくつかの例を、以下に示します。

  • StringReader などの、Closeable のリソースなしインプリメンター。

    Closeable のリソースなし実装がクローズされない場合、リソース・リークは報告されない

  • リソースなし Closeable を直接的または間接的にラップするだけの、Closeable のラッピング・インプリメンター (BufferedReader など)。

    Closeable のリソースなし実装をラップするリソースがクローズされない場合、リソース・リークは報告されない

  • チェーン内のいずれかのリソースが (潜在的に) がクローズされる、ラップされるリソース。

    ラッパー・リソースのチェーンに含まれるリソースが実行パスの一部でクローズされるとき、潜在的なリソース・リークが報告される。

バッチ・コンパイラーの新しい警告オプション コンパイル時の警告を構成するための 2 つの新しいバッチ・コンパイラー・オプションを使用できるようになりました。
  • -warn:all すべてのコンパイラーの警告を有効にするために使用できます
  • -warn:resource リソース・リークの警告を有効にするために使用できます
ソース・フォルダーの出力ロケーションが別のソース・フォルダーとオーバーラップする場合に警告するための新しいビルド・パス・オプション JDT は、ソース・フォルダーの出力ロケーションが別のソース・フォルダーとオーバーラップする場合に、ビルド・パス・エラーを表示するようになりました。 このエラーは、「Java」>「コンパイラー」>「ビルド」>「出力ロケーションがソース・ロケーションとオーバーラップ」設定ページで構成できます。

ソース・フォルダーの出力ロケーションが別のソース・フォルダーとオーバーラップするときのビルド・パス・エラー

注釈ベースの NULL 分析 JDT は、NULL 注釈として指定された注釈を使用して拡張プロシージャー間 NULL 分析を実行するように構成できるようになりました。 このフィーチャーは、「設定」>「Java」>「コンパイラー」>「エラー/警告」>「NULL 分析」で有効にすることができます。

「エラー/警告」設定ページで「注釈ベースの NULL 分析を使用可能にする」が強調表示されている

NULL 注釈として、JDT にバンドルされているデフォルトの注釈を使用することも、独自の注釈を使用することもできます。 NULL 分析を使用可能にする操作に加えて、注釈をプロジェクトの Java ビルド・パスに配置する必要があります。 デフォルトの注釈は、plugins ディレクトリーの org.eclipse.jdt.annotation JAR にあります。 この JAR は、OSGi バンドルまたはプレーン JAR として取り込み可能です。

注釈ベースの NULL 分析が使用可能になっている場合、JDT は、NULL 注釈によって指定されている、変数またはメソッドの戻りの型の NULL 特性に基づいて、新しい診断を発行します。

	public void foo(@NonNull Object o1) {¶		System.out.println(o1.toString()); // OK: o1 cannot be null¶	}¶	¶	@NonNull Object bar(@Nullable String s1) {¶		foo(null); // cannot pass null argument¶		@NonNull String s= null; // cannot assign null value ¶		@NonNull String t= s1; // cannot assign potentially null value ¶		return null; // cannot return null value¶	}

割り当てられた/返された値に NULL の可能性があるか、または NULL 特性が不明である場合にも、同様の診断が出されます。

オーバーライドする側のメソッドの正確さも、次のように検査されます。

class Base {¶	@NonNull Object method(@Nullable Object o) {¶		return new Object();¶	}¶}¶¶class Sub extends Base {¶	@Override            // method parameter must allow null¶	@Nullable Object method(@NonNull Object o) {¶		return new Object();¶	}¶}

また、@NonNullByDefault 注釈を使用して、中に含まれるすべてのエレメントに対してエレメント (パッケージ、型、メソッド) のグローバル・デフォルトを設定することができます。

@NonNullByDefault¶class MyClass {¶	// redundant @NonNull annotations:¶	public @NonNull Object foo(@NonNull Object o) {¶		return o;¶	}¶	¶	@NonNullByDefault(false) // cancels the default¶	Object bar(@NonNull Object o) {¶		return o;¶	}¶}

メソッド・シグニチャーに注釈を付けると、既存のプロシージャー内 NULL 分析で検出される情報はユーザー指定の注釈の働きによってはるかに多くなり、結果がさらに良くなります。 次の例では、NULL 注釈を使用しなければ、コンパイラーはパラメーター「obj」NULL 状況を評価することができません (警告を表示するには、オプション「冗長な NULL の検査」を有効にしなければなりません)。

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

新しい診断は、以下の 3 つのカテゴリーに分類されます。

  • NULL 指定の違反
    このオプションは、¶「NULL 型の不一致: '@NonNull String' が必要ですが、指定された値は @Nullable と指定されています」の警告を生成します

    ここでは、「in」は有効な戻り値ではありません。その宣言の中に @Nullable 注釈があるためです。

  • NULL 注釈と NULL 推論の間の競合
    このオプションは、¶「NULL 型の不一致: @NonNull String が必要ですが、指定された値は @Nullable と推論されます」の警告を生成します

    ここでは、「local」は有効な戻り値ではありません。注釈なし変数「local」のフロー分析では、いずれかのパスで NULL になる可能性があることが推測されるためです。

  • 非注釈型から @NonNull 型への未検査変換
    このオプションは、¶「NULL 型の安全性: 型 String の式は、未検査の型変換を使用して @NonNull String に準拠するようにする必要があります」警告を生成します

    ここでは、「getLegacyValue()」からの戻り値は、「@NonNull String」との互換性があるかどうかが不明です。 「getLegacyValue()」には @NonNull 注釈も @Nullable 注釈もないため、既存の raw 型から総称型への変換と同様に、ここでも基本的な型情報が欠落しています。

注: 本製品は、このフィーチャーの最初のバージョンです。 Java プロジェクトのセットアップにおいてこれを簡単に取り込めるようにする開発作業が進められています。 実装されたフィーチャーは完成してテストされていますが、サード・パーティー・ライブラリーのフィールドや API に注釈を付ける機能のサポートなどは現在欠落しています。クイック・フィックスの初期セットが含まれていますが、これは将来さらに改良が加えられる予定です。

背景情報については、ここも参照してください。

NULL 注釈を使用するためのバッチ・コンパイラーのオプション トークン nullAnnot(nullable|nonnull|nonnullbydefault) を -warn オプションに渡すことにより NULL 分析用の注釈を使用するように、バッチ・コンパイラーを構成できるようになりました。 ここで、nullable、nonnull、および nonnullbydefault は、NULL 分析で使用する注釈タイプの完全修飾名です。 nullAnnot を単独で使用すると、JDT のデフォルトの注釈を使用できます。

さらに、-nonNullByDefault トークンを使用すると、注釈ベースの NULL 分析が使用可能であるときに、デフォルトでグローバルに nonnull を使用することができます。 これは、NULL 注釈がないメソッド・シグニチャーのすべてのタイプが非 NULL 指定と見なされることを意味します。

デフォルトの NULL 特性注釈の欠落の検出 非 NULL をメソッド・シグニチャーにおいて注釈なしの型のデフォルトにするには、すべてのパッケージで '@NonNullByDefault' 注釈を使用できます。 すべてのパッケージを完全にカバーするには、デフォルトの NULL 特性注釈の欠落を検出するように JDT を構成できます。 「設定」>「Java」>「コンパイラー」>「エラー/警告」>「NULL 分析」>「'@NonNullByDefault' 注釈がパッケージで欠落しています」が使用可能になっていると、JDT は次の場合にエラー/警告を発行します。
  • package-info.java の「@NonNullByDefault」注釈がパッケージに含まれない場合には、次のようになります。

    「@NonNullByDefault 注釈がパッケージで欠落しています」の警告

  • デフォルト・パッケージ内部の型に、デフォルトの NULL 特性注釈が含まれていない。

    型で @NonNullByDefault 注釈が欠落していることの警告

NULL 分析は、org.​eclipse.​core.​runtime.​Assert を Java の assert のように扱う org.eclipse.core.runtime.Assert はちょうど Java の assert キーワードのようにして使用されることがよくあるため、JDT の NULL 分析では、org.eclipse.core.runtime.Assert に渡されるブール式を、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 エディターの問題吹き出しにある「問題の重大度を構成」ボタン

現在では、1 つの矢印で選択項目が強調表示され、別の矢印でマウスの下の項目が強調表示されます。

設定ページでの強調表示

強調表示は、PDE ツールと API ツールの設定ページでも作動します。

プロパティー・ファイル・エディター

プロパティーのキーを再編成するためのクイック・アシスト Eclipse スタイルの外部化されたストリングを使用する場合、以下の新しいクイック・アシストを使用すると、プロパティー・ファイル・エディター内のキーを簡単に再編成できるようになります。
  • ワークスペース内の名前変更 - プロパティー・ファイル内のキーを名前変更し、すべての参照を更新します
  • フィールドを '{0}' に作成 - 対応するフィールドをリソース・バンドル・アクセサー・クラスに作成します
  • プロパティーの削除 - プロパティー・ファイルからプロパティーを削除し、リソース・バンドル・アクセサー・クラスからフィールドを削除します
  • プロパティーの削除 - プロパティー・ファイルから選択した複数のプロパティーを削除し、リソース・バンドル・アクセサー・クラスから複数のフィールドを削除します

デバッグ

エクスポートの詳細フォーマッター 詳細フォーマッター (「変数」ビューのオブジェクトのレンダリングなどに使用します) を、別個の設定としてエクスポートできるようになりました。 以前は、詳細フォーマッターを共有する唯一の方法は、ワークスペースのすべての設定をエクスポートするという方法でした。

エクスポート・ダイアログの詳細フォーマッター

「モニターの表示」がデフォルトでオン 「デバッグ」ビューでモニター情報を表示するためのデフォルト設定は、オン に設定されるようになりました。 この変更は、新規ワークスペースにのみ影響があり、既存の設定は変更されません。

モニター情報の表示は、「デバッグ」ビュー内で「Java」>「モニターの表示」ビュー・アクションを使用することによってオン/オフできます。

ブレークポイントの切り替えの修飾キー Java エディターでブレークポイントを切り替えるときの修飾子キーがサポートされるようになりました。
  • Ctrl キーを押しながらブレークポイントをダブルクリック (切り替え操作) を行うと、そのブレークポイントの「プロパティー・ダイアログ」が表示されます (Mac では、Command を使用します)

  • Alt キーを押しながらブレークポイントのダブルクリック (切り替え操作) を行うと、ブレークポイントが使用可能/使用不可になります
既存のブレークポイントがない場合、修飾子キーを押した場合でも、通常のブレークポイント切り替えが行われます。

JUnit

JUnit 4.10 Eclipse とともに出荷される JUnit 4 のバージョンが、4.10 に更新されました。