Project

General

Profile

1 4080 daigle
/**
2
 *  '$RCSfile$'
3
 *    Purpose:  A Class that implements skins configuration methods
4
 *  Copyright: 2008 Regents of the University of California and the
5
 *             National Center for Ecological Analysis and Synthesis
6
 *    Authors: Michael Daigle
7
 *
8
 *   '$Author$'
9
 *     '$Date$'
10
 * '$Revision$'
11
 *
12
 * This program is free software; you can redistribute it and/or modify
13
 * it under the terms of the GNU General Public License as published by
14
 * the Free Software Foundation; either version 2 of the License, or
15
 * (at your option) any later version.
16
 *
17
 * This program is distributed in the hope that it will be useful,
18
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20
 * GNU General Public License for more details.
21
 *
22
 * You should have received a copy of the GNU General Public License
23
 * along with this program; if not, write to the Free Software
24
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
25
 */
26
27
package edu.ucsb.nceas.metacat.admin;
28
29
import java.io.IOException;
30
import java.util.HashMap;
31 4321 daigle
import java.util.Set;
32 4080 daigle
import java.util.Vector;
33
34
import javax.servlet.ServletException;
35
import javax.servlet.http.HttpServletRequest;
36
import javax.servlet.http.HttpServletResponse;
37
38
import org.apache.log4j.Logger;
39
40
import edu.ucsb.nceas.metacat.service.PropertyService;
41
import edu.ucsb.nceas.metacat.service.SkinPropertyService;
42
import edu.ucsb.nceas.metacat.util.RequestUtil;
43
import edu.ucsb.nceas.metacat.util.SkinUtil;
44 4106 daigle
import edu.ucsb.nceas.utilities.FileUtil;
45 4321 daigle
import edu.ucsb.nceas.utilities.MetaDataProperty;
46 4080 daigle
import edu.ucsb.nceas.utilities.PropertiesMetaData;
47
import edu.ucsb.nceas.utilities.GeneralPropertyException;
48 4106 daigle
import edu.ucsb.nceas.utilities.PropertyNotFoundException;
49 4080 daigle
import edu.ucsb.nceas.utilities.SortedProperties;
50
51
/**
52
 * Control the display of the skins configuration page and the processing
53
 * of the configuration values.
54
 */
