summaryrefslogtreecommitdiff
path: root/dicore3/core/src/main/java/io/dico/dicore/exceptions/checkedfunctions/CheckedFunction.java
blob: 9ff806ae8c5faad6b276160ed3bf94a61542b0b9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
package io.dico.dicore.exceptions.checkedfunctions;

import io.dico.dicore.exceptions.ExceptionHandler;

import java.util.function.Function;

/**
 * checked mimic of {@link Function}
 *
 * @param <TParam>
 * @param <TResult>
 * @param <TException>
 */
@FunctionalInterface
public interface CheckedFunction<TParam, TResult, TException extends Throwable>
        extends CheckedFunctionalObject<TResult, TException>, Function<TParam, TResult> {
    
    /**
     * the functional method
     *
     * @param t the input
     * @return the function output
     * @throws TException if an exception occurs
     */
    TResult checkedApply(TParam t) throws TException;
    
    /**
     * unchecked wrapper for {@link #checkedApply(Object)}
     * If a {@link TException} occurs, an unchecked one might be thrown by {@link #resultOnError(Throwable, Object...)}
     *
     * @param t the input
     * @return the function output, or the result from {@link #resultOnError(Throwable, Object...)} if an exception was thrown
     * @see #checkedApply(Object)
     * @see #resultOnError(Throwable, Object...)
     */
    @Override
    default TResult apply(TParam t) {
        try {
            return checkedApply(t);
        } catch (Throwable ex) {
            return handleGenericException(ex, t);
        }
    }
    
    /**
     * {@inheritDoc}
     */
    @Override
    default CheckedFunction<TParam, TResult, TException> handleExceptionsWith(ExceptionHandler handler) {
        return new CheckedFunction<TParam, TResult, TException>() {
            @Override
            public TResult checkedApply(TParam t) throws TException {
                return CheckedFunction.this.checkedApply(t);
            }
            
            @Override
            @SuppressWarnings("unchecked")
            public TResult handleGenericException(Throwable thrown, Object... args) {
                Object result = handler.handleGenericException(thrown, args);
                try {
                    return (TResult) result;
                } catch (Exception ex) {
                    return null;
                }
            }
            
            @Override
            public CheckedFunction<TParam, TResult, TException> handleExceptionsWith(ExceptionHandler handler) {
                return CheckedFunction.this.handleExceptionsWith(handler);
            }
        };
    }
    
}