Modifier and Type	Class and Description
private static record	ReflectionFactory.Config The configurations for the reflection factory.

Modifier and Type	Field and Description
private static ReflectionFactory.Config	config The configuration is lazily initialized after the module system is initialized.
private static final ReflectionFactory.Config	DEFAULT_CONFIG
private static volatile Method	hasStaticInitializerMethod
private final JavaLangReflectAccess	langReflectAccess
private static final Set<Class<?>>	nonSerializableLeafClasses These are specific leaf classes which appear to be Serializable, but which have special semantics according to the serialization specification.
private static final ReflectionFactory	soleInstance

Access	Constructor and Description
private	ReflectionFactory()

Method Summary

Modifier and Type	Method and Description
private final ClassFileFormatVersion	classFileFormatVersion(Class<?> cl)
private static ReflectionFactory.Config	config()
public <T> Constructor<T>	copyConstructor(Constructor<T> arg) Makes a copy of the passed constructor.
public Field	copyField(Field arg) Makes a copy of the passed field.
public Method	copyMethod(Method arg) Makes a copy of the passed method.
public final MethodHandle	defaultReadObjectForSerialization(Class<?> cl)
public final MethodHandle	defaultWriteObjectForSerialization(Class<?> cl)
private static boolean	disableSerialConstructorChecks()
private final MethodHandle	findReadWriteObjectForSerialization(Class<?> cl, String methodName, Class<?> streamClass)
private final Constructor<?>	generateConstructor(Class<?> cl, Constructor<?> constructorToCall)
public Class<?>[]	getExecutableSharedParameterTypes(Executable ex)
public byte[]	getExecutableTypeAnnotationBytes(Executable ex) Gets the byte[] that encodes TypeAnnotations on an executable.
public static ReflectionFactory	getReflectionFactory() Provides the caller with the capability to instantiate reflective objects.
private MethodHandle	Returns: a MethodHandle for the method or `null` if not found or has the wrong signature. getReplaceResolveForSerialization(Class<?> a serializable class cl, String the method name to find methodName) Lookup readResolve or writeReplace on a class with specified signature constraints.
private static boolean	hasDefaultOrNoSerialization(Class<?> cl)
public final boolean	hasStaticInitializerForSerialization(Class<?> cl) Returns true if the given class defines a static initializer method, false otherwise.
public Method	leafCopyMethod(Method arg) Makes a copy of the passed method.
private static ReflectionFactory.Config	loadConfig()
public ConstructorAccessor	newConstructorAccessor(Constructor<?> c)
public final Constructor<?>	newConstructorForExternalization(Class<?> cl)
public final Constructor<?>	newConstructorForSerialization(Class<?> cl, Constructor<?> constructorToCall)
public final Constructor<?>	Returns: the generated constructor, or null if none is available newConstructorForSerialization(Class<?> the class for which a constructor is to be found cl) Returns a constructor that allocates an instance of cl and that then initializes the instance by calling the no-arg constructor of its first non-serializable superclass.
public FieldAccessor	newFieldAccessor(Field field, boolean override)
public <T> T	newInstance(Constructor<T> ctor, Object[] args, Class<?> caller)
public MethodAccessor	newMethodAccessor(Method method, boolean callerSensitive)
public final Constructor<OptionalDataException>	Returns: the eof constructor for OptionalDataException newOptionalDataExceptionForSerialization() Return the accessible constructor for OptionalDataException signaling eof.
private static boolean	Returns: true if the two classes are in the same classloader and package packageEquals(Class<?> a class cl1, Class<?> another class cl2) Returns true if classes are defined in the classloader and same package, false otherwise.
public final Set<AccessFlag>	parseAccessFlags(int mask, AccessFlag.Location location, Class<?> classFile)
public final MethodHandle	readObjectForSerialization(Class<?> cl)
public final MethodHandle	readObjectNoDataForSerialization(Class<?> cl)
public final MethodHandle	Returns: the `writeReplace` MethodHandle or `null` if not found readResolveForSerialization(Class<?> a serializable class cl) Returns a MethodHandle for `readResolve` on the serializable class or null if no match found.
public final ObjectStreamField[]	serialPersistentFields(Class<?> cl)
private boolean	Returns: whether the superclass has a constructor accessible from cl superHasAccessibleConstructor(Class<?> the class from which access is checked cl) Given a class, determines whether its superclass has any constructors that are accessible from the class.
pack-priv static boolean	useNativeAccessorOnly()
public final MethodHandle	writeObjectForSerialization(Class<?> cl)
public final MethodHandle	Returns: the `writeReplace` MethodHandle or `null` if not found writeReplaceForSerialization(Class<?> a serializable class cl) Returns a MethodHandle for `writeReplace` on the serializable class or null if no match found.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

