org.apache.commons.io.output

Class FileWriterWithEncoding.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<FileWriterWithEncoding,FileWriterWithEncoding.Builder>

org.apache.commons.io.output.FileWriterWithEncoding.Builder

All Implemented Interfaces:

IOSupplier<FileWriterWithEncoding>

Enclosing class:

FileWriterWithEncoding

public static class FileWriterWithEncoding.Builder
extends AbstractStreamBuilder<FileWriterWithEncoding,FileWriterWithEncoding.Builder>

Builds a new FileWriterWithEncoding.

Using a CharsetEncoder:

 FileWriterWithEncoding w = FileWriterWithEncoding.builder()
   .setPath(path)
   .setAppend(false)
   .setCharsetEncoder(StandardCharsets.UTF_8.newEncoder())
   .get();
 

Using a Charset:

 FileWriterWithEncoding w = FileWriterWithEncoding.builder()
   .setPath(path)
   .setAppend(false)
   .setCharsetEncoder(StandardCharsets.UTF_8)
   .get();
 

Since:

2.12.0

See Also:

get()

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	append
private java.nio.charset.CharsetEncoder	charsetEncoder

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
FileWriterWithEncoding	get() Builds a new FileWriterWithEncoding.
FileWriterWithEncoding.Builder	setAppend(boolean append) Sets whether or not to append.
FileWriterWithEncoding.Builder	setCharsetEncoder(java.nio.charset.CharsetEncoder charsetEncoder) Sets charsetEncoder to use for encoding.

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

getBufferSize, getBufferSizeDefault, getCharSequence, getCharset, getCharsetDefault, getInputStream, getOpenOptions, getOutputStream, getPath, getReader, getWriter, setBufferSize, setBufferSize, setBufferSizeChecker, setBufferSizeDefault, setBufferSizeMax, setCharset, setCharset, setCharsetDefault, setOpenOptions

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

checkOrigin, getOrigin, hasOrigin, newByteArrayOrigin, newCharSequenceOrigin, newFileOrigin, newFileOrigin, newInputStreamOrigin, newOutputStreamOrigin, newPathOrigin, newPathOrigin, newReaderOrigin, newURIOrigin, newWriterOrigin, setByteArray, setCharSequence, setFile, setFile, setInputStream, setOrigin, setOutputStream, setPath, setPath, setReader, setURI, setWriter

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

asThis

Methods inherited from class java.lang.Object

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

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

asSupplier

Field Detail

append

private boolean append

charsetEncoder

private java.nio.charset.CharsetEncoder charsetEncoder

Constructor Detail

Builder

public Builder()

Method Detail

get

public FileWriterWithEncoding get()
                           throws java.io.IOException

Builds a new FileWriterWithEncoding.

You must set input that supports File on this builder, otherwise, this method throws an exception.

This builder use the following aspects:

• File
• CharsetEncoder
• append

Returns:

a new instance.

Throws:

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

java.lang.IllegalStateException - if the origin is null.

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

See Also:

AbstractOrigin.getFile()

setAppend

public FileWriterWithEncoding.Builder setAppend(boolean append)

Sets whether or not to append.

Parameters:

append - Whether or not to append.

Returns:

this

setCharsetEncoder

public FileWriterWithEncoding.Builder setCharsetEncoder(java.nio.charset.CharsetEncoder charsetEncoder)

Sets charsetEncoder to use for encoding.

Parameters:

charsetEncoder - The charsetEncoder to use for encoding.

Returns:

this