/*
* $Id: JavascriptValidatorTag.java 664382 2008-06-07 20:45:12Z pbenedict $
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.struts.faces.taglib;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import javax.faces.webapp.UIComponentTag;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.BodyTagSupport;
import javax.servlet.jsp.tagext.Tag;
import javax.servlet.ServletContext;
import org.apache.commons.validator.Field;
import org.apache.commons.validator.Form;
import org.apache.commons.validator.ValidatorAction;
import org.apache.commons.validator.ValidatorResources;
import org.apache.commons.validator.Var;
import org.apache.commons.validator.util.ValidatorUtils;
import org.apache.struts.Globals;
import org.apache.struts.config.ModuleConfig;
import org.apache.struts.faces.component.FormComponent;
import org.apache.struts.taglib.TagUtils;
import org.apache.struts.util.MessageResources;
import org.apache.struts.util.ModuleUtils;
import org.apache.struts.validator.Resources;
import org.apache.struts.validator.ValidatorPlugIn;
/**
* Custom tag that generates JavaScript for client side validation based
* on the validation rules loaded by the <code>ValidatorPlugIn</code>
* defined in the struts-config.xml file. This is based on the code in
* the corresponding class of the Struts HTML tag library, modified as needed
* to reflect differences in the way JavaServer Faces renders field
* identifiers.
*
* @version $Rev: 664382 $ $Date: 2008-06-07 22:45:12 +0200 (Sam, 07 jui 2008) $
*/
public class JavascriptValidatorTag extends BodyTagSupport {
// ----------------------------------------------------------- Properties
/**
* The servlet context attribute key for our resources.
*/
protected String bundle = Globals.MESSAGES_KEY;
/**
* The default locale on our server.
* @deprecated This variable is no longer used.
*/
protected static Locale defaultLocale = Locale.getDefault();
/**
* The name of the form that corresponds with the action name
* in struts-config.xml. Specifying a form name places a
* <script> </script> around the javascript.
*/
protected String formName = null;
/**
* The line ending string.
*/
protected static String lineEnd = System.getProperty("line.separator");
/**
* The current page number of a multi-part form.
* Only valid when the formName attribute is set.
*/
protected int page = 0;
/**
* This will be used as is for the JavaScript validation method name if it
* has a value. This is the method name of the main JavaScript method that
* the form calls to perform validations.
*/
protected String methodName = null;
/**
* The static JavaScript methods will only be printed if this is set to
* "true".
*/
protected String staticJavascript = "true";
/**
* The dynamic JavaScript objects will only be generated if this is set to
* "true".
*/
protected String dynamicJavascript = "true";
/**
* The src attribute for html script element (used to include an external
* script resource). The src attribute is only recognized
* when the formName attribute is specified.
*/
protected String src = null;
/**
* The JavaScript methods will enclosed with html comments if this is set to
* "true".
*/
protected String htmlComment = "true";
/**
* Hide JavaScript methods in a CDATA section for XHTML when "true".
*/
protected String cdata = "true";
private String htmlBeginComment = "\n<!-- Begin \n";
private String htmlEndComment = "//End --> \n";
/**
* Gets the key (form name) that will be used
* to retrieve a set of validation rules to be
* performed on the bean passed in for validation.
*/
public String getFormName() {
return formName;
}
/**
* Sets the key (form name) that will be used
* to retrieve a set of validation rules to be
* performed on the bean passed in for validation.
* Specifying a form name places a
* <script> </script> tag around the javascript.
*/
public void setFormName(String formName) {
this.formName = formName;
}
/**
* Gets the current page number of a multi-part form.
* Only field validations with a matching page numer
* will be generated that match the current page number.
* Only valid when the formName attribute is set.
*/
public int getPage() {
return page;
}
/**
* Sets the current page number of a multi-part form.
* Only field validations with a matching page numer
* will be generated that match the current page number.
* Only valid when the formName attribute is set.
*/
public void setPage(int page) {
this.page = page;
}
/**
* Gets the method name that will be used for the Javascript
* validation method name if it has a value. This overrides
* the auto-generated method name based on the key (form name)
* passed in.
*/
public String getMethod() {
return methodName;
}
/**
* Sets the method name that will be used for the Javascript
* validation method name if it has a value. This overrides
* the auto-generated method name based on the key (form name)
* passed in.
*/
public void setMethod(String methodName) {
this.methodName = methodName;
}
/**
* Gets whether or not to generate the static
* JavaScript. If this is set to 'true', which
* is the default, the static JavaScript will be generated.
*/
public String getStaticJavascript() {
return staticJavascript;
}
/**
* Sets whether or not to generate the static
* JavaScript. If this is set to 'true', which
* is the default, the static JavaScript will be generated.
*/
public void setStaticJavascript(String staticJavascript) {
this.staticJavascript = staticJavascript;
}
/**
* Gets whether or not to generate the dynamic
* JavaScript. If this is set to 'true', which
* is the default, the dynamic JavaScript will be generated.
*/
public String getDynamicJavascript() {
return dynamicJavascript;
}
/**
* Sets whether or not to generate the dynamic
* JavaScript. If this is set to 'true', which
* is the default, the dynamic JavaScript will be generated.
*/
public void setDynamicJavascript(String dynamicJavascript) {
this.dynamicJavascript = dynamicJavascript;
}
/**
* Gets whether or not to delimit the
* JavaScript with html comments. If this is set to 'true', which
* is the default, the htmlComment will be surround the JavaScript.
*/
public String getHtmlComment() {
return htmlComment;
}
/**
* Sets whether or not to delimit the
* JavaScript with html comments. If this is set to 'true', which
* is the default, the htmlComment will be surround the JavaScript.
*/
public void setHtmlComment(String htmlComment) {
this.htmlComment = htmlComment;
}
/**
* Gets the src attribute's value when defining
* the html script element.
*/
public String getSrc() {
return src;
}
/**
* Sets the src attribute's value when defining
* the html script element. The src attribute is only recognized
* when the formName attribute is specified.
*/
public void setSrc(String src) {
this.src = src;
}
/**
* Render the JavaScript for to perform validations based on the form name.
*
* @exception JspException if a JSP exception has occurred
*/
public int doStartTag() throws JspException {
StringBuffer results = new StringBuffer();
HttpServletRequest request =
(HttpServletRequest)pageContext.getRequest();
ServletContext servletContext = pageContext.getServletContext();
ModuleConfig config =
ModuleUtils.getInstance().getModuleConfig(request, servletContext);
ValidatorResources resources =
(ValidatorResources) pageContext.getAttribute(
ValidatorPlugIn.VALIDATOR_KEY + config.getPrefix(),
PageContext.APPLICATION_SCOPE);
Locale locale = TagUtils.getInstance().getUserLocale(pageContext, null);
Form form = resources.getForm(locale, formName);
if (form != null) {
if ("true".equalsIgnoreCase(dynamicJavascript)) {
MessageResources messages =
(MessageResources) pageContext.getAttribute(
bundle + config.getPrefix(),
PageContext.APPLICATION_SCOPE);
List lActions = new ArrayList();
List lActionMethods = new ArrayList();
// Get List of actions for this Form
for (Iterator i = form.getFields().iterator(); i.hasNext();) {
Field field = (Field) i.next();
for (Iterator x = field.getDependencyList().iterator();
x.hasNext();) {
Object o = x.next();
if (o != null && !lActionMethods.contains(o)) {
lActionMethods.add(o);
}
}
}
// Create list of ValidatorActions based on lActionMethods
for (Iterator i = lActionMethods.iterator(); i.hasNext();) {
String depends = (String) i.next();
ValidatorAction va = resources.getValidatorAction(depends);
// throw nicer NPE for easier debugging
if (va == null) {
throw new NullPointerException(
"Depends string \""
+ depends
+ "\" was not found in validator-rules.xml.");
}
String javascript = va.getJavascript();
if (javascript != null && javascript.length() > 0) {
lActions.add(va);
} else {
i.remove();
}
}
Collections.sort(lActions, new Comparator() {
public int compare(Object o1, Object o2) {
ValidatorAction va1 = (ValidatorAction) o1;
ValidatorAction va2 = (ValidatorAction) o2;
if ((va1.getDepends() == null
|| va1.getDepends().length() == 0)
&& (va2.getDepends() == null
|| va2.getDepends().length() == 0)) {
return 0;
} else if (
(va1.getDepends() != null
&& va1.getDepends().length() > 0)
&& (va2.getDepends() == null
|| va2.getDepends().length() == 0)) {
return 1;
} else if (
(va1.getDepends() == null
|| va1.getDepends().length() == 0)
&& (va2.getDepends() != null
&& va2.getDepends().length() > 0)) {
return -1;
} else {
return va1.getDependencyList().size() -
va2.getDependencyList().size();
}
}
});
String methods = null;
for (Iterator i = lActions.iterator(); i.hasNext();) {
ValidatorAction va = (ValidatorAction) i.next();
if (methods == null) {
methods = va.getMethod() + "(form)";
} else {
methods += " && " + va.getMethod() + "(form)";
}
}
results.append(getJavascriptBegin(methods));
for (Iterator i = lActions.iterator(); i.hasNext();) {
ValidatorAction va = (ValidatorAction) i.next();
String jscriptVar = null;
String functionName = null;
if (va.getJsFunctionName() != null
&& va.getJsFunctionName().length() > 0) {
functionName = va.getJsFunctionName();
} else {
functionName = va.getName();
}
if (isStruts11()) {
results.append(" function " +
functionName + " () { \n");
} else {
results.append(" function " +
formName + "_" + functionName +
" () { \n");
}
for (Iterator x = form.getFields().iterator();
x.hasNext();) {
Field field = (Field) x.next();
// Skip indexed fields for now until there is a good
// way to handle error messages (and the length of the
// list (could retrieve from scope?))
if (field.isIndexed()
|| field.getPage() != page
|| !field.isDependency(va.getName())) {
continue;
}
String message =
Resources.getMessage(messages, locale, va, field);
message = (message != null) ? message : "";
jscriptVar = this.getNextVar(jscriptVar);
results.append(
" this."
+ jscriptVar
+ " = new Array(\""
+ getFormClientId()
+ ":"
+ field.getKey()
+ "\", \""
+ message
+ "\", ");
results.append("new Function (\"varName\", \"");
Map vars = field.getVars();
// Loop through the field's variables.
Iterator varsIterator = vars.keySet().iterator();
while (varsIterator.hasNext()) {
String varName = (String) varsIterator.next();
Var var = (Var) vars.get(varName);
String varValue = var.getValue();
String jsType = var.getJsType();
// skip requiredif variables field, fieldIndexed,
// fieldTest, fieldValue
if (varName.startsWith("field")) {
continue;
}
if (Var.JSTYPE_INT.equalsIgnoreCase(jsType)) {
results.append(
"this."
+ varName
+ "="
+ ValidatorUtils.replace(
varValue,
"\\",
"\\\\")
+ "; ");
} else if (Var.JSTYPE_REGEXP.equalsIgnoreCase(
jsType)) {
results.append(
"this."
+ varName
+ "=/"
+ ValidatorUtils.replace(
varValue,
"\\",
"\\\\")
+ "/; ");
} else if (Var.JSTYPE_STRING.equalsIgnoreCase(
jsType)) {
results.append(
"this."
+ varName
+ "='"
+ ValidatorUtils.replace(
varValue,
"\\",
"\\\\")
+ "'; ");
// So everyone using the latest format doesn't
// need to change their xml files immediately.
} else if ("mask".equalsIgnoreCase(varName)) {
results.append(
"this."
+ varName
+ "=/"
+ ValidatorUtils.replace(
varValue,
"\\",
"\\\\")
+ "/; ");
} else {
results.append(
"this."
+ varName
+ "='"
+ ValidatorUtils.replace(
varValue,
"\\",
"\\\\")
+ "'; ");
}
}
results.append(" return this[varName];\"));\n");
}
results.append(" } \n\n");
}
} else if ("true".equalsIgnoreCase(staticJavascript)) {
results.append(this.getStartElement());
if ("true".equalsIgnoreCase(htmlComment)) {
results.append(htmlBeginComment);
}
}
}
if ("true".equalsIgnoreCase(staticJavascript)) {
results.append(getJavascriptStaticMethods(resources));
}
if (form != null
&& ("true".equalsIgnoreCase(dynamicJavascript)
|| "true".equalsIgnoreCase(staticJavascript))) {
results.append(getJavascriptEnd());
}
JspWriter writer = pageContext.getOut();
try {
writer.print(results.toString());
} catch (IOException e) {
throw new JspException(e.getMessage(), e);
}
return (EVAL_BODY_TAG);
}
/**
* Release any acquired resources.
*/
public void release() {
super.release();
bundle = Globals.MESSAGES_KEY;
formName = null;
page = 0;
methodName = null;
staticJavascript = "true";
dynamicJavascript = "true";
htmlComment = "true";
cdata = "true";
src = null;
formClientId = null;
}
/**
* Returns the opening script element and some initial javascript.
*/
protected String getJavascriptBegin(String methods) {
StringBuffer sb = new StringBuffer();
String name =
formName.substring(0, 1).toUpperCase()
+ formName.substring(1, formName.length());
sb.append(this.getStartElement());
if (this.isXhtml() && "true".equalsIgnoreCase(this.cdata)) {
sb.append("<![CDATA[\r\n");
}
if (!this.isXhtml() && "true".equals(htmlComment)) {
sb.append(htmlBeginComment);
}
sb.append("\n var bCancel = false; \n\n");
if (methodName == null || methodName.length() == 0) {
sb.append(
" function validate"
+ name
+ "(form) { "
+ " \n");
} else {
sb.append(
" function "
+ methodName
+ "(form) { "
+ " \n");
}
sb.append(" if (bCancel) \n");
sb.append(" return true; \n");
sb.append(" else \n");
// Always return true if there aren't any Javascript validation methods
if (methods == null || methods.length() == 0) {
sb.append(" return true; \n");
} else {
sb.append(" return " + methods + "; \n");
}
sb.append(" } \n\n");
return sb.toString();
}
protected String getJavascriptStaticMethods(ValidatorResources resources) {
StringBuffer sb = new StringBuffer();
sb.append("\n\n");
Iterator actions = resources.getValidatorActions().values().iterator();
while (actions.hasNext()) {
ValidatorAction va = (ValidatorAction) actions.next();
if (va != null) {
String javascript = va.getJavascript();
if (javascript != null && javascript.length() > 0) {
sb.append(javascript + "\n");
}
}
}
return sb.toString();
}
/**
* Returns the closing script element.
*/
protected String getJavascriptEnd() {
StringBuffer sb = new StringBuffer();
sb.append("\n");
if (!this.isXhtml() && "true".equals(htmlComment)){
sb.append(htmlEndComment);
}
if (this.isXhtml() && "true".equalsIgnoreCase(this.cdata)) {
sb.append("]]>\r\n");
}
sb.append("</script>\n\n");
return sb.toString();
}
/**
* The value <code>null</code> will be returned at the end of the sequence.
* ex: "zz" will return <code>null</code>
*/
private String getNextVar(String input) {
if (input == null) {
return "aa";
}
input = input.toLowerCase();
for (int i = input.length(); i > 0; i--) {
int pos = i - 1;
char c = input.charAt(pos);
c++;
if (c <= 'z') {
if (i == 0) {
return c + input.substring(pos, input.length());
} else if (i == input.length()) {
return input.substring(0, pos) + c;
} else {
return input.substring(0, pos) + c + input.substring(pos,
input.length() - 1);
}
} else {
input = replaceChar(input, pos, 'a');
}
}
return null;
}
/**
* Replaces a single character in a <code>String</code>
*/
private String replaceChar(String input, int pos, char c) {
if (pos == 0) {
return c + input.substring(pos, input.length());
} else if (pos == input.length()) {
return input.substring(0, pos) + c;
} else {
return input.substring(0, pos) + c + input.substring(pos,
input.length() - 1);
}
}
/**
* Constructs the beginning <script> element depending on
* xhtml status.
*/
private String getStartElement() {
StringBuffer start =
new StringBuffer("<script type=\"text/javascript\"");
// there is no language attribute in xhtml
if (!this.isXhtml()) {
start.append(" language=\"Javascript1.1\"");
}
if (this.src != null) {
start.append(" src=\"" + src + "\"");
}
start.append("> \n");
return start.toString();
}
/**
* Returns true if this is an xhtml page.
*/
private boolean isXhtml() {
return TagUtils.getInstance().isXhtml(this.pageContext);
}
/**
* Returns the cdata setting "true" or "false".
* @return String - "true" if JavaScript will be hidden in a CDATA section
*/
public String getCdata() {
return cdata;
}
/**
* Sets the cdata status.
* @param cdata The cdata to set
*/
public void setCdata(String cdata) {
this.cdata = cdata;
}
private String formClientId = null;
/**
* <p>Return the <code>clientId</code> of the form component for which
* we are rendering validation Javascript.</p>
*
* @exception IllegalStateException if we are not nested inside a
* UIComponentTag with a child FormComponent matching our form name
*/
private String getFormClientId(){
// Return any cached value
if (formClientId != null) {
return (formClientId);
}
// Locate our parent tag that is a component tag
Tag parent = getParent();
while (parent != null) {
if (parent instanceof UIComponentTag) {
break;
}
parent = parent.getParent();
}
if (parent == null) {
throw new IllegalArgumentException
("Not nested inside a UIComponentTag");
}
// Are we nested inside our corresponding form tag?
UIComponent parentComponent =
((UIComponentTag) parent).getComponentInstance();
if (parentComponent instanceof FormComponent) {
if (formName.equals(
parentComponent.getAttributes().get("beanName"))) {
formClientId = parentComponent.getClientId
(FacesContext.getCurrentInstance());
return (formClientId);
}
}
// Scan the children of this tag's component
Iterator kids = ((UIComponentTag) parent).
getComponentInstance().getChildren().iterator();
while (kids.hasNext()) {
UIComponent kid = (UIComponent) kids.next();
if (!(kid instanceof FormComponent)) {
continue;
}
if (formName.equals(kid.getAttributes().get("beanName"))) {
formClientId =
kid.getClientId(FacesContext.getCurrentInstance());
return (formClientId);
}
}
throw new IllegalArgumentException
("Cannot find child FormComponent for form '" + formName + "'");
}
// ---------------------------------------------------------- Static Methods
private static boolean struts11;
static {
try {
JavascriptValidatorTag.class.getClassLoader().loadClass
("org.apache.struts.taglib.TagUtils");
struts11 = false;
} catch (Exception e) {
struts11 = true;
}
}
/**
* <p>Return <code>true</code> if we are running on top of Struts 1.1</p>
*/
private static boolean isStruts11() {
return struts11;
}
}