A pool of InputStreams opened from distinct files. Only a single instance is ever opened from the same file. This is used to read special infinite files like /dev/random where the current file pointer is not relevant, so multiple readers can share the same file descriptor and consequently the same InputStream.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	FileInputStreamPool.StreamRef
private static class	FileInputStreamPool.UnclosableInputStream

Field Summary

Modifier and Type	Field and Description
private static final ConcurrentMap<File, FileInputStreamPool.StreamRef>	pool a pool of: StreamRef -> UnclosableInputStream -> FileInputStream(s)
private static final ReferenceQueue<FileInputStreamPool.UnclosableInputStream>	refQueue a reference queue of cleared StreamRef(s)

Access	Constructor and Description
pack-priv	FileInputStreamPool()

Method Summary

Modifier and Type	Method and Description
pack-priv static InputStream	Returns: a shared `java.io.InputStream` instance opened from given file. getInputStream(File the file to be opened for reading. file) This method opens an underlying `java.io.FileInputStream` for a given `file` and returns a wrapper over it.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

pool	back to summary
private static final ConcurrentMap<File, FileInputStreamPool.StreamRef> pool a pool of: StreamRef -> UnclosableInputStream -> FileInputStream(s)

refQueue	back to summary
private static final ReferenceQueue<FileInputStreamPool.UnclosableInputStream> refQueue a reference queue of cleared StreamRef(s)

FileInputStreamPool	back to summary
pack-priv FileInputStreamPool()

Method Detail

getInputStream back to summary

getInputStream	back to summary
pack-priv static InputStream getInputStream(File file) throws IOException This method opens an underlying `java.io.FileInputStream` for a given `file` and returns a wrapper over it. The wrapper is shared among multiple readers of the same `file` and ignores `java.io.InputStream#close()` requests. The underlying stream is closed when all references to the wrapper are relinquished. Parameters file:File the file to be opened for reading. Returns:InputStream a shared `java.io.InputStream` instance opened from given file. Exceptions FileNotFoundException: if the file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened for reading.

pack-priv static InputStream getInputStream(File file) throws IOException

This method opens an underlying java.io.FileInputStream for a given file and returns a wrapper over it. The wrapper is shared among multiple readers of the same file and ignores java.io.InputStream#close() requests. The underlying stream is closed when all references to the wrapper are relinquished.

Parameters

file:File: the file to be opened for reading.

Returns:InputStream

a shared java.io.InputStream instance opened from given file.

Exceptions

FileNotFoundException:: if the file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened for reading.

sun.security.provider back to summary

private Class FileInputStreamPool.StreamRef

Class Inheritance

extends WeakReference<FileInputStreamPool.UnclosableInputStream>

java.lang.Object
java.lang.ref.Reference
java.lang.ref.WeakReference
sun.security.provider.FileInputStreamPool.StreamRef

Field Summary

Modifier and Type	Field and Description
pack-priv final File	file

Constructor Summary

Access	Constructor and Description
pack-priv	StreamRef(File file, FileInputStreamPool.UnclosableInputStream stream, ReferenceQueue<FileInputStreamPool.UnclosableInputStream> refQueue)

Field Detail

file	back to summary
pack-priv final File file

Constructor Detail

StreamRef	back to summary
pack-priv StreamRef(File file, FileInputStreamPool.UnclosableInputStream stream, ReferenceQueue<FileInputStreamPool.UnclosableInputStream> refQueue)

sun.security.provider back to summary

private final Class FileInputStreamPool.UnclosableInputStream

Class Inheritance

extends FilterInputStream

java.lang.Object
java.io.InputStream
java.io.FilterInputStream
sun.security.provider.FileInputStreamPool.UnclosableInputStream

Field Summary

Inherited from java.io.FilterInputStream:: in

Constructor Summary

Access	Constructor and Description
pack-priv	UnclosableInputStream(InputStream in)

Method Summary

Modifier and Type	Method and Description
public void	close() Overrides java.io.FilterInputStream.close. Implements java.io.Closeable.close. Closes this input stream and releases any system resources associated with the stream.
pack-priv InputStream	getWrappedStream()

Inherited from java.io.FilterInputStream:: available mark markSupported read read read reset skip

Constructor Detail

UnclosableInputStream	back to summary
pack-priv UnclosableInputStream(InputStream in)

Method Detail

close	back to summary
public void close() throws IOException Overrides java.io.FilterInputStream.close. Implements java.io.Closeable.close. Doc from java.io.FilterInputStream.close. Closes this input stream and releases any system resources associated with the stream. Annotations @Override Exceptions IOException: if an I/O error occurs.

back to summary

public void close() throws IOException

Overrides java.io.FilterInputStream.close.

Implements java.io.Closeable.close.

Doc from java.io.FilterInputStream.close.

Closes this input stream and releases any system resources associated with the stream.

Annotations