struts2标签 - JAVA - 编程开发网

gin/login.action" method="post">

Name:	value="" id="login_name" />
Password:	name="password" id="login_password" />
value="Submit" />
value="Reset" />

在由标签生成HTML代码的时候，例如：

生成的代码为：

Name:

我们可以看到，标签提供的有效信息只有Name和name，而其余的部分，例如，，等代码都根据一个固定的模板文件生成，这个模板文件为：

标签使我们开发JSP画面的时候使用的最小组件单元，我们根据客户的需要组合各种Tag达到客户的需求。模板是生成这些Tag时候使用的，使用模板可以定义Tag的基本形式，在使用tag的时候，我们只需要指定该Tag的不同属性，即可根据Tag指定的特殊属性，结合模板的基本属性生成可视化的HTML元素。主题是不同tag结合在一起而形成的。

name="${parameters.name default("") html}"<#rt/>
<#if parameters.get("size") exists>
size="${parameters.get("size") html}"<#rt/>

<#if parameters.maxlength exists>
maxlength="${parameters.maxlength html}"<#rt/>

<#if parameters.nameva lue exists>
value="<@s.property value="parameters.nameva lue"/>"<#rt/>

<#if parameters.disabled default(false)>
disabled="disabled"<#rt/>

<#if parameters.readonly default(false)>
readonly="readonly"<#rt/>

<#if parameters.tabindex exists>
tabindex="${parameters.tabindex html}"<#rt/>

<#if parameters.id exists>
id="${parameters.id html}"<#rt/>

<#if parameters.cssClass exists>
class="${parameters.cssClass html}"<#rt/>

<#if parameters.cssStyle exists>
style="${parameters.cssStyle html}"<#rt/>

<#if parameters.title exists>
title="${parameters.title html}"<#rt/>

<#include "/${parameters.templateDir}/simple/scripting-events.ftl" />
<#include "/${parameters.templateDir}/simple/common-attributes.ftl" />
/>

我们考虑标签（Tag）使用模板（Template）生成HTML的过程，根据不同的模板，坑顶可以生成不同的HTML画面，这样我们可以把不同tag的，视觉效果一致的模板放在一起：
例如：
TemplateForm_A, TemplateForm_B
TemplateTextField_A, TemplateTextField_B
TemplatePassword_A, TemplatePassword_B
， TemplateSubmit_A, TemplateSubmit_B
TemplateReset_A, TemplateReset_B

这样将_A的模板放在一起叫做A主题（Theme），将_B的模板放在一起叫B主题。这样我们在分别使用A主题，B主题的时候可以得到同一个Tag的不同的视觉效果。

模版和主题的概念处在Struts Tag的核心位置。

Struts2默认提供了四种主题：
Simple 主题：最简单的主题
XHTML 主题：默认主题，使用常用的HTML技巧
CSS XHTML主题：使用CSS实现的XHTML主题
AJAX 主题：基于XHTML主题，但是同工了AJAX功能

相关配置：
在struts.properties文件中有如下项目：
struts.ui.theme=xhtml
struts.ui.templateDir=template
struts.ui.templateSuffix=ftl

struts.ui.theme的值表示的是使用哪个主题，可选项位：xhtml,simple,css_html,ajax其中xhtml为默认值。
struts.ui.templateDir的值表示模板的存放目录。
struts.ui.templateSuffix的值表示模板文件明的后缀，因为Struts2默认使用FreeMarker来编写模板，所以这里我们基本使用ftl。另外也可以使用vm（Velocity）和 jsp（ Java Server Page），但是所有的Template和Theme要我们自己开发。

关于模板文件的存放目录我们需要详细说明，如上述说明，模板文件的存放位置位template，那么系统在那里寻找template目录呢，
首先，在web应用程序中查找，如果应用程序中存在一个叫做template的目录（跟WEB-INF目录平级），那么所有的文件从这个目录中取得，具体的路径还要加上主题的名字。
然后，如果在web应用程序中没有找到template目录，那么struts2会在classpath中寻找，由于struts2-core-2.0.9.jar文件中存在template目录，其中内置了四种主题，所以会使用这里变的模板。
例如：
如果我们使用了ajax主题，那么会在如下位置超找的主题
应用程序 /template/ajax/textfield.ftl
classpath /template/ajax/textfield.ftl

修改或者扩展模板：
有些时候Struts提供的模板不一定能够满足我们的需求，这时候我们需要修改或者扩展现有模板。重新做新的模板是不明智的，如果是在需要全新的模板，可以考虑基于simple扩展。

修改：
根据模板的装载机制，可以考虑将模板从struts2-core-2.0.9.jar文件中解压缩到web项目目录，之后修改对应的文件。

包装：
XHTML提供了一个很好的例子，simple主题提供了基本的功能，XHTML将它包括起来，例如：
以下是template/x html/xxx.ftl（xxx表示模板名字）文件内容：
<#include "/${parameters.templateDir}/xhtml/controlheader.ftl" />
<#include "/${parameters.templateDir}/simple/xxx.ftl" />
<#include "/${parameters.templateDir}/xhtml/controlfooter.ftl" />

扩展（extend）：
使用棉线对象的特性可以扩展一个主题，扩展一个主题的时候不需要实现所有的模板，只需要实现需要变化的标签。
扩展需要在目录中新建一个叫做theme.properties的文件，这个文件只有一行，表明了继承而来的主题的名字，例如：
/template/ajax/theme.properties文件内容为：
parent = xhtml

4.4节 AJAX标签（试验阶段）
Struts2内置了Dojo 0.4 来提供对Ajax的支持。
想要使用AJAX标签需要做到两点：
1 使用Ajax主题
2 在JSP画面中使用了head标签配置Ajax属性

AJAX标签主要有：

AJAX标签的一些通用属性：
属性说明类型
href 请求使用的URL String
listenTopic 使用逗号分割的一组主题列表，这个列表中的主题会导致这个Tag自己内容（Div，Autocompleter）重新装载或者执行一个Action（Anchor，Submit） String
notifyTopic 使用逗号分割的一组主题列表，向这个列表中的主题发布一些信息，例如：’data’,’type’,’request’，参看每个标签的详细说明 String
showErrorTransportText 设置是否显示错误消息（默认显示） Boolean
indicator 请求过程中显示的对象，通常位ProgressBar等 String

Indicator
src="${pageContext.request.contextPath}/i

struts2标签(三)