org.kohsuke.stapler.lang.MethodRef Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of stapler Show documentation

Stapler HTTP request handling engine

There is a newer version: 1.263

package org.kohsuke.stapler.lang;

import java.lang.annotation.Annotation;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import javax.annotation.CheckForNull;

/**
 * @author Kohsuke Kawaguchi
 * @since 1.220
 */
public abstract class MethodRef extends AnnotatedRef {
    /**
     * Returns true if this method is a 'public' method that should be used for routing requests.
     */
    public boolean isRoutable() {
        return true;
    }
    
    /**
     * Retrieves the referenced method name.
     * Some implementations (e.g. Ruby) cannot guarantee availability of names for all cases,
     * so sometimes the name may be missing.
     * @return Method name. {@code null} if it cannot be determined.
     * @since 1.248
     */
    @CheckForNull
    public String getName() {
        return null;
    }

    public abstract Object invoke(Object _this, Object... args) throws InvocationTargetException, IllegalAccessException;

    public static MethodRef wrap(final Method m) {
        m.setAccessible(true);

        return new MethodRef() {
            @Override
            public  T getAnnotation(Class type) {
                return m.getAnnotation(type);
            }

            @Override
            public boolean isRoutable() {
                if (m.isBridge())    return false;
                return (m.getModifiers() & Modifier.PUBLIC)!=0;
            }
      
            @Override
            public String getName() {
                return m.getName();
            }
            
            @Override
            public Object invoke(Object _this, Object... args) throws InvocationTargetException, IllegalAccessException {
                return m.invoke(_this,args);
            }
        };
    }
}