sample/java.lang.reflect.AccessibleObject.txt

   1 *java.lang.reflect.AccessibleObject* *AccessibleObject* The AccessibleObject cla
   2
   3 public class AccessibleObject
   4   extends    |java.lang.Object|
   5   implements |java.lang.reflect.AnnotatedElement|
   6
   7 |java.lang.reflect.AccessibleObject_Description|
   8 |java.lang.reflect.AccessibleObject_Fields|
   9 |java.lang.reflect.AccessibleObject_Constructors|
  10 |java.lang.reflect.AccessibleObject_Methods|
  11
  12 ================================================================================
  13
  14 *java.lang.reflect.AccessibleObject_Constructors*
  15 |java.lang.reflect.AccessibleObject()|Constructor: only used by the Java Virtua
  16
  17 *java.lang.reflect.AccessibleObject_Methods*
  18 |java.lang.reflect.AccessibleObject.getAnnotation(Class<T>)|
  19 |java.lang.reflect.AccessibleObject.getAnnotations()|
  20 |java.lang.reflect.AccessibleObject.getDeclaredAnnotations()|
  21 |java.lang.reflect.AccessibleObject.isAccessible()|Get the value of the accessi
  22 |java.lang.reflect.AccessibleObject.isAnnotationPresent(Class<?extendsAnnotation>)|
  23 |java.lang.reflect.AccessibleObject.setAccessible(AccessibleObject[],boolean)|C
  24 |java.lang.reflect.AccessibleObject.setAccessible(boolean)|Set the accessible f
  25
  26 *java.lang.reflect.AccessibleObject_Description*
  27
  28 The AccessibleObject class is the base class for Field, Method and Constructor
  29 objects. It provides the ability to flag a reflected object as suppressing
  30 default Java language access control checks when it is used. The access
  31 checks--for public, default (package) access, protected, and private
  32 members--are performed when Fields, Methods or Constructors are used to set or
  33 get fields, to invoke methods, or to create and initialize new instances of
  34 classes, respectively.
  35
  36 Setting the accessible flag in a reflected object permits sophisticated
  37 applications with sufficient privilege, such as Java Object Serialization or
  38 other persistence mechanisms, to manipulate objects in a manner that would
  39 normally be prohibited.
  40
  41
  42
  43 *java.lang.reflect.AccessibleObject()*
  44
  45 protected AccessibleObject()
  46
  47 Constructor: only used by the Java Virtual Machine.
  48
  49
  50 *java.lang.reflect.AccessibleObject.getAnnotation(Class<T>)*
  51
  52 public |T| getAnnotation(java.lang.Class<T> annotationClass)
  53
  54
  55
  56
  57
  58 *java.lang.reflect.AccessibleObject.getAnnotations()*
  59
  60 public |java.lang.annotation.Annotation|[] getAnnotations()
  61
  62
  63
  64
  65
  66 *java.lang.reflect.AccessibleObject.getDeclaredAnnotations()*
  67
  68 public |java.lang.annotation.Annotation|[] getDeclaredAnnotations()
  69
  70
  71
  72
  73
  74 *java.lang.reflect.AccessibleObject.isAccessible()*
  75
  76 public boolean isAccessible()
  77
  78 Get the value of the accessible flag for this object.
  79
  80
  81
  82     Returns: the value of the object's accessible flag
  83
  84 *java.lang.reflect.AccessibleObject.isAnnotationPresent(Class<?extendsAnnotation>)*
  85
  86 public boolean isAnnotationPresent(java.lang.Class<? extends java.lang.annotation.Annotation> annotationClass)
  87
  88
  89
  90
  91
  92 *java.lang.reflect.AccessibleObject.setAccessible(AccessibleObject[],boolean)*
  93
  94 public static void setAccessible(
  95   java.lang.reflect.AccessibleObject[] array,
  96   boolean flag)
  97   throws |java.lang.SecurityException|
  98
  99 Convenience method to set the accessible flag for an array of objects with a
 100 single security check (for efficiency).
 101
 102 First, if there is a security manager, its checkPermission method is called
 103 with a ReflectPermission("suppressAccessChecks") permission.
 104
 105 A SecurityException is raised if flag is true but accessibility of any of the
 106 elements of the input array may not be changed (for example, if the element
 107 object is a (|java.lang.reflect.Constructor|) object for the class
 108 (|java.lang.Class|) ). In the event of such a SecurityException, the
 109 accessibility of objects is set to flag for array elements upto (and excluding)
 110 the element for which the exception occurred; the accessibility of elements
 111 beyond (and including) the element for which the exception occurred is
 112 unchanged.
 113
 114
 115     array - the array of AccessibleObjects
 116     flag - the new value for the accessible flag in each object
 117
 118 *java.lang.reflect.AccessibleObject.setAccessible(boolean)*
 119
 120 public void setAccessible(boolean flag)
 121   throws |java.lang.SecurityException|
 122
 123 Set the accessible flag for this object to the indicated boolean value. A value
 124 of true indicates that the reflected object should suppress Java language
 125 access checking when it is used. A value of false indicates that the reflected
 126 object should enforce Java language access checks.
 127
 128 First, if there is a security manager, its checkPermission method is called
 129 with a ReflectPermission("suppressAccessChecks") permission.
 130
 131 A SecurityException is raised if flag is true but accessibility of this object
 132 may not be changed (for example, if this element object is a
 133 (|java.lang.reflect.Constructor|) object for the class (|java.lang.Class|) ).
 134
 135 A SecurityException is raised if this object is a
 136 (|java.lang.reflect.Constructor|) object for the class java.lang.Class, and
 137 flag is true.
 138
 139
 140     flag - the new value for the accessible flag
 141
 142