config	back to summary
private static ReflectionFactory.Config config The configuration is lazily initialized after the module system is initialized. The default config would be used before the proper config is loaded. The static initializer of ReflectionFactory is run before the system properties are set up. The class initialization is caused by the class initialization of java.lang.reflect.Method (more properly, caused by the class initialization for java.lang.reflect.AccessibleObject) that happens very early VM startup, initPhase1. Annotations @Stable

config

back to summary

private static ReflectionFactory.Config config

The configuration is lazily initialized after the module system is initialized. The default config would be used before the proper config is loaded. The static initializer of ReflectionFactory is run before the system properties are set up. The class initialization is caused by the class initialization of java.lang.reflect.Method (more properly, caused by the class initialization for java.lang.reflect.AccessibleObject) that happens very early VM startup, initPhase1.

Annotations

@Stable

DEFAULT_CONFIG	back to summary
private static final ReflectionFactory.Config DEFAULT_CONFIG

hasStaticInitializerMethod	back to summary
private static volatile Method hasStaticInitializerMethod

langReflectAccess	back to summary
private final JavaLangReflectAccess langReflectAccess

nonSerializableLeafClasses	back to summary
private static final Set<Class<?>> nonSerializableLeafClasses These are specific leaf classes which appear to be Serializable, but which have special semantics according to the serialization specification. We could theoretically include array classes here, but it is easier and clearer to just use `Class#isArray` instead.

soleInstance	back to summary
private static final ReflectionFactory soleInstance

Constructor Detail

ReflectionFactory	back to summary
private ReflectionFactory()

Method Detail

classFileFormatVersion	back to summary
private final ClassFileFormatVersion classFileFormatVersion(Class<?> cl)

config	back to summary
private static ReflectionFactory.Config config()

copyConstructor	back to summary
public <T> Constructor<T> copyConstructor(Constructor<T> arg) Makes a copy of the passed constructor. The returned constructor is a "child" of the passed one; see the comments in Constructor.java for details.

copyField	back to summary
public Field copyField(Field arg) Makes a copy of the passed field. The returned field is a "child" of the passed one; see the comments in Field.java for details.

copyMethod	back to summary
public Method copyMethod(Method arg) Makes a copy of the passed method. The returned method is a "child" of the passed one; see the comments in Method.java for details.

defaultReadObjectForSerialization	back to summary
public final MethodHandle defaultReadObjectForSerialization(Class<?> cl)

defaultWriteObjectForSerialization	back to summary
public final MethodHandle defaultWriteObjectForSerialization(Class<?> cl)

disableSerialConstructorChecks	back to summary
private static boolean disableSerialConstructorChecks()

findReadWriteObjectForSerialization	back to summary
private final MethodHandle findReadWriteObjectForSerialization(Class<?> cl, String methodName, Class<?> streamClass)

generateConstructor	back to summary
private final Constructor<?> generateConstructor(Class<?> cl, Constructor<?> constructorToCall)

getExecutableSharedParameterTypes	back to summary
public Class<?>[] getExecutableSharedParameterTypes(Executable ex)

