Javadoc

Author: garydgregory

src/main/java/org/apache/commons/lang3/reflect/AccessibleObjects.java

@@ -24,10 +24,23 @@
  */
 class AccessibleObjects {
 
+    /**
+     * Delegates to {@link AccessibleObject#isAccessible()} if {@code accessibleObject} isn't null.
+     *
+     * @param accessibleObject The accessible object.
+     * @return The value of the object's {@code accessible} flag
+     */
     static boolean isAccessible(final AccessibleObject accessibleObject) {
         return accessibleObject == null || accessibleObject.isAccessible();
     }
 
+    /**
+     * Delegates to {@link AccessibleObject#setAccessible(boolean)} only if {@link AccessibleObject#isAccessible()} returns false. This avoid a
+     * permission check if there is a security manager.
+     *
+     * @param accessibleObject The accessible object.
+     * @return Whether {@link AccessibleObject#setAccessible(boolean)} was called.
+     */
     static boolean setAccessible(final AccessibleObject accessibleObject) {
         if (!isAccessible(accessibleObject)) {
             accessibleObject.setAccessible(true);