2009年4月アーカイブ

2009年4月24日の記事「EclipseでAPIリファレンスをすばやく参照するには？」では、
ソースプログラムから、JDK　の API リファレンスを探す基本的な手順を紹介しました。

 デフォルト設定では、このAPIリファレンスは英語です。でも、日本語で読みたいですよね？
次のように設定すれば、日本語で読めるようになります。

 メニューの[ウィンドウ]-[設定]から、「設定」ダイアログを開きます。
そして、[Java]-[インストール済のJRE]を開きます。

 このダイアログの中に、チェックがついているJDKが1つあるはずです。
それをアクティブにして、[編集]をクリックします。

  「JREの編集」ダイアログが開きますので、[JREシステムライブラリー]内のすべての jarファイルを
選択して、[Javadocロケーション]をクリックします。

図1: [Javadocロケーション]をクリック。

そして、[Javadoc ロケーション・パス]の欄に、URLを入力します。

 J2SE 5.0 の場合は、

　http://java.sun.com/j2se/1.5.0/ja/docs/ja/api/

になります。

図2: URLの入力

"OK"をクリックしながらダイアログを閉じていけば設定完了です。

ソースコードに戻って、今一度、

　System.out.println("Hello");

の"out"を選択し、

　[Shift] + [F2]

を実行してください。今度は日本語のAPIリファレンスが表示されます。

しかし、まだ設定変更が必要な場合があります。
その設定方法は...次回をお楽しみに！

＜追記＞

次の記事はこちらです。

⇒EclipseでAPIリファレンスをすばやく参照するには？その3

Eclipse のエディターでコーディングをしていると、「このクラスのAPI
リファレンスをちょっと見てみたいなあ」と思うことは、あると思います。

そんなとき、すばやく参照する方法があります。

まず、ソースコードのクラス名やメソッド名を選択します。
例えば、

　System.out.println("Hello");

で、outメソッドのAPIリファレンスを見たい場合には、"out"を選択します。

そして、

　[Shift] + [F2]

を実行してください。ブラウザが起動して、該当するAPIリファレンスが
表示されるのです。

デフォルトの設定では、オンライン経由で Sun Microsystems社のサイトに
掲載されているAPIリファレンスにアクセスします。そのため、参照できる
のはJDKが提供しているクラスになります。

ただし、デフォルト設定だと物足りないと思うかもしれません。
例えば、

　・アクセス先のAPIリファレンスはすべて英語。日本語で読みたいのに。
　・JDK以外のAPIリファレンスも読みたい。
　・インターネットに接続されていないPCでEclipseを使っているから、
　　マニュアルが見えないよ。

そんなときは、設定を変更しましょう。

具体的な変更方法は...次回をお楽しみに！

＜追記＞

 次の記事はこちらです。

⇒EclipseでAPIリファレンスをすばやく参照するには？その2

 Eclipse 3.3 (Europa) 以降では、Javaエディタ－の機能もいろいろ改良されています。

あまり目立った機能向上ではありませんが、細かいところで使い勝手がよくなっています。

例えば、従来のエディターでは単なる白い空白にしか見えなかった文字を、

空白(U+0020), 水平タブ(U+0008), 復帰改行(U+000D, U+000A), 和字間隔(U+3000) など、

区別して表示できるようになった点が挙げられます。

これらの文字を，明示的に分けて表示したい場合、以下の手順で設定します。

1. [ワークベンチ]画面から[ウィンドウ(W)]->[設定(P)...]メニューを選択して，[設定]ダイアログを表示。
2. [設定]ダイアログで，[一般]->[エディター]->[Text Editors]とツリーを選択して[Show whitespace characters]チェックボックスにチェックを入れてください。

図: 空白文字の表示を設定する

以前のエディター表示では、空白の違いを一目で確認することができないため、

以下のような問題が発生することがありました。

• ソースコードのインデント部分に，全角スペース ( = 和字間隔) が混じっており，意味不明の構文エラーが発生する。
• Tab文字だったインデントがスペースのインデントに変わっており，何も変えてないつもりの行が「変更あり」と判定される。

これらの問題は，基本的なコーディングミスやチェック誤りなのですが，

見ただけでは原因が分からず，悩まされることがありました。

Eclipse 3.3 では，エディターで見るだけで問題が分かるようになっています。

また，Eclipse 3.3 では，コードチェックの機能も改良されています。

従来は行単位でのエラー表示だったのが，文字の位置まで表示してくれます。

全角スペースの存在に気づかずに悩むこともなくなりました。

ちょっとした進化ですが，いろいろとうれしい変更ですね。

ローカルヒストリーとは、Eclipse のエディターに備わっている

「ファイルの変更履歴を保存してくれる」機能です。

　「プログラムを変更しようとしたら、コピーの範囲を間違えてプログラムの
　一部が消えてしまった」

　「プログラムを変更したら、不正な動作をするようになった。
　元に戻そうと思ったが、どこを変更したのか分からない。」

といった経験はないでしょうか？このような場合にローカルヒストリーが役に
立ちます。

ファイルを古いものに戻して変更を取り消すことができますし、また、
変更前と変更後を並べて、変更箇所を視覚的に確認することもできます。

それでは、さっそくこの機能を使ってみましょう。

パッケージエクスプローラービューで、該当するファイルを選択します。
右クリックすることポップアップメニューが現れるので、
[比較]-[ローカル・ヒストリー]
を選択します。

図：ローカル・ヒストリーを選択する

すると、対象ファイルの「履歴」一覧が表示されます。

「履歴」の中から任意の時点を選択することで、現時点のファイルとの違いを
確認することができます。
変更箇所を1つ1つ確認しながら元に戻すか戻さないかを決めることもできますし、
一度にすべての変更箇所を戻す(昔のファイルで上書きする)ことも可能です。

さらに、パッケージエクスプローラービューでパッケージを選択すれば、
消してしまったファイル(クラス)を復元することも可能です。

気軽に使用できる便利な機能なので、使ったことのない人はぜひ試してみてください。
なお、履歴として残るのは「保存」したファイルだけ。注意してください。