Modifier and Type	Class and Description
private static class	PlatformResourceBundleLocator.AggregateResourceBundleControl

Modifier and Type	Field and Description
private final boolean	aggregate
private final String	bundleName
private final ClassLoader	classLoader
private static final Log	LOG
private final Map<Locale, ResourceBundle>	preloadedResourceBundles
private static final boolean	RESOURCE_BUNDLE_CONTROL_INSTANTIABLE

Constructor Summary

Access	Constructor and Description
public	PlatformResourceBundleLocator(String the name of the bundle to load bundleName) Creates a new `PlatformResourceBundleLocator`.
public	PlatformResourceBundleLocator(String the name of the bundle to load bundleName, ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. classLoader) Creates a new `PlatformResourceBundleLocator`.
public	PlatformResourceBundleLocator(String the name of the bundle to load bundleName, ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. classLoader, boolean Whether or not all resource bundles of a given name should be loaded and potentially merged. aggregate) Creates a new `PlatformResourceBundleLocator`.
public	PlatformResourceBundleLocator(String the name of the bundle to load bundleName, Set<Locale> the set of locales to initialize at bootstrap localesToInitialize) Creates a new `PlatformResourceBundleLocator`.
public	PlatformResourceBundleLocator(String the name of the bundle to load bundleName, Set<Locale> the set of locales to initialize at bootstrap localesToInitialize, ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. classLoader) Creates a new `PlatformResourceBundleLocator`.
public	PlatformResourceBundleLocator(String the name of the bundle to load bundleName, Set<Locale> the set of locales to initialize at bootstrap localesToInitialize, ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. classLoader, boolean Whether or not all resource bundles of a given name should be loaded and potentially merged. aggregate) Creates a new `PlatformResourceBundleLocator`.

Method Summary

Modifier and Type	Method and Description
private static boolean	determineAvailabilityOfResourceBundleControl() Check whether ResourceBundle.Control is available, which is needed for bundle aggregation.
private ResourceBundle	doGetResourceBundle(Locale locale)
public ResourceBundle	Returns: the resource bundle or `null` if none is found. getResourceBundle(Locale The locale of the bundle to load. locale) Implements org.hibernate.validator.spi.resourceloading.ResourceBundleLocator.getResourceBundle. Search current thread classloader for the resource bundle.
private ResourceBundle	loadBundle(ClassLoader classLoader, Locale locale, String message)
private static <T> T	run(PrivilegedAction<T> action) Runs the given privileged action, using a privileged block if required.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

aggregate	back to summary
private final boolean aggregate

bundleName	back to summary
private final String bundleName

classLoader	back to summary
private final ClassLoader classLoader

LOG	back to summary
private static final Log LOG

preloadedResourceBundles	back to summary
private final Map<Locale, ResourceBundle> preloadedResourceBundles Annotations @Immutable

RESOURCE_BUNDLE_CONTROL_INSTANTIABLE	back to summary
private static final boolean RESOURCE_BUNDLE_CONTROL_INSTANTIABLE

Constructor Detail

PlatformResourceBundleLocator back to summary

PlatformResourceBundleLocator	back to summary
public PlatformResourceBundleLocator(String bundleName) Creates a new `PlatformResourceBundleLocator`. Parameters bundleName:String the name of the bundle to load

public PlatformResourceBundleLocator(String bundleName)

Creates a new PlatformResourceBundleLocator.

Parameters

bundleName:String: the name of the bundle to load

PlatformResourceBundleLocator back to summary

PlatformResourceBundleLocator	back to summary
public PlatformResourceBundleLocator(String bundleName, ClassLoader classLoader) Creates a new `PlatformResourceBundleLocator`. Parameters bundleName:String the name of the bundle to load classLoader:ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. Since 5.2

public PlatformResourceBundleLocator(String bundleName, ClassLoader classLoader)

Creates a new PlatformResourceBundleLocator.

