Package org.glassfish.pfl.basic.reflection

Class 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 Detail

      • GET_BRIDGE_PERMISSION

        private static final java.security.Permission GET_BRIDGE_PERMISSION

      • bridge

        private static Bridge bridge

      • latestUserDefinedLoaderMethod

        private final java.lang.reflect.Method latestUserDefinedLoaderMethod

      • optionalDataExceptionConstructor

        private final java.lang.reflect.Constructor<java.io.OptionalDataException> optionalDataExceptionConstructor

      • reflectionFactory

        private final sun.reflect.ReflectionFactory reflectionFactory

      • hasStaticInitializerMethod

        private static java.lang.reflect.Method hasStaticInitializerMethod

    • Constructor Detail

      • Bridge

        private Bridge()

    • Method Detail

      • getLatestUserDefinedLoaderMethod

        private java.lang.reflect.Method getLatestUserDefinedLoaderMethod()

      • getOptDataExceptionCtor

        private java.lang.reflect.Constructor<java.io.OptionalDataException> getOptDataExceptionCtor()

      • 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:
        java.lang.SecurityException - if the caller does not have the required permissions and the caller has a non-null security manager.

      • getLatestUserDefinedLoader

        public final java.lang.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> java.lang.reflect.Constructor<T> newConstructorForExternalization​(java.lang.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

      • isPublic

        private static boolean isPublic​(java.lang.reflect.Constructor<?> cons)

      • newConstructorForSerialization

        public final <T> java.lang.reflect.Constructor<T> newConstructorForSerialization​(java.lang.Class<T> aClass,
                                                                                 java.lang.reflect.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> java.lang.reflect.Constructor<T> newConstructorForSerialization​(java.lang.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.

      • getNearestNonSerializableBaseClass

        private static <T> java.lang.Class<?> getNearestNonSerializableBaseClass​(java.lang.Class<T> clazz)

      • isAccessibleFromSubclass

        private static boolean isAccessibleFromSubclass​(java.lang.reflect.Constructor<?> constructor,
                                                java.lang.Class<?> clazz,
                                                java.lang.Class<?> baseClass)

      • inSamePackage

        private static boolean inSamePackage​(java.lang.Class<?> clazz,
                                     java.lang.Class<?> baseClass)

      • isPublicOrProtected

        private static boolean isPublicOrProtected​(java.lang.reflect.Constructor<?> constructor)

      • isPrivate

        private static boolean isPrivate​(java.lang.reflect.Constructor<?> cons)

      • hasStaticInitializerForSerialization

        public boolean hasStaticInitializerForSerialization​(java.lang.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

      • getHasStaticInitializerMethod

        private static java.lang.reflect.Method getHasStaticInitializerMethod()
                                                               throws java.lang.NoSuchMethodException
        Throws:
        java.lang.NoSuchMethodException

      • writeObjectForSerialization

        public java.lang.invoke.MethodHandle writeObjectForSerialization​(java.lang.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

      • toMethodHandle

        private static java.lang.invoke.MethodHandle toMethodHandle​(java.lang.reflect.Method method)

      • getPrivateMethod

        private static java.lang.reflect.Method getPrivateMethod​(java.lang.Class<?> cl,
                                                         java.lang.String name,
                                                         java.lang.Class<?> returnType,
                                                         java.lang.Class<?>... argTypes)

      • isStatic

        private static boolean isStatic​(java.lang.reflect.Method method)

      • isPrivate

        private static boolean isPrivate​(java.lang.reflect.Method method)

      • readObjectForSerialization

        public java.lang.invoke.MethodHandle readObjectForSerialization​(java.lang.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 java.lang.invoke.MethodHandle readResolveForSerialization​(java.lang.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

      • getInheritableMethod

        private static java.lang.reflect.Method getInheritableMethod​(java.lang.Class<?> cl,
                                                             java.lang.String name,
                                                             java.lang.Class<?> returnType,
                                                             java.lang.Class<?>... argTypes)

      • getMatchingMethod

        private static java.lang.reflect.Method getMatchingMethod​(java.lang.Class<?> cl,
                                                          java.lang.String name,
                                                          java.lang.Class<?> returnType,
                                                          java.lang.Class<?>[] argTypes)

      • isMethodInheritableBy

        private static boolean isMethodInheritableBy​(java.lang.Class<?> callingClass,
                                             java.lang.reflect.Method method)

      • packageEquals

        private static boolean packageEquals​(java.lang.Class<?> cl1,
                                     java.lang.Class<?> cl2)
        Returns true if classes are defined in the same package, false Copied from the Merlin java.io.ObjectStreamClass.

      • writeReplaceForSerialization

        public java.lang.invoke.MethodHandle writeReplaceForSerialization​(java.lang.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 java.io.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