getExecutableTypeAnnotationBytes	back to summary
public byte[] getExecutableTypeAnnotationBytes(Executable ex) Gets the byte[] that encodes TypeAnnotations on an executable.

getReflectionFactory back to summary

getReflectionFactory	back to summary
public static ReflectionFactory getReflectionFactory() Provides the caller with the capability to instantiate reflective objects. The returned `ReflectionFactory` object should be carefully guarded by the caller, since it can be used to read and write private data and invoke private methods, as well as to load unverified bytecodes. It must never be passed to untrusted code.

public static ReflectionFactory getReflectionFactory()

Provides the caller with the capability to instantiate reflective objects.

The returned ReflectionFactory object should be carefully guarded by the caller, since it can be used to read and write private data and invoke private methods, as well as to load unverified bytecodes. It must never be passed to untrusted code.

getReplaceResolveForSerialization back to summary

getReplaceResolveForSerialization	back to summary
private MethodHandle getReplaceResolveForSerialization(Class<?> cl, String methodName) Lookup readResolve or writeReplace on a class with specified signature constraints. Parameters cl:Class<?> a serializable class methodName:String the method name to find Returns:MethodHandle a MethodHandle for the method or `null` if not found or has the wrong signature.

private MethodHandle getReplaceResolveForSerialization(Class<?> cl, String methodName)

Lookup readResolve or writeReplace on a class with specified signature constraints.

Parameters

cl:Class<?>: a serializable class
methodName:String: the method name to find

Returns:MethodHandle

a MethodHandle for the method or null if not found or has the wrong signature.

hasDefaultOrNoSerialization	back to summary
private static boolean hasDefaultOrNoSerialization(Class<?> cl)

hasStaticInitializerForSerialization	back to summary
public final boolean hasStaticInitializerForSerialization(Class<?> cl) Returns true if the given class defines a static initializer method, false otherwise.

leafCopyMethod	back to summary
public Method leafCopyMethod(Method arg) Makes a copy of the passed method. The returned method is NOT a "child" but a "sibling" of the Method in arg. Should only be used on non-root methods.

loadConfig	back to summary
private static ReflectionFactory.Config loadConfig()

newConstructorAccessor	back to summary
public ConstructorAccessor newConstructorAccessor(Constructor<?> c)

newConstructorForExternalization	back to summary
public final Constructor<?> newConstructorForExternalization(Class<?> cl)

newConstructorForSerialization	back to summary
public final Constructor<?> newConstructorForSerialization(Class<?> cl, Constructor<?> constructorToCall)

newConstructorForSerialization	back to summary
public final Constructor<?> newConstructorForSerialization(Class<?> cl) Returns a constructor that allocates an instance of cl and that then initializes the instance by calling the no-arg constructor of its first non-serializable superclass. This is specified in the Serialization Specification, section 3.1, in step 11 of the deserialization process. If cl is not serializable, returns cl's no-arg constructor. If no accessible constructor is found, or if the class hierarchy is somehow malformed (e.g., a serializable class has no superclass), null is returned. Parameters cl:Class<?> the class for which a constructor is to be found Returns:Constructor<?> the generated constructor, or null if none is available

newConstructorForSerialization

back to summary

public final Constructor<?> newConstructorForSerialization(Class<?> cl)

Returns a constructor that allocates an instance of cl and that then initializes the instance by calling the no-arg constructor of its first non-serializable superclass. This is specified in the Serialization Specification, section 3.1, in step 11 of the deserialization process. If cl is not serializable, returns cl's no-arg constructor. If no accessible constructor is found, or if the class hierarchy is somehow malformed (e.g., a serializable class has no superclass), null is returned.

Parameters

cl:Class<?>: the class for which a constructor is to be found

Returns:Constructor<?>

the generated constructor, or null if none is available

newFieldAccessor	back to summary
public FieldAccessor newFieldAccessor(Field field, boolean override)

newInstance	back to summary
public <T> T newInstance(Constructor<T> ctor, Object[] args, Class<?> caller) throws IllegalAccessException, InstantiationException, InvocationTargetException

