コーディングの最近のブログ記事

2009年4月20日の記事では、Eclipse 3.3のJavaエディターにて空白文字やタブ文字を表示する
機能をご紹介しました。

Eclipse 3.7からは、これらの表示を細かく指定できるようになりました。
今日はその機能をご紹介します。

Eclipse 3.6までの場合、Javaエディターにて空白文字や改行文字を表示する場合には、
「表示する」か「表示しない」かのいずれかの選択でした。

Eclipse 3.7以降では、「表示する」場合に、何を表示するか、どこの表示をするか、
という指定が可能になっています。

　表示する文字の指定：

• Space：　半角スペース
• Ideographic space：　全角スペース
• Tab：　タブ
• Carriage Return：　行頭復帰
• Line Feed：　改行

　表示場所の指定：

• Leading：　行頭から先頭文字の間
• Enclosed：　文字の間
• Trailing：　最後の文字から行末までの間

この指定は、次のように行います。

1.  [ワークベンチ]画面から[ウィンドウ(W)]->[設定(P)...]メニューを選択すると、
　　[設定]ダイアログが表示されます。

2.  [設定]ダイアログで、[一般]->[エディター]->[テキスト・エディタ]とツリーを選択し、
　　ページ内にある[Show whitespace characters]チェックボックスにチェックを入れます。
3.  "whitespace characters"の部分のリンクをクリックします。

4.  表示したい文字、場所にチェックを入れてOKをクリックします。

例えば、すべてにチェックが付いていると次のように表示されるコードの場合、

　注意：表示実験用のコードであり、実際には動作しません。

"Space"と"Tab"のチェックをすべて削除した場合には、全角スペース、行頭復帰、改行コードだけ
表示されるようになります。

こうすれば、「ソースコードの中に間違って全角スペースが混入してしまうと、どこにあるのか
わかりにくいので、それだけ表示させるようにしたい」という場合に、ぴったりな表示が
できるようになります。

とても細かな配慮ですが、使いやすくなっていますね！

Javaアプリケーションを開発していると、初めて使用するAPIを実装しなければ
ならないことがありますが、

　このAPIを、いきなり作成中のソースコードに組み込むのは気が引ける。
　テスト用のコードを作成して使い方を理解してからソースコードに組み込みたい。

と思うことがあります。

このようなとき、単純なJavaのクラスとmainメソッドを作成し、mainメソッドの中で
いろいろなコードを書き、APIの呼び出し方や戻り値がどうなるかを試してみて、
「そうかわかった！」となってからソースコードに組み込む、ということが
よく行われるようです。

しかしEclipseには、テスト用クラスとmainメソッドをわざわざ作成しなくても、
コードのテストが簡単にできる機能が用意されています。
今日は、「スクラップブック」と呼ばれるこの機能をご紹介します。

まず、".jpage"という拡張子の付いたファイルを作成します。

メインメニューから[ファイル]-[新規]-[その他]-[Javaの実行/デバッグ]-[スクラップブック・ページ]を
選択します。

[次へ]をクリックし、ファイルの格納フォルダとファイル名を指定して[終了]をクリックします。

これで準備ができました。

このファイル上にテスト用のコードを書きます。
なお、出力結果を確認するためには、System.out.printlnメソッドの実装が必要なようです。
コードが書けたら、テストしたい部分を選択します。

そして右クリックして[実行]を選択するか、またはショートカットキー（CTRL-U）を実行します。
すると、コンソールビューに結果が表示されます。

選択した範囲が実行対象となりますので、いちいちファイルの内容を保存する
必要がありません。そのため、コード（特に入力値）を少しずつ変えながら、
何度も繰り返しテストする作業がとても簡単にできます。

ご活用ください。

2009年10月26日の記事では、繰り返し使うJavaコードをメソッドとして別に定義する際に使用できる、
Eclipseの「メソッドの抽出」機能をご紹介しました。

繰り返し使うJavaコードといっても様々で、
メソッドとして切り出せるようなまとまった処理だけではありません。

　同じような式を何度も書いている・・・

ということもあるかと思います。

このような、何度も繰り返して使われる式は「ローカル変数として定義しておく」のがよいでしょう。

特に式が複雑な場合は、ローカル変数として切り出しておくことで、コード自体もすっきりし、
読みやすくなります。


Eclipseでは「ローカル変数への抽出」機能があり、簡単にローカル変数として切り出すことができます。

