/**
* Copyright (c) 2014, the Railo Company Ltd.
* Copyright (c) 2015, Lucee Assosication Switzerland
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*
*/
package lucee.runtime.reflection;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Member;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.util.ArrayList;
import java.util.Calendar;
import java.util.Date;
import java.util.HashSet;
import java.util.Hashtable;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;
import java.util.TimeZone;
import java.util.Vector;
import lucee.commons.io.res.Resource;
import lucee.commons.lang.ClassUtil;
import lucee.commons.lang.ExceptionUtil;
import lucee.commons.lang.StringUtil;
import lucee.commons.lang.types.RefInteger;
import lucee.commons.lang.types.RefIntegerImpl;
import lucee.runtime.Component;
import lucee.runtime.config.Constants;
import lucee.runtime.engine.ThreadLocalPageContext;
import lucee.runtime.exp.ApplicationException;
import lucee.runtime.exp.ExpressionException;
import lucee.runtime.exp.PageException;
import lucee.runtime.exp.PageRuntimeException;
import lucee.runtime.exp.SecurityException;
import lucee.runtime.java.JavaObject;
import lucee.runtime.net.rpc.AxisCaster;
import lucee.runtime.net.rpc.Pojo;
import lucee.runtime.op.Caster;
import lucee.runtime.op.Decision;
import lucee.runtime.op.Duplicator;
import lucee.runtime.op.Operator;
import lucee.runtime.reflection.pairs.ConstructorInstance;
import lucee.runtime.reflection.pairs.MethodInstance;
import lucee.runtime.reflection.storage.SoftMethodStorage;
import lucee.runtime.reflection.storage.WeakConstructorStorage;
import lucee.runtime.reflection.storage.WeakFieldStorage;
import lucee.runtime.type.Array;
import lucee.runtime.type.Collection;
import lucee.runtime.type.Collection.Key;
import lucee.runtime.type.KeyImpl;
import lucee.runtime.type.ObjectWrap;
import lucee.runtime.type.Query;
import lucee.runtime.type.Struct;
import lucee.runtime.type.util.ArrayUtil;
import lucee.runtime.type.util.Type;
/**
* Class to reflect on Objects and classes
*/
public final class Reflector {
private static final Object NULL = new Object();
private static final Collection.Key SET_ACCESSIBLE = KeyImpl.intern("setAccessible");
private static final Collection.Key EXIT = KeyImpl.intern("exit");
private static WeakConstructorStorage cStorage=new WeakConstructorStorage();
private static WeakFieldStorage fStorage=new WeakFieldStorage();
private static SoftMethodStorage mStorage=new SoftMethodStorage();
/**
* check if Class is instanceof a a other Class
* @param srcClassName Class name to check
* @param trg is Class of?
* @return is Class Class of...
*/
public static boolean isInstaneOf(String srcClassName,Class trg) {
Class clazz = ClassUtil.loadClass(srcClassName, null);
if(clazz==null) return false;
return isInstaneOf(clazz,trg);
}
/**
* check if Class is instanceof a a other Class
* @param srcClassName Class name to check
* @param trgClassName is Class of?
* @return is Class Class of...
*/
public static boolean isInstaneOf(String srcClassName,String trgClassName) {
Class clazz = ClassUtil.loadClass(srcClassName, null);
if(clazz==null) return false;
return isInstaneOf(clazz,trgClassName);
}
/**
* check if Class is instanceof a a other Class
* @param src is Class of?
* @param trgClassName Class name to check
* @return is Class Class of...
*/
public static boolean isInstaneOf(Class src, String trgClassName) {
Class clazz = ClassUtil.loadClass(trgClassName, null);
if(clazz==null) return false;
return isInstaneOf(src,clazz);
}
public static boolean isInstaneOfIgnoreCase(Class src ,String trg) {
if(src.isArray()) {
return isInstaneOfIgnoreCase(src.getComponentType() ,trg);
}
if(src.getName().equalsIgnoreCase(trg))return true;
// Interface
if(_checkInterfaces(src,trg)) {
return true;
}
// Extends
src=src.getSuperclass();
if(src!=null) return isInstaneOfIgnoreCase(src, trg);
return false;
}
/**
* check if Class is instanceof a a other Class
* @param src Class to check
* @param trg is Class of?
* @return is Class Class of...
*/
public static boolean isInstaneOf(Class src ,Class trg) {
if(src.isArray() && trg.isArray()) {
return isInstaneOf(src.getComponentType() ,trg.getComponentType());
}
if(src==trg)return true;
// Interface
if(trg.isInterface()) {
return _checkInterfaces(src,trg);
}
// Extends
while(src!=null) {
if(src==trg) return true;
src=src.getSuperclass();
}
return trg==Object.class;
}
private static boolean _checkInterfaces(Class src, String trg) {
Class[] interfaces = src.getInterfaces();
if(interfaces==null) return false;
for(int i=0;i<interfaces.length;i++) {
if(interfaces[i].getName().equalsIgnoreCase(trg))return true;
if(_checkInterfaces(interfaces[i],trg)) return true;
}
return false;
}
private static boolean _checkInterfaces(Class src, Class trg) {
Class[] interfaces = src.getInterfaces();
if(interfaces==null) return false;
for(int i=0;i<interfaces.length;i++) {
if(interfaces[i]==trg)return true;
if(_checkInterfaces(interfaces[i],trg)) return true;
}
src=src.getSuperclass();
if(src!=null) return _checkInterfaces(src,trg);
return false;
}
/**
* get all Classes from a Object Array
* @param objs Objects to get
* @return classes from Objects
*/
public static Class[] getClasses(Object[] objs) {
Class[] cls=new Class[objs.length];
for(int i=0;i<objs.length;i++) {
if(objs[i]==null)cls[i]=Object.class;
else cls[i]=objs[i].getClass();
}
return cls;
}
/**
* convert a primitive class Type to a Reference Type (Example: int -> java.lang.Integer)
* @param c Class to convert
* @return converted Class (if primitive)
*/
public static Class toReferenceClass(Class c) {
if(c.isPrimitive()) {
if(c==boolean.class) return Boolean.class;
if(c==byte.class) return Byte.class;
if(c==short.class) return Short.class;
if(c==char.class) return Character.class;
if(c==int.class) return Integer.class;
if(c==long.class) return Long.class;
if(c==float.class) return Float.class;
if(c==double.class) return Double.class;
}
return c;
}
/**
* creates a string list with class arguments in a displable form
* @param clazzArgs arguments to display
* @return list
*/
public static String getDspMethods(Class... clazzArgs) {
StringBuffer sb=new StringBuffer();
for(int i=0;i<clazzArgs.length;i++) {
if(i>0)sb.append(", ");
sb.append(Caster.toTypeName(clazzArgs[i]));
}
return sb.toString();
}
/**
* checks if src Class is "like" trg class
* @param src Source Class
* @param trg Target Class
* @return is similar
*/
public static boolean like(Class src, Class trg) {
if(src==trg) return true;
return isInstaneOf(src,trg);
}
/**
* convert Object from src to trg Type, if possible
* @param src Object to convert
* @param srcClass Source Class
* @param trgClass Target Class
* @return converted Object
* @throws PageException
*/
public static Object convert(Object src, Class trgClass, RefInteger rating) throws PageException {
if(rating!=null) {
Object trg = _convert(src, trgClass);
if(src==trg) {
rating.plus(10);
return trg;
}
if(src==null || trg==null) {
rating.plus(0);
return trg;
}
if(isInstaneOf(src.getClass(), trg.getClass())) {
rating.plus(9);
return trg;
}
if(src.equals(trg)) {
rating.plus(8);
return trg;
}
// different number
boolean bothNumbers=src instanceof Number && trg instanceof Number;
if(bothNumbers && ((Number)src).doubleValue()==((Number)trg).doubleValue()) {
rating.plus(7);
return trg;
}
String sSrc=Caster.toString(src,null);
String sTrg=Caster.toString(trg,null);
if(sSrc!=null && sTrg!=null) {
// different number types
if(src instanceof Number && trg instanceof Number && sSrc.equals(sTrg)) {
rating.plus(6);
return trg;
}
// looks the same
if(sSrc.equals(sTrg)) {
rating.plus(5);
return trg;
}
if(sSrc.equalsIgnoreCase(sTrg)) {
rating.plus(4);
return trg;
}
}
// CF Equal
try {
if(Operator.equals(src, trg, false, true)) {
rating.plus(3);
return trg;
}
} catch(Throwable t) {ExceptionUtil.rethrowIfNecessary(t);}
return trg;
}
return _convert(src, trgClass);
}
public static Object _convert(Object src, Class trgClass) throws PageException {
if(src==null) {
if(trgClass.isPrimitive())
throw new ApplicationException("can't convert [null] to ["+trgClass.getName()+"]");
return null;
}
if(like(src.getClass(), trgClass)) return src;
String className=trgClass.getName();
if(src instanceof ObjectWrap) {
src = ((ObjectWrap) src).getEmbededObject();
return _convert(src, trgClass);
}
if(className.startsWith("java.lang.")){
if(trgClass==Boolean.class) return Caster.toBoolean(src);
if(trgClass==Integer.class) return Caster.toInteger(src);
if(trgClass==String.class) return Caster.toString(src);
if(trgClass==Byte.class) return Caster.toByte(src);
if(trgClass==Short.class) return Caster.toShort(src);
if(trgClass==Long.class) return Caster.toLong(src);
if(trgClass==Float.class) return Caster.toFloat(src);
if(trgClass==Double.class) return Caster.toDouble(src);
if(trgClass==Character.class) {
String str=Caster.toString(src,null);
if(str!=null && str.length()==1) return new Character(str.charAt(0));
}
}
if(Decision.isArray(src)) {
if(trgClass.isArray()) {
return toNativeArray(trgClass,src);
}
else if(isInstaneOf(trgClass, List.class)) {
return Caster.toList(src);
}
else if(isInstaneOf(trgClass, Array.class)) {
return Caster.toArray(src);
}
}
if(trgClass==Calendar.class && Decision.isDate(src, true)) {
TimeZone tz = ThreadLocalPageContext.getTimeZone();
return Caster.toCalendar(Caster.toDate(src, tz),tz,Locale.US);
}
if(trgClass==Date.class) return Caster.toDate(src,true,null);
else if(trgClass==Query.class) return Caster.toQuery(src);
else if(trgClass==Map.class) return Caster.toMap(src);
else if(trgClass==Struct.class) return Caster.toStruct(src);
else if(trgClass==Resource.class) return Caster.toResource(ThreadLocalPageContext.get(),src,false);
// this 2 method are used to support conversion that match neo src types
else if(trgClass==Hashtable.class) return Caster.toHashtable(src);
else if(trgClass==Vector.class) return Caster.toVetor(src);
else if(trgClass==java.util.Collection.class) return Caster.toJavaCollection(src);
else if(trgClass==TimeZone.class && Decision.isString(src)) return Caster.toTimeZone(Caster.toString(src));
else if(trgClass==Collection.Key.class) return KeyImpl.toKey(src);
else if(trgClass==Locale.class && Decision.isString(src)) return Caster.toLocale(Caster.toString(src));
else if(Reflector.isInstaneOf(trgClass, Pojo.class) && src instanceof Map) {
Struct sct=Caster.toStruct(src);
try{
Pojo pojo=(Pojo) trgClass.newInstance();
if(sct instanceof Component)
return AxisCaster.toPojo(pojo, null, null, null, (Component)sct, new HashSet<Object>());
return AxisCaster.toPojo(pojo, null, null, null,sct, new HashSet<Object>());
}
catch(Throwable t) {ExceptionUtil.rethrowIfNecessary(t);}
}
if(trgClass.isPrimitive()) {
//return convert(src,srcClass,toReferenceClass(trgClass));
return _convert(src,toReferenceClass(trgClass));
}
throw new ApplicationException("can't convert ["+Caster.toClassName(src)+"] to ["+Caster.toClassName(trgClass)+"]");
}
/**
* gets Constructor Instance matching given parameter
* @param clazz Clazz to Invoke
* @param args Matching args
* @return Matching ConstructorInstance
* @throws NoSuchMethodException
* @throws PageException
*/
public static ConstructorInstance getConstructorInstance(Class clazz, Object[] args) throws NoSuchMethodException {
ConstructorInstance ci=getConstructorInstance(clazz, args,null);
if(ci!=null) return ci;
throw new NoSuchMethodException("No matching Constructor for "+clazz.getName()+"("+getDspMethods(getClasses(args))+") found");
}
public static ConstructorInstance getConstructorInstance(Class clazz, Object[] args, ConstructorInstance defaultValue) {
args=cleanArgs(args);
Constructor[] constructors=cStorage.getConstructors(clazz,args.length);//getConstructors(clazz);
if(constructors!=null) {
Class[] clazzArgs = getClasses(args);
// exact comparsion
outer:for(int i=0;i<constructors.length;i++) {
if(constructors[i]!=null) {
Class[] parameterTypes = constructors[i].getParameterTypes();
for(int y=0;y<parameterTypes.length;y++) {
if(toReferenceClass(parameterTypes[y])!=clazzArgs[y]) continue outer;
}
return new ConstructorInstance(constructors[i],args);
}
}
// like comparsion
outer:for(int i=0;i<constructors.length;i++) {
if(constructors[i]!=null) {
Class[] parameterTypes = constructors[i].getParameterTypes();
for(int y=0;y<parameterTypes.length;y++) {
if(!like(clazzArgs[y],toReferenceClass(parameterTypes[y]))) continue outer;
}
return new ConstructorInstance(constructors[i],args);
}
}
// convert comparsion
ConstructorInstance ci=null;
int _rating=0;
outer:for(int i=0;i<constructors.length;i++) {
if(constructors[i]!=null) {
RefInteger rating=(constructors.length>1)?new RefIntegerImpl(0):null;
Class[] parameterTypes = constructors[i].getParameterTypes();
Object[] newArgs = new Object[args.length];
for(int y=0;y<parameterTypes.length;y++) {
try {
newArgs[y]=convert(args[y],toReferenceClass(parameterTypes[y]),rating);
} catch (PageException e) {
continue outer;
}
}
if(ci==null || rating.toInt()>_rating) {
if(rating!=null)_rating=rating.toInt();
ci=new ConstructorInstance(constructors[i],newArgs);
}
//return new ConstructorInstance(constructors[i],newArgs);
}
}
return ci;
}
return defaultValue;
//throw new NoSuchMethodException("No matching Constructor for "+clazz.getName()+"("+getDspMethods(getClasses(args))+") found");
}
/**
* gets the MethodInstance matching given Parameter
* @param objMaybeNull maybe null
* @param clazz Class Of the Method to get
* @param methodName Name of the Method to get
* @param args Arguments of the Method to get
* @return return Matching Method
* @throws
*/
public static MethodInstance getMethodInstanceEL(Object objMaybeNull,Class clazz, Collection.Key methodName, Object[] args) {
checkAccessibility(objMaybeNull,clazz, methodName);
args=cleanArgs(args);
Method[] methods = mStorage.getMethods(clazz,methodName,args.length);//getDeclaredMethods(clazz);
if(methods!=null) {
Class[] clazzArgs = getClasses(args);
// exact comparsion
//print.e("exact:"+methodName);
outer:for(int i=0;i<methods.length;i++) {
if(methods[i]!=null) {
Class[] parameterTypes = methods[i].getParameterTypes();
for(int y=0;y<parameterTypes.length;y++) {
if(toReferenceClass(parameterTypes[y])!=clazzArgs[y]) continue outer;
}
return new MethodInstance(methods[i],args);
}
}
// like comparsion
//MethodInstance mi=null;
// print.e("like:"+methodName);
outer:for(int i=0;i<methods.length;i++) {
if(methods[i]!=null) {
Class[] parameterTypes = methods[i].getParameterTypes();
for(int y=0;y<parameterTypes.length;y++) {
if(!like(clazzArgs[y],toReferenceClass(parameterTypes[y]))) continue outer;
}
return new MethodInstance(methods[i],args);
}
}
// convert comparsion
// print.e("convert:"+methodName);
MethodInstance mi=null;
int _rating=0;
outer:for(int i=0;i<methods.length;i++) {
if(methods[i]!=null) {
RefInteger rating=(methods.length>1)?new RefIntegerImpl(0):null;
Class[] parameterTypes = methods[i].getParameterTypes();
Object[] newArgs = new Object[args.length];
for(int y=0;y<parameterTypes.length;y++) {
try {
newArgs[y]=convert(args[y],toReferenceClass(parameterTypes[y]),rating);
} catch (PageException e) {
continue outer;
}
}
if(mi==null || rating.toInt()>_rating) {
if(rating!=null)_rating=rating.toInt();
mi=new MethodInstance(methods[i],newArgs);
}
//return new MethodInstance(methods[i],newArgs);
}
}return mi;
}
return null;
}
private static Object[] cleanArgs(Object[] args) {
Set<Object> done=new HashSet<Object>();
if(args==null) return args;
for(int i=0;i<args.length;i++){
args[i]=_clean(done,args[i]);
}
return args;
}
private static Object _clean(Set<Object> done,Object obj) {
if(done.contains(obj)) return obj;
done.add(obj);
try {
if(obj instanceof ObjectWrap) {
try {
return ((ObjectWrap)obj).getEmbededObject();
} catch (PageException e) {
return obj;
}
}
if(obj instanceof Collection) return _clean(done,(Collection)obj);
if(obj instanceof Map) return _clean(done,(Map)obj);
if(obj instanceof List) return _clean(done,(List)obj);
if(obj instanceof Object[]) return _clean(done,(Object[])obj);
}
finally {
done.remove(obj);
}
return obj;
}
private static Object _clean(Set<Object> done,Collection coll) {
Iterator<Object> vit = coll.valueIterator();
Object v;
boolean change=false;
while(vit.hasNext()){
v=vit.next();
if(v!=_clean(done,v)) {
change=true;
break;
}
}
if(!change) return coll;
coll=coll.duplicate(false);
Iterator<Entry<Key, Object>> eit = coll.entryIterator();
Entry<Key, Object> e;
while(eit.hasNext()){
e=eit.next();
coll.setEL(e.getKey(), _clean(done,e.getValue()));
}
return coll;
}
private static Object _clean(Set<Object> done,Map map) {
Iterator vit = map.values().iterator();
Object v;
boolean change=false;
while(vit.hasNext()){
v=vit.next();
if(v!=_clean(done,v)) {
change=true;
break;
}
}
if(!change) return map;
map=Duplicator.duplicateMap(map, false);
Iterator<Entry> eit = map.entrySet().iterator();
Entry e;
while(eit.hasNext()){
e=eit.next();
map.put(e.getKey(), _clean(done,e.getValue()));
}
return map;
}
private static Object _clean(Set<Object> done,List list) {
Iterator it = list.iterator();
Object v;
boolean change=false;
while(it.hasNext()){
v=it.next();
if(v!=_clean(done,v)) {
change=true;
break;
}
}
if(!change) return list;
list=Duplicator.duplicateList(list, false);
it = list.iterator();
while(it.hasNext()){
list.add(_clean(done,it.next()));
}
return list;
}
private static Object _clean(Set<Object> done,Object[] src) {
boolean change=false;
for(int i=0;i<src.length;i++){
if(src[i]!=_clean(done,src[i])) {
change=true;
break;
}
}
if(!change) return src;
Object[] trg=new Object[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=_clean(done,src[i]);
}
return trg;
}
/**
* gets the MethodInstance matching given Parameter
* @param clazz Class Of the Method to get
* @param methodName Name of the Method to get
* @param args Arguments of the Method to get
* @return return Matching Method
* @throws NoSuchMethodException
* @throws PageException
*/
public static MethodInstance getMethodInstance(Object obj,Class clazz, String methodName, Object[] args)
throws NoSuchMethodException {
MethodInstance mi=getMethodInstanceEL(obj,clazz, KeyImpl.getInstance(methodName), args);
if(mi!=null) return mi;
Class[] classes = getClasses(args);
//StringBuilder sb=null;
JavaObject jo;
Class c;
ConstructorInstance ci;
for(int i=0;i<classes.length;i++){
if(args[i] instanceof JavaObject) {
jo=(JavaObject) args[i];
c=jo.getClazz();
ci = Reflector.getConstructorInstance(c, new Object[0], null);
if(ci==null) {
throw new NoSuchMethodException("The "+pos(i+1)+" parameter of "+methodName+"("+getDspMethods(classes)+") ia a object created " +
"by the createObject function (JavaObject/JavaProxy). This object has not been instantiated because it does not have a constructor " +
"that takes zero arguments. "+Constants.NAME+" cannot instantiate it for you, please use the .init(...) method to instantiate it with the correct parameters first");
}
}
}
/*
the argument list contains objects created by createObject,
that are no instantiated (first,third,10th) and because this object have no constructor taking no arguments, Lucee cannot instantiate them.
you need first to instantiate this objects.
*/
throw new NoSuchMethodException("No matching Method for "+methodName+"("+getDspMethods(classes)+") found for "+
Caster.toTypeName(clazz));
}
private static String pos(int index) {
if(index==1) return "first";
if(index==2) return "second";
if(index==3) return "third";
return index+"th";
}
/**
* same like method getField from Class but ignore case from field name
* @param clazz class to search the field
* @param name name to search
* @return Matching Field
* @throws NoSuchFieldException
*/
public static Field[] getFieldsIgnoreCase(Class clazz, String name) throws NoSuchFieldException {
Field[] fields=fStorage.getFields(clazz,name);
if(fields!=null) return fields;
throw new NoSuchFieldException("there is no field with name "+name+" in object ["+Type.getName(clazz)+"]");
}
public static Field[] getFieldsIgnoreCase(Class clazz, String name, Field[] defaultValue) {
Field[] fields=fStorage.getFields(clazz,name);
if(fields!=null) return fields;
return defaultValue;
}
public static String[] getPropertyKeys(Class clazz) {
Set keys=new HashSet();
Field[] fields = clazz.getFields();
Field field;
Method[] methods = clazz.getMethods();
Method method;
String name;
for(int i=0;i<fields.length;i++) {
field=fields[i];
if(Modifier.isPublic(field.getModifiers()) )keys.add(field.getName());
}
for(int i=0;i<methods.length;i++) {
method=methods[i];
if(Modifier.isPublic(method.getModifiers()) ) {
if(isGetter(method)) {
name=method.getName();
if(name.startsWith("get"))keys.add(method.getName().substring(3));
else keys.add(method.getName().substring(2));
}
else if(isSetter(method)) keys.add(method.getName().substring(3));
}
}
return (String[]) keys.toArray(new String[keys.size()]);
}
public static boolean hasPropertyIgnoreCase(Class clazz, String name) {
if(hasFieldIgnoreCase(clazz, name)) return true;
Method[] methods = clazz.getMethods();
Method method;
String n;
for(int i=0;i<methods.length;i++) {
method=methods[i];
if(Modifier.isPublic(method.getModifiers()) && StringUtil.endsWithIgnoreCase(method.getName(),name)) {
n=null;
if(isGetter(method)) {
n=method.getName();
if(n.startsWith("get"))n=method.getName().substring(3);
else n=method.getName().substring(2);
}
else if(isSetter(method)) n=method.getName().substring(3);
if(n!=null && n.equalsIgnoreCase(name)) return true;
}
}
return false;
}
public static boolean hasFieldIgnoreCase(Class clazz, String name) {
return !ArrayUtil.isEmpty(getFieldsIgnoreCase(clazz, name, null));
//getFieldIgnoreCaseEL(clazz, name)!=null;
}
/**
* call constructor of a class with matching arguments
* @param clazz Class to get Instance
* @param args Arguments for the Class
* @return invoked Instance
* @throws PageException
*/
public static Object callConstructor(Class clazz, Object[] args) throws PageException {
args=cleanArgs(args);
try {
return getConstructorInstance(clazz,args).invoke();
}
catch (InvocationTargetException e) {
Throwable target = e.getTargetException();
if(target instanceof PageException) throw (PageException)target;
throw Caster.toPageException(e.getTargetException());
}
catch (Exception e) {
throw Caster.toPageException(e);
}
}
public static Object callConstructor(Class clazz, Object[] args, Object defaultValue) {
args=cleanArgs(args);
try {
ConstructorInstance ci = getConstructorInstance(clazz,args,null);
if(ci==null) return defaultValue;
return ci.invoke();
}
catch(Throwable t) {
ExceptionUtil.rethrowIfNecessary(t);
return defaultValue;
}
}
/**
* calls a Method of a Objct
* @param obj Object to call Method on it
* @param methodName Name of the Method to get
* @param args Arguments of the Method to get
* @return return return value of the called Method
* @throws PageException
*/
public static Object callMethod(Object obj, String methodName, Object[] args) throws PageException {
return callMethod(obj, KeyImpl.getInstance(methodName), args);
}
public static Object callMethod(Object obj, Collection.Key methodName, Object[] args) throws PageException {
if(obj==null) {
throw new ExpressionException("can't call method ["+methodName+"] on object, object is null");
}
MethodInstance mi=getMethodInstanceEL(obj,obj.getClass(), methodName, args);
if(mi==null)
throw throwCall(obj,methodName,args);
try {
return mi.invoke(obj);
}
catch (Exception e) {
throw Caster.toPageException(e);
}
}
private static void checkAccessibility(Object objMaybeNull,Class clazz, Key methodName) {
// do not allow java.lang.System.exit()
if(methodName.equals(EXIT) && (clazz==System.class || clazz==Runtime.class)) { // TODO better implementation
throw new PageRuntimeException(new SecurityException("Calling the exit method is not allowed"));
}
// change the accessibility of Lucee methods is not allowed
else if(methodName.equals(SET_ACCESSIBLE)) {
if(objMaybeNull instanceof JavaObject)
objMaybeNull=((JavaObject)objMaybeNull).getEmbededObject(null);
if(objMaybeNull instanceof Member) {
Member member=(Member) objMaybeNull;
Class<?> cls = member.getDeclaringClass();
if(cls!=null) {
String name=cls.getName();
if(name!=null && name.startsWith("lucee.")) {
throw new PageRuntimeException(new SecurityException("Changing the accessibility of an object's members in the Lucee.* package is not allowed"));
}
}
}
}
}
/*private static void checkAccesibilityx(Object obj, Key methodName) {
if(methodName.equals(SET_ACCESSIBLE) && obj instanceof Member) {
if(true) return;
Member member=(Member) obj;
Class<?> cls = member.getDeclaringClass();
if(cls.getPackage().getName().startsWith("lucee.")) {
throw new PageRuntimeException(new SecurityException("Changing the accesibility of an object's members in the Lucee.* package is not allowed"));
}
}
}*/
public static Object callMethod(Object obj, Collection.Key methodName, Object[] args, Object defaultValue) {
if(obj==null) {
return defaultValue;
}
//checkAccesibility(obj,methodName);
MethodInstance mi=getMethodInstanceEL(obj,obj.getClass(), methodName, args);
if(mi==null)
return defaultValue;
try {
return mi.invoke(obj);
}
catch(Throwable t) {
ExceptionUtil.rethrowIfNecessary(t);
return defaultValue;
}
}
public static ExpressionException throwCall(Object obj,String methodName, Object[] args) {
return new ExpressionException("No matching Method/Function for "+Type.getName(obj)+"."+methodName+"("+getDspMethods(getClasses(args))+") found");
}
public static ExpressionException throwCall(Object obj,Collection.Key methodName, Object[] args) {
return new ExpressionException("No matching Method/Function for "+Type.getName(obj)+"."+methodName+"("+getDspMethods(getClasses(args))+") found");
}
/**
* calls a Static Method on the given CLass
* @param clazz Class to call Method on it
* @param methodName Name of the Method to get
* @param args Arguments of the Method to get
* @return return return value of the called Method
* @throws PageException
*/
public static Object callStaticMethod(Class clazz, String methodName, Object[] args) throws PageException {
try {
return getMethodInstance(null,clazz,methodName,args).invoke(null);
}
catch (InvocationTargetException e) {
Throwable target = e.getTargetException();
if(target instanceof PageException) throw (PageException)target;
throw Caster.toPageException(e.getTargetException());
}
catch (Exception e) {
throw Caster.toPageException(e);
}
}
/**
* to get a Getter Method of a Object
* @param clazz Class to invoke method from
* @param prop Name of the Method without get
* @return return Value of the getter Method
* @throws NoSuchMethodException
* @throws PageException
*/
public static MethodInstance getGetter(Class clazz, String prop) throws PageException, NoSuchMethodException {
String getterName = "get"+StringUtil.ucFirst(prop);
MethodInstance mi = getMethodInstanceEL(null,clazz,KeyImpl.getInstance(getterName),ArrayUtil.OBJECT_EMPTY);
if(mi==null){
String isName = "is"+StringUtil.ucFirst(prop);
mi = getMethodInstanceEL(null,clazz,KeyImpl.getInstance(isName),ArrayUtil.OBJECT_EMPTY);
if(mi!=null){
Method m = mi.getMethod();
Class rtn = m.getReturnType();
if(rtn!=Boolean.class && rtn!=boolean.class) mi=null;
}
}
if(mi==null)
throw new ExpressionException("No matching property ["+prop+"] found in ["+Caster.toTypeName(clazz)+"]");
Method m=mi.getMethod();
if(m.getReturnType()==void.class)
throw new NoSuchMethodException("invalid return Type, method ["+m.getName()+"] for Property ["+getterName+"] must have return type not void");
return mi;
}
/**
* to get a Getter Method of a Object
* @param clazz Class to invoke method from
* @param prop Name of the Method without get
* @return return Value of the getter Method
*/
public static MethodInstance getGetterEL(Class clazz, String prop) {
prop="get"+StringUtil.ucFirst(prop);
MethodInstance mi = getMethodInstanceEL(null,clazz,KeyImpl.getInstance(prop),ArrayUtil.OBJECT_EMPTY);
if(mi==null) return null;
if(mi.getMethod().getReturnType()==void.class) return null;
return mi;
}
/**
* to invoke a getter Method of a Object
* @param obj Object to invoke method from
* @param prop Name of the Method without get
* @return return Value of the getter Method
* @throws PageException
*/
public static Object callGetter(Object obj, String prop) throws PageException {
try {
return getGetter(obj.getClass(), prop).invoke(obj);
}
catch (InvocationTargetException e) {
Throwable target = e.getTargetException();
if(target instanceof PageException) throw (PageException)target;
throw Caster.toPageException(e.getTargetException());
}
catch (Exception e) {
throw Caster.toPageException(e);
}
}
/**
* to invoke a setter Method of a Object
* @param obj Object to invoke method from
* @param prop Name of the Method without get
* @param value Value to set to the Method
* @return MethodInstance
* @throws NoSuchMethodException
* @throws PageException
*/
public static MethodInstance getSetter(Object obj, String prop,Object value) throws NoSuchMethodException {
prop="set"+StringUtil.ucFirst(prop);
MethodInstance mi = getMethodInstance(obj,obj.getClass(),prop,new Object[]{value});
Method m=mi.getMethod();
if(m.getReturnType()!=void.class)
throw new NoSuchMethodException("invalid return Type, method ["+m.getName()+"] must have return type void, now ["+m.getReturnType().getName()+"]");
return mi;
}
/*
* to invoke a setter Method of a Object
* @param obj Object to invoke method from
* @param prop Name of the Method without get
* @param value Value to set to the Method
* @return MethodInstance
* @deprecated use instead <code>getSetter(Object obj, String prop,Object value, MethodInstance defaultValue)</code>
public static MethodInstance getSetterEL(Object obj, String prop,Object value) {
prop="set"+StringUtil.ucFirst(prop);
MethodInstance mi = getMethodInstanceEL(obj.getClass(),KeyImpl.getInstance(prop),new Object[]{value});
if(mi==null) return null;
Method m=mi.getMethod();
if(m.getReturnType()!=void.class) return null;
return mi;
}*/
/**
* to invoke a setter Method of a Object
* @param obj Object to invoke method from
* @param prop Name of the Method without get
* @param value Value to set to the Method
* @return MethodInstance
*/
public static MethodInstance getSetter(Object obj, String prop,Object value, MethodInstance defaultValue) {
prop="set"+StringUtil.ucFirst(prop);
MethodInstance mi = getMethodInstanceEL(obj,obj.getClass(),KeyImpl.getInstance(prop),new Object[]{value});
if(mi==null) return defaultValue;
Method m=mi.getMethod();
if(m.getReturnType()!=void.class) return defaultValue;
return mi;
}
/**
* to invoke a setter Method of a Object
* @param obj Object to invoke method from
* @param prop Name of the Method without get
* @param value Value to set to the Method
* @throws PageException
*/
public static void callSetter(Object obj, String prop,Object value) throws PageException {
try {
getSetter(obj, prop, value).invoke(obj);
}
catch (InvocationTargetException e) {
Throwable target = e.getTargetException();
if(target instanceof PageException) throw (PageException)target;
throw Caster.toPageException(e.getTargetException());
}
catch (Exception e) {
throw Caster.toPageException(e);
}
}
/**
* do nothing when not exist
* @param obj
* @param prop
* @param value
* @throws PageException
*/
public static void callSetterEL(Object obj, String prop,Object value) throws PageException {
try {
MethodInstance setter = getSetter(obj, prop, value,null);
if(setter!=null)setter.invoke(obj);
}
catch (InvocationTargetException e) {
Throwable target = e.getTargetException();
if(target instanceof PageException) throw (PageException)target;
throw Caster.toPageException(e.getTargetException());
}
catch (Exception e) {
throw Caster.toPageException(e);
}
}
/**
* to get a visible Field of a object
* @param obj Object to invoke
* @param prop property to call
* @return property value
* @throws PageException
*/
public static Object getField(Object obj, String prop) throws PageException {
try {
return getFieldsIgnoreCase(obj.getClass(),prop)[0].get(obj);
}
catch (Throwable e) {
ExceptionUtil.rethrowIfNecessary(e);
throw Caster.toPageException(e);
}
}
public static Object getField(Object obj, String prop, Object defaultValue) {
return getField(obj, prop, false, defaultValue);
}
public static Object getField(Object obj, String prop, boolean accessible, Object defaultValue) {
if(obj==null) return defaultValue;
Field[] fields = getFieldsIgnoreCase(obj.getClass(),prop,null);
if(ArrayUtil.isEmpty(fields)) return defaultValue;
try {
if(accessible)fields[0].setAccessible(true);
return fields[0].get(obj);
} catch(Throwable t) {
ExceptionUtil.rethrowIfNecessary(t);
return defaultValue;
}
}
/**
* assign a value to a visible Field of a object
* @param obj Object to assign value to his property
* @param prop name of property
* @param value Value to assign
* @throws PageException
*/
public static boolean setField(Object obj, String prop,Object value) throws PageException {
Class clazz=value.getClass();
try {
Field[] fields = getFieldsIgnoreCase(obj.getClass(),prop);
// exact comparsion
for(int i=0;i<fields.length;i++) {
if(toReferenceClass(fields[i].getType())==clazz){
fields[i].set(obj,value);
return true;
}
}
// like comparsion
for(int i=0;i<fields.length;i++) {
if(like(fields[i].getType(),clazz)) {
fields[i].set(obj,value);
return true;
}
}
// convert comparsion
for(int i=0;i<fields.length;i++) {
try {
fields[i].set(obj,convert(value,toReferenceClass(fields[i].getType()),null));
return true;
} catch (PageException e) {}
}
}
catch (Exception e) {
throw Caster.toPageException(e);
}
return false;
}
/**
* to get a visible Propety (Field or Getter) of a object
* @param obj Object to invoke
* @param prop property to call
* @return property value
* @throws PageException
*/
public static Object getProperty(Object obj, String prop) throws PageException {
Object rtn=getField(obj,prop,NULL);// NULL is used because the field can contain null as well
if(rtn!=NULL) return rtn;
char first=prop.charAt(0);
if(first>='0' && first<='9') throw new ApplicationException("there is no property with name ["+prop+"] found in ["+Caster.toTypeName(obj)+"]");
return callGetter(obj,prop);
}
/**
* to get a visible Propety (Field or Getter) of a object
* @param obj Object to invoke
* @param prop property to call
* @return property value
*/
public static Object getProperty(Object obj, String prop, Object defaultValue) {
// first try field
Field[] fields = getFieldsIgnoreCase(obj.getClass(),prop,null);
if(!ArrayUtil.isEmpty(fields)) {
try {
return fields[0].get(obj);
} catch(Throwable t) {ExceptionUtil.rethrowIfNecessary(t);}
}
// then getter
try {
char first=prop.charAt(0);
if(first>='0' && first<='9') return defaultValue;
return getGetter(obj.getClass(), prop).invoke(obj);
} catch (Throwable e1) {
ExceptionUtil.rethrowIfNecessary(e1);
return defaultValue;
}
}
/**
* assign a value to a visible Property (Field or Setter) of a object
* @param obj Object to assign value to his property
* @param prop name of property
* @param value Value to assign
* @throws PageException
*/
public static void setProperty(Object obj, String prop,Object value) throws PageException{
boolean done=false;
try {
if(setField(obj,prop,value))done=true;
}
catch(Throwable t) {ExceptionUtil.rethrowIfNecessary(t);}
if(!done)callSetter(obj,prop,value);
}
/**
* assign a value to a visible Property (Field or Setter) of a object
* @param obj Object to assign value to his property
* @param prop name of property
* @param value Value to assign
*/
public static void setPropertyEL(Object obj, String prop,Object value) {
// first check for field
Field[] fields = getFieldsIgnoreCase(obj.getClass(),prop,null);
if(!ArrayUtil.isEmpty(fields)){
try {
fields[0].set(obj,value);
return;
} catch(Throwable t) {ExceptionUtil.rethrowIfNecessary(t);}
}
// then check for setter
try {
getSetter(obj, prop, value).invoke(obj);
}
catch(Throwable t) {ExceptionUtil.rethrowIfNecessary(t);}
}
private static Object toNativeArray(Class clazz, Object obj) throws PageException {
//if(obj.getClass()==clazz) return obj;
Object[] objs=null;
if(obj instanceof Array) objs=toRefArray((Array)obj);
else if(obj instanceof List) objs=toRefArray((List)obj);
else if(Decision.isNativeArray(obj)) {
if(obj.getClass()==boolean[].class) objs=toRefArray((boolean[])obj);
else if(obj.getClass()==byte[].class) objs=toRefArray((byte[])obj);
else if(obj.getClass()==char[].class) objs=toRefArray((char[])obj);
else if(obj.getClass()==short[].class) objs=toRefArray((short[])obj);
else if(obj.getClass()==int[].class) objs=toRefArray((int[])obj);
else if(obj.getClass()==long[].class) objs=toRefArray((long[])obj);
else if(obj.getClass()==float[].class) objs=toRefArray((float[])obj);
else if(obj.getClass()==double[].class) objs=toRefArray((double[])obj);
else objs=(Object[])obj;//toRefArray((Object[])obj);
}
if(clazz==objs.getClass()) {
return objs;
}
//if(objs==null) return defaultValue;
//Class srcClass = objs.getClass().getComponentType();
Class compClass = clazz.getComponentType();
Object rtn = java.lang.reflect.Array.newInstance(compClass, objs.length);
//try{
for(int i=0;i<objs.length;i++) {
java.lang.reflect.Array.set(rtn, i, convert(objs[i], compClass,null));
}
//}catch(Throwable t){ExceptionUtil.rethrowIfNecessary(t);}
return rtn;
}
private static Object[] toRefArray(boolean[] src) {
Boolean[] trg=new Boolean[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=src[i]?Boolean.TRUE:Boolean.FALSE;
}
return trg;
}
private static Byte[] toRefArray(byte[] src) {
Byte[] trg=new Byte[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=new Byte(src[i]);
}
return trg;
}
private static Character[] toRefArray(char[] src) {
Character[] trg=new Character[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=new Character(src[i]);
}
return trg;
}
private static Short[] toRefArray(short[] src) {
Short[] trg=new Short[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=Short.valueOf(src[i]);
}
return trg;
}
private static Integer[] toRefArray(int[] src) {
Integer[] trg=new Integer[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=Integer.valueOf(src[i]);
}
return trg;
}
private static Long[] toRefArray(long[] src) {
Long[] trg=new Long[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=Long.valueOf(src[i]);
}
return trg;
}
private static Float[] toRefArray(float[] src) {
Float[] trg=new Float[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=new Float(src[i]);
}
return trg;
}
private static Double[] toRefArray(double[] src) {
Double[] trg=new Double[src.length];
for(int i=0;i<trg.length;i++) {
trg[i]=new Double(src[i]);
}
return trg;
}
private static Object[] toRefArray(Array array) throws PageException {
Object[] objs=new Object[array.size()];
for(int i=0;i<objs.length;i++) {
objs[i]=array.getE(i+1);
}
return objs;
}
private static Object[] toRefArray(List list) {
Object[] objs=new Object[list.size()];
for(int i=0;i<objs.length;i++) {
objs[i]=list.get(i);
}
return objs;
}
public static boolean isGetter(Method method) {
if(method.getParameterTypes().length>0) return false;
if(method.getReturnType()==void.class) return false;
if(!method.getName().startsWith("get") && !method.getName().startsWith("is")) return false;
if(method.getDeclaringClass()==Object.class) return false;
return true;
}
public static boolean isSetter(Method method) {
if(method.getParameterTypes().length!=1) return false;
if(method.getReturnType()!=void.class) return false;
if(!method.getName().startsWith("set")) return false;
if(method.getDeclaringClass()==Object.class) return false;
return true;
}
/**
* return all methods that are defined by the class itself (not extended)
* @param clazz
* @return
*/
public static Method[] getDeclaredMethods(Class clazz) {
Method[] methods = clazz.getMethods();
ArrayList list=new ArrayList();
for(int i=0;i<methods.length;i++) {
if(methods[i].getDeclaringClass()==clazz) list.add(methods[i]);
}
if(list.size()==0) return new Method[0];
return (Method[]) list.toArray(new Method[list.size()]);
}
public static Method[] getSetters(Class clazz) {
Method[] methods = clazz.getMethods();
ArrayList list=new ArrayList();
for(int i=0;i<methods.length;i++) {
if(isSetter(methods[i])) list.add(methods[i]);
}
if(list.size()==0) return new Method[0];
return (Method[]) list.toArray(new Method[list.size()]);
}
public static Method[] getGetters(Class clazz) {
Method[] methods = clazz.getMethods();
List<Method> list=new ArrayList<Method>();
for(int i=0;i<methods.length;i++) {
if(isGetter(methods[i])) list.add(methods[i]);
}
if(list.size()==0) return new Method[0];
return (Method[]) list.toArray(new Method[list.size()]);
}
/**
* check if given class "from" can be converted to class "to" without explicit casting
* @param from source class
* @param to target class
* @return is it possible to convert from "from" to "to"
*/
public static boolean canConvert(Class from, Class to) {
// Identity Conversions
if(from==to) return true;
// Widening Primitive Conversion
if(from==byte.class) {
return to==short.class || to==int.class || to==long.class || to==float.class || to==double.class ;
}
if(from==short.class) {
return to==int.class || to==long.class || to==float.class || to==double.class ;
}
if(from==char.class) {
return to==int.class || to==long.class || to==float.class || to==double.class ;
}
if(from==int.class) {
return to==long.class || to==float.class || to==double.class ;
}
if(from==long.class) {
return to==float.class || to==double.class ;
}
if(from==float.class) {
return to==double.class ;
}
return false;
}
public static String removeGetterPrefix(String name) {
if(name.startsWith("get")) return name.substring(3);
if(name.startsWith("is")) return name.substring(2);
return name;
}
public static Method getDeclaredMethod(Class<?> clazz,
String method, Class[] arguments, Method defaultValue) {
try {
return clazz.getDeclaredMethod(method, arguments);
}
catch(Throwable t) {
ExceptionUtil.rethrowIfNecessary(t);
return defaultValue;
}
}
}