org.opencastproject.util.ReflectionUtil Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of opencast-common Show documentation
There is a newer version: 16.7
/**
 * Licensed to The Apereo Foundation under one or more contributor license
 * agreements. See the NOTICE file distributed with this work for additional
 * information regarding copyright ownership.
 *
 *
 * The Apereo Foundation licenses this file to you under the Educational
 * Community License, Version 2.0 (the "License"); you may not use this file
 * except in compliance with the License. You may obtain a copy of the License
 * at:
 *
 *   http://opensource.org/licenses/ecl2.txt
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
 * License for the specific language governing permissions and limitations under
 * the License.
 *
 */

package org.opencastproject.util;

import static org.opencastproject.util.data.functions.Misc.chuck;

import org.opencastproject.util.data.Function;

import java.lang.reflect.Method;
import java.lang.reflect.Modifier;

/** Reflection utils. */
public final class ReflectionUtil {
    private ReflectionUtil() {
    }

    /**
     * Simple helper to avoid unnecessary return null; statements when using {@link #run(Object)},
     * {@link #run(Class, Object)} or {@link #xfer(Object, Class, org.opencastproject.util.data.Function)}.
     * Just wrap your expression like this return call(expr).
     */
    public static  A call(Object expression) {
        return null;
    }

    public static boolean bcall(Object expression) {
        return false;
    }

    public static long lcall(Object expression) {
        return 0L;
    }

    public static int icall(Object expression) {
        return 0;
    }

    public static double dcall(Object expression) {
        return 0D;
    }

    /**
     * Call all parameterless methods of c on object o.
     * 
     * Does not call any bridge, synthetic or native methods and also no methods declared in Object.
     */
    public static  void run(Class c, B o) {
        runInternal(c.getMethods(), o);
    }

    /**
     * Call all parameterless methods of object a.
     * 

     * Does not call any bridge, synthetic or native methods and also no methods declared in Object.
     */
    public static  void run(A a) {
        runInternal(a.getClass().getMethods(), a);
    }

    private static  void runInternal(Method[] ms, A a) {
        try {
            for (Method m : ms) {
                if (m.getParameterTypes().length == 0
                        && !m.getDeclaringClass().equals(Object.class)
                        && !m.isBridge() && !m.isSynthetic()
                        && !Modifier.isNative(m.getModifiers())) {
                    m.invoke(a);
                }
            }
        } catch (Exception e) {
            chuck(e);
        }
    }

    /**
     * Helper method for the transfer idiom.
     * 

     * Take target and apply it to f. Take the result and call all
     * parameterless methods on it that are described by class source. This way f
     * is able to create a transfer object that sets all properties of target.
     * 
     * The advantage of this style is that each time the source class changes the compiler
     * will yield an error if a field is missed in the transfer. The common getter/setter or constructor idiom
     * does not detect errors of this kind at compile time.
     */
    public static  A xfer(A target, Class source, Function f) {
        final B b = f.apply(target);
        run(source, b);
        return target;
    }
}