クラスjava.util.Optionalの使用 (Java SE 15 & JDK 15)

Optionalを使用しているパッケージ
パッケージ	説明
java.lang	Javaプログラミング言語の設計にあたり基本的なクラスを提供します。
java.lang.constant	クラスやメソッド・ハンドルなどのランタイム・エンティティ用に「名目記述子」を表すクラスおよびインタフェース、および定数プール・エントリや`invokedynamic`コール・サイトなどのクラス・ファイル・エンティティ用に「名目記述子」を表すクラスおよびインタフェース。
java.lang.invoke	`java.lang.invoke`パッケージは、Java Virtual Machineとやりとりするための低レベルのプリミティブを提供します。
java.lang.module	モジュール記述子をサポートし、解決とサービス・バインディングによってモジュールの構成を作成するクラス。
java.net	ネットワーク・アプリケーションを実装するためのクラスを提供します。
java.net.http	HTTPクライアントおよびWebSocket API
java.security.interfaces	RSA Laboratory Technical Note PKCS#1で定義されているRSA (Rivest, Shamir and Adleman AsymmetricCipher algorithm)キーと、NISTのFIPS-186で定義されているDSA (Digital Signature Algorithm)キーを生成するためのインタフェースを提供します。
java.security.spec	キー仕様およびアルゴリズム・パラメータ仕様のクラスおよびインタフェースを提供します。
java.util	コレクション・フレームワーク、国際化サポート・クラス、サービス・ローダー、プロパティ、乱数生成、文字列解析とスキャン・クラス、Base64エンコーディングとデコード、ビット配列、およびその他のユーティリティ・クラスが含まれています。
java.util.spi	java.utilパッケージに含まれているクラスのサービス・プロバイダ・クラスです。
java.util.stream	コレクションに対するマップ-リデュース変換など、要素のストリームに対する関数型の操作をサポートするクラスです。
javax.naming.ldap.spi
javax.net.ssl	セキュア・ソケット・パッケージのクラスを提供します。
jdk.incubator.foreign	下位レベルの安全かつ効率的なメモリー・アクセスをサポートするクラスです。

java.langでのOptionalの使用

オプションを返すjava.langのメソッド
修飾子と型	メソッド	説明
`Optional<String[]>`	ProcessHandle.Info.`arguments()`	プロセスの引数の文字列の配列を返します。
`Optional<Integer>`	Runtime.Version.`build()`	「ビルド番号」を返します。
`Optional<String>`	ProcessHandle.Info.`command()`	プロセスの実行可能パス名を返します。
`Optional<String>`	ProcessHandle.Info.`commandLine()`	プロセスのコマンドラインを返します。
`Optional<DynamicConstantDesc<Boolean>>`	Boolean.`describeConstable()`	このインスタンスの名目記述子を含む`Optional`を返します。
`Optional<DynamicConstantDesc<Byte>>`	Byte.`describeConstable()`	このインスタンスの名目記述子を含む`Optional`を返します。
`Optional<DynamicConstantDesc<Character>>`	Character.`describeConstable()`	このインスタンスの名目記述子を含む`Optional`を返します。
`Optional<ClassDesc>`	Class.`describeConstable()`	このインスタンスの名目記述子を返します(作成可能な場合)、作成できない場合は空の`Optional`を返します。
`Optional<Double>`	Double.`describeConstable()`	このインスタンス自体の名目記述子を含む`Optional`を返します。
`Optional<Enum.EnumDesc<E>>`	Enum.`describeConstable()`	このインスタンスの列挙型記述子`EnumDesc`を返します(作成可能な場合)。作成できない場合は空の`Optional`を返します。
`Optional<Float>`	Float.`describeConstable()`	このインスタンス自体の名目記述子を含む`Optional`を返します。
`Optional<Integer>`	Integer.`describeConstable()`	このインスタンス自体の名目記述子を含む`Optional`を返します。
`Optional<Long>`	Long.`describeConstable()`	このインスタンス自体の名目記述子を含む`Optional`を返します。
`Optional<DynamicConstantDesc<Short>>`	Short.`describeConstable()`	このインスタンスの名目記述子を含む`Optional`を返します。
`Optional<String>`	String.`describeConstable()`	このインスタンス自体の名目記述子を含む`Optional`を返します。
`Optional<Module>`	ModuleLayer.`findModule(String name)`	このレイヤー内に指定された名前のモジュールを返します。このレイヤー内にない場合は、parentレイヤーを返します。
`static Optional<ProcessHandle>`	ProcessHandle.`of(long pid)`	既存のネイティブ・プロセスの`Optional<ProcessHandle>`を返します。
`Optional<String>`	Runtime.Version.`optional()`	追加のビルド情報を識別するoptionalを返します。
`Optional<ProcessHandle>`	ProcessHandle.`parent()`	親プロセス用の`Optional<ProcessHandle>`を返します。
`Optional<String>`	Runtime.Version.`pre()`	オプションのpre-release情報を返します。
`Optional<Instant>`	ProcessHandle.Info.`startInstant()`	プロセスの開始時間を返します。
`Optional<Duration>`	ProcessHandle.Info.`totalCpuDuration()`	プロセスの合計cputimeを返します。
`Optional<String>`	ProcessHandle.Info.`user()`	プロセスのユーザーを返します。

