如何自定义Struts2表单验证后的错误信息显示格式/样式

前面一段时间学过一些Struts2的知识，感觉Struts2和1.x还是有很大的差别的，我还不好说1.x肯定会过时还是2.0会很快流行，这毕竟是需要作为导向的。

在Struts2中验证真的比较容易，可以在Action中直接写validate，也可以使用validate框架进行验证，这个我觉得比Struts1.x方便了很多，但是有个问题一直困扰了我，直到现在有个小程序要用到这个方面的知识，那就是验证后如何很好地人性化地在jsp页面中显示了。

大家都知道，Struts2显示验证结果有一些方式，一般通过两种方式，介绍如下：

1. 在页面的上面或者某个位置全部显示错误

代码：<s:fielderror cssStyle="color: red"></s:fielderror>

这样会显示所有的错误信息，模拟效果如下：

2.在每个字段下面或上面显示，通过

<s:fielderror cssStyle="color: red">

<s:param>XXX（标签的name属性，象user.username）</s:param>

</s:fielderror>

例：用  戶 名：

<s:fielderror cssStyle="color: red">

<s:param>user.username</s:param>

</s:fielderror>显示效果如下：

上面的差不多是Struts默认显示的两种方式，但是我们常见的显示方式并不是这样的，所有我们需要自定义这种格式，我们的习惯是把错误信息显示在某个出错字段的后面，一行显示，而它给了一个小黑点并且换了行，我们现在就来解决这个问题。

这个问题困扰了我很久，真的很久以前想过，但是没有彻底地解决，一直留到现在，今天在google上搜了很久，终于给解决了，现在分享一下解决的途径。

先提供网上的思路给大家（关键解决的思路）

1. struts2表单验证_错误信息的显示问题 中提到

引用 10 楼 starwar2030 的回复:

可以在CSS中定义
.formFieldError {
font-family: verdana, arial, helvetica, sans-serif;
font-size: 12px;
color: #FF3300;
vertical-align: bottom;
}

.formFieldError ul{
 margin: 0px;
 padding: 3px;
 vertical-align: middle;
}
而后使用类似用
<td class="formFieldError"> <s:fielderror> <s:param value="%{'userRecord.…

不需要那么复杂的，你将struts-core*中的template解出来，然后你把它放到项目的WEB-INF下,在struts.properties中添加代码
struts.ui.theme=simple
struts.ui.templateDir=WEB-INF/template
然后修改下simple下的fielderror.ftl文件，将该文件中的 <li>和 </li>删除；

或者完全拷贝simple的内容定义一个自己的UI;
比如将simple拷贝一份命名为default,同样修改fielderror.ftl,在新建一个文件为theme.properties,添加内容parent = simple

再修改struts.properties的struts.ui.theme=default;这样每个文件的theme就不要指定了

发表于：2008-08-04 09:47:3114楼得分:0

建议需要定义样式的同志看下自定义theme 这章的内容

还有 theme="simple" 是放在form标签内的

2. struts2 的 fielderror 样式问题中提到

可以改一下STRUTS2的错误信息模板.

fielderror.ftl 这个里面可以改它的样式

3. Struts2 模板中提到

先前有网友问过我，他用了 Struts2 的校验，但是错误输出是在输入框的上方，但希望错误信息是显示在输入框的右方，该如何做。当时我只告诉了他要修改模板文件，也只是大概告诉了他是在某个 template 目录下的一个 ftl 文件，因那时具体操作自己也不太清楚。现在知道了线索，但实际修改还是很麻烦的。
输入框　<s:textfield .../> 默认是用的 xhtml/text.flt 模板，text.ftl 包装了 smple/text.ftl，错误信息可以追溯发现是在 controlheader-core.ftl 中定义显示的，所以你可以把 xthml/text.ftl 和 controlheader-core.ftl 拷到 WEB-INF/classes/template/xhtml 目录中进行修改，WEB-INF/classes/template/xhtml 中的模板文件是优先于 struts2-core-2.x.x.jar 里的 template/xhtml 目录中的模板文件加载

这是我整理出来的一些思路，但是看到这些的时候，特别是第三条Struts2模板的时候，感觉自己有点思路了，后面就是一步一步地进行，发现还真的解决了。这个时候也希望能够看看上面的文章。现提供我解决自定义错误显示方式的步骤。

1. 找到你的struts2-core-2.XXX.jar这个核心包，用软件解压；

2. 在\struts2-core-2. XXX\template\simple目录下找到fielderror.ftl（跟我们自定义格式非常有关系的文件）；