newMethodAccessor	back to summary
public MethodAccessor newMethodAccessor(Method method, boolean callerSensitive)

newOptionalDataExceptionForSerialization	back to summary
public final Constructor<OptionalDataException> newOptionalDataExceptionForSerialization() Return the accessible constructor for OptionalDataException signaling eof. Returns:Constructor<OptionalDataException> the eof constructor for OptionalDataException

newOptionalDataExceptionForSerialization

back to summary

public final Constructor<OptionalDataException> newOptionalDataExceptionForSerialization()

Return the accessible constructor for OptionalDataException signaling eof.

Returns:Constructor<OptionalDataException>: the eof constructor for OptionalDataException

packageEquals	back to summary
private static boolean packageEquals(Class<?> cl1, Class<?> cl2) Returns true if classes are defined in the classloader and same package, false otherwise. Parameters cl1:Class<?> a class cl2:Class<?> another class Returns:boolean true if the two classes are in the same classloader and package

packageEquals

back to summary

private static boolean packageEquals(Class<?> cl1, Class<?> cl2)

Returns true if classes are defined in the classloader and same package, false otherwise.

Parameters

cl1:Class<?>: a class
cl2:Class<?>: another class

Returns:boolean

true if the two classes are in the same classloader and package

parseAccessFlags	back to summary
public final Set<AccessFlag> parseAccessFlags(int mask, AccessFlag.Location location, Class<?> classFile)

readObjectForSerialization	back to summary
public final MethodHandle readObjectForSerialization(Class<?> cl)

readObjectNoDataForSerialization	back to summary
public final MethodHandle readObjectNoDataForSerialization(Class<?> cl)

readResolveForSerialization back to summary

readResolveForSerialization	back to summary
public final MethodHandle readResolveForSerialization(Class<?> cl) Returns a MethodHandle for `readResolve` on the serializable class or null if no match found. Parameters cl:Class<?> a serializable class Returns:MethodHandle the `writeReplace` MethodHandle or `null` if not found

public final MethodHandle readResolveForSerialization(Class<?> cl)

Returns a MethodHandle for readResolve on the serializable class or null if no match found.

Parameters

cl:Class<?>: a serializable class

Returns:MethodHandle

the writeReplace MethodHandle or null if not found

serialPersistentFields	back to summary
public final ObjectStreamField[] serialPersistentFields(Class<?> cl)

superHasAccessibleConstructor	back to summary
private boolean superHasAccessibleConstructor(Class<?> cl) Given a class, determines whether its superclass has any constructors that are accessible from the class. This is a special purpose method intended to do access checking for a serializable class and its superclasses up to, but not including, the first non-serializable superclass. This also implies that the superclass is always non-null, because a serializable class must be a class (not an interface) and Object is not serializable. Parameters cl:Class<?> the class from which access is checked Returns:boolean whether the superclass has a constructor accessible from cl

superHasAccessibleConstructor

back to summary

private boolean superHasAccessibleConstructor(Class<?> cl)

Given a class, determines whether its superclass has any constructors that are accessible from the class. This is a special purpose method intended to do access checking for a serializable class and its superclasses up to, but not including, the first non-serializable superclass. This also implies that the superclass is always non-null, because a serializable class must be a class (not an interface) and Object is not serializable.

Parameters

cl:Class<?>: the class from which access is checked

Returns:boolean

whether the superclass has a constructor accessible from cl

useNativeAccessorOnly	back to summary
pack-priv static boolean useNativeAccessorOnly()

writeObjectForSerialization	back to summary
public final MethodHandle writeObjectForSerialization(Class<?> cl)

writeReplaceForSerialization back to summary

writeReplaceForSerialization	back to summary
public final MethodHandle writeReplaceForSerialization(Class<?> cl) Returns a MethodHandle for `writeReplace` on the serializable class or null if no match found. Parameters cl:Class<?> a serializable class Returns:MethodHandle the `writeReplace` MethodHandle or `null` if not found