Parameters

bundleName:String: the name of the bundle to load
classLoader:ClassLoader: the classloader to be used for loading the bundle. If null, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle.

Since

5.2

PlatformResourceBundleLocator back to summary

PlatformResourceBundleLocator	back to summary
public PlatformResourceBundleLocator(String bundleName, ClassLoader classLoader, boolean aggregate) Creates a new `PlatformResourceBundleLocator`. Parameters bundleName:String the name of the bundle to load classLoader:ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. aggregate:boolean Whether or not all resource bundles of a given name should be loaded and potentially merged. Since 5.2

public PlatformResourceBundleLocator(String bundleName, ClassLoader classLoader, boolean aggregate)

Creates a new PlatformResourceBundleLocator.

Parameters

bundleName:String: the name of the bundle to load
classLoader:ClassLoader: the classloader to be used for loading the bundle. If null, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle.
aggregate:boolean: Whether or not all resource bundles of a given name should be loaded and potentially merged.

Since

5.2

PlatformResourceBundleLocator back to summary

PlatformResourceBundleLocator	back to summary
public PlatformResourceBundleLocator(String bundleName, Set<Locale> localesToInitialize) Creates a new `PlatformResourceBundleLocator`. Parameters bundleName:String the name of the bundle to load localesToInitialize:Set<Locale> the set of locales to initialize at bootstrap Annotations @Incubating Since 6.1.1

public PlatformResourceBundleLocator(String bundleName, Set<Locale> localesToInitialize)

Creates a new PlatformResourceBundleLocator.

Parameters

bundleName:String: the name of the bundle to load
localesToInitialize:Set<Locale>: the set of locales to initialize at bootstrap

Annotations

@Incubating

Since

6.1.1

PlatformResourceBundleLocator back to summary

PlatformResourceBundleLocator	back to summary
public PlatformResourceBundleLocator(String bundleName, Set<Locale> localesToInitialize, ClassLoader classLoader) Creates a new `PlatformResourceBundleLocator`. Parameters bundleName:String the name of the bundle to load localesToInitialize:Set<Locale> the set of locales to initialize at bootstrap classLoader:ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. Annotations @Incubating Since 6.1.1

public PlatformResourceBundleLocator(String bundleName, Set<Locale> localesToInitialize, ClassLoader classLoader)

Creates a new PlatformResourceBundleLocator.

Parameters

bundleName:String: the name of the bundle to load
localesToInitialize:Set<Locale>: the set of locales to initialize at bootstrap
classLoader:ClassLoader: the classloader to be used for loading the bundle. If null, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle.

Annotations

@Incubating

Since

6.1.1

PlatformResourceBundleLocator back to summary

PlatformResourceBundleLocator	back to summary
public PlatformResourceBundleLocator(String bundleName, Set<Locale> localesToInitialize, ClassLoader classLoader, boolean aggregate) Creates a new `PlatformResourceBundleLocator`. Parameters bundleName:String the name of the bundle to load localesToInitialize:Set<Locale> the set of locales to initialize at bootstrap classLoader:ClassLoader the classloader to be used for loading the bundle. If `null`, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle. aggregate:boolean Whether or not all resource bundles of a given name should be loaded and potentially merged. Annotations @Incubating Since 6.1

public PlatformResourceBundleLocator(String bundleName, Set<Locale> localesToInitialize, ClassLoader classLoader, boolean aggregate)

Creates a new PlatformResourceBundleLocator.

Parameters

bundleName:String: the name of the bundle to load
localesToInitialize:Set<Locale>: the set of locales to initialize at bootstrap
classLoader:ClassLoader: the classloader to be used for loading the bundle. If null, the current thread context classloader and finally Hibernate Validator's own classloader will be used for loading the specified bundle.
aggregate:boolean: Whether or not all resource bundles of a given name should be loaded and potentially merged.

Annotations

@Incubating

Since

6.1

Method Detail