3. 根据Struts2模板中提到的，把上面的fielderror.ftl放到WEB-INF/classes/template/simple目录下，这个我当时以为就在WEB-INF下新建一个classes的文件夹，后来提示已经存在，想想整个工程的结构发现，classes是放Java编译后的文件的，所有，这个时候的操作是在Src目录下新建一个template的文件夹，再在里面新建一个simple的文件夹（template/simple）（一定要注意建文件夹的步骤，是分两个文件夹建而不是建一个文件夹template.simple），把fielderror.ftl放到里面，目录结构如下：

4. 修改fielderror.ftl配置文件，这一步才是关键，如何修改了，实际上也很简单，就是把<ul></ul><li></li>标签删除（仅仅是删除标签而不删除标签里面的内容），简便的方法就是用记事本打开这个文件并用空格替换上面的每个标签（一个一个来哦）。后面我会提供我已经修改后的这个文件，如果大家不想修改的话就直接把我修改后的文件放到上面的目录即可。

5. 上面一步就是把错误信息显示前面的小黑点和换行都去掉了，是个关键步骤了，后面就来显示了，还是用上面的方式

<s:fielderror cssStyle="color: red">

<s:param>XXX（标签的name属性，象user.username）</s:param>

</s:fielderror>

要不要加theme="simple"大家看着办，反正我是没加，也是可以的,还有，这个时候，你就可以通过css来定义一下错误信息显示的字体啊，颜色啊等，这里不再叙述。

6. 整个步骤的原理就是Struts会加载一些配置文件，如果我们的classess里面没有的话会找到jar包里面的，如果有的话优先使用配置文件。我们这里的就是用我们修改的fielderror.ftl配置文件来覆盖jar包里面的文件。

7. 来看看我们修改后的自定义显示错误信息吧，截图如下：

是不是很舒服哦。有什么问题和好的方法的话，非常欢迎联系木子（QQ：5068今天在这里，也仅是整理和学习，其中也算有一种新的方法来分享给大家。(Struts2 显示错误的时候出现黑点和换行问题)

环境

Struts 2.1.8.1 + Myeclipse 8.6 + Tomcat 7.0.2

前提

请大家搭建好Struts2的Web项目，这个应该很简单，就不在叙述，本篇文章主要做的是如何显示Struts的错误信息，那么这里就建立一个Action类，来模拟产生的错误。请看下面的Action类。（源码会在后面提供）

public class DisplayErrorInfoAction extends ActionSupport

