类的用途
java.util.Optional

使用 Optional 的包

包	描述
java.lang	提供对 Java 编程语言的设计至关重要的类。
java.lang.constant	代表 nominal descriptors 运行时实体（例如类或方法句柄）和类文件实体（例如常量池条目或 invokedynamic 调用站点）的类和接口。
java.lang.foreign	提供对 Java 运行时之外的内存和函数的低级访问。
java.lang.invoke	java.lang.invoke 包提供用于与 Java 虚拟机交互的低级原语。
java.lang.module	通过解析和服务绑定支持模块描述符和创建模块配置的类。
java.net	提供用于实现网络应用程序的类。
java.net.http	HTTP 客户端和 WebSocket API
java.security.interfaces	提供用于生成 RSA（Rivest、Shamir 和 Adleman AsymmetricCipher 算法）密钥的接口，如 RSA 实验室技术说明 PKCS#1 中所定义，以及 DSA（数字签名算法）密钥，如 NIST 的 FIPS-186 中所定义。
java.security.spec	提供关键规范和算法参数规范的类和接口。
java.util	包含集合框架、一些国际化支持类、服务加载器、属性、随机数生成、字符串解析和扫描类、base64 编码和解码、位数组和几个杂项实用程序类。
java.util.spi	java.util 包中类的服务提供者类。
java.util.stream	支持对元素流进行函数式操作的类，例如对集合的 map-reduce 转换。
javax.naming.ldap.spi
javax.net.ssl	为安全套接字包提供类。
jdk.incubator.concurrent	为并发编程定义非最终 API。

Optional 在 java.lang 中的用法

java.lang 中返回 Optional 的方法

修饰符和类型	方法	描述
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 包含此实例的标称描述符，即实例本身。
final 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()	返回可选的 预发布 信息。
Optional<Instant>	ProcessHandle.Info.startInstant()	返回进程的开始时间。
Optional<Duration>	ProcessHandle.Info.totalCpuDuration()	返回进程累积的总 cputime。
Optional<String>	ProcessHandle.Info.user()	返回进程的用户。

Optional 在 java.lang.constant 中的用法

java.lang.constant 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<? extends ConstantDesc>	Constable.describeConstable()	如果可以构造，则返回包含此实例的标称描述符的 Optional ，如果无法构造，则返回空的 Optional 。

Optional 在 java.lang.foreign 中的用法

java.lang.foreign 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<Object>	MemorySegment.array()	返回与此内存段关联的 Java 数组（如果有）。
Optional<MemorySegmentPREVIEW>	MemorySegment.asOverlappingSlice(MemorySegmentPREVIEW other)	返回此片段的一部分，该片段是此片段与提供的片段之间的重叠部分。
Optional<MemorySegmentPREVIEW>	SymbolLookup.find(String name)	返回具有给定名称的符号的地址。
Optional<String>	MemoryLayout.name()	返回与此布局关联的名称（如果有）。
Optional<MemoryLayoutPREVIEW>	FunctionDescriptor.returnLayout()	返回与此函数描述符关联的返回布局（如果有）。

Optional 在 java.lang.invoke 中的用法

java.lang.invoke 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<MethodHandleDesc>	MethodHandle.describeConstable()	如果可以构造，则返回此实例的标称描述符，如果不能构造，则返回一个空的Optional 。
Optional<MethodTypeDesc>	MethodType.describeConstable()	如果可以构造，则返回此实例的标称描述符，如果不能构造，则返回一个空的 Optional 。
Optional<VarHandle.VarHandleDesc>	VarHandle.describeConstable()	如果可以构造，则返回此实例的标称描述符，如果不能构造，则返回一个空的Optional 。

Optional 在 java.lang.module 中的用法

java.lang.module 中返回 Optional 的方法

修饰符和类型	方法	描述
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 配置。
final 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()	返回模块版本。

Optional 在 java.net 中的用法

java.net 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<SSLSession>	SecureCacheResponse.getSSLSession()	返回一个 Optional 包含在检索网络资源的原始连接上使用的 SSLSession。

Optional 在 java.net.http 中的用法

java.net.http 中返回 Optional 的方法

修饰符和类型	方法	描述
abstract Optional<Authenticator>	HttpClient.authenticator()	返回包含此客户端上的 Authenticator 集的 Optional。
abstract Optional<HttpRequest.BodyPublisher>	HttpRequest.bodyPublisher()	返回一个 Optional，其中包含在此请求上设置的 HttpRequest.BodyPublisher 。
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()	返回一个 Optional 包含将为此 HttpRequest 请求的 HTTP 协议版本。

