freemarker-2.3.20.tar.gz

/* * Copyright (c) 2003 The Visigoth Software Society. All rights * reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * 3. The end-user documentation included with the redistribution, if * any, must include the following acknowledgement: * "This product includes software developed by the * Visigoth Software Society (http://www.visigoths.org/)." * Alternately, this acknowledgement may appear in the software itself, * if and wherever such third-party acknowledgements normally appear. * * 4. Neither the name "FreeMarker", "Visigoth", nor any of the names of the * project contributors may be used to endorse or promote products derived * from this software without prior written permission. For written * permission, please contact visigoths@visigoths.org. * * 5. Products derived from this software may not be called "FreeMarker" or "Visigoth" * nor may "FreeMarker" or "Visigoth" appear in their names * without prior written permission of the Visigoth Software Society. * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE VISIGOTH SOFTWARE SOCIETY OR * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Visigoth Software Society. For more * information on the Visigoth Software Society, please see * http://www.visigoths.org/ */ package freemarker.ext.beans; import java.beans.BeanInfo; import java.beans.IndexedPropertyDescriptor; import java.beans.IntrospectionException; import java.beans.Introspector; import java.beans.MethodDescriptor; import java.beans.PropertyDescriptor; import java.io.InputStream; import java.lang.reflect.AccessibleObject; import java.lang.reflect.Array; import java.lang.reflect.Constructor; import java.lang.reflect.Field; import java.lang.reflect.InvocationTargetException; import java.lang.reflect.Method; import java.lang.reflect.Modifier; import java.math.BigDecimal; import java.math.BigInteger; import java.util.Arrays; import java.util.Collection; import java.util.Collections; import java.util.Date; import java.util.Enumeration; import java.util.HashMap; import java.util.HashSet; import java.util.Iterator; import java.util.LinkedList; import java.util.List; import java.util.Map; import java.util.Properties; import java.util.ResourceBundle; import java.util.Set; import java.util.StringTokenizer; import freemarker.core._ConcurrentMapFactory; import freemarker.ext.util.IdentityHashMap; import freemarker.ext.util.ModelCache; import freemarker.ext.util.ModelFactory; import freemarker.ext.util.WrapperTemplateModel; import freemarker.log.Logger; import freemarker.template.AdapterTemplateModel; import freemarker.template.ObjectWrapper; import freemarker.template.TemplateBooleanModel; import freemarker.template.TemplateCollectionModel; import freemarker.template.TemplateDateModel; import freemarker.template.TemplateHashModel; import freemarker.template.TemplateModel; import freemarker.template.TemplateModelException; import freemarker.template.TemplateNumberModel; import freemarker.template.TemplateScalarModel; import freemarker.template.TemplateSequenceModel; import freemarker.template.utility.ClassUtil; import freemarker.template.utility.Collections12; import freemarker.template.utility.SecurityUtilities; import freemarker.template.utility.UndeclaredThrowableException; /** * Utility class that provides generic services to reflection classes. * It handles all polymorphism issues in the {@link #wrap(Object)} and {@link #unwrap(TemplateModel)} methods. * @author Attila Szegedi */ public class BeansWrapper implements ObjectWrapper { static final Object CAN_NOT_UNWRAP = new Object(); private static final Class BIGINTEGER_CLASS = java.math.BigInteger.class; private static final Class BOOLEAN_CLASS = Boolean.class; private static final Class CHARACTER_CLASS = Character.class; private static final Class COLLECTION_CLASS = Collection.class; private static final Class DATE_CLASS = Date.class; private static final Class HASHADAPTER_CLASS = HashAdapter.class; private static final Class ITERABLE_CLASS; private static final Class LIST_CLASS = List.class; private static final Class MAP_CLASS = Map.class; private static final Class NUMBER_CLASS = Number.class; private static final Class OBJECT_CLASS = Object.class; private static final Class SEQUENCEADAPTER_CLASS = SequenceAdapter.class; private static final Class SET_CLASS = Set.class; private static final Class SETADAPTER_CLASS = SetAdapter.class; private static final Class STRING_CLASS = String.class; static { Class iterable; try { iterable = Class.forName("java.lang.Iterable"); } catch(ClassNotFoundException e) { // We're running on a pre-1.5 JRE iterable = null; } ITERABLE_CLASS = iterable; } // When this property is true, some things are stricter. This is mostly to // catch anomalous things in development that can otherwise be valid situations // for our users. private static final boolean DEVELOPMENT = "true".equals(SecurityUtilities.getSystemProperty("freemarker.development")); private static final Constructor ENUMS_MODEL_CTOR = enumsModelCtor(); private static final Logger logger = Logger.getLogger("freemarker.beans"); private static final Set UNSAFE_METHODS = createUnsafeMethodsSet(); static final Object GENERIC_GET_KEY = new Object(); private static final Object CONSTRUCTORS = new Object(); private static final Object ARGTYPES = new Object(); private static final boolean javaRebelAvailable = isJavaRebelAvailable(); /** * The default instance of BeansWrapper */ private static final BeansWrapper INSTANCE = new BeansWrapper(); /** * Used for synchronization by {@link #genericClassIntrospectionCache}, * {@link #staticModels} and {@link #enumModels} (and by any similar future * fields). The primary goal of using a common monitor is to prevent * deadlocks when these objects call each other. */ private final Object sharedClassIntrospectionCacheLock = new Object(); /** * This is called the "generic" class introspection cache because when the * public API simply says "introspection cache" it refers to the sum of all * caches. The other less generic caches are in {@link #staticModels} * and {@link #enumModels}. */ private final Map/*<Class, Map<String, Object>>*/ genericClassIntrospectionCache = _ConcurrentMapFactory.newMaybeConcurrentHashMap(); private final boolean isGenericClassIntrospectionCacheConcurrentMap = _ConcurrentMapFacto