インタフェース
java.util.function.Functionの使用

Functionを使用しているパッケージ

パッケージ	説明
java.security	セキュリティ・フレームワークのクラスとインタフェースを提供します。
java.util	コレクション・フレームワーク、レガシー・コレクション・クラス、イベント・モデル、日時機能、国際化、およびさまざまなユーティリティ・クラス(StringTokenizer、乱数ジェネレータ、およびビット配列)が含まれています。
java.util.concurrent	並行プログラミングでよく使用されるユーティリティ・クラスです。
java.util.function	関数型インタフェースは、ラムダ式やメソッド参照のターゲットとなる型を提供します。
java.util.stream	コレクションに対するマップ-リデュース変換など、要素のストリームに対する関数型の操作をサポートするクラスです。

java.securityでのFunctionの使用

Function型のパラメータを持つjava.securityのメソッド

修飾子と型	メソッドと説明
Object	Provider.computeIfAbsent(Object key, Function<? super Object,? extends Object> mappingFunction) 指定されたキーがまだ値に関連付けられていない(またはnullにマップされている)場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。

java.utilでのFunctionの使用

Function型のパラメータを持つjava.utilのメソッド

修飾子と型	メソッドと説明
static <T,U extends Comparable<? super U>> Comparator<T>	Comparator.comparing(Function<? super T,? extends U> keyExtractor) 型TからComparableソート・キーを抽出する関数を受け取り、そのソート・キーで比較するComparator<T>を返します。
static <T,U> Comparator<T>	Comparator.comparing(Function<? super T,? extends U> keyExtractor, Comparator<? super U> keyComparator) 型Tからソート・キーを抽出する関数を受け取り、指定されたComparatorを使ってそのソート・キーで比較するComparator<T>を返します。
V	HashMap.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
V	Hashtable.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction)
default V	Map.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction) 指定されたキーがまだ値に関連付けられていない(またはnullにマップされている)場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。
<U> Optional<U>	Optional.flatMap(Function<? super T,Optional<U>> mapper) 値が存在する場合は、指定されたOptional生成マッピング関数をその値に適用し、その結果を返します。そうでない場合は空のOptionalを返します。
<U> Optional<U>	Optional.map(Function<? super T,? extends U> mapper) 値が存在する場合は、指定されたマッピング関数をその値に適用し、結果がnullでなければ結果を記述するOptionalを返します。
default <U extends Comparable<? super U>> Comparator<T>	Comparator.thenComparing(Function<? super T,? extends U> keyExtractor) Comparableソート・キーを抽出する関数を含む辞書式順序コンパレータを返します。
default <U> Comparator<T>	Comparator.thenComparing(Function<? super T,? extends U> keyExtractor, Comparator<? super U> keyComparator) 指定されたComparatorで比較されるキーを抽出する関数を含む辞書式順序コンパレータを返します。

java.util.concurrentでのFunctionの使用

Function型のパラメータを持つjava.util.concurrentのメソッド