操作手順は「メソッドの抽出」方法と同様で、ローカル変数として切り出したい式を
エディター上で選択し、「ローカル変数の抽出」というメニューを選択するだけです。


(1)
Javaエディター上で、式を選択し、右クリックしてコンテキスト・メニューから
「リファクタリング」>「ローカル変数の抽出」を選択します。



(2)
「ローカル変数の抽出」ダイアログが表示されるので、変数名を入力します。

「プレビュー」ボタンをクリックすると、実際にどのようなコードが生成されるのかを
事前に確認することができます。

Eclipseのエディターでソースコードを作成していると、

　ちょっと印刷して、紙の上で確認したいな

と思うことがあります。

（紙に印刷したソースコードは、画面で見るのとは違って見えるから不思議です。）

Eclipseでは、次のようにすることでソースコードを印刷できます。

　1. 「ファイル」>「印刷」を選択する。

　2. プリンタドライバの画面が出てくるので、条件を設定して印刷する。

しかし、このままでは、印刷されてきたソースコードには行番号が入りません。

ソースコードが短いものであれば問題ないのですが、何百行もあるようなソースコードだと、

紙上でミスを見つけたとき、それがエディター上のどの辺りなのかを探すのが大変です。

そこで、印刷するときに行番号も一緒に出力するように設定しましょう。

これは、Eclipse 3.4 以降であれば、次のようにして設定します。

1. Eclipseのエディターで、次のようにして行番号を表示するように設定します。

　(1) 「ウィンドウ」>「設定」>「一般」>「エディタ」>「テキスト・エディタ」を選択します。

　(2) 「行番号の表示」にチェックを入れて、「OK」をクリックします。

2. ソースコードを印刷します。（具体的な方法は先に述べたとおりです。）

残念ながら、Eclipse 3.3 以前では行番号を印刷することができません。

Eclipse以外のエディターを使用する、印刷用としてのEclipse 3.4以降をインストールする、

などの工夫が必要になります。

Eclipseのエディターでソースコードを作成していると、例えば、

　26行目でコンパイルエラーが出た

というときに、

　26行目ってどの辺だ？

ということが、とっさにはわかりにくいことがあります。

デフォルト設定では、画面の下（ステータスバー）に、現在のカーソル位置が表示されます。
例えば下の図では、「上から26行目、左から14文字目」であることが示されています。

図1: ステータスバー

しかし、いちいちステータスバーを見に行くのも面倒ですね。

そこで、エディターで行番号を表示するように変更しましょう。これは、次のように設定します。

1. 「ウィンドウ」>「設定」>「一般」>「エディタ」>「テキスト・エディタ」を選択します。

2. 「行番号の表示」にチェックを入れて、「OK」をクリックします。

図2: 「行番号の表示」にチェックを入れる

これで、行番号が表示されます。

ほんのちょっとのことですが、これだけで編集がかなり楽になりますよ。

• Javadocコマンドのロケーション
• APIリファレンスの生成対象とするJavaソース
• APIリファレンスの出力先

指定したら、「終了」ボタンを選択しましょう。
これで、APIリファレンスの生成が完了です。


APIリファレンスの出力先として、現在作業中のJavaプロジェクト内を指定すると、
Eclipseの「パッケージ・エクスプローラー」ビューなどで多くのファイルが生成されていることが、
すぐに確認できますね。

2009年8月31日の記事 の続きです。
今日は、「/*」と「*/」で囲むコメント形式についてご紹介します。

この形式は、複数行に渡るような長いコメントであっても、最初と最後の位置だけ
入力すれば済むという特徴があります。

Eclipse では、この「/*」と「*/」を追加するショートカットキーを用意しています。
それは、コメント化する範囲を指定した後、

　Ctrl+Shift+/

です。コメント化されると、その範囲内の文字が緑色になります。

逆に、コメントを外すショートカットキーもあります。
コメントを外すときには、すべての範囲を選択する必要はありません。
範囲内の「一部」だけを選択すればOKです。一部を選択した後、

　Ctrl+Shift+\

とすれば、コメントを外すことができます。

「//」以降から行末までをコメント化する形式のショートカットキー Ctrl - / との違いは、

　・Shiftキーも押す必要がある
　・コメントを外すときは、/ ではなく \ （バックスラッシュ）を使用する

ですね。違いを理解すれば、覚えやすいかもしれません。

さて、ここでショートカットを使ったときの細かな動作を挙げておきます。

