モジュール java.base
パッケージ java.util.stream

インタフェースStream.Builder<T>

型パラメータ:
T - ストリーム要素の型
すべてのスーパー・インタフェース:
Consumer<T>
含まれているインタフェース:
Stream<T>
public static interface Stream.Builder<T> extends Consumer<T>
Streamの可変ビルダーです。 これを使えば、要素を個別に生成してBuilderに追加することによりStreamを作成できます(ArrayListを一時バッファーとして使用した場合に発生するコピー・オーバーヘッドを回避できます)。

ストリーム・ビルダーのライフサイクルは、要素の追加が可能な構築中フェーズから始まり、その後、要素の追加が不可能な構築済フェーズに遷移します。 構築済フェーズはbuild()メソッドが呼び出された時点で始まりますが、その際に作成される順序付けされたStreamの要素は、ストリーム・ビルダーに追加された要素を追加された順番に並べたものになります。

導入されたバージョン:
1.8
関連項目:

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    accept(T t)
    構築中のストリームに要素を追加します。
    default Stream.Builder<T>
    add(T t)
    構築中のストリームに要素を追加します。
    Stream<T>
    build()
    ストリームを構築し、このビルダーの状態を構築済に遷移させます。

    インタフェース java.util.function.Consumerで宣言されたメソッド

    andThen

  • メソッドの詳細

    • accept

      void accept(T t)
      構築中のストリームに要素を追加します。
      定義:
      accept 、インタフェース Consumer<T>
      パラメータ:
      t - 入力引数
      例外:
      IllegalStateException - ビルダーがすでに構築済状態に遷移していた場合

    • add

      default Stream.Builder<T> add(T t)
      構築中のストリームに要素を追加します。
      実装要件:
      デフォルト実装の動作は次のようになります。 
      
     accept(t)
     return this;
      パラメータ:
      t - 追加する要素
      戻り値:
      this(このビルダー)
      例外:
      IllegalStateException - ビルダーがすでに構築済状態に遷移していた場合

    • build

      Stream<T> build()
      ストリームを構築し、このビルダーの状態を構築済に遷移させます。 構築済状態への移行後にさらにビルダーの操作が試みられた場合、IllegalStateExceptionがスローされます。
      戻り値:
      構築されたストリーム
      例外:
      IllegalStateException - ビルダーがすでに構築済状態に遷移していた場合