public final MethodHandle writeReplaceForSerialization(Class<?> cl)

Returns a MethodHandle for writeReplace on the serializable class or null if no match found.

Parameters

cl:Class<?>: a serializable class

Returns:MethodHandle

the writeReplace MethodHandle or null if not found

jdk.internal.reflect back to summary

private final Record ReflectionFactory.Config

Class Inheritance

extends Record

java.lang.Object
java.lang.Record
jdk.internal.reflect.ReflectionFactory.Config

Record Components

useNativeAccessorOnly:boolean
disableSerialConstructorChecks:boolean

The configurations for the reflection factory. Configurable via system properties but only available after ReflectionFactory is loaded during early VM startup. Note that the default implementations of the object methods of this Config record (toString, equals, hashCode) use indy, which is available to use only after initPhase1. These methods are currently not called, but should they be needed, a workaround is to override them.

Field Summary

Modifier and Type	Field and Description
private final boolean	disableSerialConstructorChecks Record Component accessed by disableSerialConstructorChecks().
private final boolean	useNativeAccessorOnly Record Component accessed by useNativeAccessorOnly().

Constructor Summary

Access	Constructor and Description
private	Config(boolean useNativeAccessorOnly, boolean disableSerialConstructorChecks)

Method Summary

Modifier and Type	Method and Description
public boolean	disableSerialConstructorChecks() Record Component getter of disableSerialConstructorChecks.
public final boolean	equals(Object o) Implements abstract java.lang.Record.equals. Indicates whether some other object is "equal to" this one.
public final int	hashCode() Implements abstract java.lang.Record.hashCode. Returns a hash code value for the record.
public final String	toString() Implements abstract java.lang.Record.toString. Returns a string representation of the record.
public boolean	useNativeAccessorOnly() Record Component getter of useNativeAccessorOnly.

Field Detail

disableSerialConstructorChecks	back to summary
private final boolean disableSerialConstructorChecks Record Component accessed by disableSerialConstructorChecks().

useNativeAccessorOnly	back to summary
private final boolean useNativeAccessorOnly Record Component accessed by useNativeAccessorOnly().

Constructor Detail

Config	back to summary
private Config(boolean useNativeAccessorOnly, boolean disableSerialConstructorChecks)

Method Detail

disableSerialConstructorChecks	back to summary
public boolean disableSerialConstructorChecks() Record Component getter of disableSerialConstructorChecks.

equals back to summary

public final boolean equals(Object o)

Implements abstract java.lang.Record.equals.

Doc from java.lang.Record.equals.

Indicates whether some other object is "equal to" this one. In addition to the general contract of Object.equals, record classes must further obey the invariant that when a record instance is "copied" by passing the result of the record component accessor methods to the canonical constructor, as follows:

    R copy = new R(r.c1(), r.c2(), ..., r.cn());

then it must be the case that r.equals(copy).

hashCode back to summary

public final int hashCode()

Implements abstract java.lang.Record.hashCode.

Doc from java.lang.Record.hashCode.

Returns a hash code value for the record. Obeys the general contract of Object.hashCode. For records, hashing behavior is constrained by the refined contract of Record.equals, so that any two records created from the same components must have the same hash code.

toString back to summary

public final String toString()

Implements abstract java.lang.Record.toString.

Doc from java.lang.Record.toString.

Returns a string representation of the record. In accordance with the general contract of Object#toString(), the toString method returns a string that "textually represents" this record. The result should be a concise but informative representation that is easy for a person to read.

In addition to this general contract, record classes must further participate in the invariant that any two records which are equal must produce equal strings. This invariant is necessarily relaxed in the rare case where corresponding equal component values might fail to produce equal strings for themselves.

useNativeAccessorOnly	back to summary
public boolean useNativeAccessorOnly() Record Component getter of useNativeAccessorOnly.

public Class ReflectionFactory

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Record ReflectionFactory.Config

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail