/*
 * 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.resourceloading;

import java.util.ArrayList;
import java.util.Enumeration;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.ResourceBundle;

import org.hibernate.validator.internal.util.CollectionHelper;
import org.hibernate.validator.internal.util.Contracts;
import org.hibernate.validator.spi.resourceloading.ResourceBundleLocator;

A ResourceBundleLocator implementation that provides access to multiple source ResourceBundles by merging them into one aggregated bundle. 
Author:
Gunnar Morling/**
 * A {@link ResourceBundleLocator} implementation that provides access
 * to multiple source {@link ResourceBundle}s by merging them into one
 * aggregated bundle.
 *
 * @author Gunnar Morling
 */
public class AggregateResourceBundleLocator extends DelegatingResourceBundleLocator {
	private final List<String> bundleNames;
	private final ClassLoader classLoader;

	
Creates a locator that delivers a resource bundle merged from the given
list of source bundles.
Params:
bundleNames – A list with source bundle names. The returned bundle will
contain all entries from all source bundles. In case a key occurs
in multiple source bundles, the value will be taken from the
first bundle containing the key./**
	 * Creates a locator that delivers a resource bundle merged from the given
	 * list of source bundles.
	 *
	 * @param bundleNames A list with source bundle names. The returned bundle will
	 * contain all entries from all source bundles. In case a key occurs
	 * in multiple source bundles, the value will be taken from the
	 * first bundle containing the key.
	 */
	public AggregateResourceBundleLocator(List<String> bundleNames) {
		this( bundleNames, null );
	}

	
Creates a locator that delivers a resource bundle merged from the given
list of source bundles.
Params:
bundleNames – A list with source bundle names. The returned bundle will
contain all keys from all source bundles. In case a key occurs
in multiple source bundles, the value will be taken from the
first bundle containing the key.
delegate – A delegate resource bundle locator. The bundle returned by
this locator will be added to the aggregate bundle after all
source bundles./**
	 * Creates a locator that delivers a resource bundle merged from the given
	 * list of source bundles.
	 *
	 * @param bundleNames A list with source bundle names. The returned bundle will
	 * contain all keys from all source bundles. In case a key occurs
	 * in multiple source bundles, the value will be taken from the
	 * first bundle containing the key.
	 * @param delegate A delegate resource bundle locator. The bundle returned by
	 * this locator will be added to the aggregate bundle after all
	 * source bundles.
	 */
	public AggregateResourceBundleLocator(List<String> bundleNames, ResourceBundleLocator delegate) {
		this( bundleNames, delegate, null );
	}

	
Creates a locator that delivers a resource bundle merged from the given
list of source bundles.
Params:
bundleNames – A list with source bundle names. The returned bundle will
contain all keys from all source bundles. In case a key occurs
in multiple source bundles, the value will be taken from the
first bundle containing the key.
delegate – A delegate resource bundle locator. The bundle returned by
this locator will be added to the aggregate bundle after all
source bundles.
classLoader – The classloader to use for loading the bundle.
Since:
5.2/**
	 * Creates a locator that delivers a resource bundle merged from the given
	 * list of source bundles.
	 *
	 * @param bundleNames A list with source bundle names. The returned bundle will
	 * contain all keys from all source bundles. In case a key occurs
	 * in multiple source bundles, the value will be taken from the
	 * first bundle containing the key.
	 * @param delegate A delegate resource bundle locator. The bundle returned by
	 * this locator will be added to the aggregate bundle after all
	 * source bundles.
	 * @param classLoader The classloader to use for loading the bundle.
	 * @since 5.2
	 */
	public AggregateResourceBundleLocator(List<String> bundleNames, ResourceBundleLocator delegate,
			ClassLoader classLoader) {
		super( delegate );
		Contracts.assertValueNotNull( bundleNames, "bundleNames" );

		this.bundleNames = CollectionHelper.toImmutableList( bundleNames );
		this.classLoader = classLoader;
	}

	@Override
	public ResourceBundle getResourceBundle(Locale locale) {
		List<ResourceBundle> sourceBundles = new ArrayList<ResourceBundle>();

		for ( String bundleName : bundleNames ) {
			ResourceBundleLocator resourceBundleLocator =
					new PlatformResourceBundleLocator( bundleName, classLoader );

			ResourceBundle resourceBundle = resourceBundleLocator.getResourceBundle( locale );

			if ( resourceBundle != null ) {
				sourceBundles.add( resourceBundle );
			}
		}

		ResourceBundle bundleFromDelegate = super.getResourceBundle( locale );

		if ( bundleFromDelegate != null ) {
			sourceBundles.add( bundleFromDelegate );
		}

		return sourceBundles.isEmpty() ? null : new AggregateBundle( sourceBundles );
	}

	
A ResourceBundle whose content is aggregated from multiple source bundles. 

This class is package-private for the sake of testability.

Author:
Gunnar Morling/**
	 * A {@link ResourceBundle} whose content is aggregated from multiple source bundles.
	 * <p>
	 * This class is package-private for the sake of testability.
	 * </p>
	 *
	 * @author Gunnar Morling
	 */
	public static class AggregateBundle extends ResourceBundle {
		private final Map<String, Object> contents = new HashMap<String, Object>();

		
Creates a new AggregateBundle.
Params:
bundles – A list of source bundles, which shall be merged into one
aggregated bundle. The newly created bundle will contain
all keys from all source bundles. In case a key occurs in
multiple source bundles, the value will be taken from the
first bundle containing the key./**
		 * Creates a new AggregateBundle.
		 *
		 * @param bundles A list of source bundles, which shall be merged into one
		 * aggregated bundle. The newly created bundle will contain
		 * all keys from all source bundles. In case a key occurs in
		 * multiple source bundles, the value will be taken from the
		 * first bundle containing the key.
		 */
		public AggregateBundle(List<ResourceBundle> bundles) {
			if ( bundles != null ) {

				for ( ResourceBundle bundle : bundles ) {
					Enumeration<String> keys = bundle.getKeys();
					while ( keys.hasMoreElements() ) {
						String oneKey = keys.nextElement();
						if ( !contents.containsKey( oneKey ) ) {
							contents.put( oneKey, bundle.getObject( oneKey ) );
						}
					}
				}
			}
		}

		@Override
		public Enumeration<String> getKeys() {
			return new IteratorEnumeration<String>( contents.keySet().iterator() );
		}

		@Override
		protected Object handleGetObject(String key) {
			return contents.get( key );
		}
	}

	
An Enumeration implementation, that wraps an Iterator. Can be used to integrate older APIs working with enumerations with iterators. 
Author:
Gunnar Morling
Type parameters:
<T> – The enumerated type./**
	 * An {@link Enumeration} implementation, that wraps an {@link Iterator}. Can
	 * be used to integrate older APIs working with enumerations with iterators.
	 *
	 * @param <T> The enumerated type.
	 *
	 * @author Gunnar Morling
	 */
	private static class IteratorEnumeration<T> implements Enumeration<T> {

		private final Iterator<T> source;

		
Creates a new IterationEnumeration.
Params:
source – The source iterator. Must not be null./**
		 * Creates a new IterationEnumeration.
		 *
		 * @param source The source iterator. Must not be null.
		 */
		public IteratorEnumeration(Iterator<T> source) {

			if ( source == null ) {
				throw new IllegalArgumentException( "Source must not be null" );
			}

			this.source = source;
		}

		@Override
		public boolean hasMoreElements() {
			return source.hasNext();
		}

		@Override
		public T nextElement() {
			return source.next();
		}
	}
}