(1)
コメントの先頭「/*」のある行で改行キーを入力すると、新しく作成された行の
先頭に「*」が自動で付加されます。

これは「コメントを書く」という観点ではとても便利ですが、コメント化したり
コメントを外したり、を頻繁に行う場合には注意が必要です。

なぜなら、 Ctrl+Shift+\ でコメントを外すと、自動で付加された「*」が
残ったままになってしまい、コンパイルエラーを引き起こすからです。

頻繁にコメント化したりコメントを外す場合には、 // を使用する方が便利です。

(2)
ショートカットを使用すると、コメントがネストするのを防いでくれます。
すなわち、

　/*　/*　*/　*/

のようなコメントは入力できないようになっています。入力ミスを防ぐという点で
とても便利な機能ですね。

// に比べると少し使い方が難しくなりますが、うまく使いこなして、理解しやすい
コードを書いていきましょう！

Java プログラムをコーディングする際には、「コメント」を頻繁に活用されると思います。

例えば、

　・コードについてのちょっとしたメモを書いておこうかな。

　・デバッグ用に書いたコード（print文）を、実行しないように変更してしまおう
　　（でもまた使うかもしれないから削除まではしないでおくけど）。

などのときに使いますね。

Javaのコメントには次の3種類あります。

　(1)「//」以降、行末までをコメントとする形式
　(2)「/*」と「*/」で対象を囲む形式
　(3)「/**」と「*/」で対象を囲むJavadoc用のコメント形式

今日は、(1)のコメント形式についてご紹介します。

コメントの始まりを示す // は、行頭でも、行の途中でも書くことができますが、
頻繁に使用するのは行頭に書くケースではないでしょうか。

Eclipse では、行頭に // を追加するショートカットキーを用意しています。
それは、コメント化したい行にカーソルを移動した後に、

　 CTRL - /

です。

「コメントはスラッシュから始まるので、スラッシュの前にCTRLキーを押す」と理解すれば、
すぐに覚えられます。

（なお、 CTRL - 7 でも同じことができます。しかし、 CTRL - / の方が
より直感的に使用できますので、こちらのキーをお勧めします。）

また、行頭で // によりコメント化されている行にカーソルを移動した後、

　 CTRL - /

とすれば、コメントを外すことができます。これも、覚えやすいですね。

1行だけをコメント化するのであれば、手入力でよいかもしれません。しかし、
複数行を一気にコメント化したいときには、このショートカットキーが威力を発揮します。
一気にコメント化するには、

　コメント化したい最初の行にカーソルを移動し、シフトキーを押しながらカーソルを
　移動させてすべての行を選択した後、  CTRL - /

です。

さて、ここでショートカットを使ったときの細かな動作を挙げておきます。

　(1)行頭からスペースやタブでインデントをつけており、その後ろに // がある場合、
　　　その // は「行頭にある」と判断されます。

　　　そのため、この状態で  CTRL - / とすると、コメントが外れます。

　(2)行頭に // のある行と // のない行を一緒に選択して CTRL - / とすると、
　　　コメント化されます。

　　　すなわち、行頭に // のある行では、さらに // が付加されて //// となります。
　　　Java 文法としては問題ありませんが、コメントを外すのがちょっと面倒になって
　　　しまいますので気をつけてください。

このショートカットはとても便利な機能ですので、ぜひ使いこなしてください。

• Eclipseのクリーンアップ機能でコーディングスタイルを統一する
• Eclipseのクリーンアップ機能で適用するコーディングスタイルのカスタマイズ

• コンテキスト・メニュー（右クリック）からの実行
• Eclipseメニューの「ソース」から実行

今回は、Eclipseのクリーンアップ機能についてご紹介します。

チームでアプリケーション開発を行う場合は、コーディングスタイルなどが
決められていることが多いと思います。
でも、プログラマにはそれぞれコードを書く時の"癖"がありますね。

いくら　コーディングスタイルを守らねば！！　と気をつけていても
うっかり、規則から外れたコードを書いてしまうということもあるかと思いますので、
コーディング規則を守るためには、ツールによる手助けが欠かせません。

Eclipseには、コーディングスタイルの統一を手助けするための
様々な機能があり、その一つが今回ご紹介する『クリーンアップ』機能です。

この『クリーンアップ』機能は、Eclipse 3.2 の JDTで追加された機能です。
ソースコードの整形だけにとどまらず、Javaの構文にまで踏み込み、
コーディングスタイルを統一してくれます。