修飾子と型	メソッドと説明
<U> CompletionStage<U>	CompletionStage.applyToEither(CompletionStage<? extends T> other, Function<? super T,U> fn) このステージまたは指定された他のステージが正常に完了したときに、対応する結果を指定された関数への引数に設定して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.applyToEither(CompletionStage<? extends T> other, Function<? super T,U> fn)
<U> CompletionStage<U>	CompletionStage.applyToEitherAsync(CompletionStage<? extends T> other, Function<? super T,U> fn) このステージまたは指定された他のステージが正常に完了したときに、対応する結果を指定された関数への引数に設定し、このステージのデフォルトの非同期実行機能を使用して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.applyToEitherAsync(CompletionStage<? extends T> other, Function<? super T,U> fn)
<U> CompletionStage<U>	CompletionStage.applyToEitherAsync(CompletionStage<? extends T> other, Function<? super T,U> fn, Executor executor) このステージまたは指定された他のステージが正常に完了したときに、対応する結果を指定されたアクションへの引数に設定し、指定されたエグゼキュータを使用して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.applyToEitherAsync(CompletionStage<? extends T> other, Function<? super T,U> fn, Executor executor)
V	ConcurrentSkipListMap.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction) 指定されたキーがまだ値に関連付けられていない場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。
default V	ConcurrentMap.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction) 指定されたキーがまだ値に関連付けられていない(またはnullにマップされている)場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。
V	ConcurrentHashMap.computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction) 指定されたキーがまだ値に関連付けられていない場合、指定されたマッピング関数を使用してその値の計算を試行し、nullでない場合はそれをこのマップに入力します。
CompletionStage<T>	CompletionStage.exceptionally(Function<Throwable,? extends T> fn) このステージが例外で完了したときに、このステージの例外を指定された関数への引数に設定して実行される新しいCompletionStageを返します。
CompletableFuture<T>	CompletableFuture.exceptionally(Function<Throwable,? extends T> fn) このCompletableFutureが完了したときに完了する新しいCompletableFutureを返します。例外で完了した場合は、このCompletableFutureの完了をトリガーした例外の指定された関数の結果を含みます。このCompletableFutureが正常に完了した場合は、返されるCompletableFutureも同じ値で正常に完了します。
<U> void	ConcurrentHashMap.forEachEntry(long parallelismThreshold, Function<Map.Entry<K,V>,? extends U> transformer, Consumer<? super U> action) 各エントリのnull以外の各変換に対して指定されたアクションを実行します。
<U> void	ConcurrentHashMap.forEachKey(long parallelismThreshold, Function<? super K,? extends U> transformer, Consumer<? super U> action) 各キーのnull以外の各変換に対して指定されたアクションを実行します。
<U> void	ConcurrentHashMap.forEachValue(long parallelismThreshold, Function<? super V,? extends U> transformer, Consumer<? super U> action) 各値のnull以外の各変換に対して指定されたアクションを実行します。
<U> U	ConcurrentHashMap.reduceEntries(long parallelismThreshold, Function<Map.Entry<K,V>,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer) 指定されたリデューサを使用して値を結合することにより、すべてのエントリの指定された変換の累積結果を返します。結果がない場合はnullを返します。
<U> U	ConcurrentHashMap.reduceKeys(long parallelismThreshold, Function<? super K,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer) 指定されたリデューサを使用して値を結合することにより、すべてのキーの指定された変換の累積結果を返します。結果がない場合はnullを返します。
<U> U	ConcurrentHashMap.reduceValues(long parallelismThreshold, Function<? super V,? extends U> transformer, BiFunction<? super U,? super U,? extends U> reducer) 指定されたリデューサを使用して値を結合することにより、すべての値の指定された変換の累積結果を返します。結果がない場合はnullを返します。
<U> U	ConcurrentHashMap.searchEntries(long parallelismThreshold, Function<Map.Entry<K,V>,? extends U> searchFunction) 各エントリに指定された検索関数を適用したnull以外の結果を返します。結果がない場合はnullを返します。
<U> U	ConcurrentHashMap.searchKeys(long parallelismThreshold, Function<? super K,? extends U> searchFunction) 各キーに指定された検索関数を適用したnull以外の結果を返します。結果がない場合はnullを返します。
<U> U	ConcurrentHashMap.searchValues(long parallelismThreshold, Function<? super V,? extends U> searchFunction) 各値に指定された検索関数を適用したnull以外の結果を返します。結果がない場合はnullを返します。
<U> CompletionStage<U>	CompletionStage.thenApply(Function<? super T,? extends U> fn) このステージが正常に完了したときに、このステージの結果を指定された関数への引数に設定して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.thenApply(Function<? super T,? extends U> fn)
<U> CompletionStage<U>	CompletionStage.thenApplyAsync(Function<? super T,? extends U> fn) このステージが正常に完了したときに、このステージの結果を指定された関数への引数に設定し、このステージのデフォルトの非同期実行機能を使用して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.thenApplyAsync(Function<? super T,? extends U> fn)
<U> CompletionStage<U>	CompletionStage.thenApplyAsync(Function<? super T,? extends U> fn, Executor executor) このステージが正常に完了したときに、このステージの結果を指定された関数への引数に設定し、指定されたエグゼキュータを使用して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.thenApplyAsync(Function<? super T,? extends U> fn, Executor executor)
<U> CompletionStage<U>	CompletionStage.thenCompose(Function<? super T,? extends CompletionStage<U>> fn) このステージが正常に完了したときに、このステージを指定された関数への引数に設定して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.thenCompose(Function<? super T,? extends CompletionStage<U>> fn)
<U> CompletionStage<U>	CompletionStage.thenComposeAsync(Function<? super T,? extends CompletionStage<U>> fn) このステージが正常に完了したときに、このステージを指定された関数への引数に設定し、このステージのデフォルトの非同期実行機能を使用して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.thenComposeAsync(Function<? super T,? extends CompletionStage<U>> fn)
<U> CompletionStage<U>	CompletionStage.thenComposeAsync(Function<? super T,? extends CompletionStage<U>> fn, Executor executor) このステージが正常に完了したときに、このステージの結果を指定された関数への引数に設定し、指定されたエグゼキュータを使用して実行される新しいCompletionStageを返します。
<U> CompletableFuture<U>	CompletableFuture.thenComposeAsync(Function<? super T,? extends CompletionStage<U>> fn, Executor executor)

