【Java学習｜実務向け】実務で役立つ！Stream APIとCollectors.joining()でスマートな文字列結合を実現する

1. 導入: なぜ今、Collectors.joining()が必要なのか？

Java開発において、複数の文字列を特定の区切り文字で結合する場面は頻繁に発生します。例えば、データベースから取得したユーザー名の一覧をカンマ区切りで表示したり、ログメッセージを整形したり、といった具合です。

これまでのJavaでは、このような文字列結合は主に`for`ループと`StringBuilder`を使って行われてきました。しかし、この方法はコードが冗長になりがちで、特に要素数が多い場合や、複雑な変換を伴う場合には可読性が低下するという課題がありました。

Java 8で導入されたStream APIは、コレクション処理の記述を劇的に改善しました。その中でも`Collectors.joining()`メソッドは、コレクション内の要素を簡潔かつ強力に文字列結合するための強力なツールです。これを使えば、従来の冗長なコードから解放され、より宣言的で読みやすいコードを実現できます。本記事では、この`Collectors.joining()`の基本的な使い方から、実務で役立つ応用例、そして注意点までを、具体的なコード例を交えながら解説していきます。

2. 基礎知識: Stream APIとCollectors.joining()の役割

まず、`Collectors.joining()`を理解するために必要な基礎知識を確認しましょう。

Stream APIとは？
Java 8で導入されたStream APIは、コレクション（List, Setなど）の要素を関数型プログラミングのスタイルで処理するための強力な機能です。要素のフィルタリング、変換、集計といった操作を、中間操作（`filter()`, `map()`など）と終端操作（`forEach()`, `collect()`など）を組み合わせて記述します。これにより、コードの記述量が減り、並行処理も容易になります。

`collect()`メソッドの役割
Stream APIの終端操作の一つである`collect()`メソッドは、ストリームの要素を「収集」し、結果を単一の値や新しいコレクションにまとめる役割を担います。この「収集」の具体的な方法を指定するのが`java.util.stream.Collectors`クラスです。

`Collectors.joining()`とは？
`Collectors`クラスは、様々な「コレクタ」を提供するファクトリクラスです。その中の`joining()`メソッドは、ストリームの要素を文字列として結合するためのコレクタを生成します。

`joining()`にはいくつかのオーバーロードがありますが、今回のテーマである`joining(delimiter)`は、ストリームの各要素間に指定された区切り文字（delimiter）を挿入して結合します。例えば、`joining(“, “)`とすれば、各要素がカンマとスペースで区切られて結合されます。

3. 実装/解決策: Collectors.joining(delimiter)の使い方

`Collectors.joining(delimiter)`を使った文字列結合の基本的な流れは以下のようになります。

1. コレクションからストリームを作成する: `List`, `Set`などのコレクションに対して`.stream()`メソッドを呼び出します。
2. 要素を文字列に変換する: 必要に応じて、`map()`メソッドを使ってコレクションの要素を文字列に変換します。例えば、オブジェクトのリストであれば、そのオブジェクトの特定のプロパティ（String型）を取り出す、といった加工を行います。
3. `collect()`メソッドで結合する: 終端操作として`collect(Collectors.joining(delimiter))`を呼び出します。ここで指定する`delimiter`が、結合される文字列の間に挿入されます。

この一連の処理をパイプラインで記述できるため、非常に簡潔なコードになります。

4. サンプルプログラム

