Javadoc

Add @throws and @see tags for SecurityException and SecurityManager
respectively

Author: garydgregory

src/main/java/org/apache/commons/lang3/builder/ReflectionDiffBuilder.java

@@ -193,6 +193,12 @@ private boolean accept(final Field field) {
         return !field.isAnnotationPresent(DiffExclude.class);
     }
 
+    /**
+     * Appends fields using reflection.
+     *
+     * @throws SecurityException if an underlying accessible object's method denies the request.
+     * @see SecurityManager#checkPermission
+     */
     private void appendFields(final Class<?> clazz) {
         for (final Field field : FieldUtils.getAllFields(clazz)) {
             if (accept(field)) {
@@ -207,6 +213,12 @@ private void appendFields(final Class<?> clazz) {
         }
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @throws SecurityException if an underlying accessible object's method denies the request.
+     * @see SecurityManager#checkPermission
+     */
     @Override
     public DiffResult<T> build() {
         if (getLeft().equals(getRight())) {
@@ -234,6 +246,21 @@ private T getRight() {
         return diffBuilder.getRight();
     }
 
+    /**
+     * Reads a {@link Field}, forcing access if needed.
+     *
+     * @param field
+     *            the field to use
+     * @param target
+     *            the object to call on, may be {@code null} for {@code static} fields
+     * @return the field value
+     * @throws NullPointerException
+     *             if the field is {@code null}
+     * @throws IllegalAccessException
+     *             if the field is not made accessible
+     * @throws SecurityException if an underlying accessible object's method denies the request.
+     * @see SecurityManager#checkPermission
+     */
     private Object readField(final Field field, final Object target) throws IllegalAccessException {
         return FieldUtils.readField(field, target, true);
     }

src/main/java/org/apache/commons/lang3/event/EventUtils.java

@@ -68,6 +68,8 @@ private boolean hasMatchingParametersMethod(final Method method) {
          * @param method the method to be invoked
          * @param parameters the parameters for the method invocation
          * @return the result of the method call
+         * @throws SecurityException if an underlying accessible object's method denies the request.
+         * @see SecurityManager#checkPermission
          * @throws Throwable if an error occurs
          */
         @Override

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

@@ -103,6 +103,8 @@ public static <T> Constructor<T> getAccessibleConstructor(final Constructor<T> c
      * @param parameterTypes find method with compatible parameters
      * @return the constructor, null if no matching accessible constructor found
      * @throws NullPointerException if {@code cls} is {@code null}
+     * @throws SecurityException if an underlying accessible object's method denies the request.
+     * @see SecurityManager#checkPermission
      */
     public static <T> Constructor<T> getMatchingAccessibleConstructor(final Class<T> cls,
             final Class<?>... parameterTypes) {
@@ -157,6 +159,8 @@ public static <T> Constructor<T> getMatchingAccessibleConstructor(final Class<T>
      * @throws IllegalAccessException if invocation is not permitted by security
      * @throws InvocationTargetException if an error occurs on invocation
      * @throws InstantiationException if an error occurs on instantiation
+     * @throws SecurityException if an underlying accessible object's method denies the request.
+     * @see SecurityManager#checkPermission
      * @see #invokeConstructor(Class, Object[], Class[])
      */
     public static <T> T invokeConstructor(final Class<T> cls, Object... args)
@@ -183,6 +187,8 @@ public static <T> T invokeConstructor(final Class<T> cls, Object... args)
      * @throws IllegalAccessException if invocation is not permitted by security
      * @throws InvocationTargetException if an error occurs on invocation
      * @throws InstantiationException if an error occurs on instantiation
+     * @throws SecurityException if an underlying accessible object's method denies the request.
+     * @see SecurityManager#checkPermission
      * @see Constructor#newInstance
      */
     public static <T> T invokeConstructor(final Class<T> cls, Object[] args, Class<?>[] parameterTypes)