java.util.functionでのFunctionの使用

java.util.functionでのFunctionのサブインタフェース

修飾子と型	インタフェースと説明
interface	UnaryOperator<T> 単一のオペランドに作用してオペランドと同じ型の結果を生成する演算を表します。

Functionを返すjava.util.functionのメソッド

修飾子と型	メソッドと説明
default <V> Function<T,V>	Function.andThen(Function<? super R,? extends V> after) まず入力にこの関数を適用し、次に結果に関数afterを適用する合成関数を返します。
default <V> Function<V,R>	Function.compose(Function<? super V,? extends T> before) まず入力に関数beforeを適用し、次に結果にこの関数を適用する合成関数を返します。
static <T> Function<T,T>	Function.identity() 常に入力引数を返す関数を返します。

Function型のパラメータを持つjava.util.functionのメソッド

修飾子と型	メソッドと説明
default <V> Function<T,V>	Function.andThen(Function<? super R,? extends V> after) まず入力にこの関数を適用し、次に結果に関数afterを適用する合成関数を返します。
default <V> BiFunction<T,U,V>	BiFunction.andThen(Function<? super R,? extends V> after) まず入力にこの関数を適用し、次に結果に関数afterを適用する合成関数を返します。
default <V> Function<V,R>	Function.compose(Function<? super V,? extends T> before) まず入力に関数beforeを適用し、次に結果にこの関数を適用する合成関数を返します。

java.util.streamでのFunctionの使用

Functionを返すjava.util.streamのメソッド

修飾子と型	メソッドと説明
Function<A,R>	Collector.finisher() 中間蓄積の型Aから最終結果の型Rへの最終的な変換を実行します。

Function型のパラメータを持つjava.util.streamのメソッド

