001: /*
002: * $Header: /export/home/cvsroot/MyPersonalizerRepository/MyPersonalizer/Subsystems/Admin/Sources/es/udc/mypersonalizer/admin/http/view/actionforms/util/PropertyValidator.java,v 1.1.1.1 2004/03/25 12:08:39 fbellas Exp $
003: * $Revision: 1.1.1.1 $
004: * $Date: 2004/03/25 12:08:39 $
005: *
006: * =============================================================================
007: *
008: * Copyright (c) 2003, The MyPersonalizer Development Group
009: * (http://www.tic.udc.es/~fbellas/mypersonalizer/index.html) at
010: * University Of A Coruna
011: * All rights reserved.
012: *
013: * Redistribution and use in source and binary forms, with or without
014: * modification, are permitted provided that the following conditions are met:
015: *
016: * - Redistributions of source code must retain the above copyright notice,
017: * this list of conditions and the following disclaimer.
018: *
019: * - Redistributions in binary form must reproduce the above copyright notice,
020: * this list of conditions and the following disclaimer in the documentation
021: * and/or other materials provided with the distribution.
022: *
023: * - Neither the name of the University Of A Coruna nor the names of its
024: * contributors may be used to endorse or promote products derived from
025: * this software without specific prior written permission.
026: *
027: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
028: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
029: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
030: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
031: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
032: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
033: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
034: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
035: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
036: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
037: * POSSIBILITY OF SUCH DAMAGE.
038: *
039: */
040:
041: package es.udc.mypersonalizer.admin.http.view.actionforms.util;
042:
043: import org.apache.struts.action.ActionError;
044: import org.apache.struts.action.ActionErrors;
045:
046: /**
047: * It contains common validation/conversion operations for action form classes.
048: * Each operation takes the following parameters:
049: *
050: * <ul>
051: *
052: * <li>An <code>ActionErrors</code>.</li>
053: * <li>A property name: the name of a form field.</li>
054: * <li>The property value: the value of the form field.</li>
055: * <li>A <code>boolean</code> value specifying whether or not the property is
056: * mandatory.</li>
057: * <li>A specification of the range of valid values (maybe specified with
058: * several parameters).</li>
059: * <li>A <code>Locale</code> object if validation/conversion is
060: * locale-dependent.</li>
061: *
062: * </ul>
063: *
064: * If the property value is not correct, an <code>ActionError</code> is added
065: * to <code>ActionErrors</code> using the property name. The key of the
066: * <code>ActionError</code> maybe one of the following values:
067: *
068: * <ul>
069: *
070: * <li><code>ErrorMessages.mandatoryField</code>: mandatory field.</li>
071: * <li><code>ErrorMessages.incorrectValue</code>: incorrect value.</li>
072: *
073: * </ul>
074: *
075: * <p>
076: * Some operations return the value resulting from the conversion. If the
077: * conversion is not successful, the returned value is meaningless.
078: * <p>
079: */
080: public final class PropertyValidator {
081:
082: private final static String MANDATORY_FIELD = "ErrorMessages.mandatoryField";
083:
084: private PropertyValidator() {
085: }
086:
087: /**
088: * Checks if a mandatory field is present.
089: *
090: * @return <code>false</code> if <code>propertyValue</code> is
091: * <code>null</code> or the empty string; <code>true</code>
092: * otherwise
093: */
094: public final static boolean validateMandatory(ActionErrors errors,
095: String propertyName, String propertyValue) {
096:
097: if ((propertyValue == null) || (propertyValue.length() == 0)) {
098: errors.add(propertyName, new ActionError(MANDATORY_FIELD));
099: return false;
100: } else {
101: return true;
102: }
103:
104: }
105:
106: private final static boolean validateMandatory(ActionErrors errors,
107: String propertyName, String propertyValue, boolean mandatory) {
108:
109: if (mandatory) {
110: return validateMandatory(errors, propertyName,
111: propertyValue);
112: } else {
113: return true;
114: }
115:
116: }
117:
118: }
|