フォーマッター

Java エディターのコード上で Ctrl+Shift+F を押して、フォーマットします。 選択が設定されない場合はソース全体がフォーマットされ、設定される場合は選択された部分だけがフォーマットされます。 フォーマッターの使用に関するいくつかのヒントがこの章の段落にリストされています。

「Java フォーマッター」設定には、 「Java フォーマッター」設定ページを開く「Java フォーマッター」設定ページからアクセスできます。

セクション内のフォーマッターの使用不能化

以下のサンプルで示されているコード内の 1 つ以上のセクションのフォーマッターを使用不可/使用可能にすることができます。

Java フォーマッターの例。使用不能化および使用可能化タグを使ったコードの一部。

上記のスニペットではデフォルトのタグ名が使用されていますが、「Java フォーマッター」設定ページの「オフ/オン・タグ」タブで変更することができます。

最外部のメソッド呼び出しの折り返し

バージョン 3.6 以降、Java フォーマッターは最外部のメソッド呼び出しを最初に折り返すようになりました。これにより、ネスト・メソッド呼び出しを折り返すときに生成される出力が改善されました。

以下は、フォーマッターが最外部のメッセージ呼び出しの引数の間で行を折り返すフォーマット済みコードの一例です。これにより、各ネスト・メソッド呼び出しが 1 行に保たれています。

Java フォーマッターの例。フォーマット済みのネスト・メソッド呼び出しを含んでいる単純なスニペット。

新規設定では、この方式を使用不可にして (コードを以前のようにフォーマットする場合など)、「外部式のラッピングを選択 (ネストされた式を 1 行に保持する)」設定のチェック・マークを外すことができます。これは「Java フォーマッター」設定ページの「行折り返し」タブからアクセスできます。

注: 現在、新規戦略はネスト・メソッド呼び出しに対してのみ適用されます。ただし、将来のバージョンでは他のネスト式に拡張される可能性があります。

Javadoc およびブロック・コメントの圧縮

ユーザーは、以下の例で示されているように、フォーマットされた複数行のコメントの行数を削減することができます。

Java フォーマッターの例。ブロックおよび Javadoc コメントをフォーマットしてデフォルト・プロファイルより行数が少なくなっている単純なスニペット。

この振る舞いをアクティブにするには、「個々の行に /* および */」設定のチェック・マークを外します。 これは「Java フォーマッター」設定ページの「コメント」タブからアクセスできます。

同じような設定は、Javadoc コメントについても使用できます。

ユーザーの改行の保持

ユーザーは、コードまたはコメントの行を結合しないことで、改行を保持することができます。

例えば、以下のテスト・ケースのような、既に折り返された return ステートメントの行があるとします。

フォーマットするコードの例

この行は、「行を結合しない」設定を使用するとフォーマッターによって保持されます。これがフォーマットされると以下のような出力になります。

「行を結合しない」を使用してフォーマットされたコード

この振る舞いをアクティブにするには、「行を結合しない」設定にチェック・マークを付けます。これは「Java フォーマッター」設定ページの「行折り返し」および「コメント」タブからアクセスできます。

関連概念

Java エディター
Java 開発ツール (JDT)

関連参照

「編集」メニュー
Java エディター設定
フォーマッター設定