Metacat

/**

 *  '$RCSfile$'

 *    Purpose:  A Class that implements main property configuration methods

 *  Copyright: 2008 Regents of the University of California and the

 *             National Center for Ecological Analysis and Synthesis

 *    Authors: Michael Daigle

 *

 *   '$Author: daigle $'

 *     '$Date: 2008-07-07 13:49:18 -0700 (Mon, 07 Jul 2008) $'

 * '$Revision: 4084 $'

 *

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 2 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 */

package edu.ucsb.nceas.metacat.admin;

import java.io.IOException;

import java.util.Vector;

import javax.servlet.ServletException;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import org.apache.log4j.Logger;

import edu.ucsb.nceas.metacat.DBVersion;

import edu.ucsb.nceas.metacat.MetaCatVersion;

import edu.ucsb.nceas.metacat.service.PropertyService;

import edu.ucsb.nceas.metacat.util.RequestUtil;

import edu.ucsb.nceas.metacat.util.SystemUtil;

import edu.ucsb.nceas.utilities.FileUtil;

import edu.ucsb.nceas.utilities.GeneralPropertyException;

import edu.ucsb.nceas.utilities.PropertiesMetaData;

import edu.ucsb.nceas.utilities.SortedProperties;

/**

 * Control the display of the main properties configuration page and the 

 * processing of the configuration values.

 */

public class PropertiesAdmin extends MetaCatAdmin {

	private static PropertiesAdmin propertiesAdmin = null;

	private static Logger logMetacat = Logger.getLogger(PropertiesAdmin.class);

	/**

	 * private constructor since this is a singleton

	 */

	private PropertiesAdmin() {}

	/**

	 * Get the single instance of the MetaCatConfig.

	 * 

	 * @return the single instance of MetaCatConfig

	 */

	public static PropertiesAdmin getInstance() {

		if (propertiesAdmin == null) {

			propertiesAdmin = new PropertiesAdmin();

		}

		return propertiesAdmin;

	}

	/**

	 * Handle configuration of the main application properties

	 * 

	 * @param request

	 *            the http request object

	 * @param response

	 *            the http response to be sent back to the client

	 */

