src/main/java/com/android/apkzlib/utils/IOExceptionFunction.java

/*
 * Copyright (C) 2016 The Android Open Source Project
 *
 * 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.android.apkzlib.utils;

import java.io.IOException;
import java.io.UncheckedIOException;
import java.util.function.Function;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;

/**
 * Function that can throw an I/O Exception
 */
@FunctionalInterface
public interface IOExceptionFunction<F, T> {

    /**
     * Applies the function to the given input.
     * @param input the input
     * @return the function result
     */
    @Nullable T apply(@Nullable F input) throws IOException;

    /**
     * Wraps a function that may throw an IO Exception throwing an {@code UncheckedIOException}.
     *
     * @param f the function
     */
    @Nonnull
    static <F, T> Function<F, T> asFunction(@Nonnull IOExceptionFunction<F, T> f)  {
        return i -> {
            try {
                return f.apply(i);
            } catch (IOException e) {
                throw new UncheckedIOException(e);
            }
        };
    }
}