Javaで複数行のSQL文を書こうとすると、+ 演算子と \n だらけの読みにくいコードになりがちです。
JSONを組み立てるときも、ダブルクォートのエスケープでいちいち手が止まります。
Java 15で正式導入されたテキストブロックは、この面倒を構文レベルで解消してくれます。
3つのダブルクォート """ で囲むだけで、複数行の文字列を見たままの形で書けるようになりました。
この記事では、基本構文からformatted()を使った変数の埋め込み、改行・エスケープの制御方法まで、実例コード付きで解説します。
この記事でわかること
- テキストブロックの基本的な書き方とインデント制御
formatted()を使った変数埋め込みの方法- 改行の抑止やエスケープシーケンスの使い方
- SQL・JSON・HTMLでの実践的な活用例
Javaのテキストブロックとは?意味と基本構文
Javaのテキストブロックは、複数行にわたる文字列を、見たままの形で直感的に記述できる機能です。
これまでのような面倒なエスケープシーケンスや文字列連結から、私たち開発者を解放してくれます。
テキストブロックが導入された背景
テキストブロックが登場する前、Javaで複数行の文字列を扱うのは煩雑でした。
例えば、複数行の文字列を定義するには、+ 演算子で一行ずつ連結したり、改行文字 \n を大量に含めたりする必要がありました。
この方法はコードの可読性を大きく下げます。特にSQL文やJSON、HTMLをコード内に埋め込む際、開発者の頭を悩ませていました。
このような問題を解決し、より現代的で開発者フレンドリーな言語へと進化するために、Javaにテキストブロックが導入されました。
対応バージョン(Java 13〜15の経緯)
Javaのテキストブロックは、すぐに標準機能になったわけではありません。
- Java 13, 14: プレビュー機能として導入
- Java 15: 正式に標準機能として採用
この経緯があるため、テキストブロックをプロジェクトで利用するには、Java 15以降の環境が必要です。
Java 8やJava 11で稼働しているプロジェクトでは、テキストブロックは使えません。
Java 17・21・25(いずれもLTS)以降であれば問題なく使えます。
なおOracle JDK 21の無償ライセンス(NFTC)での更新提供は2026年9月で終了しました(10月以降の更新はJava SE OTNライセンス)。新規プロジェクトはJava 25を選ぶのが無難です。
利用する前に、プロジェクトのJavaバージョンを確認します。
テキストブロックの基本的な書き方
テキストブロックの使い方はとてもシンプルです。3つのダブルクォーテーション """ で文字列を囲むだけで、複数行の文字列を簡単に表現できます。
従来の文字列リテラルとの違い
まずは、従来の書き方とテキストブロックの書き方を見比べます。その差は一目瞭然です。
従来の書き方String html = "<html>\n" +
" <body>\n" +
" <p>Hello, World!</p>\n" +
" </body>\n" +
"</html>";
テキストブロックを使った書き方
String html = """
<html>
<body>
<p>Hello, World!</p>
</body>
</html>
""";
テキストブロックを使うと、コード内に埋め込んだ文字列が、まるで別のファイルから読み込んだかのように自然に見えます。
+ 演算子も改行文字 \n も不要になり、コードがすっきりとしました。
ダブルクォーテーション3つで書く複数行文字列の記述方法
テキストブロックのルールは簡単です。
- 開始デリミタ
"""の直後には、必ず改行を入れる。 - 文字列を自由に記述する。
- 終了デリミタ
"""で閉じる。
これだけです。例えば、簡単な挨拶文は以下のように書けます。
String greeting = """
こんにちは。
Javaのテキストブロックの世界へようこそ。
""";
見たままの通りの文字列が、greeting 変数に格納されます。
インデントの自動制御と終了デリミタの位置
テキストブロックの最も賢い特徴のひとつが、インデントの自動的な処理です。
Javaコンパイラは、中身の各行(終了デリミタ """ だけの行も含む)の先頭にある空白のうち最も少ない量を基準として、すべての行から共通する不要な空白を自動的に取り除いてくれます。
public class Main {
public static void main(String[] args) {
String json = """
{
"name": "Java",
"version": "17"
}
""";
System.out.println(json);
}
}
このコードを実行すると、json 変数の先頭に不要なインデントは含まれず、きれいなJSON文字列が出力されます。
{
"name": "Java",
"version": "17"
}
終了デリミタ """ を左にずらすと、その分インデントが保持されるようになります。
インデントをどこに合わせるかは、終了デリミタの位置でコントロールできます。
""" の前の空白:12文字取り除かれる空白:12文字OUTPUT / 出力される文字列
{
"name": "Java",
"version": "17"
}共通の空白がすべて消え、インデントなしで出力""" の前の空白:8文字取り除かれる空白:8文字OUTPUT / 出力される文字列
{
"name": "Java",
"version": "17"
}消える空白が4文字減り、各行に4文字のインデントが残る実務でのハマりポイント:IDEの自動フォーマット機能によって終了デリミタ """ の位置がずれると、意図しないインデントが混入します。
チーム開発では .editorconfig やIDEの設定でテキストブロックのフォーマットルールを統一しておくと、この問題を防げます。
終了デリミタの位置ずれの問題はIDEの自動フォーマットに任せきりにしていると気づきにくく、レビュー段階で発覚することが多いです。
終了デリミタの位置ひとつでインデント全体の見た目が変わるため、フォーマットの統一はレビュアー任せにせず、プロジェクト共通の設定ファイルとして明文化しておくべきです。
改行の制御方法(行末\と改行コード)
テキストブロック内の改行は、OSに関係なくLF(\n)に正規化されます。Windows環境でもCR+LFにはなりません。
改行を抑止したい場合は、行末に \(バックスラッシュ)を置きます。これはJava 14のプレビューで導入され、Java 15で正式採用された機能です。
String singleLine = """
この行と\
この行は\
1行になります。\
""";
// 結果: "この行とこの行は1行になります。"
また、各行の末尾空白は自動的に除去されますが、\s(スペースエスケープ)を使うと末尾空白を明示的に保持できます。
String withSpace = """
名前: \s
住所: \s
""";
// 各行の末尾に半角スペース3つが保持される(「:」の後の2つと \s の1つ)
エスケープシーケンスの使い方
テキストブロック内でも、従来のエスケープシーケンスはそのまま使用可能です。
ダブルクォートのエスケープは不要になります(トリプルクォート自体を含めたい場合のみ\"""でエスケープが必要です)。
知っておくべきエスケープシーケンスをまとめます。
\n— 改行(テキストブロック内では通常の改行で十分なため使用頻度は低い)\t— タブ\"— ダブルクォーテーション(テキストブロック内では通常エスケープ不要)\"""— トリプルクォート自体を文字列に含めたい場合に使用\(行末) — 改行の抑止\s— 末尾空白の保持
特に \""" のように、3つ続けたクォートのうち少なくとも1つをエスケープすれば、テキストブロック内にトリプルクォートを含められます(""\" でも同じです)。
テキストブロックの活用例
Javaのテキストブロックは、特に定型的な長い文字列を扱う場面で、その真価を発揮します。
まずは変数の埋め込み方法を押さえてから、SQL・JSON・テストコードでの具体例に進みます。
formatted()で変数を埋め込む方法
テキストブロックには、JavaScriptのテンプレートリテラルのような変数埋め込み機能はありません。
Java 21でString Templates(JEP 430)がプレビュー導入され、Java 22でJEP 459として再プレビューされましたが、Java 23で削除され、まだ復活していません。
そのため現時点では、formatted()(または String.format())で埋め込むのが標準的な方法です。
formatted() はJava 15で追加された String のインスタンスメソッドで、String.format() と同じフォーマット指定子(%s, %d, %,d など)が使えます。
String name = "太郎";
int price = 1234;
String message = """
%sさん、こんにちは。
ご注文金額は%,d円です。
""".formatted(name, price);
// 結果:
// 太郎さん、こんにちは。
// ご注文金額は1,234円です。
String.format() は静的メソッドなので String.format(テンプレート, 引数...) と書きますが、formatted() はテキストブロックに直接メソッドチェーンできるため、コードがすっきりします。
// String.format() の場合
String sql1 = String.format("""
SELECT * FROM users WHERE name = '%s'
""", userName);
// formatted() の場合(推奨)
String sql2 = """
SELECT * FROM users WHERE name = '%s'
""".formatted(userName);
注意
上記のSQL例は formatted() の使い方を示すためのものです。本番コードでは PreparedStatement を使用してください。
formatted() でSQL文を直接組み立てると、SQLインジェクションの危険があります。
テキストブロック + formatted() が活躍するのは、ログ出力やテストデータ生成など、外部入力を含まない場面です。
SQL文をきれいに書く
データベースを操作する際、Javaコード内にSQL文を記述することはよくあります。
テキストブロックを使えば、複雑なSQL文も見やすく管理できます。
従来の書き方String query = "SELECT user_id, user_name, email " +
"FROM users " +
"WHERE registration_date > '2023-01-01' " +
"AND is_active = true " +
"ORDER BY user_name;";
テキストブロックを使った書き方
String query = """
SELECT
user_id,
user_name,
email
FROM
users
WHERE
registration_date > '2023-01-01'
AND is_active = true
ORDER BY
user_name;
""";
テキストブロックを使った書き方のほうが、SQLの構造が一目で分かります。SQLをそのままコピー&ペーストできるため、開発効率が大きく向上します。
HTML・XML・JSONを扱う場合
Webアプリケーション開発では、HTMLやJSONを文字列として扱う場面が頻繁にあります。ここでもJavaのテキストブロックが活躍します。
XML形式の設定ファイルやSOAPリクエストのボディをテスト用に定義する場合も、同様にテキストブロックが役立ちます。
タグの入れ子構造をそのままの見た目で記述でき、閉じタグの対応関係も追いやすくなります。
JSONの例String jsonData = """
{
"book": {
"title": "Effective Java",
"author": "Joshua Bloch",
"publicationYear": 2001,
"tags": ["Java", "Programming", "Best Practices"]
}
}
""";
" (ダブルクォーテーション)を \" のようにエスケープする必要が一切ない点に注目してください。
これにより、JSON文字列の作成や修正が格段に楽になります。
テストコードでの可読性向上
テストコードでは、期待する結果を文字列として定義することがよくあります。一例として、APIのレスポンスとして返されるJSONの期待値が挙げられます。
テキストブロックを使えば、期待値のデータもきれいに記述でき、テストコード自体の可読性が向上します。
@Test
void testGetUserApi() {
String expectedJson = """
{
"userId": 101,
"userName": "Taro Yamada",
"isActive": true
}
""";
// APIを呼び出し、実際のレスポンスを取得する処理
String actualJson = userApiService.getUser(101);
// 期待値と実際の結果を比較
assertEquals(expectedJson, actualJson);
}
テストデータが明確になることで、テストの意図が伝わりやすくなり、メンテナンス性の向上にもつながります。
💡 テスト実装のコツ: テキストブロックでJSON期待値を書く場合、末尾の改行やインデントに差異があると、assertEquals での直接比較は失敗します。
直接比較する代わりに、JSONライブラリ(Jackson等)でパースしてからオブジェクト比較する方法が、インデントに左右されず堅牢です。
テキストブロックのメリットと注意点
Javaのテキストブロックは便利な機能ですが、メリットを最大限に活かし、トラブルを避けるためには、いくつかの注意点を知っておく必要があります。
テキストブロックを使う2つのメリット
テキストブロックの最大のメリットは、コードの可読性が大きく向上する点です。文字列がコードの一部として自然に溶け込み、ロジックの流れを妨げません。
チーム開発でのコードレビューでも大きな効果を発揮します。
もう一つのメリットは、\n や \" といったエスケープシーケンスが大幅に減ることです。
タイプミスによるバグを防ぎ、文字列の本質的な内容に集中できるようになります。
バージョン依存や互換性の注意点
最も重要な注意点は、Java 15以降のバージョンでなければ使用できないという点です。
もしあなたのプロジェクトがJava 8や11で稼働している場合、テキストブロックを使うことはできません。
なお、Oracle JDK 21の無償(パーミッシブ)ライセンスでの更新提供は2026年9月で終了しました(10月以降の更新はJava SE OTNライセンス)。新規プロジェクトではJava 25の利用が推奨されます。
チームで開発している場合は、「この機能はJava 15以上が必要」という共通認識を持つことが大切です。
古いシステムを保守している環境でうっかり使ってしまうと、コンパイルエラーの原因になります。プロジェクトのJavaバージョンを必ず確認してください。
よくある質問
Q1. Javaのテキストブロックとは何ですか?
A1. 複数行の文字列を、見たままの形で直感的に記述できるJavaの機能です。3つのダブルクォート """ で囲むだけで使え、Java 15で正式導入されました。
Q2. テキストブロックはJavaのどのバージョンから使えますか?
A2. Java 15以降で正式に使えます。Java 13・14ではプレビュー機能として先行導入されていました。Java 8や11では使用できません。
Q3. テキストブロックで変数を埋め込むにはどうすればいいですか?
A3. formatted()メソッドを使います。String.format()と同じ%sや%dといったフォーマット指定子が使え、テキストブロックに直接メソッドチェーンできます。
Q4. テキストブロック内でダブルクォーテーションをエスケープする必要はありますか?
A4. 基本的に不要です。ただし、トリプルクォート自体を文字列に含めたい場合は\"""でエスケープします。
Q5. テキストブロックのインデントはどう扱われますか?
A5. 中身の各行(終了デリミタ"""だけの行も含む)の先頭の空白のうち最も少ない量を基準に、共通する不要な空白は自動的に除去されます。終了デリミタを左にずらすとインデントが保持されます。
Q6. テキストブロックで改行を抑止することはできますか?
A6. できます。行末にバックスラッシュ\を置くと、その行の改行が抑止され、次の行と1行に結合されます。
Q7. formatted()でSQL文を組み立てても安全ですか?
A7. 本番コードでは推奨されません。SQLインジェクションの危険があるため、formatted()の直接組み立てはログ出力やテストデータ生成など外部入力を含まない場面に限定し、実際のSQL実行にはPreparedStatementを使ってください。
まとめ
Javaのテキストブロックは、複数行の文字列を扱う際の長年の課題を解決する、画期的な機能です。
テキストブロックを使うべき場面
- SQLクエリの記述
- HTML、XML、JSONといった構造化データの埋め込み
- テストコードでの期待値データ定義
- その他、複数行にわたる設定情報やメッセージの記述
これらの場面でテキストブロックを積極的に活用することで、あなたのJavaコードはよりクリーンで、読みやすく、そして保守しやすいものに生まれ変わります。
これからのJavaコードでの位置づけ
テキストブロックは、もはや単なる便利機能ではありません。現代的なJava開発におけるスタンダードな記述方法です。
Java 17以降のLTS環境(17・21・25)で開発しているなら、テキストブロックを使わない理由はありません。
| REV. | DATE | 内容 |
|---|---|---|
| 6 | 2026-10-16 | 図解を描き直し(図面のデザインにそろえた) |
| 5 | 2026-10-14 | 雰囲気だけの挿絵を外した |
| 4 | 2026-10-04 | 記載内容の事実確認と修正 |
| 3 | 2026-09-06 | 2026年9月時点の情報で全体を見直し(古い記述を5件更新) |
| … ほか1回の改訂 | ||
| 1 | 2025-10-03 | 初版 |

