Package org.apache.commons.io.input

Class AutoCloseInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.apache.commons.io.input.ProxyInputStream

org.apache.commons.io.input.AutoCloseInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

Direct Known Subclasses:

DbInputStream, LazyFileInputStream

public class AutoCloseInputStream
extends ProxyInputStream

Proxy stream that closes and discards the underlying stream as soon as the end of input has been reached or when the stream is explicitly closed. Not even a reference to the underlying stream is kept after it has been closed, so any allocated in-memory buffers can be freed even if the client application still keeps a reference to the proxy stream.

This class is typically used to release any resources related to an open stream as soon as possible even if the client application (by not explicitly closing the stream when no longer needed) or the underlying stream (by not releasing resources once the last byte has been read) do not do that.

Since:

1.4

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AutoCloseInputStream.Builder	Builds a new AutoCloseInputStream instance.

Constructor Summary

Constructors

Constructor	Description
AutoCloseInputStream(java.io.InputStream in)	Deprecated. Use builder(), AutoCloseInputStream.Builder, and AutoCloseInputStream.Builder.get()

Method Summary

Modifier and Type	Method	Description
static AutoCloseInputStream.Builder	builder()	Constructs a new AutoCloseInputStream.Builder.
void	close()	Closes the underlying input stream and replaces the reference to it with a ClosedInputStream instance.

Methods inherited from class org.apache.commons.io.input.ProxyInputStream

available, mark, markSupported, read, read, read, reset, skip

Methods inherited from class java.io.InputStream

nullInputStream, readAllBytes, readNBytes, readNBytes, transferTo

Methods inherited from class java.lang.Object

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

Constructor Detail

AutoCloseInputStream

@Deprecated
public AutoCloseInputStream(java.io.InputStream in)

Deprecated.

Use builder(), AutoCloseInputStream.Builder, and AutoCloseInputStream.Builder.get()

Creates an automatically closing proxy for the given input stream.

Parameters:

in - underlying input stream

Method Detail

builder

public static AutoCloseInputStream.Builder builder()

Constructs a new AutoCloseInputStream.Builder.

Returns:

a new AutoCloseInputStream.Builder.

Since:

2.12.0

close

public void close()
           throws java.io.IOException

Closes the underlying input stream and replaces the reference to it with a ClosedInputStream instance.

This method is automatically called by the read methods when the end of input has been reached.

Note that it is safe to call this method any number of times. The original underlying input stream is closed and discarded only once when this method is first called.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Overrides:

close in class ProxyInputStream

Throws:

java.io.IOException - if the underlying input stream can not be closed