When will an EOFException occur in JAVA's streams

I am working with a DataInputStream and had a question about EOFExceptions.

According to java docs:

Signals that an end of file or end of stream has been reached unexpectedly during input.

This exception is mainly used by data input streams to signal end of stream. Note that many other input operations return a special value on end of stream rather than throwing an exception.

Does this mean that when a EOFException is generated, the stream will not NEVER open again? Does it mean you should NEVER expect any more data from it ever?

If an outputstream is connected to an inputstream and outputstream.close() is called, will an inputstream receive the EOFException or an IOException?

An IOException is described as:

Signals that an I/O exception of some sort has occurred. This class is the general class of exceptions produced by failed or interrupted I/O operations.

Does a close on the outputstream produce either a EOFException or an IOException on the datainputstream side?


Solution 1:

The key word is unexpected.

If you use DataInputStream and read a 4 byte integer but there were only 3 bytes remaining in the stream you'll get an EOFException.

But if you call read() at the end of stream you'll just get -1 back and no exception.

Solution 2:

When you reach the end of a stream (end of file, or peer closes the connection):

  • read() returns -1
  • readLine() returns null
  • readXXX() for any other X throws EOFException.

The stream is still open, but you should stop reading from it and close it.

Solution 3:

Answering another part of your question: Yes, EOF means that no more data will be seen on the stream; you should close it.

Solution 4:

EOFException is a subclass of IOException. It will be thrown if you attempt to read from the stream and there is no more data to be read (e.g. because your DataInputStream is wrapped around a FileInputStream and you're trying to read more bytes than are left in the file).