cn.crane4j.core.util

类 Try<T>

java.lang.Object

cn.crane4j.core.util.Try<T>

public class Try<T>
extends Object

A control structure that can be used to perform a computation that may throw an exception.

从以下版本开始:

2.8.0

作者:

huangchengxing

构造器概要

构造器

构造器和说明
Try()

方法概要

限定符和类型	方法和说明
static <R> Try<R>	failure(Throwable ex) Create a failed action.
T	get() Get the result.
@Nullable Throwable	getCause() Get the cause of the exception.
Optional<T>	getOptional() Get the optional result.
T	getOrElse(T defaultValue) Get the result or the default value.
T	getOrElseGet(Function<Throwable,T> function) Get the result or the default value.
<X extends Throwable> T	getOrElseThrow(Function<Throwable,X> function) Get the result or throw an exception.
Try<T>	getOrElseTry(CheckedFunction<Throwable,T> function) Get this or the other instance if this action is failed.
T	getOrNull() Get the result or null if the supplier throws an exception.
boolean	isFailure() Whether the computation is failed.
boolean	isSuccess() Whether the computation is successful.
static Try<Void>	of(CheckedRunnable runnable) Create an action that does nothing.
static <R> Try<R>	of(CheckedSupplier<R> supplier) Create an action that does nothing and returns a result.
void	perform() Perform the computation and subscribe the result and the exception.
void	run() Run the supplier.
<X extends Throwable> void	runOrThrow(Function<Throwable,X> function) Run the supplier and throw an exception if the supplier throws an exception.
Try<T>	subscribeFailure(Consumer<Throwable> subscriber) Subscribe the result.
Try<T>	subscribeSuccess(Consumer<T> subscriber) Subscribe the result.
static <R> Try<R>	success(R result) Create a successful action.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Try

public Try()

方法详细资料

of

public static Try<Void> of(CheckedRunnable runnable)

Create an action that does nothing.

参数:

runnable - the runnable

返回:

the try action instance

of

public static <R> Try<R> of(CheckedSupplier<R> supplier)

Create an action that does nothing and returns a result.

类型参数:

R - the type of the result

参数:

supplier - the supplier of the result

返回:

the try action instance

success

public static <R> Try<R> success(R result)

Create a successful action.

类型参数:

R - the type of the result

参数:

result - the result

返回:

the try action instance

failure

public static <R> Try<R> failure(Throwable ex)

Create a failed action.

类型参数:

R - the type of the result

参数:

ex - the exception

返回:

the try action instance

perform

public final void perform()

Perform the computation and subscribe the result and the exception.

isSuccess

public boolean isSuccess()

Whether the computation is successful.

返回:

whether the computation is successful

isFailure

public boolean isFailure()

Whether the computation is failed.

返回:

whether the computation is failed

getCause

public @Nullable Throwable getCause()

Get the cause of the exception.

返回:

the exception

另请参阅:

isFailure()

subscribeFailure

public Try<T> subscribeFailure(Consumer<Throwable> subscriber)

Subscribe the result.

参数:

subscriber - the subscriber of the result

返回:

this

抛出:

IllegalStateException - if the computation has been performed

subscribeSuccess

public Try<T> subscribeSuccess(Consumer<T> subscriber)

Subscribe the result.

参数:

subscriber - the subscriber of the result

返回:

this

抛出:

IllegalStateException - if the computation has been performed

get

public T get()
      throws Throwable

Get the result.

返回:

the result

抛出:

Throwable - the exception that may be thrown by the supplier

getOrNull

public T getOrNull()

Get the result or null if the supplier throws an exception.

返回:

the result or null

另请参阅:

getOptional()

getOptional

public Optional<T> getOptional()

Get the optional result.

返回:

the optional result

另请参阅:

getOrNull()

getOrElse

public T getOrElse(T defaultValue)

Get the result or the default value.

参数:

defaultValue - the default value to return if the supplier throws an exception

返回:

the result or the default value

getOrElseGet

public T getOrElseGet(Function<Throwable,T> function)

Get the result or the default value.

参数:

function - the function to return the default value if the supplier throws an exception

返回:

the result or the default value returned by the function

getOrElseThrow

public <X extends Throwable> T getOrElseThrow(Function<Throwable,X> function)
                                       throws X extends Throwable

Get the result or throw an exception.

类型参数:

X - the type of the exception to throw

参数:

function - the function to throw an exception if the supplier throws an exception

返回:

the result

抛出:

X - the exception thrown by the function

X extends Throwable

getOrElseTry

public Try<T> getOrElseTry(CheckedFunction<Throwable,T> function)

Get this or the other instance if this action is failed.

参数:

function - the function to get the other instance

返回:

this or the other instance

run

public void run()
         throws Throwable

Run the supplier.

抛出:

Throwable - the exception that may be thrown by the supplier

runOrThrow

public <X extends Throwable> void runOrThrow(Function<Throwable,X> function)
                                      throws X extends Throwable

Run the supplier and throw an exception if the supplier throws an exception.

参数:

function - the function to handle the exception

抛出:

X extends Throwable