ValidationProviderFactory.java

/**
* The contents of this file are subject to the Mozilla Public License
* Version 1.1 (the "License"); you may not use this file except in
* compliance with the License. You may obtain a copy of the License at
* http://www.mozilla.org/MPL/ 
* 
* Software distributed under the License is distributed on an "AS IS"
* basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
* License for the specific language governing rights and limitations under
* the License.
* 
* The Original Code is OpenELIS code.
* 
* Copyright (C) The Minnesota Department of Health.  All Rights Reserved.
*/
package us.mn.state.health.lims.common.provider.validation;

import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

import us.mn.state.health.lims.common.exception.LIMSRuntimeException;
import us.mn.state.health.lims.common.util.resources.ResourceLocator;
import us.mn.state.health.lims.common.log.LogEvent;

/**
 * This class will abstract the ValidationProvider creation. It will read the
 * name of the class file from properties file and create the class
 * 
 * @version 1.0
 * @author diane benz
 * 
 */

public class ValidationProviderFactory {

	private static ValidationProviderFactory instance; // Instance of this

	// class

	// Properties object that holds validation provider mappings
	private Properties validationProviderClassMap = null;

	/**
	 * Singleton global access for ValidationProviderFactory
	 * 
	 */

	public static ValidationProviderFactory getInstance() {
		if (instance == null) {
			synchronized (ValidationProviderFactory.class) {
				if (instance == null) {
					instance = new ValidationProviderFactory();
				}
			}

		}
		return instance;
	}

	/**
	 * Create an object for the full class name passed in.
	 * 
	 * @param String
	 *            full class name
	 * @return Object Created object
	 */
	protected Object createObject(String className) throws LIMSRuntimeException {
		Object object = null;
		try {
			Class classDefinition = Class.forName(className);
			object = classDefinition.newInstance();
		} catch (Exception e) {
            //bugzilla 2154 
			LogEvent.logError("ValidationProviderFactory","createObject()",e.toString());
			throw new LIMSRuntimeException("Unable to create an object for "
					+ className, e, LogEvent.getLog(ValidationProviderFactory.class));
		}
		return object;
	}

	/**
	 * Search for the ValidationProvider implementation class name in the
	 * Validation.properties file for the given ValidationProvider name
	 * 
	 * @param String
	 *            ValidationProvider name e.g "OrganizationLocalAbbreviationValidationProvider"
	 * @return String Full implementation class e.g
	 *         "us.mn.state.health.lims.common.validation.provider"
	 */
	protected String getValidationProviderClassName(
			String validationProvidername) throws LIMSRuntimeException {
		if (validationProviderClassMap == null) { // Need to load the property
			// object with the class
			// mappings
			ResourceLocator rl = ResourceLocator.getInstance();
			InputStream propertyStream = null;
			// Now load a java.util.Properties object with the properties
			validationProviderClassMap = new Properties();
			try {
				propertyStream = rl
						.getNamedResourceAsInputStream(ResourceLocator.AJAX_PROPERTIES);

				validationProviderClassMap.load(propertyStream);
			} catch (IOException e) {
                //bugzilla 2154
			    LogEvent.logError("ValidationProviderFactory","getValidationProviderClassName()",e.toString());
				throw new LIMSRuntimeException(
						"Unable to load validation provider class mappings.",
						e, LogEvent.getLog(ValidationProviderFactory.class));
			} finally {
				if (null != propertyStream) {
					try {
						propertyStream.close();
						propertyStream = null;
					} catch (Exception e) {
                		//bugzilla 2154
			    		LogEvent.logError("ValidationProviderFactory","getValidationProviderClassName()",e.toString());
					}
				}
			}
		}

		String mapping = validationProviderClassMap
				.getProperty(validationProvidername);
		if (mapping == null) {
			//bugzilla 2154
			LogEvent.logError("ValidationProviderFactory","getValidationProviderClassName()",validationProvidername);
			throw new LIMSRuntimeException(
					"getValidationProviderClassName - Unable to find mapping for "
							+ validationProvidername);
		}
		return mapping;
	}

	/**
	 * Validation Provider creation method
	 * 
	 * @param name
	 * @return Validation Provider object
	 * 
	 */
	public BaseValidationProvider getValidationProvider(String name)
			throws LIMSRuntimeException {
		BaseValidationProvider provider = null;

		String className = getValidationProviderClassName(name);

		provider = (BaseValidationProvider) createObject(className);

		return provider;
	}

}