Eclipse ORB Primitive Function Library 5.1.1 · org.glassfish.pfl.basic.reflection.Bridge

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.

Modifier and Type	Field and Description
private static Bridge	bridge
private static final Permission	GET_BRIDGE_PERMISSION
private final ReflectionFactory	reflectionFactory

Access	Constructor and Description
private	Bridge()

Modifier and Type	Method and Description
public static synchronized Bridge	Returns: The singleton instance of the Bridge class get() Fetch the Bridge singleton.
public boolean	hasStaticInitializerForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.hasStaticInitializerForSerialization. Returns true if the given class defines a static initializer method, false otherwise.
public <T> Constructor<T>	newConstructorForExternalization(Class<T> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForExternalization. Return a constructor that can be used to create an instance of the class for externalization.
public <T> Constructor<T>	newConstructorForSerialization(Class<T> aClass, Constructor<?> cons) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization. Return a no-arg constructor for the specified class which invokes the specified constructor.
public <T> Constructor<T>	newConstructorForSerialization(Class<T> aClass) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization. Return a no-arg constructor for the specified class, based on the default constructor for its nearest non-serializable base class.
public OptionalDataException	newOptionalDataExceptionForSerialization(boolean bool) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newOptionalDataExceptionForSerialization. Return a new OptionalDataException instance.
public MethodHandle	readObjectForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.readObjectForSerialization. Returns a method handle to allow invocation of the specified class's readObject method.
public MethodHandle	readObjectNoDataForSerialization(Class<?> cl)
public MethodHandle	readResolveForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.readResolveForSerialization. Returns a method handle to allow invocation of the specified class's readResolve method.
public MethodHandle	writeObjectForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.writeObjectForSerialization. Returns a method handle to allow invocation of the specified class's writeObject method.
public MethodHandle	writeReplaceForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.writeReplaceForSerialization. Returns a method handle to allow invocation of the specified class's writeReplace method.

bridge	back to summary
private static Bridge bridge

GET_BRIDGE_PERMISSION	back to summary
private static final Permission GET_BRIDGE_PERMISSION

reflectionFactory	back to summary
private final ReflectionFactory reflectionFactory

Bridge	back to summary
private Bridge()

Method Detail

get	back to summary
public static synchronized Bridge get() Fetch the Bridge singleton. This requires the following permissions: RuntimePermission "reflectionFactoryAccess" BridgePermission "getBridge" ReflectPermission "suppressAccessChecks" Returns:Bridge The singleton instance of the Bridge class Exceptions SecurityException: if the caller does not have the required permissions and the caller has a non-null security manager.

get

back to summary

public static synchronized Bridge get()

Fetch the Bridge singleton. This requires the following permissions:

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

Returns:Bridge

The singleton instance of the Bridge class

Exceptions

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

hasStaticInitializerForSerialization	back to summary
public boolean hasStaticInitializerForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.hasStaticInitializerForSerialization. Returns true if the given class defines a static initializer method, false otherwise. Annotations @Override

hasStaticInitializerForSerialization

back to summary

public boolean hasStaticInitializerForSerialization(Class<?> cl)

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.hasStaticInitializerForSerialization.

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

Annotations

@Override

newConstructorForExternalization	back to summary
public <T> Constructor<T> newConstructorForExternalization(Class<T> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForExternalization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForExternalization. Return a constructor that can be used to create an instance of the class for externalization. Annotations @Override @SuppressWarnings:unchecked

newConstructorForExternalization

back to summary

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

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForExternalization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForExternalization.

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

Annotations

@Override
@SuppressWarnings:unchecked

newConstructorForSerialization	back to summary
public <T> Constructor<T> newConstructorForSerialization(Class<T> aClass, Constructor<?> cons) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization. Return a no-arg constructor for the specified class which invokes the specified constructor. Annotations @Override @SuppressWarnings:unchecked

newConstructorForSerialization

back to summary

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

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization.

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

Annotations

@Override
@SuppressWarnings:unchecked

newConstructorForSerialization	back to summary
public <T> Constructor<T> newConstructorForSerialization(Class<T> aClass) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization. Return a no-arg constructor for the specified class, based on the default constructor for its nearest non-serializable base class. Annotations @Override @SuppressWarnings:unchecked

newConstructorForSerialization

back to summary

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

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newConstructorForSerialization.

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

Annotations

@Override
@SuppressWarnings:unchecked

newOptionalDataExceptionForSerialization	back to summary
public OptionalDataException newOptionalDataExceptionForSerialization(boolean bool) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newOptionalDataExceptionForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newOptionalDataExceptionForSerialization. Return a new OptionalDataException instance. Annotations @Override

newOptionalDataExceptionForSerialization

back to summary

public OptionalDataException newOptionalDataExceptionForSerialization(boolean bool)

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.newOptionalDataExceptionForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.newOptionalDataExceptionForSerialization.

Return a new OptionalDataException instance.

Annotations

@Override

readObjectForSerialization	back to summary
public MethodHandle readObjectForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.readObjectForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.readObjectForSerialization. Returns a method handle to allow invocation of the specified class's readObject method. Annotations @Override

readObjectForSerialization

back to summary

public MethodHandle readObjectForSerialization(Class<?> cl)

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.readObjectForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.readObjectForSerialization.

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

Annotations

@Override

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

readResolveForSerialization	back to summary
public MethodHandle readResolveForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.readResolveForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.readResolveForSerialization. Returns a method handle to allow invocation of the specified class's readResolve method. Annotations @Override

readResolveForSerialization

back to summary

public MethodHandle readResolveForSerialization(Class<?> cl)

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.readResolveForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.readResolveForSerialization.

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

Annotations

@Override

writeObjectForSerialization	back to summary
public MethodHandle writeObjectForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.writeObjectForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.writeObjectForSerialization. Returns a method handle to allow invocation of the specified class's writeObject method. Annotations @Override

writeObjectForSerialization

back to summary

public MethodHandle writeObjectForSerialization(Class<?> cl)

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.writeObjectForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.writeObjectForSerialization.

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

Annotations

@Override

writeReplaceForSerialization	back to summary
public MethodHandle writeReplaceForSerialization(Class<?> cl) Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.writeReplaceForSerialization. Doc from org.glassfish.pfl.basic.reflection.BridgeBase.writeReplaceForSerialization. Returns a method handle to allow invocation of the specified class's writeReplace method. Annotations @Override

writeReplaceForSerialization

back to summary

public MethodHandle writeReplaceForSerialization(Class<?> cl)

Implements abstract org.glassfish.pfl.basic.reflection.BridgeBase.writeReplaceForSerialization.

Doc from org.glassfish.pfl.basic.reflection.BridgeBase.writeReplaceForSerialization.

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

Annotations

@Override

public final Class Bridge

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail