org.xwiki.velocity.introspection.DeprecatedCheckUberspector Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of xwiki-commons-velocity Show documentation
APIs to evaluate content with Velocity
There is a newer version: 16.10.2
Show newest version
/*
 * See the NOTICE file distributed with this work for additional
 * information regarding copyright ownership.
 *
 * This 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 software 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 software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */
package org.xwiki.velocity.introspection;

import java.lang.reflect.Method;

import org.apache.velocity.util.introspection.AbstractChainableUberspector;
import org.apache.velocity.util.introspection.Info;
import org.apache.velocity.util.introspection.Introspector;
import org.apache.velocity.util.introspection.Uberspect;
import org.apache.velocity.util.introspection.UberspectLoggable;
import org.apache.velocity.util.introspection.VelMethod;
import org.apache.velocity.util.introspection.VelPropertyGet;
import org.apache.velocity.util.introspection.VelPropertySet;

/**
 * Chainable Velocity Uberspector that checks for deprecated method calls. It does that by checking if the returned
 * method has a Deprecated annotation. Because this is a chainable uberspector, it has to re-get the method using a
 * default introspector, which is not safe; future uberspectors might not be able to return a precise method name, or a
 * method of the original target object.
 *
 * @since 1.5M1
 * @version $Id: 5ed2d8bc1fa378bab643da92aa535cd8caa05674 $
 * @see ChainableUberspector
 */
public class DeprecatedCheckUberspector extends AbstractChainableUberspector implements Uberspect, UberspectLoggable
{
    @Override
    public void init()
    {
        super.init();
        this.introspector = new Introspector(this.log);
    }

    @Override
    public VelMethod getMethod(Object obj, String methodName, Object[] args, Info i) throws Exception
    {
        VelMethod method = super.getMethod(obj, methodName, args, i);
        if (method != null) {
            Method m = this.introspector.getMethod(obj.getClass(), method.getMethodName(), args);
            if (m != null
                && (m.isAnnotationPresent(Deprecated.class)
                    || m.getDeclaringClass().isAnnotationPresent(Deprecated.class)
                    || obj.getClass().isAnnotationPresent(Deprecated.class))) {
                logWarning("method", obj, method.getMethodName(), i);
            }
        }

        return method;
    }

    @Override
    public VelPropertyGet getPropertyGet(Object obj, String identifier, Info i) throws Exception
    {
        VelPropertyGet method = super.getPropertyGet(obj, identifier, i);
        if (method != null) {
            Method m = this.introspector.getMethod(obj.getClass(), method.getMethodName(), new Object[] {});
            if (m != null
                && (m.isAnnotationPresent(Deprecated.class)
                    || m.getDeclaringClass().isAnnotationPresent(Deprecated.class)
                    || obj.getClass().isAnnotationPresent(Deprecated.class))) {
                logWarning("getter", obj, method.getMethodName(), i);
            }
        }

        return method;
    }

    @Override
    public VelPropertySet getPropertySet(Object obj, String identifier, Object arg, Info i) throws Exception
    {
        // TODO Auto-generated method stub
        VelPropertySet method = super.getPropertySet(obj, identifier, arg, i);
        if (method != null) {
            Method m = this.introspector.getMethod(obj.getClass(), method.getMethodName(), new Object[] { arg });
            if (m != null
                && (m.isAnnotationPresent(Deprecated.class)
                    || m.getDeclaringClass().isAnnotationPresent(Deprecated.class)
                    || obj.getClass().isAnnotationPresent(Deprecated.class))) {
                logWarning("setter", obj, method.getMethodName(), i);
            }
        }

        return method;
    }

    /**
     * Helper method to log a warning when a deprecation has been found.
     *
     * @param deprecationType the type of deprecation (eg "getter", "setter", "method")
     * @param object the object that has a deprecation
     * @param methodName the deprecated method's name
     * @param info a Velocity {@link org.apache.velocity.util.introspection.Info} object containing information about
     *            where the deprecation was located in the Velocity template file
     */
    private void logWarning(String deprecationType, Object object, String methodName, Info info)
    {
        this.log.warn(String.format("Deprecated usage of %s [%s] in %s@%d,%d", deprecationType, object.getClass()
            .getCanonicalName() + "." + methodName, info.getTemplateName(), info.getLine(), info.getColumn()));
    }
}