java.net.http 中的方法参数，类型参数为 Optional

修饰符和类型	方法	描述
static HttpResponse.BodyHandler<Void>	HttpResponse.BodyHandlers.ofByteArrayConsumer(Consumer<Optional<byte[]>> consumer)	返回一个 BodyHandler<Void>，它返回一个从 BodySubscribers.ofByteArrayConsumer(Consumer) 获得的 BodySubscriber <Void>。
static HttpResponse.BodySubscriber<Void>	HttpResponse.BodySubscribers.ofByteArrayConsumer(Consumer<Optional<byte[]>> consumer)	返回一个 BodySubscriber，它将传入的正文数据提供给 Optional<byte[]> 的消费者。

Optional 在 java.security.interfaces 中的用法

java.security.interfaces 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<byte[]>	EdECPrivateKey.getBytes()	获取表示私钥的字节数组的副本。
Optional<byte[]>	XECPrivateKey.getScalar()	获取编码为未修剪字节数组的标量值。

Optional 在 java.security.spec 中的用法

java.security.spec 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<byte[]>	EdDSAParameterSpec.getContext()	获取签名将使用的上下文。

Optional 在 java.util 中的用法

java.util 中返回 Optional 的方法

修饰符和类型	方法	描述
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 方位映射函数应用于该值的结果，否则返回空的 Optional 。
<U> Optional<U>	Optional.map(Function<? super T,? extends U> mapper)	如果存在值，则返回一个 Optional 描述（如同通过 ofNullable(T) ）将给定映射函数应用于该值的结果，否则返回一个空的 Optional 。
static <T> Optional<T>	Optional.of(T value)	返回一个 Optional 描述给定的非 null 值。
static <T> Optional<T>	Optional.ofNullable(T value)	返回一个 Optional 描述给定值，如果非 null ，否则返回一个空的 Optional 。
Optional<T>	Optional.or(Supplier<? extends Optional<? extends T>> supplier)	如果存在值，则返回描述该值的 Optional，否则返回由提供函数生成的 Optional。

java.util 中的方法参数，类型参数为 Optional

修饰符和类型	方法	描述
<U> Optional<U>	Optional.flatMap(Function<? super T,? extends Optional<? extends U>> mapper)	如果存在值，则返回将给定的 Optional 方位映射函数应用于该值的结果，否则返回空的 Optional 。
Optional<T>	Optional.or(Supplier<? extends Optional<? extends T>> supplier)	如果存在值，则返回描述该值的 Optional，否则返回由提供函数生成的 Optional。

Optional 在 java.util.spi 中的用法

java.util.spi 中返回 Optional 的方法

修饰符和类型	方法	描述
default Optional<String>	ToolProvider.description()	返回工具的简短描述，如果没有可用描述，则返回空的 Optional。
static Optional<ToolProvider>	ToolProvider.findFirst(String name)	返回具有给定名称的 ToolProvider 的第一个实例，由 ServiceLoader 使用系统类加载器加载。

Optional 在 java.util.stream 中的用法

java.util.stream 中返回 Optional 的方法

修饰符和类型	方法	描述
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 生成最大元素的 Collector，描述为 Optional<T>。
static <T> Collector<T,?,Optional<T>>	Collectors.minBy(Comparator<? super T> comparator)	返回根据给定的 Comparator 生成最小元素的 Collector，描述为 Optional<T>。
static <T> Collector<T,?,Optional<T>>	Collectors.reducing(BinaryOperator<T> op)	返回一个 Collector，它在指定的 BinaryOperator 下执行其输入元素的缩减。

Optional 在 javax.naming.ldap.spi 中的用法

javax.naming.ldap.spi 中返回 Optional 的方法

修饰符和类型	方法	描述
abstract Optional<LdapDnsProviderResult>	LdapDnsProvider.lookupEndpoints(String url, Map<?,?> env)	查找给定 Context provider URL 和环境的端点和域名。

Optional 在 javax.net.ssl 中的用法

javax.net.ssl 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<SSLSession>	HttpsURLConnection.getSSLSession()	返回一个 Optional ，其中包含在此连接上使用的 SSLSession。

Optional 在 jdk.incubator.concurrent 中的用法

jdk.incubator.concurrent 中返回 Optional 的方法

修饰符和类型	方法	描述
Optional<Throwable>	StructuredTaskScope.ShutdownOnFailure.exception()	返回以异常完成的第一个子任务的异常。