nbbrd.io.text.TextFormatter Maven / Gradle / Ivy

Go to download
package nbbrd.io.text;

import internal.io.text.*;
import lombok.NonNull;
import nbbrd.design.StaticFactoryMethod;
import nbbrd.io.FileFormatter;
import nbbrd.io.Resource;
import nbbrd.io.function.IOBiConsumer;
import nbbrd.io.function.IOFunction;
import nbbrd.io.function.IOSupplier;

import java.io.*;
import java.nio.charset.Charset;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Optional;
import java.util.function.Consumer;

public interface TextFormatter {

    default @NonNull String formatToString(@NonNull T value) throws IOException {
        StringWriter writer = new StringWriter();
        formatWriter(value, writer);
        return writer.toString();
    }

    default void formatChars(@NonNull T value, @NonNull Appendable target) throws IOException {
        StringWriter writer = new StringWriter();
        formatWriter(value, writer);
        target.append(writer.getBuffer());
    }

    default void formatFile(@NonNull T value, @NonNull File target, @NonNull Charset encoding) throws IOException {
        try (OutputStream resource = LegacyFiles.openOutputStream(target)) {
            formatStream(value, resource, encoding);
        }
    }

    default void formatPath(@NonNull T value, @NonNull Path target, @NonNull Charset encoding) throws IOException {
        Optional file = Resource.getFile(target);
        if (file.isPresent()) {
            formatFile(value, file.get(), encoding);
        } else {
            formatStream(value, () -> Files.newOutputStream(target), encoding);
        }
    }

    default void formatWriter(@NonNull T value, @NonNull IOSupplier target) throws IOException {
        try (Writer resource = LegacyFiles.openWriter(target)) {
            formatWriter(value, resource);
        }
    }

    default void formatStream(@NonNull T value, @NonNull IOSupplier target, @NonNull Charset encoding) throws IOException {
        try (OutputStream resource = LegacyFiles.openOutputStream(target)) {
            formatStream(value, resource, encoding);
        }
    }

    void formatWriter(@NonNull T value, @NonNull Writer resource) throws IOException;

    void formatStream(@NonNull T value, @NonNull OutputStream resource, @NonNull Charset encoding) throws IOException;

    default  @NonNull TextFormatter compose(@NonNull IOFunction before) {
        return new ComposeTextFormatter<>(this, before);
    }

    default @NonNull FileFormatter asFileFormatter(@NonNull Charset encoding) {
        return new WithCharsetFileFormatter<>(this, encoding);
    }

    default @NonNull Formatter asFormatter() {
        return asFormatter(InternalFormatter::doNothing);
    }

    default @NonNull Formatter asFormatter(@NonNull Consumer onError) {
        return value -> {
            if (value != null) {
                try {
                    return formatToString(value);
                } catch (Throwable ex) {
                    onError.accept(ex);
                }
            }
            return null;
        };
    }

    @StaticFactoryMethod
    static  @NonNull TextFormatter onFormattingWriter(@NonNull IOBiConsumer function) {
        return new FunctionalTextFormatter<>(function);
    }
}