determineAvailabilityOfResourceBundleControl	back to summary
private static boolean determineAvailabilityOfResourceBundleControl() Check whether ResourceBundle.Control is available, which is needed for bundle aggregation. If not, we'll skip resource aggregation. It is not available in the Google App Engine environment when running HV as Java 9 named module (which would be the case when adding a module-info descriptor to the HV JAR) See Also GAE JRE whitelist, HV-1023, ResourceBundle.Control

determineAvailabilityOfResourceBundleControl

back to summary

private static boolean determineAvailabilityOfResourceBundleControl()

Check whether ResourceBundle.Control is available, which is needed for bundle aggregation. If not, we'll skip resource aggregation.

It is *not* available

in the Google App Engine environment
when running HV as Java 9 named module (which would be the case when adding a module-info descriptor to the HV JAR)

See Also: GAE JRE whitelist, HV-1023, ResourceBundle.Control

doGetResourceBundle	back to summary
private ResourceBundle doGetResourceBundle(Locale locale)

getResourceBundle back to summary

getResourceBundle	back to summary
public ResourceBundle getResourceBundle(Locale locale) Implements org.hibernate.validator.spi.resourceloading.ResourceBundleLocator.getResourceBundle. Search current thread classloader for the resource bundle. If not found, search validator (this) classloader. Parameters locale:Locale The locale of the bundle to load. Returns:ResourceBundle the resource bundle or `null` if none is found. Annotations @Override

public ResourceBundle getResourceBundle(Locale locale)

Implements org.hibernate.validator.spi.resourceloading.ResourceBundleLocator.getResourceBundle.

Search current thread classloader for the resource bundle. If not found, search validator (this) classloader.

Parameters

locale:Locale: The locale of the bundle to load.

Returns:ResourceBundle

the resource bundle or null if none is found.

Annotations

@Override

loadBundle	back to summary
private ResourceBundle loadBundle(ClassLoader classLoader, Locale locale, String message)

run	back to summary
private static <T> T run(PrivilegedAction<T> action) Runs the given privileged action, using a privileged block if required. Note This must never be changed into a publicly available method to avoid execution of arbitrary privileged actions within HV's protection domain. Annotations @IgnoreForbiddenApisErrors reason:SecurityManager is deprecated in JDK17

run

back to summary

private static <T> T run(PrivilegedAction<T> action)

Runs the given privileged action, using a privileged block if required.

Note

This must never be changed into a publicly available method to avoid execution of arbitrary privileged actions within HV's protection domain.

Annotations

@IgnoreForbiddenApisErrors
reason:SecurityManager is deprecated in JDK17

org.hibernate.validator.resourceloading back to summary

private Class PlatformResourceBundleLocator.AggregateResourceBundleControl

Class Inheritance

extends Control

java.lang.Object
java.util.ResourceBundle.Control
org.hibernate.validator.resourceloading.PlatformResourceBundleLocator.AggregateResourceBundleControl

Field Summary

Modifier and Type	Field and Description
private static final ResourceBundle.Control	CONTROL

Inherited from java.util.ResourceBundle.Control:: FORMAT_CLASS FORMAT_DEFAULT FORMAT_PROPERTIES TTL_DONT_CACHE TTL_NO_EXPIRATION_CONTROL

Constructor Summary

Access	Constructor and Description
private	AggregateResourceBundleControl()

Method Summary

Modifier and Type Method and Description

Modifier and Type	Method and Description
private static List<ResourceBundle>	load(String resourceName, ClassLoader loader)
public ResourceBundle	newBundle(String the base bundle name of the resource bundle, a fully qualified class name baseName, Locale the locale for which the resource bundle should be instantiated locale, String the resource bundle format to be loaded format, ClassLoader the `ClassLoader` to use to load the bundle loader, boolean the flag to indicate bundle reloading; `true` if reloading an expired resource bundle, `false` otherwise reload) Overrides java.util.ResourceBundle.Control.newBundle. Instantiates a resource bundle for the given bundle name of the given format and locale, using the given class loader if necessary.

