/*
 * 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.invoke.MethodHandles;
import java.security.PrivilegedAction;

import org.hibernate.validator.HibernateValidator;
import org.hibernate.validator.internal.util.logging.Log;
import org.hibernate.validator.internal.util.logging.LoggerFactory;

Loads a class specified by name.

If no class loader is provided, first the thread context class loader is tried, and finally Hibernate Validator's own class loader.

Note: When loading classes provided by the user (such as XML-configured beans or constraint types), the user class loader passed to the configuration must be passed.

Author:Emmanuel Bernard, Hardy Ferentschik, Kevin Pollet <kevin.pollet@serli.com> (C) 2011 SERLI, Gunnar Morling, Guillaume Smet
/** * Loads a class specified by name. * <p> * If no class loader is provided, first the thread context class loader is tried, and finally Hibernate Validator's own * class loader. * <p> * <b>Note</b>: When loading classes provided by the user (such as XML-configured beans or constraint types), the user * class loader passed to the configuration must be passed. * * @author Emmanuel Bernard * @author Hardy Ferentschik * @author Kevin Pollet &lt;kevin.pollet@serli.com&gt; (C) 2011 SERLI * @author Gunnar Morling * @author Guillaume Smet */
public final class LoadClass implements PrivilegedAction<Class<?>> { private static final Log LOG = LoggerFactory.make( MethodHandles.lookup() ); private static final String HIBERNATE_VALIDATOR_CLASS_NAME = "org.hibernate.validator"; private final String className; private final ClassLoader classLoader; private final ClassLoader initialThreadContextClassLoader;
when true, it will check the Thread Context ClassLoader when the class is not found in the provided one
/** * when true, it will check the Thread Context ClassLoader when the class is not found in the provided one */
private final boolean fallbackOnTCCL; public static LoadClass action(String className, ClassLoader classLoader) { return action( className, classLoader, true ); } public static LoadClass action(String className, ClassLoader classLoader, boolean fallbackOnTCCL) { return new LoadClass( className, classLoader, null, fallbackOnTCCL ); }
in some cases, the TCCL has been overridden so we need to pass it explicitly.
/** * in some cases, the TCCL has been overridden so we need to pass it explicitly. */
public static LoadClass action(String className, ClassLoader classLoader, ClassLoader initialThreadContextClassLoader) { return new LoadClass( className, classLoader, initialThreadContextClassLoader, true ); } private LoadClass(String className, ClassLoader classLoader, ClassLoader initialThreadContextClassLoader, boolean fallbackOnTCCL) { this.className = className; this.classLoader = classLoader; this.initialThreadContextClassLoader = initialThreadContextClassLoader; this.fallbackOnTCCL = fallbackOnTCCL; } @Override public Class<?> run() { if ( className.startsWith( HIBERNATE_VALIDATOR_CLASS_NAME ) ) { return loadClassInValidatorNameSpace(); } else { return loadNonValidatorClass(); } } // HV-363 - library internal classes are loaded via Class.forName first private Class<?> loadClassInValidatorNameSpace() { final ClassLoader loader = HibernateValidator.class.getClassLoader(); Exception exception; try { return Class.forName( className, true, HibernateValidator.class.getClassLoader() ); } catch (ClassNotFoundException e) { exception = e; } catch (RuntimeException e) { exception = e; } if ( fallbackOnTCCL ) { ClassLoader contextClassLoader = initialThreadContextClassLoader != null ? initialThreadContextClassLoader : Thread.currentThread().getContextClassLoader(); if ( contextClassLoader != null ) { try { return Class.forName( className, false, contextClassLoader ); } catch (ClassNotFoundException e) { throw LOG.getUnableToLoadClassException( className, contextClassLoader, e ); } } else { throw LOG.getUnableToLoadClassException( className, loader, exception ); } } else { throw LOG.getUnableToLoadClassException( className, loader, exception ); } } private Class<?> loadNonValidatorClass() { Exception exception = null; if ( classLoader != null ) { try { return Class.forName( className, false, classLoader ); } catch (ClassNotFoundException e) { exception = e; } catch (RuntimeException e) { exception = e; } } if ( fallbackOnTCCL ) { try { ClassLoader contextClassLoader = initialThreadContextClassLoader != null ? initialThreadContextClassLoader : Thread.currentThread().getContextClassLoader(); if ( contextClassLoader != null ) { return Class.forName( className, false, contextClassLoader ); } } catch (ClassNotFoundException e) { // ignore - try using the classloader of the caller first // TODO: might be wise to somehow log this } catch (RuntimeException e) { // ignore } final ClassLoader loader = LoadClass.class.getClassLoader(); try { return Class.forName( className, true, loader ); } catch (ClassNotFoundException e) { throw LOG.getUnableToLoadClassException( className, loader, e ); } } else { throw LOG.getUnableToLoadClassException( className, classLoader, exception ); } } }