S-JIS[2008-05-23/2010-08-21] 変更履歴

Eclipse3の警告抑止

Eclipseを使ってコーディングをしていると、自動的にエラー（赤い下線）や警告（黄色い下線）が出る。
クイックフィックス等を使って修正することが出来る（修正すべきだ）が、Eclipseの設定でエラー/警告のレベルを変えたり無視したりすることが出来る。

javacの-Xlintオプション（の「-」付き指定）に相当。[2007-08-25]

• 警告を設定するダイアログ [/2008-05-23]
• エラー/警告の内容 [/2010-08-21]
• @SuppressWarningsに指定できる文字列 [/2010-08-21]

設定ダイアログ

設定は、プロジェクト毎か、Eclipse全体に対して行う。[2007-08-25/2008-05-23]

1. Eclipse全体：　メニューバーの「ウィンドウ(W)」→「設定(P)」で「設定」ダイアログを開く。
   プロジェクト毎：メニューバーの「プロジェクト(P)」→「プロパティー(P)」で「プロパティー」ダイアログを開く。
2. 左側のツリーから「Javaコンパイラー」→「エラー/警告」を選択する。
3. 右ペインで該当するチェックに対して「無視」「警告」「エラー」を選択する。

これらのプロジェクト固有の設定は、プロジェクトのディレクトリ直下に「.settings」というディレクトリがあり、そのorg.eclipse.jdt.core.prefsというファイルで保持されている。
すなわち、プロジェクト全体をCVSで管理していれば、警告の設定も共有できる（共有される）ということ。

エラー/警告の内容

エラーや警告には以下のようなものがある。

• コード・スタイル(C) [/2008-08-24]
• 潜在的なプログラミングの問題(P) [/2009-03-28]
• 名前のシャドーイングおよび競合
• 使用すべきではない制限されたAPI(E)
• 不要なコード(U) [/2008-08-24]
• 総称型(G) [/2010-08-21]
• 注釈(N) [2008-10-25]

   "".valueOf(123);
○ String.valueOf(123);

class S1 {
  public static int v;
}
class S2 extends S1{
}

  S2.v = 1;

int value;

void method() {
  value = 1;
}

void method() {}

String s = "a";

↓こういうコメントを付けておくと
↓チェックが抑制される
String s = "a"; //$NON-NLS-1$

class Test implements Serializable {
}

boolean b = 〜;
if (b = true) { 〜 }

int test() {
  try {
  } finally {
    return 1;
  }
}

;;

switch(n) {
case 1: case 2:
  System.out.println(n);
default:
  break;
}

Object obj = null;
obj.toString();

void null2(int n) {
  Object obj = null;
  if (n == 1) {
    obj = new Object();
  }
  obj.toString();
}

class Hide {
  int value;

  class Sub extends Hide {
    int value;
  }
}

class Hide {
  int value;

  void hide() {
    int value;
  }
}

new Date("2008/05/23");

{ int n = 0; }

import java.util.List;

private int field;

private void method(){}

Number n = (Number)123;

String s = 〜;
if (s instanceof String) {
  〜
}

※「未使用のインポート」に関しては、そのソースファイル内の一番先頭にあるクラス（やインターフェース等）に対して@SuppressWarnings("unused")を付けてやると、警告が出なくなる。

void test(List list) {
  list.add("abc");
}

List list = new ArrayList();

void test(List list) {
}

class Clz<T extends String> {
}

/** @deprecated */
void method() {
}

警告の中には、@SuppressWarningsで抑止可能なものもある。
指定できる値（文字列）が無い場合、「@SuppressWarnings("all")」を指定すると止めることが出来る。（allは全警告を抑止する）
“指定できる文字列が無く、Eclipseの設定はいじりたくないが警告を抑止したい”という場合には使えるかな。

@SuppressWarningsに指定可能なトークン

Eclipse3.2・3.4で@SuppressWarningsに指定可能なトークン（値・文字列）は以下の通り。[2008-08-21/2010-08-21]
all boxing cast dep-ann deprecation fallthrough finally hiding incomplete-switch nls null rawtypes restriction serial static-access synthetic-access unchecked unqualified-field-access unused

それぞれが何を意味するか（の簡単な説明）は、Eclipseのヘルプに載っている。

1. メニューバーの「ヘルプ(H)」→「ヘルプ目次(H)」
2. 左ペインから「JDTプラグイン・デベロッパー・ガイド」→「プログラマーズ・ガイド」→「JDTコア」→「Javaコードのコンパイル （Compiling Java code）」
3. 右ペインの一番下に「SuppressWarning注釈内で使用可能なトークンのリスト」が出ている。

Eclipse3.6ではどこに載っているか不明(苦笑) [2010-08-21]
追加されたrawtypesについては「Java開発ユーザー・ガイド」→「新機能」（What's New in 3.6 (JDT)）の「Java Compiler」に載っている。

→Sunのjavacで指定可能なトークン