io.jsonwebtoken.impl.io

Class FilteredOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

io.jsonwebtoken.impl.io.FilteredOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

Direct Known Subclasses:

EncodingOutputStream, TeeOutputStream

public class FilteredOutputStream
extends FilterOutputStream

A Proxy stream which acts as expected, that is it passes the method calls on to the proxied stream and doesn't change which methods are being called. It is an alternative base class to FilterOutputStream to increase reusability.

See the protected methods for ways in which a subclass can easily decorate a stream with custom pre-, post- or error processing functionality.

Since:

0.12.0, copied from commons-io 3a17f5259b105e734c8adce1d06d68f29884d1bb

Field Summary

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

Constructors

Constructor and Description
FilteredOutputStream(OutputStream out) Constructs a new ProxyOutputStream.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	afterWrite(int n) Invoked by the write methods after the proxied call has returned successfully.
protected void	beforeWrite(int n) Invoked by the write methods before the call is proxied.
void	close() Invokes the delegate's close() method.
void	flush() Invokes the delegate's flush() method.
protected void	onThrowable(Throwable t) Handle any IOExceptions thrown.
void	write(byte[] bts) Invokes the delegate's write(byte[]) method.
void	write(byte[] bts, int st, int end) Invokes the delegate's write(byte[]) method.
void	write(int idx) Invokes the delegate's write(int) method.

Methods inherited from class java.lang.Object

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

Constructor Detail

FilteredOutputStream

public FilteredOutputStream(OutputStream out)

Constructs a new ProxyOutputStream.

Parameters:

out - the OutputStream to delegate to

Method Detail

afterWrite

protected void afterWrite(int n)
                   throws IOException

Invoked by the write methods after the proxied call has returned successfully. The number of bytes written (1 for the write(int) method, buffer length for write(byte[]), etc.) is given as an argument.

Subclasses can override this method to add common post-processing functionality without having to override all the write methods. The default implementation does nothing.

Parameters:

n - number of bytes written

Throws:

IOException - if the post-processing fails

Since:

2.0

beforeWrite

protected void beforeWrite(int n)
                    throws IOException

Invoked by the write methods before the call is proxied. The number of bytes to be written (1 for the write(int) method, buffer length for write(byte[]), etc.) is given as an argument.

Subclasses can override this method to add common pre-processing functionality without having to override all the write methods. The default implementation does nothing.

Parameters:

n - number of bytes to be written

Throws:

IOException - if the pre-processing fails

close

public void close()
           throws IOException

Invokes the delegate's close() method.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class FilterOutputStream

Throws:

IOException - if an I/O error occurs.

flush

public void flush()
           throws IOException

Invokes the delegate's flush() method.

Specified by:

flush in interface Flushable

Overrides:

flush in class FilterOutputStream

Throws:

IOException - if an I/O error occurs.

onThrowable

protected void onThrowable(Throwable t)
                    throws IOException

Handle any IOExceptions thrown.

This method provides a point to implement custom exception handling. The default behavior is to re-throw the exception.

Parameters:

t - The Throwable thrown

Throws:

IOException - if an I/O error occurs.

write

public void write(byte[] bts)
           throws IOException

Invokes the delegate's write(byte[]) method.

Overrides:

write in class FilterOutputStream

Parameters:

bts - the bytes to write

Throws:

IOException - if an I/O error occurs.

write

public void write(byte[] bts,
         int st,
         int end)
           throws IOException

Invokes the delegate's write(byte[]) method.

Overrides:

write in class FilterOutputStream

Parameters:

bts - the bytes to write

st - The start offset

end - The number of bytes to write

Throws:

IOException - if an I/O error occurs.

write

public void write(int idx)
           throws IOException

Invokes the delegate's write(int) method.

Overrides:

write in class FilterOutputStream

Parameters:

idx - the byte to write

Throws:

IOException - if an I/O error occurs.