この記事では、Java Streams を使って「特定の型だけを抽出し、配列としてまとめる」方法について、実際のコードとともに整理します。

背景

例えば、ある配列 attributes の中に複数の型のオブジェクトが混在している場合、
Annotations 型だけを抜き出して、その中の AnnotationsEntity 要素を 1 つの配列にまとめたい、とします。

Object[] attributes = { "string", someAnnotation, 123, anotherAnnotation };

元のコード（OSS例）

Streams.of(attributes)
       .filter(Annotations.class::isInstance)
       .flatMap(e -> Stream.of(((Annotations) e).toArray(AnnotationsEntity[]::new)));

Streams.of(attributes) → 配列や可変長引数を Stream に変換
filter(Annotations.class::isInstance) → Annotations 型だけ抽出
flatMap(e -> Stream.of(...)) → 配列を Stream に変換（ただし平坦化されない）

注意
このままだと「配列そのものが 1 要素の Stream」になるだけで、配列の中身は平坦化されません。

配列と Stream の関係

配列のイメージ
attributes
├─ attributes[0] → arr1 → [entity1, entity2]
└─ attributes[1] → arr2 → [entityA, entityB]

arr1 や arr2 が Annotations 型で、その中に複数の AnnotationsEntity が格納されている

[entity1, entity2] のカンマは表示上の表記で、実際にはメモリ上にカンマ文字は存在しません

Stream.of(array) と Arrays.stream(array)

メソッド	Stream 内の要素
`Stream.of(array)`	配列そのものが 1 要素
`Arrays.stream(array)`	配列の中身が 1 要素ずつ Stream に展開

flatMap と組み合わせる場合、中身を展開したいなら Arrays.stream() を使うのが正しい

実装例（配列にまとめる場合）

AnnotationsEntity[] result = Stream.of(attributes)
    .filter(Annotations.class::isInstance)                  // Annotations 型だけ抽出
    .flatMap(e -> Arrays.stream(((Annotations) e)
                  .toArray(AnnotationsEntity[]::new)))      // 配列の中身を平坦化
    .toArray(AnnotationsEntity[]::new);                      // 配列に変換

result は AnnotationsEntity 型だけをまとめた配列になります
他の型（String, Integer など）は無視されます

処理の流れ（図解イメージ）

attributes: [arr1, arr2] 
  arr1 = [entity1, entity2]
  arr2 = [entityA, entityB]

Stream.of(attributes)
  ↓ filter
Stream([arr1, arr2])
  ↓ flatMap(Arrays.stream(...))
Stream([entity1, entity2, entityA, entityB])
  ↓ toArray
AnnotationsEntity[] result = [entity1, entity2, entityA, entityB]

これにより、特定型だけを抽出し、1つの配列にまとめる処理が完了します

まとめ

Stream.of(array) は配列を 1 要素として Stream にする
Arrays.stream(array) で配列の中身を個別要素として Stream に展開
filter と flatMap を組み合わせて、特定の型の要素だけを抽出して配列にまとめるのが基本パターン
表記上のカンマは見やすくするためのもので、実際の配列や Stream 内には文字として存在しない