AutoTweaker API/io.github.autotweaker.api.base/CatchingResult

CatchingResult

@JvmInline

value class CatchingResult<T>(source)

Result 的包装，泛型 T 在类级别，提供成员函数来弥补 Result 错误处理方面的缺陷，并转发 Result 的标准 API。为了避免 <E, T> 导致编译器无法推断泛型类型，包装 Result，成员函数就不需要 T 了。

Properties

isFailure

val isFailure: Boolean

isSuccess

val isSuccess: Boolean

Functions

exceptionOrNull

fun exceptionOrNull(): Throwable?

fold

inline fun <R> fold(onSuccess: (T) -> R, onFailure: (Throwable) -> R): R

getOrDefault

fun <R, T : R> CatchingResult<T>.getOrDefault(defaultValue: R): R

getOrElse

inline fun <R, T : R> CatchingResult<T>.getOrElse(onFailure: (Throwable) -> R): R

getOrNull

fun getOrNull(): T?

getOrThrow

fun getOrThrow(): T

map

inline fun <R> map(transform: (T) -> R): CatchingResult<R>

onException

inline fun <E : Throwable> onException(action: (E) -> Unit): CatchingResult<T>

如果异常为 E，执行 action

onExceptionExcept

inline fun <E : Throwable> onExceptionExcept(action: (Throwable) -> Unit): CatchingResult<T>

如果异常不是 E，执行 action

onFailure

inline fun onFailure(action: (Throwable) -> Unit): CatchingResult<T>

onFailureIf

inline fun onFailureIf(test: (Throwable) -> Boolean, action: (Throwable) -> Unit): CatchingResult<T>

如果 test，执行 action

onSuccess

inline fun onSuccess(action: (T) -> Unit): CatchingResult<T>

recover

inline fun <R, T : R> CatchingResult<T>.recover(transform: (Throwable) -> R): CatchingResult<R>

recoverException

inline fun <E : Throwable, R, T : R> CatchingResult<T>.recoverException(transform: (E) -> R): CatchingResult<Any?>

如果异常为 E，对 T 进行 transform，返回新的 CatchingResult。

recoverIf

inline fun <R, T : R> CatchingResult<T>.recoverIf(test: (Throwable) -> Boolean, transform: (Throwable) -> R): CatchingResult<Any?>

如果 test，对 T 进行 transform，返回新的 CatchingResult

rethrow

inline fun <E : Throwable> rethrow(): CatchingResult<T>

重新抛出类型为 E 的异常，请使用 rethrowCancellation 替代 rethrow<CancellationException>()

inline fun <E : Throwable> rethrow(on: (E) -> Unit): CatchingResult<T>

如果异常为 E，执行 on 并抛出异常。请使用 rethrowCancellation 替代 rethrow<CancellationException>()

rethrowCancellation

fun rethrowCancellation(): CatchingResult<T>

重新抛出类型为 CancellationException 的异常

fun rethrowCancellation(on: (CancellationException) -> Unit): CatchingResult<T>

如果异常为 CancellationException，执行 on 并抛出 CancellationException

rethrowIf

inline fun rethrowIf(test: (Throwable) -> Boolean): CatchingResult<T>

如果 test，重新抛出异常

inline fun rethrowIf(test: (Throwable) -> Boolean, on: (Throwable) -> Unit): CatchingResult<T>

如果 test，执行 on 并重新抛出异常

rethrowNot

inline fun <E : Throwable> rethrowNot(): CatchingResult<T>

如果异常不是 E，重新抛出