java.lang.constantでのOptionalの使用

オプションを返すjava.lang.constantのメソッド
修飾子と型	メソッド	説明
`Optional<? extends ConstantDesc>`	Constable.`describeConstable()`	このインスタンスの名目記述子を含む`Optional`を返します(作成可能な場合)、作成できない場合は空の`Optional`を返します。

java.lang.invokeでのOptionalの使用

オプションを返すjava.lang.invokeのメソッド
修飾子と型	メソッド	説明
`Optional<MethodHandleDesc>`	MethodHandle.`describeConstable()`	このインスタンスの名目記述子を返します(作成可能な場合)、作成できない場合は空の`Optional`を返します。
`Optional<MethodTypeDesc>`	MethodType.`describeConstable()`	このインスタンスの名目記述子を返します(作成可能な場合)、作成できない場合は空の`Optional`を返します。
`Optional<VarHandle.VarHandleDesc>`	VarHandle.`describeConstable()`	このインスタンスの名目記述子を返します(作成可能な場合)、作成できない場合は空の`Optional`を返します。

java.lang.moduleでのOptionalの使用

オプションを返すjava.lang.moduleのメソッド
修飾子と型	メソッド	説明
`Optional<ModuleDescriptor.Version>`	ModuleDescriptor.Requires.`compiledVersion()`	コンパイル時に記録されている場合、モジュールのバージョンを返します。
`Optional<ModuleReference>`	ModuleFinder.`find(String name)`	指定された名前のモジュールへの参照を検索します。
`Optional<URI>`	ModuleReader.`find(String name)`	リソースを検索し、モジュール内のリソースにURIを返します。
`Optional<ResolvedModule>`	Configuration.`findModule(String name)`	この構成で解決されたモジュールを検索するか、この構成でない場合はparent構成を検索します。
`Optional<URI>`	ModuleReference.`location()`	認識されている場合は、このモジュール・コンテンツのロケーションを返します。
`Optional<String>`	ModuleDescriptor.`mainClass()`	モジュール・メイン・クラスを返します。
`default Optional<InputStream>`	ModuleReader.`open(String name)`	リソースをオープンし、モジュール内のリソースを読み取る入力ストリームを返します。
`Optional<String>`	ModuleDescriptor.Requires.`rawCompiledVersion()`	コンパイル時に記録されている場合は、解析できないバージョンのモジュールを含む文字列を返します。
`Optional<String>`	ModuleDescriptor.`rawVersion()`	おそらく解析不能なバージョンのモジュールを含む文字列を返します。
`default Optional<ByteBuffer>`	ModuleReader.`read(String name)`	リソースを読み込み、リソースの内容を含むバイト・バッファを返します。
`Optional<ModuleDescriptor.Version>`	ModuleDescriptor.`version()`	モジュールのバージョンを返します。

java.netでのOptionalの使用

オプションを返すjava.netのメソッド
修飾子と型	メソッド	説明
`Optional<SSLSession>`	SecureCacheResponse.`getSSLSession()`	ネットワーク・リソースを取得した元の接続で使用中の`SSLSession`を含む`Optional`を返します。

java.net.httpでのOptionalの使用

