Uberspect.java

/*
* Copyright 2016 Nabarun Mondal
* Licensed under the Apache 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://www.apache.org/licenses/LICENSE-2.0

* 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 com.noga.njexl.lang.introspection;

import java.lang.reflect.Constructor;
import java.util.Iterator;

import com.noga.njexl.lang.JexlInfo;

/**
 * 'Federated' introspection/reflection interface to allow the introspection
 * behavior in JEXL to be customized.
 * 
 * @since 1.0
 */
public interface Uberspect {
    /** Sets the class loader to use when getting a constructor with
     * a class name parameter.
     * @param loader the class loader
     */
    void setClassLoader(ClassLoader loader);

    /**
     * Returns a class constructor.
     * @param ctorHandle a class or class name
     * @param args constructor arguments
     * @param info contextual information
     * @return a {@link Constructor}
     */
    @Deprecated
    Constructor<?> getConstructor(Object ctorHandle, Object[] args, JexlInfo info);
    
    /**
     * Returns a class constructor wrapped in a JexlMethod.
     * @param ctorHandle a class or class name
     * @param args constructor arguments
     * @param info contextual information
     * @return a {@link Constructor}
     * @since 2.1
     */
    JexlMethod getConstructorMethod(Object ctorHandle, Object[] args, JexlInfo info);
    
    /**
     * Returns a JexlMethod.
     * @param obj the object
     * @param method the method name
     * @param args method arguments
     * @param info contextual information
     * @return a {@link JexlMethod}
     */
    JexlMethod getMethod(Object obj, String method, Object[] args, JexlInfo info);

    /**
     * Property getter.
     * <p>Returns JexlPropertyGet appropos for ${bar.woogie}.
     * @param obj the object to get the property from
     * @param identifier property name
     * @param info contextual information
     * @return a {@link JexlPropertyGet}
     */
    JexlPropertyGet getPropertyGet(Object obj, Object identifier, JexlInfo info);

    /**
     * Property setter.
     * <p>returns JelPropertySet appropos for ${foo.bar = "geir"}</p>.
     * @param obj the object to get the property from.
     * @param identifier property name
     * @param arg value to set
     * @param info contextual information
     * @return a {@link JexlPropertySet}.
     */
    JexlPropertySet getPropertySet(Object obj, Object identifier, Object arg, JexlInfo info);

    /**
     * Gets an iterator from an object.
     * @param obj to get the iterator for
     * @param info contextual information
     * @return an iterator over obj
     */
    Iterator<?> getIterator(Object obj, JexlInfo info);

}