com.landawn.abacus.util.Throwables Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of abacus-util-se Show documentation
Show all versions of abacus-util-se Show documentation
A general programming library in Java/Android. It's easy to learn and simple to use with concise and powerful APIs.
/*
* Copyright (C) 2019 HaiYang Li
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
* in compliance with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License
* is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
* or implied. See the License for the specific language governing permissions and limitations under
* the License.
*/
package com.landawn.abacus.util;
// TODO: Auto-generated Javadoc
/**
* Catch checked exception and convert it to RuntimeException.
*
* @author Haiyang Li
* @param
* @since 0.8
*/
public final class Throwables {
private Throwables() {
// Singleton for utility class.
}
/**
*
* @param cmd
* @throws RuntimeException if some error happens
*/
public static void run(final Throwables.Runnable cmd) {
try {
cmd.run();
} catch (Throwable e) {
throw N.toRuntimeException(e);
}
}
/**
*
* @param cmd
* @param actionOnError
*/
public static void run(final Throwables.Runnable cmd,
final com.landawn.abacus.util.function.Consumer actionOnError) {
N.checkArgNotNull(actionOnError);
try {
cmd.run();
} catch (Throwable e) {
actionOnError.accept(e);
}
}
/**
*
* @param
* @param cmd
* @return
* @throws RuntimeException if some error happens
*/
public static R call(final Throwables.Callable cmd) {
try {
return cmd.call();
} catch (Throwable e) {
throw N.toRuntimeException(e);
}
}
/**
*
* @param
* @param cmd
* @param actionOnError
* @return
*/
public static R call(final Throwables.Callable cmd,
final com.landawn.abacus.util.function.Function actionOnError) {
N.checkArgNotNull(actionOnError);
try {
return cmd.call();
} catch (Throwable e) {
return actionOnError.apply(e);
}
}
/**
*
* @param
* @param cmd
* @param supplier
* @return
*/
public static R call(final Throwables.Callable cmd, final com.landawn.abacus.util.function.Supplier supplier) {
N.checkArgNotNull(supplier);
try {
return cmd.call();
} catch (Throwable e) {
return supplier.get();
}
}
/**
*
* @param
* @param cmd
* @param defaultValue
* @return
*/
public static R call(final Throwables.Callable cmd, final R defaultValue) {
try {
return cmd.call();
} catch (Throwable e) {
return defaultValue;
}
}
/**
*
* @param
* @param cmd
* @param predicate
* @param supplier
* @return
* @throws RuntimeException if some error happens and predicate return false.
*/
public static R call(final Throwables.Callable cmd,
final com.landawn.abacus.util.function.Predicate predicate, final com.landawn.abacus.util.function.Supplier supplier) {
N.checkArgNotNull(predicate);
N.checkArgNotNull(supplier);
try {
return cmd.call();
} catch (Throwable e) {
if (predicate.test(e)) {
return supplier.get();
} else {
throw N.toRuntimeException(e);
}
}
}
/**
*
* @param
* @param cmd
* @param predicate
* @param defaultValue
* @return
* @throws RuntimeException if some error happens and predicate return false.
*/
public static R call(final Throwables.Callable cmd,
final com.landawn.abacus.util.function.Predicate predicate, final R defaultValue) {
N.checkArgNotNull(predicate);
try {
return cmd.call();
} catch (Throwable e) {
if (predicate.test(e)) {
return defaultValue;
} else {
throw N.toRuntimeException(e);
}
}
}
/**
* The Interface Runnable.
*
* @param
*/
public static interface Runnable {
/**
*
* @throws E the e
*/
void run() throws E;
}
/**
* The Interface Callable.
*
* @param
* @param
*/
public static interface Callable {
/**
*
* @return
* @throws E the e
*/
R call() throws E;
}
/**
* The Interface Supplier.
*
* @param
* @param
*/
public static interface Supplier {
/**
*
* @return
* @throws E the e
*/
T get() throws E;
}
/**
* The Interface BooleanSupplier.
*
* @param
*/
public static interface BooleanSupplier {
/**
* Gets the as boolean.
*
* @return
* @throws E the e
*/
boolean getAsBoolean() throws E;
}
/**
* The Interface CharSupplier.
*
* @param
*/
public static interface CharSupplier {
/**
* Gets the as char.
*
* @return
* @throws E the e
*/
char getAsChar() throws E;
}
/**
* The Interface ByteSupplier.
*
* @param
*/
public static interface ByteSupplier {
/**
* Gets the as byte.
*
* @return
* @throws E the e
*/
byte getAsByte() throws E;
}
/**
* The Interface ShortSupplier.
*
* @param
*/
public static interface ShortSupplier {
/**
* Gets the as short.
*
* @return
* @throws E the e
*/
short getAsShort() throws E;
}
/**
* The Interface IntSupplier.
*
* @param
*/
public static interface IntSupplier {
/**
* Gets the as int.
*
* @return
* @throws E the e
*/
int getAsInt() throws E;
}
/**
* The Interface LongSupplier.
*
* @param
*/
public static interface LongSupplier {
/**
* Gets the as long.
*
* @return
* @throws E the e
*/
long getAsLong() throws E;
}
/**
* The Interface FloatSupplier.
*
* @param
*/
public static interface FloatSupplier {
/**
* Gets the as float.
*
* @return
* @throws E the e
*/
float getAsFloat() throws E;
}
/**
* The Interface DoubleSupplier.
*
* @param
*/
public static interface DoubleSupplier {
/**
* Gets the as double.
*
* @return
* @throws E the e
*/
double getAsDouble() throws E;
}
/**
* The Interface Predicate.
*
* @param
* @param
*/
public static interface Predicate {
/**
*
* @param t
* @return true, if successful
* @throws E the e
*/
boolean test(T t) throws E;
}
/**
* The Interface BiPredicate.
*
* @param
* @param
* @param
*/
public static interface BiPredicate {
/**
*
* @param t
* @param u
* @return true, if successful
* @throws E the e
*/
boolean test(T t, U u) throws E;
}
/**
* The Interface TriPredicate.
*
* @param
* @param
* @param
* @param
*/
public static interface TriPredicate {
/**
*
* @param a
* @param b
* @param c
* @return true, if successful
* @throws E the e
*/
boolean test(A a, B b, C c) throws E;
}
/**
* The Interface QuadPredicate.
*
* @param
* @param
* @param
* @param
* @param
*/
public static interface QuadPredicate {
/**
*
* @param a
* @param b
* @param c
* @param d
* @return true, if successful
* @throws E the e
*/
boolean test(A a, B b, C c, D d) throws E;
}
/**
* The Interface Function.
*
* @param
* @param
* @param
*/
public static interface Function {
/**
*
* @param t
* @return
* @throws E the e
*/
R apply(T t) throws E;
}
/**
* The Interface BiFunction.
*
* @param
* @param
* @param
* @param
*/
public static interface BiFunction {
/**
*
* @param t
* @param u
* @return
* @throws E the e
*/
R apply(T t, U u) throws E;
}
/**
* The Interface TriFunction.
*
* @param
* @param
* @param
* @param
* @param
*/
public static interface TriFunction {
/**
*
* @param a
* @param b
* @param c
* @return
* @throws E the e
*/
R apply(A a, B b, C c) throws E;
}
/**
* The Interface QuadFunction.
*
* @param
* @param
* @param
* @param
* @param
* @param
*/
public static interface QuadFunction {
/**
*
* @param a
* @param b
* @param c
* @param d
* @return
* @throws E the e
*/
R apply(A a, B b, C c, D d) throws E;
}
/**
* The Interface Consumer.
*
* @param
* @param
*/
public static interface Consumer {
/**
*
* @param t
* @throws E the e
*/
void accept(T t) throws E;
}
/**
* The Interface BiConsumer.
*
* @param
* @param
* @param
*/
public static interface BiConsumer {
/**
*
* @param t
* @param u
* @throws E the e
*/
void accept(T t, U u) throws E;
}
/**
* The Interface TriConsumer.
*
* @param
* @param
* @param
* @param
*/
public static interface TriConsumer {
/**
*
* @param a
* @param b
* @param c
* @throws E the e
*/
void accept(A a, B b, C c) throws E;
}
/**
* The Interface QuadConsumer.
*
* @param
* @param
* @param
* @param
* @param
*/
public static interface QuadConsumer {
/**
*
* @param a
* @param b
* @param c
* @param d
* @throws E the e
*/
void accept(A a, B b, C c, D d) throws E;
}
/**
* The Interface IndexedConsumer.
*
* @param
* @param
*/
public static interface IndexedConsumer {
/**
*
* @param idx
* @param e
* @throws E the e
*/
void accept(int idx, T e) throws E;
}
/**
* The Interface IndexedBiConsumer.
*
* @param
* @param
* @param
*/
public static interface IndexedBiConsumer {
/**
*
* @param u
* @param idx
* @param e
* @throws E the e
*/
void accept(U u, int idx, T e) throws E;
}
/**
* The Interface IndexedFunction.
*
* @param
* @param
* @param
*/
public static interface IndexedFunction {
/**
*
* @param idx
* @param e
* @return
* @throws E the e
*/
R apply(int idx, T e) throws E;
}
/**
* The Interface IndexedBiFunction.
*
* @param
* @param
* @param
* @param
*/
public static interface IndexedBiFunction {
/**
*
* @param u
* @param idx
* @param e
* @return
* @throws E the e
*/
R apply(U u, int idx, T e) throws E;
}
/**
* The Interface IndexedPredicate.
*
* @param
* @param
*/
public static interface IndexedPredicate {
/**
*
* @param idx
* @param e
* @return true, if successful
* @throws E the e
*/
boolean test(int idx, T e) throws E;
}
/**
* The Interface IndexedBiPredicate.
*
* @param
* @param
* @param
*/
public static interface IndexedBiPredicate {
/**
*
* @param u
* @param idx
* @param e
* @return true, if successful
* @throws E the e
*/
boolean test(U u, int idx, T e) throws E;
}
/**
* The Interface BooleanPredicate.
*
* @param
*/
public static interface BooleanPredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(boolean value) throws E;
}
/**
* The Interface BooleanFunction.
*
* @param
* @param
*/
public static interface BooleanFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(boolean value) throws E;
}
/**
* The Interface BooleanConsumer.
*
* @param
*/
public static interface BooleanConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(boolean t) throws E;
}
/**
* The Interface CharPredicate.
*
* @param
*/
public static interface CharPredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(char value) throws E;
}
/**
* The Interface CharFunction.
*
* @param
* @param
*/
public static interface CharFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(char value) throws E;
}
/**
* The Interface CharConsumer.
*
* @param
*/
public static interface CharConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(char t) throws E;
}
/**
* The Interface BytePredicate.
*
* @param
*/
public static interface BytePredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(byte value) throws E;
}
/**
* The Interface ByteFunction.
*
* @param
* @param
*/
public static interface ByteFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(byte value) throws E;
}
/**
* The Interface ByteConsumer.
*
* @param
*/
public static interface ByteConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(byte t) throws E;
}
/**
* The Interface ShortPredicate.
*
* @param
*/
public static interface ShortPredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(short value) throws E;
}
/**
* The Interface ShortFunction.
*
* @param
* @param
*/
public static interface ShortFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(short value) throws E;
}
/**
* The Interface ShortConsumer.
*
* @param
*/
public static interface ShortConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(short t) throws E;
}
/**
* The Interface IntPredicate.
*
* @param
*/
public static interface IntPredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(int value) throws E;
}
/**
* The Interface IntFunction.
*
* @param
* @param
*/
public static interface IntFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(int value) throws E;
}
/**
* The Interface IntConsumer.
*
* @param
*/
public static interface IntConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(int t) throws E;
}
/**
* The Interface LongPredicate.
*
* @param
*/
public static interface LongPredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(long value) throws E;
}
/**
* The Interface LongFunction.
*
* @param
* @param
*/
public static interface LongFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(long value) throws E;
}
/**
* The Interface LongConsumer.
*
* @param
*/
public static interface LongConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(long t) throws E;
}
/**
* The Interface FloatPredicate.
*
* @param
*/
public static interface FloatPredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(float value) throws E;
}
/**
* The Interface FloatFunction.
*
* @param
* @param
*/
public static interface FloatFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(float value) throws E;
}
/**
* The Interface FloatConsumer.
*
* @param
*/
public static interface FloatConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(float t) throws E;
}
/**
* The Interface DoublePredicate.
*
* @param
*/
public static interface DoublePredicate {
/**
*
* @param value
* @return true, if successful
* @throws E the e
*/
boolean test(double value) throws E;
}
/**
* The Interface DoubleFunction.
*
* @param
* @param
*/
public static interface DoubleFunction {
/**
*
* @param value
* @return
* @throws E the e
*/
R apply(double value) throws E;
}
/**
* The Interface DoubleConsumer.
*
* @param
*/
public static interface DoubleConsumer {
/**
*
* @param t
* @throws E the e
*/
void accept(double t) throws E;
}
/**
* The Interface ToBooleanFunction.
*
* @param
* @param
*/
public static interface ToBooleanFunction {
/**
* Apply as boolean.
*
* @param t
* @return true, if successful
* @throws E the e
*/
boolean applyAsBoolean(T t) throws E;
}
/**
* The Interface ToCharFunction.
*
* @param
* @param
*/
public static interface ToCharFunction {
/**
* Apply as char.
*
* @param t
* @return
* @throws E the e
*/
char applyAsChar(T t) throws E;
}
/**
* The Interface ToByteFunction.
*
* @param
* @param
*/
public static interface ToByteFunction {
/**
* Apply as byte.
*
* @param t
* @return
* @throws E the e
*/
byte applyAsByte(T t) throws E;
}
/**
* The Interface ToShortFunction.
*
* @param
* @param
*/
public static interface ToShortFunction {
/**
* Apply as short.
*
* @param t
* @return
* @throws E the e
*/
short applyAsShort(T t) throws E;
}
/**
* The Interface ToIntFunction.
*
* @param
* @param
*/
public static interface ToIntFunction {
/**
* Apply as int.
*
* @param t
* @return
* @throws E the e
*/
int applyAsInt(T t) throws E;
}
/**
* The Interface ToLongFunction.
*
* @param
* @param
*/
public static interface ToLongFunction {
/**
* Apply as long.
*
* @param t
* @return
* @throws E the e
*/
long applyAsLong(T t) throws E;
}
/**
* The Interface ToFloatFunction.
*
* @param
* @param
*/
public static interface ToFloatFunction {
/**
* Apply as float.
*
* @param t
* @return
* @throws E the e
*/
float applyAsFloat(T t) throws E;
}
/**
* The Interface ToDoubleFunction.
*
* @param
* @param
*/
public static interface ToDoubleFunction {
/**
* Apply as double.
*
* @param t
* @return
* @throws E the e
*/
double applyAsDouble(T t) throws E;
}
/**
* The Interface UnaryOperator.
*
* @param
* @param
*/
public static interface UnaryOperator extends Function {
}
/**
* The Interface BinaryOperator.
*
* @param
* @param
*/
public static interface BinaryOperator extends BiFunction {
}
/**
* The Interface TernaryOperator.
*
* @param
* @param
*/
public static interface TernaryOperator extends BiFunction {
}
/**
* The Interface BooleanUnaryOperator.
*
* @param
*/
public static interface BooleanUnaryOperator {
/**
* Apply as boolean.
*
* @param operand
* @return true, if successful
* @throws E the e
*/
boolean applyAsBoolean(boolean operand) throws E;
}
/**
* The Interface CharUnaryOperator.
*
* @param
*/
public static interface CharUnaryOperator {
/**
* Apply as char.
*
* @param operand
* @return
* @throws E the e
*/
char applyAsChar(char operand) throws E;
}
/**
* The Interface ByteUnaryOperator.
*
* @param
*/
public static interface ByteUnaryOperator {
/**
* Apply as byte.
*
* @param operand
* @return
* @throws E the e
*/
byte applyAsByte(byte operand) throws E;
}
/**
* The Interface ShortUnaryOperator.
*
* @param
*/
public static interface ShortUnaryOperator {
/**
* Apply as short.
*
* @param operand
* @return
* @throws E the e
*/
short applyAsShort(short operand) throws E;
}
/**
* The Interface IntUnaryOperator.
*
* @param
*/
public static interface IntUnaryOperator {
/**
* Apply as int.
*
* @param operand
* @return
* @throws E the e
*/
int applyAsInt(int operand) throws E;
}
/**
* The Interface LongUnaryOperator.
*
* @param
*/
public static interface LongUnaryOperator {
/**
* Apply as long.
*
* @param operand
* @return
* @throws E the e
*/
long applyAsLong(long operand) throws E;
}
/**
* The Interface FloatUnaryOperator.
*
* @param
*/
public static interface FloatUnaryOperator {
/**
* Apply as float.
*
* @param operand
* @return
* @throws E the e
*/
float applyAsFloat(float operand) throws E;
}
/**
* The Interface DoubleUnaryOperator.
*
* @param
*/
public static interface DoubleUnaryOperator {
/**
* Apply as double.
*
* @param operand
* @return
* @throws E the e
*/
double applyAsDouble(double operand) throws E;
}
/**
* The Interface BooleanBinaryOperator.
*
* @param
*/
public static interface BooleanBinaryOperator {
/**
* Apply as boolean.
*
* @param left
* @param right
* @return true, if successful
* @throws E the e
*/
boolean applyAsBoolean(boolean left, boolean right) throws E;
}
/**
* The Interface CharBinaryOperator.
*
* @param
*/
public static interface CharBinaryOperator {
/**
* Apply as char.
*
* @param left
* @param right
* @return
* @throws E the e
*/
char applyAsChar(char left, char right) throws E;
}
/**
* The Interface ByteBinaryOperator.
*
* @param
*/
public static interface ByteBinaryOperator {
/**
* Apply as byte.
*
* @param left
* @param right
* @return
* @throws E the e
*/
byte applyAsByte(byte left, byte right) throws E;
}
/**
* The Interface ShortBinaryOperator.
*
* @param
*/
public static interface ShortBinaryOperator {
/**
* Apply as short.
*
* @param left
* @param right
* @return
* @throws E the e
*/
short applyAsShort(short left, short right) throws E;
}
/**
* The Interface IntBinaryOperator.
*
* @param
*/
public static interface IntBinaryOperator {
/**
* Apply as int.
*
* @param left
* @param right
* @return
* @throws E the e
*/
int applyAsInt(int left, int right) throws E;
}
/**
* The Interface LongBinaryOperator.
*
* @param
*/
public static interface LongBinaryOperator {
/**
* Apply as long.
*
* @param left
* @param right
* @return
* @throws E the e
*/
long applyAsLong(long left, long right) throws E;
}
/**
* The Interface FloatBinaryOperator.
*
* @param
*/
public static interface FloatBinaryOperator {
/**
* Apply as float.
*
* @param left
* @param right
* @return
* @throws E the e
*/
float applyAsFloat(float left, float right) throws E;
}
/**
* The Interface DoubleBinaryOperator.
*
* @param
*/
public static interface DoubleBinaryOperator