StringOutputStream.java

package com.tazkiyatech.utils.streams;

import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.StandardCharsets;

import androidx.annotation.NonNull;

/**
 * Provides an easy method for writing a {@link String} to an {@link OutputStream}.
 */
public class StringOutputStream implements AutoCloseable {

    @NonNull
    private final OutputStream outputStream;

    /**
     * Constructor.
     *
     * @param outputStream the {@link OutputStream} instance to write to.
     */
    public StringOutputStream(@NonNull OutputStream outputStream) {
        this.outputStream = outputStream;
    }

    /**
     * Writes {@code value} to the {@link OutputStream} instance that this class wraps.
     *
     * @param value the {@link String} value to write to the output stream.
     * @throws IOException if an I/O error occurs.
     */
    public void write(@NonNull String value) throws IOException {
        outputStream.write(value.getBytes(StandardCharsets.UTF_8));
        outputStream.flush();
    }

    @Override
    public void close() throws IOException {
        outputStream.flush();
        outputStream.close();
    }
}