以下に、`Collectors.joining(delimiter)`を使用した具体的なサンプルコードを示します。

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class CollectorsJoiningExample {

// ユーザー情報を表現するシンプルなクラス
static class User {
private String id;
private String name;
private int age;

public User(String id, String name, int age) {
this.id = id;
this.name = name;
this.age = age;
}

public String getId() {
return id;
}

public String getName() {
return name;
}

public int getAge() {
return age;
}

@Override
public String toString() {
return “User{id='” + id + “‘, name='” + name + “‘, age=” + age + “}”;
}
}

public static void main(String[] args) {
// 文字列のリストを結合する例
List fruits = Arrays.asList(“Apple”, “Banana”, “Cherry”, “Date”);

// カンマ区切りで結合
String commaSeparatedFruits = fruits.stream()
.collect(Collectors.joining(“, “));
System.out.println(“カンマ区切りの果物リスト: ” + commaSeparatedFruits);
// 出力: Apple, Banana, Cherry, Date

// ハイフン区切りで結合
String hyphenSeparatedFruits = fruits.stream()
.collect(Collectors.joining(“-“));
System.out.println(“ハイフン区切りの果物リスト: ” + hyphenSeparatedFruits);
// 出力: Apple-Banana-Cherry-Date

System.out.println(“——————–“);

// オブジェクトのリストから特定のプロパティを抽出し、結合する例
List users = Arrays.asList(
new User(“001”, “Alice”, 30),
new User(“002”, “Bob”, 25),
new User(“003”, “Charlie”, 35)
);

// ユーザー名だけを抽出し、セミコロン区切りで結合
String userNames = users.stream()
.map(User::getName) // Userオブジェクトから名前（String）を抽出
.collect(Collectors.joining(“; “));
System.out.println(“セミコロン区切りのユーザー名: ” + userNames);
// 出力: Alice; Bob; Charlie

// ユーザーIDだけを抽出し、スラッシュ区切りで結合
String userIds = users.stream()
.map(User::getId) // UserオブジェクトからID（String）を抽出
.collect(Collectors.joining(“/”));
System.out.println(“スラッシュ区切りのユーザーID: ” + userIds);
// 出力: 001/002/003

System.out.println(“——————–“);

// 要素が空のリストの場合
List emptyList = List.of(); // Java 9以降の不変リスト作成
String emptyJoined = emptyList.stream()
.collect(Collectors.joining(“, “));
System.out.println(“空リストの結合結果: ‘” + emptyJoined + “‘”);
// 出力: 空リストの結合結果: ” (空文字列になる)

System.out.println(“——————–“);

// nullを含むリストの場合 (注意が必要なケース)
List nullableItems = Arrays.asList(“ItemA”, null, “ItemC”);

// そのまま結合するとNullPointerExceptionが発生する可能性
// 以下は実行するとエラーになるのでコメントアウト
// try {
// String errorResult = nullableItems.stream()
// .collect(Collectors.joining(“, “));
// System.out.println(“Nullを含むリストの結合 (エラー): ” + errorResult);
// } catch (NullPointerException e) {
// System.err.println(“Nullを含むリストの結合でエラーが発生しました: ” + e.getMessage());
// }

// null要素を除外して結合する安全な方法
String safeJoined = nullableItems.stream()
.filter(s -> s != null) // null要素を除外
.collect(Collectors.joining(“, “));
System.out.println(“Nullを除外して結合した結果: ” + safeJoined);
// 出力: Nullを除外して結合した結果: ItemA, ItemC
}
}

5. 応用・注意点: 現場で活かすためのヒント

`Collectors.joining(delimiter)`は非常に便利ですが、さらに応用を効かせたり、思わぬ落とし穴を回避するためのポイントがあります。

5.1. 他のオーバーロードも活用する

`Collectors.joining()`には、引数の異なる以下のオーバーロードがあります。

• `Collectors.joining()`: 区切り文字なしで単純にすべての要素を結合します。
• `Collectors.joining(CharSequence delimiter)`: 今回解説した、指定した区切り文字で要素を結合します。
• `Collectors.joining(CharSequence prefix, CharSequence delimiter, CharSequence suffix)`: 区切り文字だけでなく、結果文字列の先頭に`prefix`、末尾に`suffix`を付加して結合します。

例えば、HTMLのリストタグを生成するような場合に使えます。

List items = Arrays.asList(“Item 1”, “Item 2”);
String htmlList = items.stream()
.collect(Collectors.joining(“