Java : Consumer - API使用例

Consumer (Java SE 21 & JDK 21) の使い方まとめです。
だいたいのメソッドを網羅済みです。
API仕様書のおともにどうぞ。

概要

単一の入力引数を受け取って結果を返さないオペレーションを表します。 Consumerは他のほとんどの関数型インタフェースと異なり、副作用を介して動作することを期待されます。

クラス構成

Consumer は、パラメータあり、戻り値なしの関数型インタフェースです。
主に、Stream や Optional のラムダ式として使われます。

final var stream = Stream.of("a", "b", "c");

final var action = new Consumer<String>() {
    @Override
    public void accept(String s) {
        System.out.println(s.toUpperCase().repeat(3));
    }
};

System.out.println("-- forEach --");
stream.forEach(action);

// 結果
// ↓
//-- forEach --
//AAA
//BBB
//CCC

// ラムダ式の例です。
final var stream = Stream.of("a", "b", "c");

System.out.println("-- forEach --");
stream.forEach(s -> {
    System.out.println(s.toUpperCase().repeat(3));
});

// 結果
// ↓
//-- forEach --
//AAA
//BBB
//CCC

メソッド

void accept (T t)

指定された引数でこのオペレーションを実行します。

final var stream = Stream.of("a", "b", "c");

final var action = new Consumer<String>() {
    @Override
    public void accept(String s) {
        System.out.println(s.toUpperCase().repeat(3));
    }
};

System.out.println("-- forEach --");
stream.forEach(action);

// 結果
// ↓
//-- forEach --
//AAA
//BBB
//CCC

// ラムダ式の例です。
final var stream = Stream.of("a", "b", "c");

System.out.println("-- forEach --");
stream.forEach(s -> {
    System.out.println(s.toUpperCase().repeat(3));
});

// 結果
// ↓
//-- forEach --
//AAA
//BBB
//CCC

default Consumer<T> andThen (Consumer<? super T> after)

このオペレーションを実行した後、続けてafterオペレーションを実行する合成Consumerを返します。

final var consumer1 = new Consumer<String>() {
    @Override
    public void accept(String s) {
        System.out.println(s);
    }
};

final var after = new Consumer<String>() {
    @Override
    public void accept(String s) {
        System.out.println(s.toUpperCase());
    }
};

final var consumer2 = consumer1.andThen(after);

System.out.println("-- accept --");
consumer2.accept("abcd");

// 結果
// ↓
//-- accept --
//abcd
//ABCD

final var consumer1 = new Consumer<String>() {
    @Override
    public void accept(String s) {
        System.out.println("  consumer1 accept!");
        if (s == null) {
            throw new IllegalArgumentException("s is null");
        }
    }
};

final var after = new Consumer<String>() {
    @Override
    public void accept(String s) {
        System.out.println("  after accept!");
    }
};

final var consumer2 = consumer1.andThen(after);

try {
    System.out.println("-- accept null --");
    consumer2.accept(null);
} catch (IllegalArgumentException e) {
    System.out.println("IllegalArgumentException! : " + e.getMessage());
}

// 結果
// ↓
//-- accept null --
//  consumer1 accept!
//IllegalArgumentException! : s is null

API 使用例

Java : Consumer - API使用例

概要

メソッド

void accept (T t)

default Consumer<T> andThen (Consumer<? super T> after)

関連記事