java.io
Interface ObjectInput
- AutoCloseable, DataInput
- ClassLoaderObjectInputStream, CorbaInput, ObjectInputStream, RMIMarshalledObjectInputStream, RMIObjectInputStream
This interface extends the DataInput interface to provide a
facility to read objects as well as primitive types from a stream. It
also has methods that allow input to be done in a manner similar to
InputStream
int | available()- This method returns the number of bytes that can be read without
blocking.
|
void | close()- This method closes the input source
|
int | read()- This method reading a byte of data from a stream.
|
int | read(byte[] buf)- This method reads raw bytes and stores them them a byte array buffer.
|
int | read(byte[] buf, int offset, int len)- This method reads raw bytes and stores them in a byte array buffer
buf starting at position offset into the
buffer.
|
Object | readObject()- Reads an object instance and returns it.
|
long | skip(long numBytes)- This method causes the specified number of bytes to be read and
discarded.
|
readBoolean, readByte, readChar, readDouble, readFloat, readFully, readFully, readInt, readLine, readLong, readShort, readUTF, readUnsignedByte, readUnsignedShort, skipBytes |
available
public int available()
throws IOException This method returns the number of bytes that can be read without
blocking.
- The number of bytes available before blocking
read
public int read()
throws IOException This method reading a byte of data from a stream. It returns that byte
as an int. This method blocks if no data is available
to be read.
read
public int read(byte[] buf)
throws IOException This method reads raw bytes and stores them them a byte array buffer.
Note that this method will block if no data is available. However,
it will not necessarily block until it fills the entire buffer. That is,
a "short count" is possible.
buf - The byte array to receive the data read
- The actual number of bytes read or -1 if end of stream
read
public int read(byte[] buf,
int offset,
int len)
throws IOException This method reads raw bytes and stores them in a byte array buffer
buf starting at position offset into the
buffer. A
maximum of len bytes will be read. Note that this method
blocks if no data is available, but will not necessarily block until
it can read len bytes of data. That is, a "short count" is
possible.
buf - The byte array to receive the data readoffset - The offset into buf to start storing datalen - The maximum number of bytes to read
- The actual number of bytes read or -1 if end of stream
readObject
public Object readObject()
throws ClassNotFoundException,
IOException Reads an object instance and returns it. If the class for the object
being read cannot be found, then a ClassNotFoundException
will be thrown.
- The object instance that was read
skip
public long skip(long numBytes)
throws IOException This method causes the specified number of bytes to be read and
discarded. It is possible that fewer than the requested number of bytes
will actually be skipped.
numBytes - The number of bytes to skip
- The actual number of bytes skipped
ObjectInput.java -- Read object data from a stream
Copyright (C) 1998,2003 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module. An independent module is a module which is not derived from
or based on this library. If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so. If you do not wish to do so, delete this
exception statement from your version.