17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.io;
  27 
  28 /**
  29  * ObjectInput extends the DataInput interface to include the reading of
  30  * objects. DataInput includes methods for the input of primitive types,
  31  * ObjectInput extends that interface to include objects, arrays, and Strings.
  32  *
  33  * @author  unascribed
  34  * @see java.io.InputStream
  35  * @see java.io.ObjectOutputStream
  36  * @see java.io.ObjectInputStream
  37  * @since   JDK1.1
  38  */
  39 public interface ObjectInput extends DataInput, AutoCloseable {
  40     /**
  41      * Read and return an object. The class that implements this interface
  42      * defines where the object is "read" from.
  43      *
  44      * @return the object read from the stream
  45      * @exception java.lang.ClassNotFoundException If the class of a serialized
  46      *      object cannot be found.
  47      * @exception IOException If any of the usual Input/Output
  48      * related exceptions occur.
  49      */
  50     public Object readObject()
  51         throws ClassNotFoundException, IOException;
  52 
  53     /**
  54      * Reads a byte of data. This method will block if no input is
  55      * available.
  56      * @return  the byte read, or -1 if the end of the
  57      *          stream is reached.

  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.io;
  27 
  28 /**
  29  * ObjectInput extends the DataInput interface to include the reading of
  30  * objects. DataInput includes methods for the input of primitive types,
  31  * ObjectInput extends that interface to include objects, arrays, and Strings.
  32  *
  33  * @author  unascribed
  34  * @see java.io.InputStream
  35  * @see java.io.ObjectOutputStream
  36  * @see java.io.ObjectInputStream
  37  * @since   1.1
  38  */
  39 public interface ObjectInput extends DataInput, AutoCloseable {
  40     /**
  41      * Read and return an object. The class that implements this interface
  42      * defines where the object is "read" from.
  43      *
  44      * @return the object read from the stream
  45      * @exception java.lang.ClassNotFoundException If the class of a serialized
  46      *      object cannot be found.
  47      * @exception IOException If any of the usual Input/Output
  48      * related exceptions occur.
  49      */
  50     public Object readObject()
  51         throws ClassNotFoundException, IOException;
  52 
  53     /**
  54      * Reads a byte of data. This method will block if no input is
  55      * available.
  56      * @return  the byte read, or -1 if the end of the
  57      *          stream is reached.