オプションを返すjava.net.httpのメソッド
修飾子と型	メソッド	説明
`abstract Optional<Authenticator>`	HttpClient.`authenticator()`	このクライアントに設定された`Authenticator`を含む`Optional`を返します。
`abstract Optional<HttpRequest.BodyPublisher>`	HttpRequest.`bodyPublisher()`	このリクエストで設定された`HttpRequest.BodyPublisher`を含む`Optional`を返します。
`abstract Optional<Duration>`	HttpClient.`connectTimeout()`	このクライアントの「接続タイムアウト時間」を含む`Optional`を返します。
`abstract Optional<CookieHandler>`	HttpClient.`cookieHandler()`	このクライアント`CookieHandler`を含む`Optional`を返します。
`abstract Optional<Executor>`	HttpClient.`executor()`	このクライアント`Executor`を含む`Optional`を返します。
`Optional<String>`	HttpHeaders.`firstValue(String name)`	指定された(おそらく多値)ヘッダーの最初のヘッダー文字列値を含む`Optional`を返します。
`Optional<HttpResponse<T>>`	HttpResponse.`previousResponse()`	以前の中間レスポンスを受信した場合はそれを含む`Optional`を返します。
`abstract Optional<ProxySelector>`	HttpClient.`proxy()`	このクライアントに提供された`ProxySelector`を含む`Optional`を返します。
`Optional<SSLSession>`	HttpResponse.`sslSession()`	このレスポンスに有効な`SSLSession`を含む`Optional`を返します。
`abstract Optional<Duration>`	HttpRequest.`timeout()`	このリクエスト・タイムアウト期間を含む`Optional`を返します。
`abstract Optional<HttpClient.Version>`	HttpRequest.`version()`	この`HttpRequest`にリクエストされるHTTPプロトコル・バージョンを含む`Optional`を返します。

型オプションの型引数を持つjava.net.httpのメソッド・パラメータ
修飾子と型	メソッド	説明
`static HttpResponse.BodyHandler<Void>`	HttpResponse.BodyHandlers.`ofByteArrayConsumer(Consumer<Optional<byte[]>> consumer)`	`BodySubscribers.ofByteArrayConsumer(Consumer)`から取得された`BodySubscriber<Void>`を返す`BodyHandler<Void>`を返します。
`static HttpResponse.BodySubscriber<Void>`	HttpResponse.BodySubscribers.`ofByteArrayConsumer(Consumer<Optional<byte[]>> consumer)`	提供された`Optional<byte[]>`のコンシューマに着信する本文データを提供する`BodySubscriber`を返します。

java.security.interfacesでのOptionalの使用

オプションを返すjava.security.interfacesのメソッド
修飾子と型	メソッド	説明
`Optional<byte[]>`	EdECPrivateKey.`getBytes()`	秘密キーを表すバイト配列のコピーを取得します。
`Optional<byte[]>`	XECPrivateKey.`getScalar()`	非実行バイト配列としてエンコードされたスカラー値を取得します。

java.security.specでの「オプション」の使用

オプションを返すjava.security.specのメソッド
修飾子と型	メソッド	説明
`Optional<byte[]>`	EdDSAParameterSpec.`getContext()`	シグネチャが使用するコンテキストを取得します。

java.utilでのOptionalの使用

Optionalを返すjava.utilのメソッド
修飾子と型	メソッド	説明
`static <T> Optional<T>`	Optional.`empty()`	空の`Optional`インスタンスを返します。
`Optional<T>`	Optional.`filter(Predicate<? super T> predicate)`	値が存在し、その値が与えられた述語に一致する場合は、値を記述する`Optional`を返し、それ以外の場合は空の`Optional`を返します。
`Optional<S>`	ServiceLoader.`findFirst()`	このローダーのサービスの最初に使用可能なサービス・プロバイダをロードします。
`<U> Optional<U>`	Optional.`flatMap(Function<? super T,? extends Optional<? extends U>> mapper)`	値が存在する場合、指定された`Optional`-bearingマッピング関数を値に適用した結果を返します。それ以外の場合は空の`Optional`を返します。
`<U> Optional<U>`	Optional.`map(Function<? super T,? extends U> mapper)`	値が存在する場合は、与えられたマッピング関数をその値に適用した結果を(`ofNullable(T)`のように)記述する`Optional`を返します。それ以外の場合は、空の`Optional`を返します。
`static <T> Optional<T>`	Optional.`of(T value)`	指定された非`null`値を記述する`Optional`を返します。
`static <T> Optional<T>`	Optional.`ofNullable(T value)`	非`null`ならば、指定された値を記述する`Optional`を返し、それ以外の場合は空の`Optional`を返します。
`Optional<T>`	Optional.`or(Supplier<? extends Optional<? extends T>> supplier)`	値が存在する場合は値を記述する`Optional`を返し、そうでない場合は供給関数によって生成された`Optional`を返します。

