Ta UtilException
klasa pomocnicza umożliwia używanie dowolnych zaznaczonych wyjątków w strumieniach Java, na przykład:
Stream.of("java.lang.Object", "java.lang.Integer", "java.lang.String")
.map(rethrowFunction(Class::forName))
.collect(Collectors.toList());
Uwaga Class::forName
rzuca ClassNotFoundException
, co jest sprawdzane . Sam strumień również rzuca ClassNotFoundException
, a NIE jakiś niezaznaczony wyjątek zawijania.
public final class UtilException {
@FunctionalInterface
public interface Consumer_WithExceptions<T, E extends Exception> {
void accept(T t) throws E;
}
@FunctionalInterface
public interface BiConsumer_WithExceptions<T, U, E extends Exception> {
void accept(T t, U u) throws E;
}
@FunctionalInterface
public interface Function_WithExceptions<T, R, E extends Exception> {
R apply(T t) throws E;
}
@FunctionalInterface
public interface Supplier_WithExceptions<T, E extends Exception> {
T get() throws E;
}
@FunctionalInterface
public interface Runnable_WithExceptions<E extends Exception> {
void run() throws E;
}
/** .forEach(rethrowConsumer(name -> System.out.println(Class.forName(name)))); or .forEach(rethrowConsumer(ClassNameUtil::println)); */
public static <T, E extends Exception> Consumer<T> rethrowConsumer(Consumer_WithExceptions<T, E> consumer) throws E {
return t -> {
try { consumer.accept(t); }
catch (Exception exception) { throwAsUnchecked(exception); }
};
}
public static <T, U, E extends Exception> BiConsumer<T, U> rethrowBiConsumer(BiConsumer_WithExceptions<T, U, E> biConsumer) throws E {
return (t, u) -> {
try { biConsumer.accept(t, u); }
catch (Exception exception) { throwAsUnchecked(exception); }
};
}
/** .map(rethrowFunction(name -> Class.forName(name))) or .map(rethrowFunction(Class::forName)) */
public static <T, R, E extends Exception> Function<T, R> rethrowFunction(Function_WithExceptions<T, R, E> function) throws E {
return t -> {
try { return function.apply(t); }
catch (Exception exception) { throwAsUnchecked(exception); return null; }
};
}
/** rethrowSupplier(() -> new StringJoiner(new String(new byte[]{77, 97, 114, 107}, "UTF-8"))), */
public static <T, E extends Exception> Supplier<T> rethrowSupplier(Supplier_WithExceptions<T, E> function) throws E {
return () -> {
try { return function.get(); }
catch (Exception exception) { throwAsUnchecked(exception); return null; }
};
}
/** uncheck(() -> Class.forName("xxx")); */
public static void uncheck(Runnable_WithExceptions t)
{
try { t.run(); }
catch (Exception exception) { throwAsUnchecked(exception); }
}
/** uncheck(() -> Class.forName("xxx")); */
public static <R, E extends Exception> R uncheck(Supplier_WithExceptions<R, E> supplier)
{
try { return supplier.get(); }
catch (Exception exception) { throwAsUnchecked(exception); return null; }
}
/** uncheck(Class::forName, "xxx"); */
public static <T, R, E extends Exception> R uncheck(Function_WithExceptions<T, R, E> function, T t) {
try { return function.apply(t); }
catch (Exception exception) { throwAsUnchecked(exception); return null; }
}
@SuppressWarnings ("unchecked")
private static <E extends Throwable> void throwAsUnchecked(Exception exception) throws E { throw (E)exception; }
}
Wiele innych przykładów, jak go używać (po zaimportowaniu statycznym UtilException
):
@Test
public void test_Consumer_with_checked_exceptions() throws IllegalAccessException {
Stream.of("java.lang.Object", "java.lang.Integer", "java.lang.String")
.forEach(rethrowConsumer(className -> System.out.println(Class.forName(className))));
Stream.of("java.lang.Object", "java.lang.Integer", "java.lang.String")
.forEach(rethrowConsumer(System.out::println));
}
@Test
public void test_Function_with_checked_exceptions() throws ClassNotFoundException {
List<Class> classes1
= Stream.of("Object", "Integer", "String")
.map(rethrowFunction(className -> Class.forName("java.lang." + className)))
.collect(Collectors.toList());
List<Class> classes2
= Stream.of("java.lang.Object", "java.lang.Integer", "java.lang.String")
.map(rethrowFunction(Class::forName))
.collect(Collectors.toList());
}
@Test
public void test_Supplier_with_checked_exceptions() throws ClassNotFoundException {
Collector.of(
rethrowSupplier(() -> new StringJoiner(new String(new byte[]{77, 97, 114, 107}, "UTF-8"))),
StringJoiner::add, StringJoiner::merge, StringJoiner::toString);
}
@Test
public void test_uncheck_exception_thrown_by_method() {
Class clazz1 = uncheck(() -> Class.forName("java.lang.String"));
Class clazz2 = uncheck(Class::forName, "java.lang.String");
}
@Test (expected = ClassNotFoundException.class)
public void test_if_correct_exception_is_still_thrown_by_method() {
Class clazz3 = uncheck(Class::forName, "INVALID");
}
Ale nie używaj go, zanim zrozumiesz następujące zalety, wady i ograniczenia :
• Jeśli kod wywołujący ma obsłużyć zaznaczony wyjątek, MUSISZ dodać go do klauzuli throws metody zawierającej strumień. Kompilator nie będzie już zmuszał Cię do dodawania go, więc łatwiej o tym zapomnieć.
• Jeśli kod wywołujący już obsługuje sprawdzony wyjątek, kompilator BĘDZIE przypominał o dodaniu klauzuli throws do deklaracji metody zawierającej strumień (jeśli tego nie zrobisz, powie: Wyjątek nigdy nie jest zgłaszany w treści odpowiedniej instrukcji try ).
• W każdym razie nie będziesz w stanie otoczyć samego strumienia, aby przechwycić zaznaczony wyjątek WEWNĄTRZ metody, która zawiera strumień (jeśli spróbujesz, kompilator powie: Wyjątek nigdy nie jest wyrzucany w treści odpowiedniej instrukcji try).
• Jeśli wywołujesz metodę, która dosłownie nigdy nie może zgłosić wyjątku, który deklaruje, nie powinieneś dołączać klauzuli throws. Na przykład: new String (byteArr, „UTF-8”) zgłasza wyjątek UnsupportedEncodingException, ale specyfikacja języka Java gwarantuje, że UTF-8 będzie zawsze obecny. W tym przypadku deklaracja rzutów jest uciążliwa i mile widziane jest wszelkie rozwiązanie, aby ją wyciszyć przy minimalnym schemacie.
• Jeśli nienawidzisz zaznaczonych wyjątków i uważasz, że nie powinny one być nigdy dodawane do języka Java na początku (coraz więcej osób myśli w ten sposób, a ja NIE jestem jednym z nich), po prostu nie dodawaj zaznaczonego wyjątku do throws klauzula metody zawierającej strumień. Zaznaczony wyjątek będzie wtedy zachowywał się jak wyjątek niezaznaczony.
• Jeśli implementujesz ścisły interfejs, w którym nie masz opcji dodania deklaracji rzucania, a mimo to zgłoszenie wyjątku jest całkowicie właściwe, wówczas zawijanie wyjątku tylko po to, aby uzyskać przywilej rzucania go, powoduje powstanie stosu śledzenia z fałszywymi wyjątkami które nie dostarczają żadnych informacji o tym, co faktycznie poszło nie tak. Dobrym przykładem jest Runnable.run (), która nie zgłasza żadnych sprawdzonych wyjątków. W takim przypadku możesz zdecydować, aby nie dodawać zaznaczonego wyjątku do klauzuli throws metody zawierającej strumień.
• W każdym przypadku, jeśli zdecydujesz się NIE dodawać (lub zapomnisz dodać) zaznaczonego wyjątku do klauzuli throws metody zawierającej strumień, pamiętaj o tych 2 konsekwencjach rzucania sprawdzonych wyjątków:
1) Kod wywołujący nie będzie w stanie przechwycić go według nazwy (jeśli spróbujesz, kompilator powie: Wyjątek nigdy nie jest zgłaszany w treści odpowiedniej instrukcji try). Będzie bąbelkowy i prawdopodobnie zostanie przechwycony w głównej pętli programu przez jakiś "catch Exception" lub "catch Throwable", co i tak może być tym, czego chcesz.
2) To narusza zasadę najmniejszego zaskoczenia: nie wystarczy już przechwycić RuntimeException, aby móc zagwarantować przechwycenie wszystkich możliwych wyjątków. Z tego powodu uważam, że nie powinno się tego robić w kodzie frameworkowym, ale tylko w kodzie biznesowym, nad którym masz pełną kontrolę.
Podsumowując: uważam, że ograniczenia tutaj nie są poważne, a z UtilException
klasy można korzystać bez obaw. Jednak to zależy od Ciebie!