compact1, compact2, compact3

java.util

Класс, Дополнительный <T>

java.lang. Объект

java.util. Дополнительный <T>

public final class Optional<T>
extends Object

Контейнерный объект, который может или, возможно, не содержит ненулевое значение. Если значение присутствует, isPresent() возвратится true и get() возвратит значение.

Дополнительные методы, которые зависят от присутствия или отсутствия содержавшего значения, обеспечиваются, такой как orElse() (возвратите значение по умолчанию если значение, не существующее), и ifPresent() (выполните блок кода, если значение присутствует).

С тех пор:

1.8

Сводка метода

Модификатор и Тип	Метод и Описание
static <T> Optional<T>	empty() Возвращает пустое Optional экземпляр.
boolean	equals(Object obj) Указывает, " ли некоторый другой объект равен" этому Дополнительному.
T	get() Если значение присутствует в этом Optional, возвращает значение, иначе бросает NoSuchElementException.
int	hashCode() Возвращает значение хэш-кода текущей стоимости, если таковые вообще имеются, или 0 (нуль), если никакое значение не присутствует.
void	ifPresent(Consumer<? super T> consumer) Сделайте, чтобы указанный потребитель принял значение, если значение присутствует, иначе ничего не сделайте.
boolean	isPresent() Возвратиться true если есть существующее значение, иначе false.
static <T> Optional<T>	of(T value) Возвратитесь Optional с указанной текущей стоимостью.
T	orElse(T other) Возвратите значение, если существующий, иначе возвратитесь other.
T	orElseGet(Supplier<? extends T> other) Возвратите значение, если существующий, иначе вызовите other и возвратите результат того вызова.
<X extends Throwable> T	orElseThrow(Supplier<? extends X> exceptionSupplier) Возвратите содержавшее значение, если есть иначе выдайте исключение, которое будет создаваться предоставленным поставщиком.
Строка	toString() Возвращает непустое строковое представление этого Дополнительного подходящий для того, чтобы отладить.

Методы, наследованные от class java.lang. Объект

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

Деталь метода

пустой

public static <T> Optional<T> empty()

Возвращает пустое Optional экземпляр. Никакое значение не присутствует для этого Дополнительного.

Примечание API:

Хотя может быть заманчиво сделать так, избежать тестировать, если объект пуст, сравниваясь с == против экземпляров, возвращенных Option.empty(). Нет никакой гарантии, что это - одиночный элемент. Вместо этого используйте isPresent().

Введите Параметры:

T - Тип несуществующего значения

Возвраты:

пустое Optional

из

public static <T> Optional<T> of(T value)

Возвратитесь Optional с указанной текущей стоимостью.

Параметры:

value - значение, чтобы присутствовать, который должен быть ненулем

Возвраты:

Optional с существующим значением

добраться

public T get()

Если значение присутствует в этом Optional, возвращает значение, иначе бросает NoSuchElementException.

Возвраты:

ненулевое значение сохранено этим Optional

Броски:

NoSuchElementException - если нет никакого существующего значения

См. Также:

isPresent()

isPresent

public boolean isPresent()

Возвратиться true если есть существующее значение, иначе false.

Возвраты:

true если есть существующее значение, иначе false

ifPresent

public void ifPresent(Consumer<? super T> consumer)

Сделайте, чтобы указанный потребитель принял значение, если значение присутствует, иначе ничего не сделайте.

Параметры:

consumer - блок, который будет выполнен, если значение присутствует

Броски:

NullPointerException - если значение присутствует и consumer нуль

orElse

public T orElse(T other)

Возвратите значение, если существующий, иначе возвратитесь other.

Параметры:

other - значение, которое будет возвращено, если нет никакого существующего значения, может быть нулем

Возвраты:

значение, если есть иначе other

orElseGet

public T orElseGet(Supplier<? extends T> other)

Возвратите значение, если существующий, иначе вызовите other и возвратите результат того вызова.

Параметры:

other - a Supplier чей результат возвращается, если никакое значение не присутствует

Возвраты:

значение, если существующий иначе результат other.get()

Броски:

NullPointerException - если значение не присутствует и other нуль

orElseThrow

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

Возвратите содержавшее значение, если есть иначе выдайте исключение, которое будет создаваться предоставленным поставщиком.

Примечание API:

Ссылка метода на конструктора исключения с пустым списком параметров может использоваться в качестве поставщика. Например, IllegalStateException::new

Введите Параметры:

X - Тип исключения, которое будет брошено

Параметры:

exceptionSupplier - Поставщик, который возвратит исключение, которое будет брошено

Возвраты:

текущая стоимость

Броски:

X - если нет никакого существующего значения

NullPointerException - если никакое значение не присутствует и exceptionSupplier нуль

X extends Throwable

равняется

public boolean equals(Object obj)

Указывает, " ли некоторый другой объект равен" этому Дополнительному. Другой объект считают равным если:

• это также Optional и;
• у обоих экземпляров нет никакого существующего значения или;
• текущая стоимость "равна" друг другу через equals().

Переопределения:

equals в class Object

Параметры:

obj - объект, который будет протестирован на равенство

Возвраты:

{кодируют истину}, если другой объект "равен" этому объекту иначе false

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает значение хэш-кода текущей стоимости, если таковые вообще имеются, или 0 (нуль), если никакое значение не присутствует.

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода текущей стоимости или 0, если никакое значение не присутствует

См. Также:

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

toString

public String toString()

Возвращает непустое строковое представление этого Дополнительного подходящий для того, чтобы отладить. Точный формат представления является неуказанным и может измениться между реализациями и версиями.

Переопределения:

toString в class Object

Требования реализации:

Если значение присутствует, результат должен включать свое строковое представление в результат. Пустой и существующий Optionals должен быть однозначно дифференцируемым.

Возвраты:

строковое представление этого экземпляра