55
public class SkinsAdmin extends MetaCatAdmin {
56
57
	private static SkinsAdmin skinsAdmin = null;
58
	private static Logger logMetacat = Logger.getLogger(SkinsAdmin.class);
59
60
	/**
61
	 * private constructor since this is a singleton
62
	 */
63
	private SkinsAdmin() {}
64
65
	/**
66
	 * Get the single instance of the MetaCatConfig.
67
	 *
68
	 * @return the single instance of MetaCatConfig
69
	 */
70
	public static SkinsAdmin getInstance() {
71
		if (skinsAdmin == null) {
72
			skinsAdmin = new SkinsAdmin();
73
		}
74
		return skinsAdmin;
75
	}
76
77
	/**
78
	 * Handle configuration of the application the first time that Metacat
79
	 * starts or when it is explicitly called in the url. Collect necessary
80
	 * configuration information from the administrator.
81
	 *
82
	 * @param request
83
	 *            the http request information
84
	 * @param response
85
	 *            the http response to be sent back to the client
86
	 */
87
	public void configureSkins(HttpServletRequest request, HttpServletResponse response)
88
			throws AdminException {
89
90
		String processForm = request.getParameter("processForm");
91
		String formErrors = (String) request.getAttribute("formErrors");
92
93
		if (processForm == null || !processForm.equals("true") || formErrors != null) {
94
			// The servlet configuration parameters have not been set, or there
95
			// were form errors on the last attempt to configure, so redirect to
96
			// the web form for configuring metacat
97
			try {
98
				Vector<String> skinNames = SkinUtil.getSkinNames();
99
				String defaultStyle =
100
					PropertyService.getProperty("application.default-style");
101
102
				request.setAttribute("defaultStyle", defaultStyle);
103
				request.setAttribute("skinNameList", skinNames);
104
105
				// add skin metadata to the request.  The configuration form
106
				// will use this data to determine what the configuration
107
				// fields should look like.
108
				HashMap<String, PropertiesMetaData> propertyMetaData =
109
					SkinPropertyService.getMetaData();
110
				request.setAttribute("metadataMap", propertyMetaData);
111
112
				// get a deep copy of properties so we can override with
113
				// backup values without changing originals
114
				HashMap<String, SortedProperties> originalPropertyMap =
115
					SkinPropertyService.getProperties();
116
				HashMap<String, HashMap<String, String>> localPropertyMap =
117
					new HashMap<String, HashMap<String, String>>();
118
				HashMap<String, SortedProperties> backupPropertiesMap =
119
					SkinPropertyService.getBackupProperties();
120
121
				for (String skinName : skinNames) {
122
					// first, get a deep copy of this skin's properties
123
124
					SortedProperties skinProperties = originalPropertyMap.get(skinName);
125
					if (skinProperties == null) {
126
						throw new GeneralPropertyException("Could not find properties "
127
								+ "for skin: " + skinName);
128
					}
129
130
					HashMap<String, String> originalSkinProperties =
131
						skinProperties.getProperties();
132
					HashMap<String, String> localSkinProperties =
133
						new HashMap<String, String>(originalSkinProperties);
134
135
					// now get the backup properties for this skin.  Overwrite the
136
					// properties with backup properties.  This allows previously
137
					// set properties to be preserved in an application upgrade.
138
					SortedProperties backupProperties = backupPropertiesMap.get(skinName);
139
					for (String propertyName : backupProperties.getPropertyNames())
140
					{
141
						localSkinProperties.put(propertyName,
142 4106 daigle
							backupProperties.getProperty(propertyName));
143 4080 daigle
					}
144
145
					localPropertyMap.put(skinName, localSkinProperties);
146
				}
147
				request.setAttribute("skinProperties", localPropertyMap);
148
149
				// Forward the request to the JSP page
150
				RequestUtil.forwardRequest(request, response,
151
						"/admin/skins-configuration.jsp");
152
153
			} catch (GeneralPropertyException pnfe) {
154
				throw new AdminException("Problem getting property while initializing "
155
						+ "skins properties page: " + pnfe.getMessage());
156
			} catch (IOException ioe) {
157
				throw new AdminException("IO problem while initializing "
158
						+ "skins properties page:" + ioe.getMessage());
159
			} catch (ServletException se) {
160
				throw new AdminException("problem forwarding request while "
161
						+ "initializing skins properties page: " + se.getMessage());
162
			}
163
164
		} else {
165
			// The configuration form is being submitted and needs to be
166
			// processed.
167
			Vector<String> processingSuccess = new Vector<String>();
168
			Vector<String> processingErrors = new Vector<String>();
169
			Vector<String> validationErrors = new Vector<String>();
170
171
			try {
172 4106 daigle
				// For each skin property, check if it is changed and save it
173
				Vector<String> skinNames = SkinUtil.getSkinNames();
174
				for (String skinName : skinNames) {
175 4321 daigle
					PropertiesMetaData skinMetaData =
176
						SkinPropertyService.getMetaData(skinName);
177
					Set<String> metaDataKeySet = skinMetaData.getKeys();
178
					for (String metaDataKey : metaDataKeySet) {
179
						MetaDataProperty metaDataProperty =
180
							skinMetaData.getProperties().get(metaDataKey);
181
						String fieldType = metaDataProperty.getFieldType();
182
						String newValue = request.getParameter(skinName + "." + metaDataKey);
183
						if (fieldType != null && fieldType.equals("checkbox")) {
184
							if (newValue != null && newValue.equals("on")) {
185
								SkinPropertyService.checkAndSetProperty("true", skinName, metaDataKey);
186
							} else {
187
								SkinPropertyService.checkAndSetProperty("false", skinName, metaDataKey);
188
							}
189
						} else {
190
							SkinPropertyService.checkAndSetProperty(request, skinName, metaDataKey);
191
						}
192 4106 daigle
					}
193
194
					// we need to write the options from memory to the
195
					// properties file
196
					SkinPropertyService.persistProperties(skinName);
197
198
					// Validate that the options provided are legitimate. Note
199
					// that we've allowed them to persist their entries. As of
200
					// this point there is no other easy way to go back to the
201
					// configure form and preserve their entries.
202
					validationErrors.addAll(validateOptions(request, skinName));
203
204
					// Try to create backup directories if necessary.
205
					String backupDir = PropertyService.getBackupDir();
206 4440 daigle
					try {
207
						FileUtil.createDirectory(backupDir);
208
					} catch (IOException ioe) {
209
						String errorString = "Could not create directory: " + backupDir +
210
							" : " + ioe.getMessage();
211 4106 daigle
						logMetacat.error(errorString);
212
						validationErrors.add(errorString);
213
					}
214
215
					// write the backup properties to a location outside the
216
					// application directories so they will be available after
217
					// the next upgrade
218
					SkinPropertyService.persistBackupProperties(skinName,
219
							request.getSession().getServletContext());
220
				}
221
222
				// Now that the options have been set, change the
223
				// 'skinsConfigured'
224
				// option to 'true' so that normal metacat requests will go
225
				// through
226 4080 daigle
				PropertyService.setProperty("configutil.skinsConfigured",
227
						PropertyService.CONFIGURED);
228 4084 daigle
			} catch (GeneralPropertyException gpe) {
229
				String errorMessage = "problem setting property while processing skins "
230
						+ "properties page: " + gpe.getMessage();
231 4080 daigle
				logMetacat.error(errorMessage);
232
				processingErrors.add(errorMessage);
233 4106 daigle
			} catch (IOException ioe) {
234
				String errorMessage = "IO problem while processing skins "
235
						+ "properties page: " + ioe.getMessage();
236
				logMetacat.error(errorMessage);
237
				processingErrors.add(errorMessage);
238 4080 daigle
			}
239
			try {
240
				if (validationErrors.size() > 0 || processingErrors.size() > 0) {
241
					RequestUtil.clearRequestMessages(request);
242
					RequestUtil.setRequestFormErrors(request, validationErrors);
243
					RequestUtil.setRequestErrors(request, processingErrors);
244
					RequestUtil.forwardRequest(request, response, "/admin");
245
				} else {
246
					// Now that the options have been set, change the
247
					// 'skinsConfigured' option to 'true'
248
					PropertyService.setProperty("configutil.skinsConfigured",
249
							PropertyService.CONFIGURED);
250
251
					// Reload the main metacat configuration page
252
					processingSuccess.add("Skins successfully configured");
253
					RequestUtil.clearRequestMessages(request);
254
					RequestUtil.setRequestSuccess(request, processingSuccess);
255
					RequestUtil.forwardRequest(request, response,
256
							"/admin?configureType=configure&processForm=false");
257
				}
258
			} catch (ServletException se) {
259
				throw new AdminException("problem forwarding request while "
260
						+ "processing skins properties page: " + se.getMessage());
261
			} catch (IOException ioe) {
262
				throw new AdminException("IO problem while processing skins "
263
						+ "properties page: " + ioe.getMessage());
264 4084 daigle
			} catch (GeneralPropertyException gpe) {
265
				String errorMessage = "problem setting property while processing skins "
266
						+ "properties page: " + gpe.getMessage();
267
				logMetacat.error(errorMessage);
268
				processingErrors.add(errorMessage);
269 4080 daigle
			}
270
		}
271
	}
272
273 4106 daigle
	protected Vector<String> validateOptions(HttpServletRequest request) {
274
		Vector<String> errorVector = new Vector<String>();
275
		Vector<String> skinNames = null;
276
		try {
277
			skinNames = SkinUtil.getSkinNames();
278
		} catch (PropertyNotFoundException pnfe) {
279
			errorVector.add("Could not find skin names: " + pnfe.getMessage());
280
		}
281
282
		for (String skinName : skinNames) {
283
			errorVector.addAll(validateOptions(request, skinName));
284
		}
285
286
		return errorVector;
287
	}
288
289 4080 daigle
	/**
290
	 * Validate the most important configuration options submitted by the user.
291
	 *
292
	 * @return a vector holding error message for any fields that fail
293
	 *         validation.
294
	 */
295 4106 daigle
	protected Vector<String> validateOptions(HttpServletRequest request, String skinName) {
296 4080 daigle
		Vector<String> errorVector = new Vector<String>();
297
298
		//TODO MCD validate options.
299
300
		return errorVector;
301
	}
302
}