{

private static final long serialVersionUID = -2690064846056775963L;

@Override

public String execute() throws Exception

{

/**

* 添加一些FieldError供测试，如果需要请自写validater方法

this.addFieldError("displayErrorInfo", "error!Please check it.");

this.addFieldError("user.username", "名字有错误啦");

return INPUT;

}

方案

第一种方案：使用OGNL拿值栈（ValueStack）的内容（重点推荐使用）

主要是通过OGNL来取得Value Stack 中 errors 和fieldErrors的值。这里先来介绍下s:debug 的标签。

debug标签主要用于辅助测试，它在页面上生成一个超链接，通过该链接可以查看ValueStack和Stack Context 中的所有值信息。可以通过OGNL 中 s:property来取得相应的值（顺利提醒： s:debug 使用请放在 s:form外面，放在里面有什么效果，请大家试试就知道了）。附上本案例使用的代码。

注：请大家关注下error code 包含‘.’（类似于user.username）的取值方法：

<s:property value="errors['user.username'][0]" /> 和 <s:property value="fieldErrors['user.username'][0]" />

(网上“struts2 property标签的 value属性” 的解决方案)

<body>

<s:form action="displayErrorInfo" method="post" theme="simple">

DisplayErrorInfoForStruts2Demo1(使用OGNL拿值栈的内容，推荐使用)

</h1>

顺利整理

</h2><hr><hr>

1.1.All ErrorInfos(Map): <s:property value="errors" />

1.2.All fieldErrorsInfos(Map): <s:property value="fieldErrors" />

<hr>

2.1.DisplayErrorInfo in errors(errors.displayErrorInfo[0]):<s:textfield />

<s:property value="errors.displayErrorInfo[0]" />

2.2.DisplayErrorInfo in errors(errors['displayErrorInfo'][0]):<s:textfield />

<s:property value="errors['displayErrorInfo'][0]" />

注：拿到值后，就可以按照自己的格式进行自定义显示了

2.3.DisplayErrorInfo in errors(一般不会使用到[1],这里仅是测试):<s:textfield />

<s:property value="errors.displayErrorInfo[1]" />

<hr>

3.1.DisplayErrorInfo in fieldErrors(fieldErrors.displayErrorInfo[0]):<s:textfield />

<s:property value="fieldErrors.displayErrorInfo[0]" />

3.2.DisplayErrorInfo in fieldErrors(fieldErrors['displayErrorInfo'][0]):<s:textfield />

<s:property value="fieldErrors['displayErrorInfo'][0]" />

注：建议使用fieldErrors取值，在Action中使用的是this.addFieldError

<hr>

4.0.DisplayErrorInfo - user.username(正确的表达式.errors['user.username'][0]):<s:textfield />

<s:property value="errors['user.username'][0]" />

4.1.DisplayErrorInfo - user.username(正确的表达式.fieldErrors['user.username'][0]):<s:textfield />

<s:property value="fieldErrors['user.username'][0]" />

4.2.DisplayErrorInfo - user.username(错误的表达式1.errors.%{user.username}[0]):<s:textfield />

<s:property value="errors.%{user.username}[0]" />

4.3.DisplayErrorInfo - user.username(错误的表达式2.errors.# {user.username}[0]):<s:textfield />

这种方法本身语言就有问题，详情请看JSP规范对# 的规范

4.4.DisplayErrorInfo - user.username(错误的表达式3.%{errors.user.username}[0]):<s:textfield />

<s:property value="%{errors.user.username}[0]" />

4.5.DisplayErrorInfo - user.username(错误的表达式4.errors.user.username):<s:textfield />

<s:property value="errors.user.username" />

</s:form>

<hr>

<s:debug />

</body>

效果如下：

第二种方案修改Template（推荐使用）

修改Struts的Template 首先要知道Struts2 的UI Theme的概念，在Struts2中有四种Theme(也就是有四种Template)，分别是archive、css_xhtml、simple、xhtml，可以通过解压Struts-core 的Jar包来查看这四种Theme的Template。

而Struts2使用的默认Template是xhtml,但是这根本不能满足需要，一般我们都会改用simple的Template，会使用类似下面的语句，切换到simple的template。

<s:form action="XXX" method="post" theme="simple"> 或者在 Struts.xml 加上<constant name="struts.ui.theme" value="simple"></constant>（使用了constant这个就不需要在使用前面）

是如何知道xhtml是struts2默认template的，这可以看看Struts-core.jar 下面的org.apache.struts2 package下的default.properties文件里关于struts.ui.theme的配置。

现在Theme已经使用了simple了，那么就知道Struts2为什么会在显示错误信息的时候，加上黑点和换行了，在simple theme的fielderror.ftl(struts2-core-2.1.8.1\template\simple下) 文件里定义了，fielderror的显示template，其中加了<ul></ul><li></li>标签，那么我们删除它们并把修改后的ftl放到工程目录src\template\simple 下就可以了。

具体的如何修改template请看如何自定义Struts2表单验证后的错误信息显示格式/样式。

在这里提醒一下大家，

一、使用这种方案的使用，请一定要切换到simple主题下。

二、在struts2-core-2.1以前只是使用了<ul></ul><li></li>,但是在struts2-core-2.1以后比如struts2-core-2.1.8.1相应的文件中是<ul<#rt/> ..>（不是<ul>,还有注意最后的一个匹配的">"）</ul><li></li>，而且现在如果仅是删除这些标签，还是有问题的，出现的页面是：

所以，彻底地修改是（红色方框内内容全部删除）

效果如下：

第三种方案使用CSS修改显示效果（喜欢CSS的还是可以使用的，不过我不推荐）

这种方案的原理就是使用CSS来修改ul和li标签的显示效果，可以尝试一下，我不太推荐。CSS如下：

.formFieldError {

color: #FF3300;

}

.formFieldError ul {

list-style-type: none;

display: inline;

margin: 0px;

padding: 3px;

}

.formFieldError ul li {

list-style-type: none;

display: inline;

}

</STYLE>

效果如下：

源码下载

顺利提供下载：
文件名：DisplayErrorInfoForStruts Src And Jars.zip
下载地址：http://usc.googlecode.com/files/DisplayErrorInfoForStruts%20Src%20And%20Jars.zip

总结和交流

这篇文章也算是对前面Struts2错误信息显示效果的继续学习总结，也谢谢大家的支持。

如果有什么建议或意见可以通过Q：506817493 或 E：[email protected] 或 MSN：[email protected]，大家一起交流学习。顺利也提供源码下载供大家一起学习探讨(见上)。

如何自定义Struts2表单验证后的错误信息显示格式/样式

环境

前提

方案

第一种方案：使用OGNL拿值栈（ValueStack）的内容（重点推荐使用）

第二种方案 修改Template（推荐使用）

第三种方案 使用CSS修改显示效果（喜欢CSS的还是可以使用的，不过我不推荐）

源码下载

总结和交流

你可能感兴趣的:(如何自定义Struts2表单验证后的错误信息显示格式/样式)

第二种方案修改Template（推荐使用）

第三种方案使用CSS修改显示效果（喜欢CSS的还是可以使用的，不过我不推荐）