Optional型の型引数を持つjava.utilのメソッドパラメータ
修飾子と型	メソッド	説明
`<U> Optional<U>`	Optional.`flatMap(Function<? super T,? extends Optional<? extends U>> mapper)`	値が存在する場合、指定された`Optional`-bearingマッピング関数を値に適用した結果を返します。それ以外の場合は空の`Optional`を返します。
`Optional<T>`	Optional.`or(Supplier<? extends Optional<? extends T>> supplier)`	値が存在する場合は値を記述する`Optional`を返し、そうでない場合は供給関数によって生成された`Optional`を返します。

java.util.spiでのOptionalの使用

オプションを返すjava.util.spiのメソッド
修飾子と型	メソッド	説明
`static Optional<ToolProvider>`	ToolProvider.`findFirst(String name)`	指定された名前を持つ`ToolProvider`の最初のインスタンスを返します。システム・クラス・ローダーを使用して`ServiceLoader`によってロードされます。

java.util.streamでのOptionalの使用

Optionalを返すjava.util.streamのメソッド
修飾子と型	メソッド	説明
`Optional<T>`	Stream.`findAny()`	ストリームの一部の要素を記述する`Optional`を返します。ストリームが空の場合は空の`Optional`を返します。
`Optional<T>`	Stream.`findFirst()`	このストリームの最初の要素を記述する`Optional`を返します。ストリームが空の場合は空の`Optional`を返します。
`Optional<T>`	Stream.`max(Comparator<? super T> comparator)`	指定された`Comparator`に従ってこのストリームの最大要素を返します。
`Optional<T>`	Stream.`min(Comparator<? super T> comparator)`	指定された`Comparator`に従ってこのストリームの最小要素を返します。
`Optional<T>`	Stream.`reduce(BinaryOperator<T> accumulator)`	結合的累積関数を使用して、このストリームの要素に対してリダクションを実行し、リダクションされた値を記述する`Optional`を返します(ある場合)。

Optional型の引数を持つ型を返すjava.util.streamのメソッド
修飾子と型	メソッド	説明
`static <T> Collector<T,?,Optional<T>>`	Collectors.`maxBy(Comparator<? super T> comparator)`	指定された`Comparator`に従って`Optional<T>`として記述された最大要素を生成する`Collector`を返します。
`static <T> Collector<T,?,Optional<T>>`	Collectors.`minBy(Comparator<? super T> comparator)`	指定された`Comparator`に従って`Optional<T>`として記述された最小要素を生成する`Collector`を返します。
`static <T> Collector<T,?,Optional<T>>`	Collectors.`reducing(BinaryOperator<T> op)`	指定された`BinaryOperator`の下で入力要素のリダクションを実行する`Collector`を返します。

javax.naming.ldap.spiでのOptionalの使用

オプションを返すjavax.naming.ldap.spiのメソッド
修飾子と型	メソッド	説明
`abstract Optional<LdapDnsProviderResult>`	LdapDnsProvider.`lookupEndpoints(String url, Map<?,?> env)`	指定された`Context` `provider URL`および環境のエンドポイントとドメイン名をルックアップします。

javax.net.sslでのOptionalの使用

オプションを返すjavax.net.sslのメソッド
修飾子と型	メソッド	説明
`Optional<SSLSession>`	HttpsURLConnection.`getSSLSession()`	この接続で使用中の`SSLSession`を含む`Optional`を返します。

jdk.incubator.foreignでのOptionalの使用

オプションを返すjdk.incubator.foreignのメソッド
修飾子と型	メソッド	説明
`Optional<Constable>`	MemoryLayout.`attribute(String name)`	指定された名前の(それが存在する場合)の属性を返します。
`Optional<DynamicConstantDesc<GroupLayout>>`	GroupLayout.`describeConstable()`
`Optional<? extends DynamicConstantDesc<? extends MemoryLayout>>`	MemoryLayout.`describeConstable()`	このレイアウトの公称記述子を含む`Optional`(構成できる場合)または空の`Optional`(作成できない場合)を返します。
`Optional<DynamicConstantDesc<SequenceLayout>>`	SequenceLayout.`describeConstable()`
`Optional<DynamicConstantDesc<ValueLayout>>`	ValueLayout.`describeConstable()`
`Optional<String>`	MemoryLayout.`name()`	このレイアウトに関連するname (もしあれば)を返します。