| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You 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 org.apache.commons.jexl2.introspection; |
| |
| import java.util.Iterator; |
| import java.lang.reflect.Constructor; |
| import org.apache.commons.jexl2.JexlInfo; |
| |
| /** |
| * 'Federated' introspection/reflection interface to allow the introspection |
| * behavior in JEXL to be customized. |
| * |
| * @since 1.0 |
| * @author <a href="mailto:geirm@apache.org">Geir Magusson Jr.</a> |
| * @version $Id$ |
| */ |
| 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} |
| */ |
| Constructor<?> getConstructor(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); |
| |
| } |