More than 5 years have passed since last update.

TISAdvent Calendar 2017

EclipseでJavaソースコードを読む技術

Posted at 2017-12-09

はじめに

プロジェクト内の他のメンバーが書いたソースコードを読んだり、利用しているフレームワークの調査のためソースコードを読んだり、色々な場面でソースコードを読む機会があります。

そういったときになるべく素早く読み進めるためにはIDEの機能を利用したり、当たりをつけるセンスを高めたり、キーボード操作が速くなるよう訓練したり、いくつかのアプローチが考えられます。

本稿ではそれらのアプローチの中からIDEの機能を利用することにフォーカスして、言語はJava・IDEはEclipseを使った場合にソースコードを読むのに役立つ機能を紹介します。

分かりやすさのため、いつくかスクリーンショットを掲載していますが、そこに写っているソースコードはDomaというデータベースアクセスライブラリのものです。（完全に私の趣味です）

また、私の体はEclipseに呪われているのでEclipseの機能について書きますが、他のIDEでも似たようなものはあると思います。ですので、他のIDEをお使いの方は「このIDEならこうすればいいよ」という記事を書いて貰えると嬉しいです。

まずは基本的なところから。ソースコードを読んでいてメソッド呼び出しをしているコードからそのメソッドを定義している箇所へジャンプしたいときは、メソッド呼び出しをしているコードにカーソルを当ててF3を押します。

特定の処理を頭から読んでいくとメソッド定義へジャンプすることがとても多いのでよく使う機能だと思います。

F3でメソッド定義へジャンプすると、その先がインターフェースで実装がない場合があります。

そういった場合はメソッド呼び出しコードにカーソルを当ててCommand + Tを押します。すると、そのメソッドを実装しているクラスの一覧が表示されるので、これだ！と思うクラスを選択してメソッドの定義へジャンプします。

この例では1つのクラスしか表示されていませんが、場合によっては多くの実装クラスが表示されます。その中から、これだ！と思えるクラスを選択するのは知識やセンスが必要になりますが、それらを鍛えるのはまた別の話なので省略します。

仕様変更の影響調査などで、あるメソッドがどこから呼ばれているのか知りたい、といったことがあると思います。その場合、調査対象のメソッド定義にカーソルを当ててControl + alt + Hを押します。すると、そのメソッドを呼び出している箇所の一覧が表示されます。

呼び出し箇所の一覧の各項目の左にある三角のマークを押すと、さらにそのメソッドの呼び出し箇所が一覧表示されます。

そうやってどんどん呼び出し階層を遡って行けます。

クラスにカーソルを当ててCommand + Shift + Gを押します。すると、そのクラスを参照している箇所が一覧表示されます。

フィールドとしてそのクラスを参照している場合はフィールド名が、引数・ローカル変数として参照している場合はコンストラクタ名やメソッド名が検索結果に表示されます。

この機能は、私はSpring Bootなど、それなりの大きさのフレームワークを読む時に必要になりました。

これら以外でよく使うのは型の検索とリソースの検索です。

私の場合、これらはソースコードを読んでいる途中よりは、ソースコードを書いているときによく使っているように思います。

Eclipse以外にもソースコードを読むのに役立てているツールはあります。ここではおまけ程度に簡単な紹介に留めます。

git grepとgit ls-filesをよく使います。git grepでは-iオプションや--name-onlyオプションを併用することも多いです。

Spring Frameworkなど、検索のためにEclipseにインポートするには大きいプロジェクトはgit grepすることが多いです。

unite.vimはファイルやバッファなど、様々なものをデータソースとして検索ができるVimプラグインです。ものすごく便利なのですが、会社のPCで動かなくてちょっと困っています。なんとかせねば……

ちなみにunite.vimはメンテナンスモードに入っており、後継はdenite.nvimだそうです。乗り換えねば……

JavaとEclipseを題材にしてソースコードを読むのに役立つ機能を紹介しましたがいかがでしたか？　先に述べたように他のIDEでも似たような機能(あるいはもっと便利な機能)はあると思いますので、お使いのIDEのマニュアルを調べたり回りの識者に質問してみてください。

今回は具体的にEclipseの機能を書きましたが、ソースコードを読むということに対するマインドな部分や、ソースコードを素早く読むためにできる他のアプローチについても別の機会に発表できたらいいなと思っています。

それではみなさん、良いソースコードリーディングライフを！