Closeable

AI-generated Key Takeaways

• The Closeable interface represents data sources or destinations that can be closed to release resources like open files.

• It extends the AutoCloseable interface and requires implementing the close() method.

• The close() method is crucial for resource management, ensuring system resources are freed when no longer needed.

• Implementations should handle potential IOExceptions during closing, prioritizing resource release and marking the object as closed.

public interface Closeable implements AutoCloseable

Known Indirect Subclasses AbstractInterruptibleChannel, AbstractSelectableChannel, AbstractSelector, AsynchronousByteChannel, AsynchronousChannel, AsynchronousFileChannel, AsynchronousServerSocketChannel, AsynchronousSocketChannel, BufferedInputStream, BufferedOutputStream, BufferedReader, BufferedWriter, ByteArrayInputStream, ByteArrayOutputStream, ByteChannel, and 82 others. AbstractInterruptibleChannel Base implementation class for interruptible channels.  AbstractSelectableChannel Base implementation class for selectable channels.  AbstractSelector Base implementation class for selectors.  AsynchronousByteChannel An asynchronous channel that can read and write bytes.  AsynchronousChannel A channel that supports asynchronous I/O operations.  AsynchronousFileChannel An asynchronous channel for reading, writing, and manipulating a file.  AsynchronousServerSocketChannel An asynchronous channel for stream-oriented listening sockets.  AsynchronousSocketChannel An asynchronous channel for stream-oriented connecting sockets.  BufferedInputStream A BufferedInputStream adds functionality to another input stream-namely, the ability to buffer the input and to support the mark and reset methods.  BufferedOutputStream The class implements a buffered output stream.  BufferedReader Reads text from a character-input stream, buffering characters so as to provide for the efficient reading of characters, arrays, and lines.  BufferedWriter Writes text to a character-output stream, buffering characters so as to provide for the efficient writing of single characters, arrays, and strings.  ByteArrayInputStream A ByteArrayInputStream contains an internal buffer that contains bytes that may be read from the stream.  ByteArrayOutputStream This class implements an output stream in which the data is written into a byte array.  ByteChannel A channel that can read and write bytes.  Channel A nexus for I/O operations.  CharArrayReader This class implements a character buffer that can be used as a character-input stream.  CharArrayWriter This class implements a character buffer that can be used as an Writer.  CheckedInputStream An input stream that also maintains a checksum of the data being read.  CheckedOutputStream An output stream that also maintains a checksum of the data being written.  CipherInputStream A CipherInputStream is composed of an InputStream and a Cipher so that read() methods return data that are read in from the underlying InputStream but have been additionally processed by the Cipher.  CipherOutputStream A CipherOutputStream is composed of an OutputStream and a Cipher so that write() methods first process the data before writing them out to the underlying OutputStream.  DataInputStream A data input stream lets an application read primitive Java data types from an underlying input stream in a machine-independent way.  DataOutputStream A data output stream lets an application write primitive Java data types to an output stream in a portable way.  DatagramChannel A selectable channel for datagram-oriented sockets.  DatagramSocket This class represents a socket for sending and receiving datagram packets.  DeflaterInputStream Implements an input stream filter for compressing data in the "deflate" compression format.  DeflaterOutputStream This class implements an output stream filter for compressing data in the "deflate" compression format.  DigestInputStream A transparent stream that updates the associated message digest using the bits going through the stream.  DigestOutputStream A transparent stream that updates the associated message digest using the bits going through the stream.  DirectoryStream<T> An object to iterate over the entries in a directory.  FileChannel A channel for reading, writing, mapping, and manipulating a file.  FileInputStream A FileInputStream obtains input bytes from a file in a file system.  FileOutputStream A file output stream is an output stream for writing data to a File or to a FileDescriptor.  FileReader Convenience class for reading character files.  FileSystem Provides an interface to a file system and is the factory for objects to access files and other objects in the file system.  FileWriter Convenience class for writing character files.  FilterInputStream A FilterInputStream contains some other input stream, which it uses as its basic source of data, possibly transforming the data along the way or providing additional functionality.  FilterOutputStream This class is the superclass of all classes that filter output streams.  FilterReader Abstract class for reading filtered character streams.  FilterWriter Abstract class for writing filtered character streams.  Formatter An interpreter for printf-style format strings.  GZIPInputStream This class implements a stream filter for reading compressed data in the GZIP file format.  GZIPOutputStream This class implements a stream filter for writing compressed data in the GZIP file format.  GatheringByteChannel A channel that can write bytes from a sequence of buffers.  InflaterInputStream This class implements a stream filter for uncompressing data in the "deflate" compression format.  InflaterOutputStream Implements an output stream filter for uncompressing data stored in the "deflate" compression format.  InputStream This abstract class is the superclass of all classes representing an input stream of bytes.  InputStreamReader An InputStreamReader is a bridge from byte streams to character streams: It reads bytes and decodes them into characters using a specified charset.  InterruptibleChannel A channel that can be asynchronously closed and interrupted.  JarFile The JarFile class is used to read the contents of a jar file from any file that can be opened with java.io.RandomAccessFile.  JarInputStream The JarInputStream class is used to read the contents of a JAR file from any input stream.  JarOutputStream The JarOutputStream class is used to write the contents of a JAR file to any output stream.  LineNumberInputStream This class is deprecated. This class incorrectly assumes that bytes adequately represent characters. As of JDK 1.1, the preferred way to operate on character streams is via the new character-stream classes, which include a class for counting line numbers.   LineNumberReader A buffered character-input stream that keeps track of line numbers.  MulticastChannel A network channel that supports Internet Protocol (IP) multicasting.  MulticastSocket The multicast datagram socket class is useful for sending and receiving IP multicast packets.  NetworkChannel A channel to a network socket.  ObjectInputStream An ObjectInputStream deserializes primitive data and objects previously written using an ObjectOutputStream.  ObjectOutputStream An ObjectOutputStream writes primitive data types and graphs of Java objects to an OutputStream.  OutputStream This abstract class is the superclass of all classes representing an output stream of bytes.  OutputStreamWriter A class for turning a character stream into a byte stream.  Pipe.SinkChannel A channel representing the writable end of a Pipe.  Pipe.SourceChannel A channel representing the readable end of a Pipe.  PipedInputStream Receives information from a communications pipe.  PipedOutputStream Places information on a communications pipe.  PipedReader Piped character-input streams.  PipedWriter Piped character-output streams.  PrintStream A PrintStream adds functionality to another output stream, namely the ability to print representations of various data values conveniently.  PrintWriter Prints formatted representations of objects to a text-output stream.  PushbackInputStream A PushbackInputStream adds functionality to another input stream, namely the ability to "push back" or "unread" one byte.  PushbackReader A character-stream reader that allows characters to be pushed back into the stream.  RandomAccessFile Instances of this class support both reading and writing to a random access file.  ReadableByteChannel A channel that can read bytes.  Reader Abstract class for reading character streams.  SSLServerSocket This class extends ServerSockets and provides secure server sockets using protocols such as the Secure Sockets Layer (SSL) or Transport Layer Security (TLS) protocols.  SSLSocket This class extends Sockets and provides secure socket using protocols such as the "Secure Sockets Layer" (SSL) or IETF "Transport Layer Security" (TLS) protocols.  Scanner A simple text scanner which can parse primitive types and strings using regular expressions.  ScatteringByteChannel A channel that can read bytes into a sequence of buffers.  SecureDirectoryStream<T> A DirectoryStream that defines operations on files that are located relative to an open directory.  SeekableByteChannel A byte channel that maintains a current position and allows the position to be changed.  SelectableChannel A channel that can be multiplexed via a Selector.  Selector A multiplexor of SelectableChannel objects.  SequenceInputStream A SequenceInputStream represents the logical concatenation of other input streams.  ServerSocket This class implements server sockets.  ServerSocketChannel A selectable channel for stream-oriented listening sockets.  Socket This class implements client sockets (also called just "sockets").  SocketChannel A selectable channel for stream-oriented connecting sockets.  StringBufferInputStream This class is deprecated. This class does not properly convert characters into bytes. As of JDK 1.1, the preferred way to create a stream from a string is via the StringReader class.   StringReader A character stream whose source is a string.  StringWriter A character stream that collects its output in a string buffer, which can then be used to construct a string.  WatchService A watch service that watches registered objects for changes and events.  WritableByteChannel A channel that can write bytes.  Writer Abstract class for writing to character streams.  ZipFile This class is used to read entries from a zip file.  ZipInputStream This class implements an input stream filter for reading files in the ZIP file format.  ZipOutputStream This class implements an output stream filter for writing files in the ZIP file format.

A Closeable is a source or destination of data that can be closed. The close method is invoked to release resources that the object is holding (such as open files).

Public Method Summary

abstract void

close() Closes this stream and releases any system resources associated with it.

Inherited Method Summary

From interface java.lang.AutoCloseable

abstract void

close() Closes this resource, relinquishing any underlying resources.

Public Methods

public abstract void close ()

Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect.

As noted in AutoCloseable.close(), cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the Closeable as closed, prior to throwing the IOException.

Throws

IOException	if an I/O error occurs