org.apache.commons.io.output

Class WriterOutputStream.Builder

java.lang.Object

org.apache.commons.io.build.AbstractSupplier<T,B>

org.apache.commons.io.build.AbstractOriginSupplier<T,B>

org.apache.commons.io.build.AbstractStreamBuilder<WriterOutputStream,WriterOutputStream.Builder>

org.apache.commons.io.output.WriterOutputStream.Builder

All Implemented Interfaces:

IOSupplier<WriterOutputStream>

Enclosing class:

WriterOutputStream

public static class WriterOutputStream.Builder
extends org.apache.commons.io.build.AbstractStreamBuilder<WriterOutputStream,WriterOutputStream.Builder>

Builds a new WriterOutputStream instance.

For example:

 WriterOutputStream s = WriterOutputStream.builder()
   .setPath(path)
   .setBufferSize(8192)
   .setCharset(StandardCharsets.UTF_8)
   .setWriteImmediately(false)
   .get();
 

Since:

2.12.0

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
WriterOutputStream	get() Constructs a new instance.
WriterOutputStream.Builder	setCharset(java.nio.charset.Charset charset)
WriterOutputStream.Builder	setCharset(java.lang.String charset)
WriterOutputStream.Builder	setCharsetDecoder(java.nio.charset.CharsetDecoder charsetDecoder) Sets the charset decoder.
WriterOutputStream.Builder	setWriteImmediately(boolean writeImmediately) Sets whether the output buffer will be flushed after each write operation (true), i.e.

Methods inherited from class org.apache.commons.io.build.AbstractStreamBuilder

getCharset, setBufferSize, setBufferSize, setOpenOptions

Methods inherited from class org.apache.commons.io.build.AbstractOriginSupplier

setByteArray, setCharSequence, setFile, setFile, setInputStream, setOutputStream, setPath, setPath, setReader, setURI, setWriter

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.commons.io.function.IOSupplier

asSupplier

Constructor Detail

Builder

public Builder()

Method Detail

get

public WriterOutputStream get()
                       throws java.io.IOException

Constructs a new instance.

This builder use the aspect Writer, OpenOption[], Charset, CharsetDecoder, buffer size and writeImmediately.

You must provide an origin that can be converted to a Writer by this builder, otherwise, this call will throw an UnsupportedOperationException.

Returns:

a new instance.

Throws:

java.lang.UnsupportedOperationException - if the origin cannot provide a Writer.

java.io.IOException - if an I/O error occurs.

See Also:

AbstractStreamBuilder.getWriter()

setCharset

public WriterOutputStream.Builder setCharset(java.nio.charset.Charset charset)

Overrides:

setCharset in class org.apache.commons.io.build.AbstractStreamBuilder<WriterOutputStream,WriterOutputStream.Builder>

setCharset

public WriterOutputStream.Builder setCharset(java.lang.String charset)

Overrides:

setCharset in class org.apache.commons.io.build.AbstractStreamBuilder<WriterOutputStream,WriterOutputStream.Builder>

setCharsetDecoder

public WriterOutputStream.Builder setCharsetDecoder(java.nio.charset.CharsetDecoder charsetDecoder)

Sets the charset decoder.

Parameters:

charsetDecoder - the charset decoder.

Returns:

this

setWriteImmediately

public WriterOutputStream.Builder setWriteImmediately(boolean writeImmediately)

Sets whether the output buffer will be flushed after each write operation (true), i.e. all available data will be written to the underlying Writer immediately. If false, the output buffer will only be flushed when it overflows or when WriterOutputStream.flush() or WriterOutputStream.close() is called.

Parameters:

writeImmediately - If true the output buffer will be flushed after each write operation, i.e. all available data will be written to the underlying Writer immediately. If false, the output buffer will only be flushed when it overflows or when WriterOutputStream.flush() or WriterOutputStream.close() is called.

Returns:

this