具体的には・・・

• if/while/for/do ステートメントでブロックを使うかどうか
• 条件文を括弧で囲むかどうか
• フィールド・アクセスやメソッド・アクセスに'this'修飾子を使うかどうか
• 未使用のインポート文を削除するかどうか
• 欠落しているアノテーション（@Overrideなど）を追加するかどうか

7月1日の記事では、Eclipseのエディターを使ってソースコードを見ているとき、

　括弧のすぐ後ろにカーソルを合わせて　Ctrl + Shift + p

とすれば、対応する括弧にジャンプしてくれることをご紹介しました。

前回も書きましたが、筆者はこのショートカットキーを見て、

　3つのキーの同時押しというのは少々面倒だ

と思い、

　キー1つで対応する括弧にジャンプできるようショートカットキーをカスタマイズ

しています。その方法をここでご紹介します。

(1)Eclipseを起動したら、[ウィンドウ]-[設定]-[一般]-[キー]へ行きます。

(2)一覧の中から、「対応する大括弧にジャンプ」を選択します。

(3)「バインディング」の欄に"Ctrl+Shift+P"と入力されているので、バックスペースキーで削除
　した後、「F4」キーを押します。（"F4"と入力するのではなく、実際にF4キーを押してください。）

(4)「場合」欄で、プルダウンの中から「Javaソースの編集」を選択します。

(5)「OK」をクリックします。

図：「対応する大括弧にジャンプ」ショートカットキーのカスタマイズ

なお、注意点です。

デフォルトの設定では、F4キーは"型階層を開く"というショートカットキーに割り当て
られています。しかし、カスタマイズをしたことにより、これは開かれなくなります。
型階層を開く場合は、

　・メニューバーの[ナビゲート]-[型階層を開く]
　・ソースコード中で右クリックし、「型階層を開く」を選択

のいずれかを実行してください。

今回のカスタマイズは、6月15日の記事と合わせて実施すると、とても快適に開発
できるようになるのではないかと思います。こちらもぜひお試しください。

また、ショートカットキーは、6月16日の記事と同様の方法でエクスポート、および
インポートすることで、他のEclipse環境でも利用できるようになります。

「こんなカスタマイズしているよ」がありましたら、ぜひコメントに入れてください！

Eclipseのエディターを使ってソースコードを見ていると、ふと、

　この閉じ括弧は、どこから始まっている括弧だっけ？
　if文？forループ？try文？...括弧を数えないと...。

と思うことがあります。

Eclipseのエディターには、括弧のすぐ「後ろ」にカーソルを合わせると、対応する
括弧を強調表示する機能があり、これですぐに場所がわかることがあります。

図1：対応する括弧の強調表示

しかし、ソースコードが長い場合には、強調されている箇所を探すのが大変です。

Eclipseには、対応する括弧にジャンプしてくれるショートカットキーも用意されています。
これを使えば、強調表示された場所を探す必要はもうありません。
そのショートカットキーとは、

　Ctrl + Shift + p

です。

実際に操作してみると、"{"と"}"の対応だけでなく、"["と"]"、"("と")"の対応でも
ジャンプするようです。（ただし、"[]"や"()"の対応はソースコード中でもすぐ近くに
あることが多いので、ショートカットキーを使うことはあまりないでしょう。）

なお、このショートカットキーを使うときにはちょっとしたコツがあります。

　　・括弧のすぐ「前」にカーソルを合わせてもジャンプしてくれません。

筆者はこれにハマったことがあります。「なぜジャンプしない？！」と。
他のエディターでのクセがついてしまっていたためですが、Eclipseでは常に
括弧の「後ろ」にカーソルを合わせる必要があります。

さらに、

　　・Shiftキーを押すのを忘れると、印刷用のダイアログが出てきてびっくりします。
　　・Ctrlキーを押すのを忘れると、大文字のPがソースコードに入力されてしまいます。

特に、"P"が入力されたのに気付かずにそのままコンパイルすると、当然ですが
エラーになってしまい、「あれ？」となります。

筆者は、このようなことがあったために、

　3つのキーの同時押しというのは少々面倒だ

と考えています。ショートカットキーを比較的頻繁に使う場合には、キーの
カスタマイズをするのがよいと思います。

このカスタマイズ方法として筆者がやっている方法があるのですが...
それは次回でご紹介します！