private static List<ResourceBundle>

load(String resourceName, ClassLoader loader)

public ResourceBundle

newBundle(String

the base bundle name of the resource bundle, a fully qualified class name

baseName, Locale

the locale for which the resource bundle should be instantiated

locale, String

the resource bundle format to be loaded

format, ClassLoader

the ClassLoader to use to load the bundle

loader, boolean

the flag to indicate bundle reloading; true if reloading an expired resource bundle, false otherwise

reload)

Overrides java.util.ResourceBundle.Control.newBundle.

Instantiates a resource bundle for the given bundle name of the given format and locale, using the given class loader if necessary.

Inherited from java.util.ResourceBundle.Control:: getCandidateLocales getControl getFallbackLocale getFormats getNoFallbackControl getTimeToLive needsReload toBundleName toResourceName

Field Detail

CONTROL	back to summary
private static final ResourceBundle.Control CONTROL

Constructor Detail

AggregateResourceBundleControl	back to summary
private AggregateResourceBundleControl()

Method Detail

load	back to summary
private static List<ResourceBundle> load(String resourceName, ClassLoader loader) throws IOException

newBundle back to summary

newBundle	back to summary
public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload) throws IllegalAccessException, InstantiationException, IOException Overrides java.util.ResourceBundle.Control.newBundle. Doc from java.util.ResourceBundle.Control.newBundle. Instantiates a resource bundle for the given bundle name of the given format and locale, using the given class loader if necessary. This method returns `null` if there is no resource bundle available for the given parameters. If a resource bundle can't be instantiated due to an unexpected error, the error must be reported by throwing an `Error` or `Exception` rather than simply returning `null`. If the `reload` flag is `true`, it indicates that this method is being called because the previously loaded resource bundle has expired. Parameters baseName:String the base bundle name of the resource bundle, a fully qualified class name locale:Locale the locale for which the resource bundle should be instantiated format:String the resource bundle format to be loaded loader:ClassLoader the `ClassLoader` to use to load the bundle reload:boolean the flag to indicate bundle reloading; `true` if reloading an expired resource bundle, `false` otherwise Returns:ResourceBundle the resource bundle instance, or `null` if none could be found. Annotations @Override Exceptions IllegalAccessException: if the class or its nullary constructor is not accessible. InstantiationException: if the instantiation of a class fails for some other reason. IOException: if an error occurred when reading resources using any I/O operations

public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload) throws IllegalAccessException, InstantiationException, IOException

Overrides java.util.ResourceBundle.Control.newBundle.

Doc from java.util.ResourceBundle.Control.newBundle.

Instantiates a resource bundle for the given bundle name of the given format and locale, using the given class loader if necessary. This method returns null if there is no resource bundle available for the given parameters. If a resource bundle can't be instantiated due to an unexpected error, the error must be reported by throwing an Error or Exception rather than simply returning null.

If the reload flag is true, it indicates that this method is being called because the previously loaded resource bundle has expired.

Parameters

baseName:String: the base bundle name of the resource bundle, a fully qualified class name
locale:Locale: the locale for which the resource bundle should be instantiated
format:String: the resource bundle format to be loaded
loader:ClassLoader: the ClassLoader to use to load the bundle
reload:boolean: the flag to indicate bundle reloading; true if reloading an expired resource bundle, false otherwise

Returns:ResourceBundle

the resource bundle instance, or null if none could be found.

Annotations

@Override

Exceptions

IllegalAccessException:: if the class or its nullary constructor is not accessible.
InstantiationException:: if the instantiation of a class fails for some other reason.
IOException:: if an error occurred when reading resources using any I/O operations

public Class PlatformResourceBundleLocator

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class PlatformResourceBundleLocator.AggregateResourceBundleControl

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail