You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by ha...@apache.org on 2003/09/27 18:17:16 UTC
cvs commit: jakarta-tapestry/framework/src/org/apache/tapestry/valid PatternValidator.java
harishkswamy 2003/09/27 09:17:16
Added: framework/src/org/apache/tapestry/valid
PatternValidator.java
Log:
Initial. The validator that provides pattern validation.
Revision Changes Path
1.1 jakarta-tapestry/framework/src/org/apache/tapestry/valid/PatternValidator.java
Index: PatternValidator.java
===================================================================
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2000-2003 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation", "Tapestry"
* must not be used to endorse or promote products derived from this
* software without prior written permission. For written
* permission, please contact apache@apache.org.
*
* 5. Products derived from this software may not be called "Apache"
* or "Tapestry", nor may "Apache" or "Tapestry" appear in their
* name, without prior written permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE TAPESTRY CONTRIBUTOR COMMUNITY
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*
*/
package org.apache.tapestry.valid;
import java.util.HashMap;
import java.util.Map;
import org.apache.tapestry.ApplicationRuntimeException;
import org.apache.tapestry.IMarkupWriter;
import org.apache.tapestry.IRequestCycle;
import org.apache.tapestry.Tapestry;
import org.apache.tapestry.form.IFormComponent;
import org.apache.tapestry.util.RegexpMatcher;
/**
* <p>The validator bean that provides a pattern validation service.
*
* <p>The actual pattern matching algorithm is provided by the
* {@link org.apache.tapestry.valid.PatternDelegate}. This enables the user to provide
* custom pattern matching implementations. In the event a custom implementation is not
* provided, this validator will use the {@link org.apache.tapestry.util.RegexpMatcher}.
*
* <p>This validator has the ability to provide client side validation on demand.
* To enable client side validation simply set the <code>clientScriptingEnabled</code>
* property to <code>true</code>.
* The default implementation of the script will be in JavaScript and allows the user to
* override this with a custom implementation by setting the path to the custom
* script via {@link #setScriptPath(String)}.
*
* @author Harish Krishnaswamy
* @version $Id: PatternValidator.java,v 1.1 2003/09/27 16:17:16 harishkswamy Exp $
* @since 3.0
*/
public class PatternValidator extends BaseValidator
{
/**
* The pattern that this validator will use to validate the input. The default
* pattern is an empty string.
*/
private String _patternString = "";
/**
* A custom message in the event of a validation failure.
*/
private String _patternNotMatchedMessage;
/**
* The object that handles pattern matching.
*/
private PatternDelegate _patternDelegate;
/**
* The location of the script specification for client side validation.
*/
private String _scriptPath = "/org/apache/tapestry/valid/PatternValidator.script";
/**
* Returns custom validation failure message. The default message comes from
* <code>ValidationStrings.properties</code> file for key
* <code>pattern-not-matched</code>.
*/
public String getPatternNotMatchedMessage()
{
return _patternNotMatchedMessage;
}
/**
* Returns the pattern that this validator uses for validation.
*/
public String getPatternString()
{
return _patternString;
}
/**
* Allows for a custom message to be set typically via the bean specification.
*/
public void setPatternNotMatchedMessage(String message)
{
_patternNotMatchedMessage = message;
}
/**
* Allows the user to change the validation pattern.
*/
public void setPatternString(String pattern)
{
_patternString = pattern;
}
/**
* Static inner class that acts as a delegate to RegexpMatcher and conforms to the
* PatternDelegate contract.
*/
private static class RegExpDelegate implements PatternDelegate
{
private RegexpMatcher _matcher;
private RegexpMatcher getPatternMatcher()
{
if (_matcher == null)
_matcher = new RegexpMatcher();
return _matcher;
}
public boolean contains(String patternString, String input)
{
return getPatternMatcher().contains(patternString, input);
}
public String getEscapedPatternString(String patternString)
{
return getPatternMatcher().getEscapedPatternString(patternString);
}
}
/**
* Allows for a custom implementation to do the pattern matching. The default pattern
* matching is done with {@link org.apache.tapestry.util.RegexpMatcher}.
*/
public void setPatternDelegate(PatternDelegate patternDelegate)
{
_patternDelegate = patternDelegate;
}
/**
* Returns the custom pattern matcher if one is provided or creates and returns the
* default matcher laziliy.
*/
public PatternDelegate getPatternDelegate()
{
if (_patternDelegate == null)
_patternDelegate = new RegExpDelegate();
return _patternDelegate;
}
/**
* @see org.apache.tapestry.valid.IValidator#toString(org.apache.tapestry.form.IFormComponent, java.lang.Object)
*/
public String toString(IFormComponent field, Object value)
{
if (value == null)
return null;
return value.toString();
}
private String buildPatternNotMatchedMessage(IFormComponent field, String patternString)
{
String templateMessage =
getPattern(
_patternNotMatchedMessage,
"pattern-not-matched",
field.getPage().getLocale());
return formatString(templateMessage, field.getDisplayName(), patternString);
}
/**
* @see org.apache.tapestry.valid.IValidator#toObject(org.apache.tapestry.form.IFormComponent, java.lang.String)
*/
public Object toObject(IFormComponent field, String input) throws ValidatorException
{
if (checkRequired(field, input))
return null;
boolean matched = false;
try
{
matched = getPatternDelegate().contains(_patternString, input);
}
catch (Throwable t)
{
throw new ApplicationRuntimeException(
Tapestry.format(
"PatternValidator.pattern-match-error",
_patternString,
field.getDisplayName()),
field,
field.getLocation(),
t);
}
if (!matched)
throw new ValidatorException(
buildPatternNotMatchedMessage(field, _patternString),
ValidationConstraint.PATTERN_MISMATCH);
return input;
}
/**
* Allows for a custom implementation of the client side validation.
*/
public void setScriptPath(String scriptPath)
{
_scriptPath = scriptPath;
}
/**
* @see org.apache.tapestry.valid.IValidator#renderValidatorContribution(org.apache.tapestry.form.IFormComponent, org.apache.tapestry.IMarkupWriter, org.apache.tapestry.IRequestCycle)
*/
public void renderValidatorContribution(
IFormComponent field,
IMarkupWriter writer,
IRequestCycle cycle)
{
if (!isClientScriptingEnabled())
return;
Map symbols = new HashMap();
if (isRequired())
symbols.put("requiredMessage", buildRequiredMessage(field));
symbols.put(
"patternNotMatchedMessage",
buildPatternNotMatchedMessage(field, getEscapedPatternString()));
processValidatorScript(_scriptPath, cycle, field, symbols);
}
/**
* Returns the escaped sequence of the pattern string for rendering in the error message.
*/
public String getEscapedPatternString()
{
return getPatternDelegate().getEscapedPatternString(_patternString);
}
public String toString()
{
return "Pattern: "
+ _patternString
+ "; Script Path: "
+ _scriptPath
+ "; Pattern Delegate: "
+ _patternDelegate.toString();
}
}
---------------------------------------------------------------------
To unsubscribe, e-mail: tapestry-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tapestry-dev-help@jakarta.apache.org