＜追記＞

次の記事はこちらです。

⇒Eclipseエディターで、対応する括弧にジャンプするショートカットは？その2

6月15日の記事では、Eclipseでソースコードを編集しているとき、

　呼び出したメソッドのソースコードへカーソルをジャンプするにはF3キー
　呼び出し位置に戻るにはF2キー

になるように、ショートカットキーをカスタマイズする方法をご紹介しました。

前回も書きましたが、カスタマイズしたEclipseの環境では快適に編集できるようになるものの、
別のEclipse環境（具体的には、別のワークスペース）を使おうとすると、元々の設定のままです。

そこで、

　カスタマイズした設定をEclipseから取り出して、別のEclipse環境に組み込む

という、ひと手間をかけましょう。

まず、設定をエクスポートします。

(1)Eclipseを起動したら、[ファイル]-[エクスポート]-[一般]-[設定]をクリックして、
　「設定のエクスポート」ダイアログを開きます。

(2)「キー設定」にチェックを入れ、「宛先設定ファイル」欄に出力ファイル名を入力して、
　「終了」をクリックします。

図：ショートカット設定のエクスポート

次に、別のEclipse環境に設定をインポートします。

(3)設定の移行先となるワークスペースを指定してEclipseを起動したら、[ファイル]-[インポート]
　-[一般]-[設定]をクリックして、「設定のインポート」ダイアログを開きます。

(4)「ソース設定ファイル」欄に(2)のファイル名を指定します。また、「キー設定」にチェックを入れて、
　「終了」をクリックします。

設定のひと手間はかかりますが、その後の開発はさくさくとできるようになります。
お試しください。

6月11日の記事で、Eclipseでソースコードを編集しているとき、

　呼び出したメソッドのソースコードへカーソルをジャンプするにはF3キー
　呼び出し位置に戻るにはAltキー+左矢印キー

というショートカットキーをご紹介しました。
前回も書きましたが、筆者はこのショートカットキーを見て、

　ジャンプするときはF3キー1つなのに、戻るときはキー2つというのは、なんとなく面倒！

と思ってしまいました。

そこで、筆者が行っている工夫をここで大公開！それは、

　キー1つで呼び出し位置に戻れるようにショートカットキーをカスタマイズ

するというものです。

(1)Eclipseを起動したら、[ウィンドウ]-[設定]-[一般]-[キー]へ行きます。

(2)一覧の中から、「ヒストリーを戻る」を選択して、「コマンドのコピー」をクリックします。

(3)「バインディング」の欄をアクティブにして、「F2」キーを押します。
　　（"F2"と入力するのではなく、実際にF2キーを押してください。）

(4)「場合」という欄が現れますので、プルダウンの中から「Javaソースの編集」を選択します。

(5)「OK」をクリックします。

図：ショートカットのカスタマイズ

なお、このカスタマイズには注意点があります。

デフォルトの設定では、F2キーを押すと"ツールチップ記述"が表示されます。
しかし、カスタマイズをしたことにより、これが表示されなくなります。
「それは困る」という場合には、F2キーではなく、（ほとんど使っていない）
別のキーに割り当ててください。

さて、このカスタマイズをすることで、今使っているEclipseの環境では快適に編集
できるようになりました。しかし、別のEclipse環境を使おうとすると、当然ですが
元々の設定のままです。

これを改善する方法があるのですが...それは次回に！

＜追記＞

次の記事はこちらです。

⇒Eclipseエディターで、メソッドへジャンプしたり呼び出し元に戻るショートカットは？その3

Eclipseでソースコードを編集していると、

　呼び出したメソッドのソースコードがちょっと見たいな

と思うことがよくあります。例えば、

　ClassA.methodB("Hello");

というメソッドを呼び出しているとき、「methodBのソースコードを見てみたい」
という場合です。

ソースファイルを探してきて開き、カーソルをそこに移動させる、というのでもよいのですが、
たくさんのメソッド呼び出しを行っていて、それらを順に見ていきたい、という場合には
少し面倒ですね。

そこでEclipseには、ソースファイル中のメソッドの先頭位置へカーソルをジャンプさせる
ためのショートカットキーが用意されており、簡単にソースコードを見ることが
できるようになっています。このショートカットキーとは、

　メソッドにカーソルを合わせた状態で、
　　方法1：　F3キー　　（マウスを使わない方法）
　　方法2：　CTRLキーを押しながらマウスの左クリック　　（マウスを使う方法）

