/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 2013 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* http://glassfish.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package org.glassfish.jersey.server.validation.internal;
import java.lang.reflect.AnnotatedElement;
import java.lang.reflect.Method;
import java.util.Collection;
import java.util.Collections;
import java.util.Deque;
import java.util.List;
import java.util.Set;
import java.util.concurrent.ConcurrentMap;
import javax.validation.Configuration;
import javax.validation.ValidationException;
import javax.validation.executable.ExecutableType;
import javax.validation.executable.ValidateOnExecution;
import org.glassfish.jersey.internal.util.ReflectionHelper;
import com.google.common.base.Supplier;
import com.google.common.collect.Lists;
import com.google.common.collect.Maps;
import com.google.common.collect.Multimap;
import com.google.common.collect.Multimaps;
import com.google.common.collect.Queues;
import com.google.common.collect.Sets;
/**
* Handler providing methods to determine whether an executable should be validated during the validation process based on the
* presence of {@link ValidateOnExecution} annotation.
*
* @author Michal Gajdos (michal.gajdos at oracle.com)
*/
class ValidateOnExecutionHandler {
private final ConcurrentMap<Method, Boolean> validateMethodCache = Maps.newConcurrentMap();
private final ConcurrentMap<Method, Boolean> validateGetterCache = Maps.newConcurrentMap();
private final Configuration config;
private final boolean checkOverrides;
/**
* Create {@link ValidateOnExecutionHandler}.
*
* @param config validation configuration to obtain bootstrap config.
* @param checkOverrides flag whether overriding/implementing methods should be checked if the {@link ValidateOnExecution}
* annotation is present.
*/
ValidateOnExecutionHandler(final Configuration config, final boolean checkOverrides) {
this.config = config;
this.checkOverrides = checkOverrides;
}
/**
* Determine whether the given {@link Method getter} on the given {@link Class clazz} should be validated during the
* resource class validation. See {@code #validationMethod} to understand the difference between this and {@code
* #validationMethod}.
*
* @param clazz class on which the getter will be invoked.
* @param method method to be examined.
* @return {@code true} if the getter should be validated, {@code false} otherwise.
*/
boolean validateGetter(final Class<?> clazz, final Method method) {
if (!validateGetterCache.containsKey(method)) {
processMethod(clazz, method, method);
}
return validateGetterCache.get(method);
}
/**
* Determine whether the given {@link Method method} to-be-executed on the given {@link Class clazz} should be validated.
* The difference between this and {@code #validateGetter} method is that this method returns {@code true} if the {@code
* method} is getter and validating getter method is not explicitly disabled by {@link ValidateOnExecution} annotation in
* the class hierarchy.
*
* @param clazz class on which the method will be invoked.
* @param method method to be examined.
* @param validationMethod method used for cache.
* @return {@code true} if the method should be validated, {@code false} otherwise.
*/
boolean validateMethod(final Class<?> clazz, final Method method, final Method validationMethod) {
if (!validateMethodCache.containsKey(validationMethod)) {
processMethod(clazz, method, validationMethod);
}
return validateMethodCache.get(validationMethod);
}
/**
* Process the given {@code method} and {@code validationMethod} on given {@code clazz} and determine whether this method
* should be validated or not.
*
* @param clazz class on which the method will be invoked.
* @param method method to be examined.
* @param validationMethod method used for cache.
*/
private void processMethod(final Class<?> clazz, final Method method, final Method validationMethod) {
final Deque<Class<?>> hierarchy = getValidationClassHierarchy(clazz);
Boolean validateMethod = processAnnotation(method, hierarchy, checkOverrides);
if (validateMethod != null) {
validateMethodCache.putIfAbsent(validationMethod, validateMethod);
validateGetterCache.putIfAbsent(validationMethod, validateMethod);
}
// Return value from validation.xml.
if (!validateMethodCache.containsKey(validationMethod)) {
final Set<ExecutableType> defaultValidatedExecutableTypes = config.getBootstrapConfiguration()
.getDefaultValidatedExecutableTypes();
validateMethod = validateMethod(method, false, defaultValidatedExecutableTypes);
validateGetterCache.putIfAbsent(validationMethod, validateMethod);
// When validateMethod is called and no ValidateOnExecution annotation is present we want to validate getters by
// default (see SPEC).
validateMethodCache.putIfAbsent(validationMethod, ReflectionHelper.isGetter(validationMethod) || validateMethod);
}
}
/**
* Process {@link ValidateOnExecution} annotation for given method on a class hierarchy.
*
* @param method method to be examined.
* @param hierarchy class hierarchy to be examined.
* @param checkOverrides flag whether a overriding/implementing methods should also be checked.
* @return {@code true} if the method should be validated, {@code false} if not, {@code null} if the flag cannot be
* determined (no annotation present).
*/
private Boolean processAnnotation(final Method method, final Deque<Class<?>> hierarchy, final boolean checkOverrides) {
// Overridden methods.
while(!hierarchy.isEmpty()) {
final Class<?> overriddenClass = hierarchy.removeFirst();
final Method overriddenMethod = ReflectionHelper.findMethodOnClass(overriddenClass, method);
if (overriddenMethod != null) {
// Method.
Set<ExecutableType> executableTypes = getExecutableTypes(overriddenMethod);
if (!executableTypes.isEmpty()) {
// If an overriding/implementing method is annotated with @ValidateOnExecution, throw an exception.
if (checkOverrides
&& processAnnotation(method, hierarchy, false) != null) {
final String methodName = method.getDeclaringClass().getName() + "#" + method.getName();
throw new ValidationException(LocalizationMessages.OVERRIDE_CHECK_ERROR(methodName));
}
return validateMethod(overriddenMethod, true, executableTypes);
}
// Class.
executableTypes = getExecutableTypes(overriddenClass);
if (!executableTypes.isEmpty()
// It should contain not only ExecutableType#IMPLICIT but something else as well.
// ExecutableType#IMPLICIT on class itself does nothing.
&& !(executableTypes.size() == 1 && executableTypes.contains(ExecutableType.IMPLICIT))) {
return validateMethod(overriddenMethod, false, executableTypes);
}
}
}
return null;
}
/**
* Determine whether the given {@link Method method} should be validated depending on the given {@code executableTypes}.
*
* @param method method to be examined.
* @param allowImplicit allows check for {@link ExecutableType#IMPLICIT} type.
* @param executableTypes executable types assigned to the method.
* @return {@code true} if the method should be validated, {@code false otherwise}.
*/
private boolean validateMethod(final Method method, final boolean allowImplicit, final Set<ExecutableType> executableTypes) {
if (executableTypes.contains(ExecutableType.ALL)
|| (allowImplicit && executableTypes.contains(ExecutableType.IMPLICIT))) {
return true;
}
return ReflectionHelper.isGetter(method) ? executableTypes.contains(ExecutableType.GETTER_METHODS)
: executableTypes.contains(ExecutableType.NON_GETTER_METHODS);
}
/**
* Return a set of executable types contained in {@link ValidateOnExecution} annotation belonging to the {@code element}.
*
* @param element element to be examined for {@link ValidateOnExecution}.
* @return set of executable types or an empty set if the element is not annotated with {@link ValidateOnExecution}.
*/
private Set<ExecutableType> getExecutableTypes(final AnnotatedElement element) {
final ValidateOnExecution validateExecutable = element.getAnnotation(ValidateOnExecution.class);
return validateExecutable != null ? Sets.newHashSet(validateExecutable.type()) : Collections.<ExecutableType>emptySet();
}
/**
* Get a class hierarchy for the given {@code clazz} suitable to be looked for {@link ValidateOnExecution} annotation
* in order according to the priority defined by Bean Validation spec (superclasses, interfaces).
*
* @param clazz class to obtain hierarchy for.
* @return class hierarchy.
*/
private Deque<Class<?>> getValidationClassHierarchy(final Class<?> clazz) {
final List<Class<?>> hierarchy = Lists.newArrayList();
// Get all superclasses.
for (Class<?> currentClass = clazz; currentClass != Object.class; currentClass = currentClass.getSuperclass()) {
hierarchy.add(clazz);
}
hierarchy.addAll(getAllValidationInterfaces(clazz));
Collections.reverse(hierarchy);
return Queues.newArrayDeque(hierarchy);
}
private List<Class<?>> getAllValidationInterfaces(final Class<?> clazz) {
final Multimap<Integer, Class<?>> map = Multimaps.newListMultimap(Maps.<Integer, Collection<Class<?>>>newTreeMap(),
new Supplier<List<Class<?>>>() {
@Override
public List<Class<?>> get() {
return Lists.newArrayList();
}
});
retrieveAllValidationInterfaces(clazz, map);
final List<Class<?>> interfaces = Lists.newArrayList(map.values());
Collections.reverse(interfaces);
return interfaces;
}
private int retrieveAllValidationInterfaces(Class<?> clazz, final Multimap<Integer, Class<?>> map) {
if (clazz == null) {
return 0;
}
int minDepth = 0;
while (clazz != null) {
for (final Class<?> iface : clazz.getInterfaces()) {
int depth = retrieveAllValidationInterfaces(iface, map);
if (!map.containsValue(iface)) {
map.put(depth, iface);
}
minDepth = minDepth > depth ? depth : minDepth;
}
clazz = clazz.getSuperclass();
}
return minDepth + 1;
}
}