compact1, compact2, compact3

java.util

Class OptionalLong

java.lang.Object

java.util.OptionalLong

public final class OptionalLong
extends Object

一个容器对象可能包含或不包含一个 long价值。如果一个值是存在的， isPresent()将返回 true和 getAsLong()将返回值。

提供了更多的方法，取决于一个有价值的存在或不存在，如orElse()（如果值不存在返回一个默认值）和ifPresent()（如果值为当前执行的代码块）。

这是一个value-based类；利用身份敏感的操作（包括引用相等（==），身份的哈希代码，或同步）的实例OptionalLong可能有不可预知的结果应该是可以避免的。

从以下版本开始：

一点八

方法摘要

Modifier and Type	Method and Description
static OptionalLong	empty() 返回一个空 OptionalLong实例。
boolean	equals(Object obj) 指示是否一些其他的对象是“平等”这optionallong。
long	getAsLong() 如果一个值是在这 OptionalLong，返回值，否则将 NoSuchElementException。
int	hashCode() 返回当前值的哈希代码值，如果有的话，或0（0），如果没有价值。
void	ifPresent(LongConsumer consumer) 如果一个值存在，则指定的消费者接受该值，否则什么也不做。
boolean	isPresent() 如果有一个价值回归 true，否则 false。
static OptionalLong	of(long value) 返回当前指定的值 OptionalLong。
long	orElse(long other) 如果目前的返回值，否则返回 other。
long	orElseGet(LongSupplier other) 如果目前的返回值，否则调用 other并返回调用结果的。
<X extends Throwable> long	orElseThrow(Supplier<X> exceptionSupplier) 返回所包含的值，如果存在的话，否则抛出一个由提供的供应商创建的异常。
String	toString() 返回对象的字符串表示形式。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

方法详细信息

empty

public static OptionalLong empty()

返回一个空 OptionalLong实例。没有价值是目前这种optionallong。

API Note:

虽然它可能是诱人的这样做，避免测试对象是否通过对实例的对比 ==空返回 Option.empty()。没有保证它是一个单身。相反，使用 isPresent()。

结果

一个空的 OptionalLong。

of

public static OptionalLong of(long value)

返回当前指定的值 OptionalLong。

参数

value -存在的价值

结果

随着价值提出了一个 OptionalLong

getAsLong

public long getAsLong()

如果一个值是在这 OptionalLong，返回值，否则将 NoSuchElementException。

结果

这 OptionalLong持有价值

异常

NoSuchElementException -如果没有存在价值

另请参见：

isPresent()

isPresent

public boolean isPresent()

如果有一个价值回归 true，否则 false。

结果

true如果有存在价值，否则 false

ifPresent

public void ifPresent(LongConsumer consumer)

如果一个值存在，则指定的消费者接受该值，否则什么也不做。

参数

consumer块被执行，如果一个值是否存在

异常

NullPointerException如果值是当前和 consumer是空的

orElse

public long orElse(long other)

如果目前的返回值，否则返回 other。

参数

other -是没有存在价值的返回值

结果

的值，如果存在，否则 other

orElseGet

public long orElseGet(LongSupplier other)

如果目前的返回值，否则调用 other并返回调用结果的。

参数

other - LongSupplier其结果返回如果没有价值存在

结果

如果存在其他的价值 other.getAsLong()结果

异常

NullPointerException如果值不存在， other是空的

orElseThrow

public <X extends Throwable> long orElseThrow(Supplier<X> exceptionSupplier)
                                       throws X extends Throwable

返回所包含的值，如果存在的话，否则抛出一个由提供的供应商创建的异常。

API Note:

一个空参数列表的异常构造函数的方法引用，可以作为供应商使用。例如， IllegalStateException::new

参数类型

X -被抛出的异常类型

参数

exceptionSupplier -供应商将被抛出的异常

结果

目前的价值

异常

X -如果没有存在价值

NullPointerException -如果没有价值存在， exceptionSupplier是空的

X extends Throwable

equals

public boolean equals(Object obj)

指示是否一些其他的对象是“平等”这optionallong。其他的对象是相同的：如果

• 这也是一个OptionalLong和；
• 这两个实例都没有值存在或；
• 目前的价值观是“等于”彼此通过==。

重写：

equals 方法重写，继承类 Object

参数

obj对象进行平等

结果

{代码}如果真的其他对象是“等于”这个对象，否则 false

另请参见：

Object.hashCode()， HashMap

hashCode

public int hashCode()

返回当前值的哈希代码值，如果有的话，或0（0），如果没有价值。

重写：

hashCode 方法重写，继承类 Object

结果

如果没有值，则本值或0的哈希代码值

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

toString

public String toString()

返回对象的字符串表示形式。总的来说，这 toString方法返回一个字符串，“以文本方式表示”这个对象。其结果应该是一个简洁，但翔实的代表性，是一个容易阅读的人。建议所有子类都重写此方法。

Object类的toString方法返回一个包含该类的对象是一个实例的名称字符串的符号` @ '，和符号进制表示的对象的哈希码。换句话说，此方法返回一个等于值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

返回一个非空的字符串表示此对象适合调试。确切的演示文稿格式是未知的，可能会在实现和版本之间有所不同。

重写：

toString 方法重写，继承类 Object

实现要求：

如果一个值存在，则结果必须包括其结果中的字符串表示形式。空和现在的情况下，必须明确可微。

结果

此实例的字符串表示形式