यह UtilException
सहायक कक्षा आपको जावा स्ट्रीम में किसी भी चेक किए गए अपवाद का उपयोग करने देती है, जैसे:
Stream.of("java.lang.Object", "java.lang.Integer", "java.lang.String")
.map(rethrowFunction(Class::forName))
.collect(Collectors.toList());
नोट Class::forName
फेंकता है ClassNotFoundException
, जिसे चेक किया जाता है । धारा स्वयं भी फेंकता है ClassNotFoundException
, और कुछ अनियंत्रित अपवाद को लपेटता नहीं है।
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; }
}
इसका उपयोग करने के तरीके (सांख्यिकीय आयात के बाद 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");
}
लेकिन निम्नलिखित फायदे, नुकसान और सीमाओं को समझने से पहले इसका उपयोग न करें :
• यदि कॉलिंग-कोड चेक किए गए अपवाद को संभालने के लिए है, तो आपको इसे उस विधि के थ्रो क्लॉज में जोड़ना होगा जिसमें स्ट्रीम शामिल है। कंपाइलर आपको इसे जोड़ने के लिए बाध्य नहीं करेगा, इसलिए इसे भूलना आसान है।
• यदि कॉलिंग-कोड पहले से ही चेक किए गए अपवाद को संभालता है, तो कंपाइलर आपको थ्रो क्लॉज को मेथड डिक्लेरेशन में जोड़ने के लिए याद दिलाता है जिसमें स्ट्रीम शामिल है (यदि आप ऐसा नहीं कहेंगे: अपवाद को कभी भी दिए गए स्टेटमेंट के बॉडी में नहीं फेंका जाता है )।
• किसी भी स्थिति में, आप चेक किए गए अपवाद को पकड़ने के लिए स्ट्रीम को स्वयं को घेरने में सक्षम नहीं होंगे। इसमें वह तरीका शामिल है जिसमें स्ट्रीम शामिल है (यदि आप कोशिश करते हैं, तो कंपाइलर कहेगा: अपवाद को कभी भी संबंधित प्रयास के शरीर में नहीं फेंका जाता है)।
• यदि आप एक ऐसी विधि कह रहे हैं, जो शाब्दिक रूप से उस अपवाद को नहीं फेंक सकती है जिसे वह घोषित करता है, तो आपको थ्रोज़ क्लॉज़ को शामिल नहीं करना चाहिए। उदाहरण के लिए: नया स्ट्रिंग (बाइटएयर, "यूटीएफ -8") अनएवरेडएन्कोडिंग एक्ससेप्शन फेंकता है, लेकिन यूटीएफ -8 की गारंटी जावा स्पेक द्वारा हमेशा मौजूद रहने के लिए दी जाती है। यहां, थ्रो डिक्लेरेशन एक उपद्रव है और इसे कम से कम बायलरप्लेट से चुप कराने का कोई भी उपाय स्वागत योग्य है।
• यदि आप चेक किए गए अपवादों से घृणा करते हैं और महसूस करते हैं कि उन्हें जावा भाषा में कभी नहीं जोड़ा जाना चाहिए जिससे शुरू हो सके (लोगों की बढ़ती संख्या इस तरह से सोचती है, और मैं उनमें से एक नहीं हूं), तो बस चेक किए गए अपवाद को न जोड़ें उस पद्धति का खंड फेंकता है जिसमें धारा होती है। इसके बाद चेक किया गया अपवाद, UNChecked अपवाद की तरह व्यवहार करेगा।
• यदि आप एक सख्त इंटरफ़ेस लागू कर रहे हैं, जहां आपके पास फेंकता घोषणा को जोड़ने का विकल्प नहीं है, और फिर भी एक अपवाद को फेंकना पूरी तरह से उचित है, तो केवल अपवाद को लपेटने से इसे फेंकने का विशेषाधिकार प्राप्त होता है, जिसके परिणामस्वरूप स्केच अपवादों के साथ स्टैकट्रेस में परिणाम होता है। जो वास्तव में गलत हुआ उसके बारे में कोई जानकारी नहीं है। एक अच्छा उदाहरण Runnable.run () है, जो किसी भी चेक किए गए अपवादों को नहीं फेंकता है। इस स्थिति में, आप उस पद्धति के फेंके हुए खंड में चेक किए गए अपवाद को नहीं जोड़ने का निर्णय ले सकते हैं जिसमें धारा शामिल है।
• किसी भी मामले में, यदि आप विधि को जोड़ने के लिए (या जोड़ने के लिए भूल नहीं) का निर्णय लेते हैं, जिसमें धारा शामिल है, तो विधि के फेंक खंड के लिए चेक किए गए अपवादों को फेंकने के इन 2 परिणामों से अवगत रहें:
1) कॉलिंग-कोड इसे नाम से पकड़ने में सक्षम नहीं होगा (यदि आप कोशिश करते हैं, तो कंपाइलर कहेगा: अपवाद को कभी भी संबंधित स्टेटमेंट के शरीर में नहीं फेंका जाता है)। यह बुलबुला होगा और संभवतः मुख्य प्रोग्राम लूप में कुछ "कैच एक्सेप्शन" या "कैच थ्रोबेबल" द्वारा पकड़ा जा सकता है, जो कि वैसे भी हो सकता है।
2) यह कम से कम आश्चर्य के सिद्धांत का उल्लंघन करता है: सभी संभावित अपवादों को पकड़ने की गारंटी देने में सक्षम होने के लिए यह रनटाइम अपवाद को पकड़ने के लिए पर्याप्त नहीं होगा। इस कारण से, मेरा मानना है कि इसे फ्रेमवर्क कोड में नहीं किया जाना चाहिए, बल्कि केवल व्यावसायिक कोड में जिसे आप पूरी तरह से नियंत्रित करते हैं।
निष्कर्ष में: मेरा मानना है कि यहां की सीमाएं गंभीर नहीं हैं, और UtilException
वर्ग का उपयोग बिना किसी भय के किया जा सकता है। हालाँकि, यह आप पर निर्भर है!