です。

Eclipseを起動するときに、JREではなくJDKを使用していれば、例えば
System.out.print()のような、JDK提供クラス/メソッドのソースコードの先頭位置
にもジャンプすることができます。

では、呼び出し位置に戻るにはどうすればよいでしょうか？それは、

　　方法1：　Altキー+左矢印キー　　（マウスを使わない方法）
　　方法2：　ツールバーにある左矢印アイコンをクリック　　（マウスを使う方法）

　　　　　　　図:ツールバーにある左矢印アイコンで呼び出し位置に戻る

です。

基本的な操作は以上ですが、特にマウスを使わない方法の場合、筆者は、

　ジャンプするときはF3キー1つなのに、戻るときはキー2つというのは、なにか面倒！

と思ってしまいました。

これを変更する方法があるのですが...それは次回に！

＜追記＞

次の記事はこちらです。

⇒Eclipseエディターで、メソッドへジャンプしたり呼び出し元に戻るショートカットは？その2

2009年4月28日の記事の続きです。

チームで開発をしていると、他のメンバーが作ったAPI（メソッド）を呼び出す
コーディングをすることが多々あるかと思います。

このようなとき、呼び出そうとするAPIの仕様書がなければコーディングができませんが、

　「仕様書を探すのが面倒！さくっと見つけられたら楽なのに！」

と思ったことはないでしょうか？

もし、APIの仕様書がJavaDocを利用して作成されたものであれば、2009年4月28日の記事で
説明したのと同じ方法、すなわち、APIを選択して、[Shift] + [F2] とすることで、すぐに
仕様書を参照することができます。

これは、次のように設定すれば可能になります。

(1)「パッケージ・エクスプローラー」ビューで、対象とするアーカイブ（JARファイル）を選択し、
　　右クリックして「プロパティ」メニューを選択します。

図1：　プロパティを選択

(2)「プロパティー」ダイアログが開きますので、ダイアログの左側で「Javadoc ロケーション」
　　を選択し、参照先とするJavaDocのロケーションを選択します。

アーカイブはローカル環境にある場合が多いと思われますが、このようなときには、
「アーカイブ内のJavadoc」に、アーカイブへのパスと、アーカイブ内のパスを指定します。

図2：　アーカイブへのパスとアーカイブ内のパスを指定

ダイアログで指定した値が正しいかどうかは「検証」ボタンをクリックして確認します。
ダイアログへ入力した値を確定する前に、JavaDocが正しく参照できるか確認してみてください。

設定できたら、ソースコードの該当箇所に戻って、[Shift] + [F2] としてみましょう。

　「おお！見れた！」

という、小さな感動が得られるのではないかと思います。

この方法は、チーム内で作成したアーカイブだけではなく、サードパーティー製の
ライブラリ（例えばHibernateなど）をダウンロードして利用している場合にも適用
できますよ。

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つ確認しながら元に戻すか戻さないかを決めることもできますし、
一度にすべての変更箇所を戻す(昔のファイルで上書きする)ことも可能です。

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

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

スニペットという言葉をご存知ですか？

スニペットとは『断片』という意味で、プログラマにとっては汎用的な（よく使う）ソースコードの部品を指します。

MyEclipseでは、多数のスニペットが用意されています。コーディング時には、使いたいスニペットを
選んで必要な箇所に挿入することで、コードを書く作業を軽減することができます。
MyEclipseのスニペット機能はとても充実しているので、ここで簡単にご紹介したいと思います。

スニペットは「スニペット」ビューに用意されています。

「スニペット」ビューを開くには、メニュー・バーで
｢ウィンドウ｣>「ビューの表示」>「その他」>「MyEclipse Enterprise Workbench」>「スニペット｣
の順に選択します。

どんなスニペットが用意されているかというと・・・

JSPやHTML、JavaScript用のスニペットがあります。

さらに、StrutsやJSFなどの主要なフレームワーク用のタグのスニペットも
ありますね。

スニペットをソースファイルへ追加する方法はとても簡単です。
追加したいスニペットを「スニペット」ビューで選択し、ソースの追加したい位置へ
ドラッグ＆ドロップするだけでOKです。

「スニペット」の具体的な活用方法についてはまた別の機会に
ご紹介したいと思います。お楽しみに！

＜追記＞

次の記事はこちらです。

⇒もっとスニペットを使ってみよう！２