net.hasor.cobble.io.input

类 AutoCloseInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

net.hasor.cobble.io.input.ProxyInputStream

net.hasor.cobble.io.input.AutoCloseInputStream

所有已实现的接口:

Closeable, AutoCloseable

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.

从以下版本开始:

1.4

版本:

$Id: AutoCloseInputStream.java 1586350 2014-04-10 15:57:20Z ggregory $

字段概要

从类继承的字段 java.io.FilterInputStream

in

构造器概要

构造器

构造器和说明
AutoCloseInputStream(InputStream in) Creates an automatically closing proxy for the given input stream.

方法概要

限定符和类型	方法和说明
protected void	afterRead(int n) Automatically closes the stream if the end of stream was reached.
void	close() Closes the underlying input stream and replaces the reference to it with a ClosedInputStream instance.
protected void	finalize() Ensures that the stream is closed before it gets garbage-collected.

从类继承的方法 net.hasor.cobble.io.input.ProxyInputStream

available, beforeRead, handleIOException, mark, markSupported, read, read, read, reset, skip

从类继承的方法 java.lang.Object

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

构造器详细资料

AutoCloseInputStream

public AutoCloseInputStream(InputStream in)

Creates an automatically closing proxy for the given input stream.

参数:

in - underlying input stream

方法详细资料

close

public void close()
           throws 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.

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

覆盖:

close 在类中 ProxyInputStream

抛出:

IOException - if the underlying input stream can not be closed

afterRead

protected void afterRead(int n)
                  throws IOException

Automatically closes the stream if the end of stream was reached.

覆盖:

afterRead 在类中 ProxyInputStream

参数:

n - number of bytes read, or -1 if no more bytes are available

抛出:

IOException - if the stream could not be closed

从以下版本开始:

2.0

finalize

protected void finalize()
                 throws Throwable

Ensures that the stream is closed before it gets garbage-collected. As mentioned in close(), this is a no-op if the stream has already been closed.

覆盖:

finalize 在类中 Object

抛出:

Throwable - if an error occurs