Metacat

/**

 *  '$RCSfile$'

 *    Purpose: A Class that implements login methods

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

 *             National Center for Ecological Analysis and Synthesis

 *    ors: Michael Daigle

 *

 *   '$or: daigle $'

 *     '$Date: 2008-11-25 09:54:32 -0800 (Tue, 25 Nov 2008) $'

 * '$Revision: 4628 $'

 *

 * 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.service.PropertyService;

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

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

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.PropertyNotFoundException;

import edu.ucsb.nceas.utilities.GeneralPropertyException;

/**

 * Control the display of the login page 

 */

public class BackupAdmin extends MetaCatAdmin {

	private static BackupAdmin Admin = null;

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

	// <base_dir>/metacat/.metacat/metacat.properties.backup exists

	public static final String HIDDEN_EXISTS_POPULATED = "hiddenExistsPopulated";

	// <base_dir>/metacat/.metacat exists writable and is empty dir

	public static final String HIDDEN_EXISTS_UNPOPULATED = "hiddenExistsUnPopulated";	

	// <base_dir> exists writable without metacat subdirectory

	public static final String BASE_EXISTS_ONLY = "baseExistsOnly";

	// we couldn't determine the status of <base_dir>

	public static final String UNKNOWN = "unknown";

	/**

	 * private constructor since this is a singleton

	 */

	private BackupAdmin() {}

	/**

	 * Get the single instance of BackupAdmin.

	 * 

	 * @return the single instance of BackupAdmin

	 */

	public static BackupAdmin getInstance() {

		if (Admin == null) {

			Admin = new BackupAdmin();

		}

		return Admin;

	}

	/**

	 * Handle configuration of the backup directory

	 * 

	 * @param request

	 *            the http request information

	 * @param response

	 *            the http response to be sent back to the client

	 */

	public void configureBackup(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 {

				String backupBaseDir = SystemUtil.discoverExternalBaseDir();

				logMetacat.debug("Backup dir discovered as: " + backupBaseDir);

				String backupDirStatus = getBackupDirStatus(backupBaseDir);

				logMetacat.debug("Status of discovered backup dir: " + backupDirStatus);

				if (backupBaseDir != null) {

					request.setAttribute("backupBaseDir", backupBaseDir);

				} else {

					request.setAttribute("backupBaseDir", "");

				}

				request.setAttribute("backupDirStatus", backupDirStatus);

				// Forward the request to the JSP page

				RequestUtil.forwardRequest(request, response,

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

			} catch (IOException ioe) {

				throw new AdminException("IO problem while initializing "

						+ "backup configuration page:" + ioe.getMessage());

			} catch (ServletException se) {

				throw new AdminException("Problem forwarding request while "

						+ "initializing backup configuration page: " + se.getMessage());

			} catch (PropertyNotFoundException pnfe) {

				throw new AdminException("Problem discovering backup directory while "

						+ "initializing backup configuration page: " + pnfe.getMessage());

			}

		} else {

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

			// processed.

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

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

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

			String backupDir = request.getParameter("backup-dir");

			String hiddenBackupDir = backupDir + FileUtil.getFS() + ".metacat";

			// Validate that the options provided are legitimate.

			validationErrors.addAll(validateOptions(request));

			if (validationErrors.size() == 0) {

				try {

					FileUtil.createDirectory(hiddenBackupDir);

					PropertyService.setProperty("application.backupDir", backupDir);

					ServiceService.refreshService("PropertyService");

					ServiceService.refreshService("SkinPropertyService");

					SystemUtil.storeExternalDirLocation(backupDir);

				} catch (IOException ue) {

					String errorMessage = "Could not create directory: " + hiddenBackupDir

							+ " : " + ue.getMessage() + ". Please try again";

					processingErrors.add(errorMessage);

					logMetacat.error(errorMessage);

				} catch (GeneralPropertyException gpe) {

					String errorMessage = "Could not set application.backupDir property "

							+ " to " + backupDir + " : " + gpe.getMessage() + ".";

					processingErrors.add(errorMessage);

					logMetacat.error(errorMessage);

				} catch (ServiceException se) {

					String errorMessage = "Could not refresh service : " + se.getMessage() + ".";

					processingErrors.add(errorMessage);

					logMetacat.error(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 {

					// Reload the main metacat configuration page

					processingSuccess.add("Directory: " + backupDir + " configured.");

					RequestUtil.clearRequestMessages(request);

					RequestUtil.setRequestSuccess(request, processingSuccess);

					RequestUtil.forwardRequest(request, response,

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

				}

			} catch (IOException ioe) {

				throw new AdminException("IO problem while processing login page: " 

						+ ioe.getMessage());

			} catch (ServletException se) {

				throw new AdminException("problem forwarding request while "

						+ "processing login page: " + se.getMessage());

			}

		}

	}

	/**

	 * Find the status of the backup base directory.  The possible statuses are:

	 *  -- HIDDEN_EXISTS_POPULATED

	 *  -- HIDDEN_EXISTS_UNPOPULATED

	 *  -- METACAT_EXISTS_ONLY

	 *  -- BASE_EXISTS_ONLY

	 *  -- UNKNOWN

	 *  

	 * @param backupBaseDir the directory we want to check

	 * @return a string corresponding to one of the statuses shown above.

	 */

	protected String getBackupDirStatus(String backupBaseDir) {

		if (backupBaseDir == null) {

			return UNKNOWN;

		}

		if (FileUtil.getFileStatus(backupBaseDir + FileUtil.getFS() + ".metacat" + FileUtil.getFS()

				+ "metacat.properties.backup") >= FileUtil.EXISTS_READ_WRITABLE) {

			return HIDDEN_EXISTS_POPULATED;

		}

		if (FileUtil.getFileStatus(backupBaseDir + FileUtil.getFS() + ".metacat") >= FileUtil.EXISTS_READ_WRITABLE) {

			return HIDDEN_EXISTS_UNPOPULATED;

		}

		if (FileUtil.getFileStatus(backupBaseDir) >= FileUtil.EXISTS_READ_WRITABLE) {

			return BASE_EXISTS_ONLY;

		}

		return UNKNOWN;

	}

	/**

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

	 * 

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

	 *         validation.

	 */

	protected Vector<String> validateOptions(HttpServletRequest request) {

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

		String backupDir = request.getParameter("backup-dir");

		String hiddenBackupDir = backupDir + FileUtil.getFS() + ".metacat";

		if (FileUtil.getFileStatus(hiddenBackupDir) > FileUtil.DOES_NOT_EXIST

				&& !FileUtil.isDirectory(hiddenBackupDir)) {

			errorVector.add(hiddenBackupDir + " exists, but is not a directory.");

		}

		String deployDir = SystemUtil.discoverDeployDir(request);

		if (backupDir.startsWith(deployDir)) {

			errorVector.add("Backup location must be outside of the application directory: "

							+ deployDir);

		}

		return errorVector;

	}

}