org.apache.commons.io.output

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

org.apache.commons.io.output.LockableFileWriter.Builder

All Implemented Interfaces:

IOSupplier<LockableFileWriter>

Enclosing class:

LockableFileWriter

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

Builds a new LockableFileWriter.

Using a CharsetEncoder:

 LockableFileWriter w = LockableFileWriter.builder()
   .setPath(path)
   .setAppend(false)
   .setLockDirectory("Some/Directory")
   .get();
 

Since:

2.12.0

See Also:

get()

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	append
private AbstractOrigin<?,?>	lockDirectory

Constructor Summary

Constructors

Constructor and Description
Builder() Builds a new LockableFileWriter.

Method Summary

Modifier and Type	Method and Description
LockableFileWriter	get() Constructs a new instance.
LockableFileWriter.Builder	setAppend(boolean append) Sets whether to append (true) or overwrite (false).
LockableFileWriter.Builder	setLockDirectory(java.io.File lockDirectory) Sets the directory in which the lock file should be held.
LockableFileWriter.Builder	setLockDirectory(java.lang.String lockDirectory) Sets the directory in which the lock file should be held.

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

lockDirectory

private AbstractOrigin<?,?> lockDirectory

Constructor Detail

Builder

public Builder()

Builds a new LockableFileWriter.

Method Detail

get

public LockableFileWriter get()
                       throws java.io.IOException

Constructs a new instance.

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

This builder use the following aspects:

• File
• AbstractStreamBuilder.getCharset()
• append
• lockDirectory

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 LockableFileWriter.Builder setAppend(boolean append)

Sets whether to append (true) or overwrite (false).

Parameters:

append - whether to append (true) or overwrite (false).

Returns:

this

setLockDirectory

public LockableFileWriter.Builder setLockDirectory(java.io.File lockDirectory)

Sets the directory in which the lock file should be held.

Parameters:

lockDirectory - the directory in which the lock file should be held.

Returns:

this

setLockDirectory

public LockableFileWriter.Builder setLockDirectory(java.lang.String lockDirectory)

Sets the directory in which the lock file should be held.

Parameters:

lockDirectory - the directory in which the lock file should be held.

Returns:

this