org.glassfish.pfl.basic.reflection

Class Bridge

java.lang.Object

org.glassfish.pfl.basic.reflection.BridgeBase

org.glassfish.pfl.basic.reflection.Bridge

public final class Bridge
extends BridgeBase

This class provides the methods for fundamental JVM operations needed in the ORB that are not part of the public Java API. This includes:

• throwException, which can throw undeclared checked exceptions. This is needed to handle throwing arbitrary exceptions across a standardized OMG interface that (incorrectly) does not specify appropriate exceptions.
• putXXX/getXXX methods that allow unchecked access to fields of objects. This is used for setting uninitialzed non-static final fields (which is impossible with reflection) and for speed.
• objectFieldOffset to obtain the field offsets for use in the putXXX/getXXX methods
• newConstructorForSerialization to get the special constructor required for a Serializable class
• latestUserDefinedLoader to get the latest user defined class loader from the call stack as required by the RMI-IIOP specification (really from the JDK 1.1 days)

The code that calls Bridge.get() must have the following Permissions:

• RuntimePermission "reflectionFactoryAccess"
• BridgePermission "getBridge"
• ReflectPermission "suppressAccessChecks"

All of these permissions are required to obtain and correctly initialize the instance of Bridge. No security checks are performed on calls made to Bridge instance methods, so access to the Bridge instance must be protected.

This class is a singleton (per ClassLoader of course). Access to the instance is obtained through the Bridge.get() method.

Field Summary

Fields inherited from class org.glassfish.pfl.basic.reflection.BridgeBase

INVALID_FIELD_OFFSET

Method Summary

Methods

Modifier and Type	Method and Description
static Bridge	get() Fetch the Bridge singleton.
ClassLoader	getLatestUserDefinedLoader() Obtain the latest user defined ClassLoader from the call stack.
boolean	hasStaticInitializerForSerialization(Class<?> cl) Returns true if the given class defines a static initializer method, false otherwise.
<T> Constructor<T>	newConstructorForExternalization(Class<T> cl) Return a constructor that can be used to create an instance of the class for externalization.
<T> Constructor<T>	newConstructorForSerialization(Class<T> aClass) Return a no-arg constructor for the specified class, based on the default constructor for its nearest non-serializable base class.
<T> Constructor<T>	newConstructorForSerialization(Class<T> aClass, Constructor<?> cons) Return a no-arg constructor for the specified class which invokes the specified constructor.
OptionalDataException	newOptionalDataExceptionForSerialization(boolean endOfData) Return a new OptionalDataException instance.
MethodHandle	readObjectForSerialization(Class<?> cl) Returns a method handle to allow invocation of the specified class's readObject method.
MethodHandle	readResolveForSerialization(Class<?> cl) Returns a method handle to allow invocation of the specified class's readResolve method.
MethodHandle	writeObjectForSerialization(Class<?> cl) Returns a method handle to allow invocation of the specified class's writeObject method.
MethodHandle	writeReplaceForSerialization(Class<?> cl) Returns a method handle to allow invocation of the specified class's writeReplace method.

Methods inherited from class org.glassfish.pfl.basic.reflection.BridgeBase

defineClass, ensureClassInitialized, getBoolean, getByte, getChar, getDouble, getFloat, getInt, getLong, getObject, getShort, objectFieldOffset, putBoolean, putByte, putChar, putDouble, putFloat, putInt, putLong, putObject, putShort, staticFieldOffset, throwException, toAccessibleField, toAccessibleMethod

Methods inherited from class java.lang.Object

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

Method Detail

get

public static Bridge get()

Fetch the Bridge singleton. This requires the following permissions:

• RuntimePermission "reflectionFactoryAccess"
• BridgePermission "getBridge"
• ReflectPermission "suppressAccessChecks"

Returns:

The singleton instance of the Bridge class

Throws:

SecurityException - if the caller does not have the required permissions and the caller has a non-null security manager.

getLatestUserDefinedLoader

public final ClassLoader getLatestUserDefinedLoader()

Description copied from class: BridgeBase

Obtain the latest user defined ClassLoader from the call stack. This is required by the RMI-IIOP specification.

Specified by:

getLatestUserDefinedLoader in class BridgeBase

newConstructorForExternalization

public final <T> Constructor<T> newConstructorForExternalization(Class<T> cl)

Description copied from class: BridgeBase

Return a constructor that can be used to create an instance of the class for externalization.

Specified by:

newConstructorForExternalization in class BridgeBase

Parameters:

cl - the class

newConstructorForSerialization

public final <T> Constructor<T> newConstructorForSerialization(Class<T> aClass,
                                                Constructor<?> cons)

Description copied from class: BridgeBase

Return a no-arg constructor for the specified class which invokes the specified constructor.

Specified by:

newConstructorForSerialization in class BridgeBase

Parameters:

aClass - the class for which a constructor should be returned.

cons - the default constructor on which to model the new constructor.

newConstructorForSerialization

public <T> Constructor<T> newConstructorForSerialization(Class<T> aClass)

Description copied from class: BridgeBase

Return a no-arg constructor for the specified class, based on the default constructor for its nearest non-serializable base class.

Specified by:

newConstructorForSerialization in class BridgeBase

Parameters:

aClass - the class for which a constructor should be returned.

hasStaticInitializerForSerialization

public boolean hasStaticInitializerForSerialization(Class<?> cl)

Description copied from class: BridgeBase

Returns true if the given class defines a static initializer method, false otherwise.

Specified by:

hasStaticInitializerForSerialization in class BridgeBase

writeObjectForSerialization

public MethodHandle writeObjectForSerialization(Class<?> cl)

Description copied from class: BridgeBase

Returns a method handle to allow invocation of the specified class's writeObject method.

Specified by:

writeObjectForSerialization in class BridgeBase

Parameters:

cl - the class containing the method

readObjectForSerialization

public MethodHandle readObjectForSerialization(Class<?> cl)

Description copied from class: BridgeBase

Returns a method handle to allow invocation of the specified class's readObject method.

Specified by:

readObjectForSerialization in class BridgeBase

Parameters:

cl - the class containing the method

readResolveForSerialization

public MethodHandle readResolveForSerialization(Class<?> cl)

Description copied from class: BridgeBase

Returns a method handle to allow invocation of the specified class's readResolve method.

Specified by:

readResolveForSerialization in class BridgeBase

Parameters:

cl - the class containing the method

writeReplaceForSerialization

public MethodHandle writeReplaceForSerialization(Class<?> cl)

Description copied from class: BridgeBase

Returns a method handle to allow invocation of the specified class's writeReplace method.

Specified by:

writeReplaceForSerialization in class BridgeBase

Parameters:

cl - the class containing the method

newOptionalDataExceptionForSerialization

public OptionalDataException newOptionalDataExceptionForSerialization(boolean endOfData)

Description copied from class: BridgeBase

Return a new OptionalDataException instance.

Specified by:

newOptionalDataExceptionForSerialization in class BridgeBase

Returns:

a new OptionalDataException instance