修飾子と型	メソッドと説明
static <T,A,R,RR> Collector<T,A,RR>	Collectors.collectingAndThen(Collector<T,A,R> downstream, Function<R,RR> finisher) 追加の仕上げ変換が実行されるようにCollectorを適応させます。
<R> Stream<R>	Stream.flatMap(Function<? super T,? extends Stream<? extends R>> mapper) このストリームの各要素をマップされたストリーム(指定されたマッピング関数を各要素に適用することで得られる)の内容で置き換えた結果から成るストリームを返します。
DoubleStream	Stream.flatMapToDouble(Function<? super T,? extends DoubleStream> mapper) このストリームの各要素を、その要素に指定されたマッピング関数を適用することによって生成されるマップ先ストリームの内容で置き換えた結果から構成されるDoubleStreamを返します。
IntStream	Stream.flatMapToInt(Function<? super T,? extends IntStream> mapper) このストリームの各要素をマップされたストリーム(指定されたマッピング関数を各要素に適用することで得られる)の内容で置き換えた結果から成るIntStreamを返します。
LongStream	Stream.flatMapToLong(Function<? super T,? extends LongStream> mapper) このストリームの各要素をマップされたストリーム(指定されたマッピング関数を各要素に適用することで得られる)の内容で置き換えた結果から成るLongStreamを返します。
static <T,K> Collector<T,?,Map<K,List<T>>>	Collectors.groupingBy(Function<? super T,? extends K> classifier) 分類関数に従って要素をグループ化し、結果をMapに格納して返す、T型の入力要素に対する「グループ化」操作を実装したCollectorを返します。
static <T,K,A,D> Collector<T,?,Map<K,D>>	Collectors.groupingBy(Function<? super T,? extends K> classifier, Collector<? super T,A,D> downstream) 分類関数に従って要素をグループ化した後、指定された下流Collectorを使って特定のキーに関連付けられた値のリダクション操作を実行する、T型の入力要素に対するカスケード「グループ化」操作を実装したCollectorを返します。
static <T,K,D,A,M extends Map<K,D>> Collector<T,?,M>	Collectors.groupingBy(Function<? super T,? extends K> classifier, Supplier<M> mapFactory, Collector<? super T,A,D> downstream) 分類関数に従って要素をグループ化した後、指定された下流Collectorを使って特定のキーに関連付けられた値のリダクション操作を実行する、T型の入力要素に対するカスケード「グループ化」操作を実装したCollectorを返します。
static <T,K> Collector<T,?,ConcurrentMap<K,List<T>>>	Collectors.groupingByConcurrent(Function<? super T,? extends K> classifier) 分類関数に従って要素をグループ化する、T型の入力要素に対する「グループ化」操作を実装した並行Collectorを返します。
static <T,K,A,D> Collector<T,?,ConcurrentMap<K,D>>	Collectors.groupingByConcurrent(Function<? super T,? extends K> classifier, Collector<? super T,A,D> downstream) 分類関数に従って要素をグループ化した後、指定された下流Collectorを使って特定のキーに関連付けられた値のリダクション操作を実行する、T型の入力要素に対するカスケード「グループ化」操作を実装した並行Collectorを返します。
static <T,K,A,D,M extends ConcurrentMap<K,D>> Collector<T,?,M>	Collectors.groupingByConcurrent(Function<? super T,? extends K> classifier, Supplier<M> mapFactory, Collector<? super T,A,D> downstream) 分類関数に従って要素をグループ化した後、指定された下流Collectorを使って特定のキーに関連付けられた値のリダクション操作を実行する、T型の入力要素に対するカスケード「グループ化」操作を実装した並行Collectorを返します。
<R> Stream<R>	Stream.map(Function<? super T,? extends R> mapper) このストリームの要素に指定された関数を適用した結果から構成されるストリームを返します。
static <T,U,A,R> Collector<T,?,R>	Collectors.mapping(Function<? super T,? extends U> mapper, Collector<? super U,A,R> downstream) U型の要素を受け取るCollectorがT型の要素を受け取れるように適応させるため、各入力要素にマッピング関数を適用した後で蓄積を行うようにします。
static <T,A,R> Collector<T,A,R>	Collector.of(Supplier<A> supplier, BiConsumer<A,T> accumulator, BinaryOperator<A> combiner, Function<A,R> finisher, Collector.Characteristics... characteristics) 指定されたsupplier、accumulator、combiner、およびfinisher関数で記述される新しいCollectorを返します。
static <T,U> Collector<T,?,U>	Collectors.reducing(U identity, Function<? super T,? extends U> mapper, BinaryOperator<U> op) 指定されたマッピング関数とBinaryOperatorの下で入力要素のリダクションを実行するCollectorを返します。
static <T,K,U> Collector<T,?,ConcurrentMap<K,U>>	Collectors.toConcurrentMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper) ConcurrentMap内に要素を累積する並行Collectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,ConcurrentMap<K,U>>	Collectors.toConcurrentMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper) ConcurrentMap内に要素を累積する並行Collectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,ConcurrentMap<K,U>>	Collectors.toConcurrentMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction) ConcurrentMap内に要素を累積する並行Collectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,ConcurrentMap<K,U>>	Collectors.toConcurrentMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction) ConcurrentMap内に要素を累積する並行Collectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U,M extends ConcurrentMap<K,U>> Collector<T,?,M>	Collectors.toConcurrentMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction, Supplier<M> mapSupplier) ConcurrentMap内に要素を累積する並行Collectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U,M extends ConcurrentMap<K,U>> Collector<T,?,M>	Collectors.toConcurrentMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction, Supplier<M> mapSupplier) ConcurrentMap内に要素を累積する並行Collectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,Map<K,U>>	Collectors.toMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper) Map内に要素を累積するCollectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,Map<K,U>>	Collectors.toMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper) Map内に要素を累積するCollectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,Map<K,U>>	Collectors.toMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction) Map内に要素を累積するCollectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U> Collector<T,?,Map<K,U>>	Collectors.toMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction) Map内に要素を累積するCollectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U,M extends Map<K,U>> Collector<T,?,M>	Collectors.toMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction, Supplier<M> mapSupplier) Map内に要素を累積するCollectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。
static <T,K,U,M extends Map<K,U>> Collector<T,?,M>	Collectors.toMap(Function<? super T,? extends K> keyMapper, Function<? super T,? extends U> valueMapper, BinaryOperator<U> mergeFunction, Supplier<M> mapSupplier) Map内に要素を累積するCollectorを返します(指定されたマッピング関数を入力要素に適用した結果が、マップのキーと値になる)。