	public void configureProperties(HttpServletRequest request,

			HttpServletResponse response) throws AdminException {

		String processForm = request.getParameter("processForm");

		String formErrors = (String)request.getAttribute("formErrors");

		if (processForm == null || !processForm.equals("true") || formErrors != null) {

			// The servlet configuration parameters have not been set, or there

			// were form errors on the last attempt to configure, so redirect to

			// the web form for configuring metacat

			try {

				// Load the properties metadata file so that the JSP page can

				// use the metadata to construct the editing form

				PropertiesMetaData metadata = PropertyService.getMainMetaData();

				request.setAttribute("metadata", metadata);

				// Attempt to discover the following properties.  These will show

				// up in the configuration fields if nothing else is provided.

				PropertyService.setPropertyNoPersist("application.context",

						SystemUtil.discoverApplicationContext(request));

				PropertyService.setPropertyNoPersist("server.name", SystemUtil

						.discoverServerName(request));

				PropertyService.setPropertyNoPersist("server.httpPort", SystemUtil

						.discoverServerPort(request));

				PropertyService.setPropertyNoPersist("server.httpSSLPort",

						SystemUtil.discoverServerSSLPort(request));

				PropertyService.setPropertyNoPersist("application.tomcatDir",

						SystemUtil.discoverTomcatDir(request));

				PropertyService.persistProperties();

				// Add the list of properties from metacat.properties to the request

				Vector<String> propertyNames = PropertyService.getPropertyNames();

				for (String propertyName : propertyNames) {

					request.setAttribute(propertyName, PropertyService.getProperty(propertyName));

				}

				// Check for any backup properties and apply them to the

				// request. These are properties from previous configurations. 

				// They keep the user from having to re-enter all values when 

				// upgrading. If this is a first time install, getBackupProperties 

				// will return null.

				SortedProperties backupProperties = null;

				if ((backupProperties = 

						PropertyService.getMainBackupProperties()) != null) {

					Vector<String> backupKeys = backupProperties.getPropertyNames();

					for (String key : backupKeys) {

						String value = backupProperties.getProperty(key);

						if (value != null) {

							request.setAttribute(key, value);

						}

					}

				}

				// Forward the request to the JSP page

				RequestUtil.forwardRequest(request, response,

						"/admin/properties-configuration.jsp");

			} catch (GeneralPropertyException gpe) {

				throw new AdminException("Problem getting or setting property while " 

						+ "initializing system properties page: " + gpe.getMessage());

			} catch (IOException ioe) {

				throw new AdminException("IO problem while initializing "

						+ "system properties page:" + ioe.getMessage());

			} catch (ServletException se) {

				throw new AdminException("problem forwarding request while " 

						+ "initializing system properties page: " + se.getMessage());

			}

		} else {

			// The configuration form is being submitted and needs to be

			// processed.

			Vector<String> validationErrors = new Vector<String>();

			Vector<String> processingErrors = new Vector<String>();

			Vector<String> processingSuccess = new Vector<String>();

			MetaCatVersion metacatVersion = null;

			try {

				metacatVersion = SystemUtil.getMetacatVersion();

				// For each property, check if it is changed and save it

				Vector<String> propertyNames = PropertyService.getPropertyNames();

				for (String name : propertyNames) {

					PropertyService.checkAndSetProperty(request, name);

				}

				// we need to write the options from memory to the properties

				// file

				PropertyService.persistProperties();

				// Validate that the options provided are legitimate. Note that

				// we've allowed them to persist their entries. As of this point

				// there is no other easy way to go back to the configure form

				// and preserve their entries.

				validationErrors.addAll(validateOptions(request));

				// Try to create backup directories if necessary.

				String backupDir = PropertyService.getBackupDir();

				if (!FileUtil.createDirectory(backupDir)) {

					String errorString = "Could not create directory: " + backupDir;

					logMetacat.error(errorString);

					validationErrors.add(errorString);

				}

				// write the backup properties to a location outside the 

				// application directories so they will be available after

				// the next upgrade

				PropertyService.persistMainBackupProperties(

						request.getSession().getServletContext());

			} catch (GeneralPropertyException gpe) {

				String errorMessage = "Problem getting or setting property while "

						+ "processing system properties page: " + gpe.getMessage();

				logMetacat.error(errorMessage);

				processingErrors.add(errorMessage);

			} catch (IOException ioe) {

				String errorMessage = "IO problem while processing system "

						+ "properties page: " + ioe.getMessage();

				logMetacat.error(errorMessage);

				processingErrors.add(errorMessage);

			}

			try {

				if (validationErrors.size() > 0 || processingErrors.size() > 0) {

					RequestUtil.clearRequestMessages(request);

					RequestUtil.setRequestFormErrors(request, validationErrors);

					RequestUtil.setRequestErrors(request, processingErrors);

					RequestUtil.forwardRequest(request, response, "/admin");

				} else {

					// Now that the options have been set, change the

					// 'propertiesConfigured' option to 'true'

					PropertyService.setProperty("configutil.propertiesConfigured",

							PropertyService.CONFIGURED);

					// if the db version is already the same as the metacat version,

					// update metacat.properties. Have to do this after

					// propertiesConfigured is set to CONFIGURED

					DBVersion dbVersion = DBAdmin.getInstance().getDBVersion();

					if (dbVersion != null && metacatVersion != null && 

							dbVersion.compareTo(metacatVersion) == 0) {

						PropertyService.setProperty("configutil.databaseConfigured", 

								PropertyService.CONFIGURED);

					}

					// Reload the main metacat configuration page

					processingSuccess.add("Properties successfully configured");

					RequestUtil.clearRequestMessages(request);

					RequestUtil.setRequestSuccess(request, processingSuccess);

					RequestUtil.forwardRequest(request, response, 

							"/admin?configureType=configure&processForm=false");

				}

			} catch (ServletException se) {

				throw new AdminException("problem forwarding request while "

						+ "processing system properties page: " + se.getMessage());

			} catch (IOException ioe) {

				throw new AdminException("IO problem while processing system "

						+ "properties page: " + ioe.getMessage());

			} catch (GeneralPropertyException gpe) {

				throw new AdminException("problem with properties while "

						+ "processing system properties page: " + gpe.getMessage());

			}

		}

	}

	/**

	 * Validate the most important configuration options submitted by the user.

	 * 

	 * @param request

	 *            the http request object

	 * 

	 * @return a vector holding error message for any fields that fail

	 *         validation.

	 */

	protected Vector<String> validateOptions(HttpServletRequest request) {

		Vector<String> errorVector = new Vector<String>();

		// Test database connectivity

		try {

			String dbError = DBAdmin.getInstance().validateDBConnectivity(

					request.getParameter("database.driver"),

					request.getParameter("database.connectionURI"),

					request.getParameter("database.user"),

					request.getParameter("database.password"));

			if (dbError != null) {

				errorVector.add(dbError);

			}

		} catch (AdminException ae) {

			errorVector.add("Could not instantiate database admin: "

					+ ae.getMessage());

		}

		return errorVector;

	}

}