W3cubDocs

/OpenJDK 21

Class ObjectInputStream.GetField

java.lang.Object
java.io.ObjectInputStream.GetField
Enclosing class:
ObjectInputStream
public abstract static class ObjectInputStream.GetField extends Object
Provide access to the persistent fields read from the input stream.

Constructor Summary

Constructor Description
GetField()
Constructor for subclasses to call.

Method Summary

Modifier and Type Method Description
abstract boolean defaulted(String name)
Return true if the named field is defaulted and has no value in this stream.
abstract boolean get(String name, boolean val)
Get the value of the named boolean field from the persistent field.
abstract byte get(String name, byte val)
Get the value of the named byte field from the persistent field.
abstract char get(String name, char val)
Get the value of the named char field from the persistent field.
abstract double get(String name, double val)
Get the value of the named double field from the persistent field.
abstract float get(String name, float val)
Get the value of the named float field from the persistent field.
abstract int get(String name, int val)
Get the value of the named int field from the persistent field.
abstract long get(String name, long val)
Get the value of the named long field from the persistent field.
abstract short get(String name, short val)
Get the value of the named short field from the persistent field.
abstract Object get(String name, Object val)
Get the value of the named Object field from the persistent field.
abstract ObjectStreamClass getObjectStreamClass()
Get the ObjectStreamClass that describes the fields in the stream.

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GetField

public GetField()
Constructor for subclasses to call.

Method Details

getObjectStreamClass

public abstract ObjectStreamClass getObjectStreamClass()
Get the ObjectStreamClass that describes the fields in the stream.
Returns:
the descriptor class that describes the serializable fields

defaulted

public abstract boolean defaulted(String name) throws IOException
Return true if the named field is defaulted and has no value in this stream.
Parameters:
name - the name of the field
Returns:
true, if and only if the named field is defaulted
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if name does not correspond to a serializable field

get

public abstract boolean get(String name, boolean val) throws IOException
Get the value of the named boolean field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named boolean field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract byte get(String name, byte val) throws IOException
Get the value of the named byte field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named byte field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract char get(String name, char val) throws IOException
Get the value of the named char field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named char field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract short get(String name, short val) throws IOException
Get the value of the named short field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named short field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract int get(String name, int val) throws IOException
Get the value of the named int field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named int field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract long get(String name, long val) throws IOException
Get the value of the named long field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named long field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract float get(String name, float val) throws IOException
Get the value of the named float field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named float field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract double get(String name, double val) throws IOException
Get the value of the named double field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named double field
Throws:
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

get

public abstract Object get(String name, Object val) throws IOException, ClassNotFoundException
Get the value of the named Object field from the persistent field.
Parameters:
name - the name of the field
val - the default value to use if name does not have a value
Returns:
the value of the named Object field
Throws:
ClassNotFoundException - Class of a serialized object cannot be found.
IOException - if there are I/O errors while reading from the underlying InputStream
IllegalArgumentException - if type of name is not serializable or if the field type is incorrect

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/ObjectInputStream.GetField.html