Package 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()

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	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

getCharset, setBufferSize, setBufferSize, setBufferSizeChecker, setBufferSizeMax, setCharset, setCharset, 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 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