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)|
  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)|
  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 *java.lang.reflect.AccessibleObject()*
  43
  44 protected AccessibleObject()
  45
  46 Constructor: only used by the Java Virtual Machine.
  47
  48
  49 *java.lang.reflect.AccessibleObject.getAnnotation(Class)*
  50
  51 public |java.lang.annotation.Annotation| getAnnotation(java.lang.Class annotationClass)
  52
  53
  54
  55
  56 *java.lang.reflect.AccessibleObject.getAnnotations()*
  57
  58 public |java.lang.annotation.Annotation| getAnnotations()
  59
  60
  61
  62
  63 *java.lang.reflect.AccessibleObject.getDeclaredAnnotations()*
  64
  65 public |java.lang.annotation.Annotation| getDeclaredAnnotations()
  66
  67
  68
  69
  70 *java.lang.reflect.AccessibleObject.isAccessible()*
  71
  72 public boolean isAccessible()
  73
  74 Get the value of the accessible flag for this object.
  75
  76
  77     Returns: the value of the object's accessible flag
  78 *java.lang.reflect.AccessibleObject.isAnnotationPresent(Class)*
  79
  80 public boolean isAnnotationPresent(java.lang.Class annotationClass)
  81
  82
  83
  84
  85 *java.lang.reflect.AccessibleObject.setAccessible(AccessibleObject[],boolean)*
  86
  87 public static void setAccessible(
  88   java.lang.reflect.AccessibleObject[] array,
  89   boolean flag)
  90   throws |java.lang.SecurityException|
  91
  92 Convenience method to set the accessible flag for an array of objects with a
  93 single security check (for efficiency).
  94
  95 First, if there is a security manager, its checkPermission method is called
  96 with a ReflectPermission("suppressAccessChecks") permission.
  97
  98 A SecurityException is raised if flag is true but accessibility of any of the
  99 elements of the input array may not be changed (for example, if the element
 100 object is a (|java.lang.reflect.Constructor|) object for the class
 101 (|java.lang.Class|) ). In the event of such a SecurityException, the
 102 accessibility of objects is set to flag for array elements upto (and excluding)
 103 the element for which the exception occurred; the accessibility of elements
 104 beyond (and including) the element for which the exception occurred is
 105 unchanged.
 106
 107     array - the array of AccessibleObjects
 108     flag - the new value for the accessible flag in each object
 109
 110 *java.lang.reflect.AccessibleObject.setAccessible(boolean)*
 111
 112 public void setAccessible(boolean flag)
 113   throws |java.lang.SecurityException|
 114
 115 Set the accessible flag for this object to the indicated boolean value. A value
 116 of true indicates that the reflected object should suppress Java language
 117 access checking when it is used. A value of false indicates that the reflected
 118 object should enforce Java language access checks.
 119
 120 First, if there is a security manager, its checkPermission method is called
 121 with a ReflectPermission("suppressAccessChecks") permission.
 122
 123 A SecurityException is raised if flag is true but accessibility of this object
 124 may not be changed (for example, if this element object is a
 125 (|java.lang.reflect.Constructor|) object for the class (|java.lang.Class|) ).
 126
 127 A SecurityException is raised if this object is a
 128 (|java.lang.reflect.Constructor|) object for the class java.lang.Class, and
 129 flag is true.
 130
 131     flag - the new value for the accessible flag
 132
 133