/*
 * Hibernate Validator, declare and validate application constraints
 *
 * License: Apache License, Version 2.0
 * See the license.txt file in the root directory or <http://www.apache.org/licenses/LICENSE-2.0>.
 */
package org.hibernate.validator.internal.util.privilegedactions;

import java.lang.reflect.Method;
import java.security.PrivilegedAction;
import java.util.Set;

Returns the method with the specified property name or null if it does not exist. This action will iterate through getter name candidates and return the first found method. 
 GetMethodFromPropertyName#lookForMethodsInHierarchy parameter controls if we need to check for methods on superclasses/implemented interfaces or not, if equals to false it will use Class.getDeclaredMethod(String, Class[]), and Class.getMethod(String, Class[]) otherwise. 
Author:
Marko Bekhta/**
 * Returns the method with the specified property name or {@code null} if it does not exist. This action will
 * iterate through getter name candidates and return the first found method.
 * <p>
 * {@code GetMethodFromPropertyName#lookForMethodsInHierarchy} parameter controls if we need to check for methods on
 * superclasses/implemented interfaces or not, if equals to {@code false} it will use
 * {@link Class#getDeclaredMethod(String, Class[])}, and {@link Class#getMethod(String, Class[])} otherwise.
 *
 * @author Marko Bekhta
 */
public final class GetMethodFromGetterNameCandidates implements PrivilegedAction<Method> {

	private final Class<?> clazz;
	private final Set<String> getterNameCandidates;
	private final boolean lookForMethodsInHierarchy;

	private GetMethodFromGetterNameCandidates(Class<?> clazz, Set<String> getterNameCandidates, boolean lookForMethodsInHierarchy) {
		this.clazz = clazz;
		this.getterNameCandidates = getterNameCandidates;
		this.lookForMethodsInHierarchy = lookForMethodsInHierarchy;
	}

	public static GetMethodFromGetterNameCandidates action(Class<?> clazz, Set<String> getterNameCandidates) {
		return new GetMethodFromGetterNameCandidates( clazz, getterNameCandidates, false );
	}

	public static GetMethodFromGetterNameCandidates action(Class<?> clazz, Set<String> possibleMethodNames, boolean lookForMethodsInHierarchy) {
		return new GetMethodFromGetterNameCandidates( clazz, possibleMethodNames, lookForMethodsInHierarchy );
	}


	@Override
	public Method run() {
		for ( String methodName : getterNameCandidates ) {
			try {
				if ( lookForMethodsInHierarchy ) {
					return clazz.getMethod( methodName );
				}
				else {
					return clazz.getDeclaredMethod( methodName );
				}
			}
			catch (NoSuchMethodException e) {
				// just ignore the exception
			}
		}

		return null;
	}
}