org.apache.commons.io.output

Class BrokenWriter

java.lang.Object

java.io.Writer

org.apache.commons.io.output.BrokenWriter

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable

public class BrokenWriter
extends Writer

Always throws an IOException from all Writer methods.

This class is mostly useful for testing error handling in code that uses a writer.

Since:

2.0

Field Summary

Fields

Modifier and Type	Field and Description
static BrokenWriter	INSTANCE The singleton instance.

Fields inherited from class java.io.Writer

lock

Constructor Summary

Constructors

Constructor and Description
BrokenWriter() Creates a new writer that always throws an IOException.
BrokenWriter(IOException exception) Creates a new writer that always throws the given exception.
BrokenWriter(Supplier<IOException> exceptionSupplier) Creates a new writer that always throws an IOException.

Method Summary

Modifier and Type	Method and Description
void	close() Throws the configured exception.
void	flush() Throws the configured exception.
void	write(char[] cbuf, int off, int len) Throws the configured exception.

Methods inherited from class java.io.Writer

append, append, append, write, write, write, write

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final BrokenWriter INSTANCE

The singleton instance.

Since:

2.12.0

Constructor Detail

BrokenWriter

public BrokenWriter()

Creates a new writer that always throws an IOException.

BrokenWriter

public BrokenWriter(IOException exception)

Creates a new writer that always throws the given exception.

Parameters:

exception - the exception to be thrown.

BrokenWriter

public BrokenWriter(Supplier<IOException> exceptionSupplier)

Creates a new writer that always throws an IOException.

Parameters:

exceptionSupplier - a supplier for the exception to be thrown.

Since:

2.12.0

Method Detail

close

public void close()
           throws IOException

Throws the configured exception.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in class Writer

Throws:

IOException - always thrown

flush

public void flush()
           throws IOException

Throws the configured exception.

Specified by:

flush in interface Flushable

Specified by:

flush in class Writer

Throws:

IOException - always thrown

write

public void write(char[] cbuf,
                  int off,
                  int len)
           throws IOException

Throws the configured exception.

Specified by:

write in class Writer

Parameters:

cbuf - ignored

off - ignored

len - ignored

Throws:

IOException - always thrown