Archive

For the Struts2 category

访问OGNL上下文和Action上下文,#相当于ActionContext.getContext();

No Comments
名称 作用 例子
parameters 包含当前HTTP请求参数的Map #parameters.id[0]作用相当于request.getParameter(“id”)

(这个是因为在请求中可能包含多个同一名字的参数,所以这里是数组,所以切记要用数组下标[0]来取元素)
request 包含当前HttpServletRequest的属性(attribute)的Map #request.userName相当于request.getAttribute(“userName”)
session 包含当前HttpSession的属性(attribute)的Map #session.userName相当于session.getAttribute(“userName”)
application 包含当前应用的ServletContext的属性(attribute)的Map #application.userName相当于application.getAttribute(“userName”)
attr 用于按request > session > application顺序访问其属性(attribute) #attr.userName相当于按顺序在以上三个范围(scope)内读取userName属性,直到找到为止

struts2 dojo 续3

No Comments

3、<s:tree />

树是是比较常用的数据结构,因为它可以很好地体现真实世界中对象之间的关系。<s:tree />的使用也相对简单,但需要说明的是——Struts 2.0.6 GA版本的<s:tree />是有BUG的,大家可以点击这个链接https://issues.apache.org/struts/browse/WW-1813了解详细的情况。这个BUG主要是在<s:tree />的通过“treeCollapsedTopic”、“treeExpandedTopic”和“treeSelectedTopic”设定的话题(Topic)都没有起作用,上述链接相应给出了解决方法,但我认为该方法太麻烦(需要自己重新编译和打包Struts 2),所以下面的例子,我将另辟徯径,请参考以下代码。

<%@ page language=java contentType=text/html; charset=utf-8

pageEncoding
=utf-8%>
<%@ taglib prefix=s uri=/struts-tags%>

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
<html xmlns=”http://www.w3.org/1999/xhtml”>
<head>
<title>Struts 2 AJAX – Tree</title>
<s:head theme=”ajax” debug=”true” />
<script type=”text/javascript”>
function treeNodeSelected(arg) {

alert(arg.source.title
+ ‘ selected’);

}

dojo.addOnLoad(
function() {
var s = dojo.widget.byId(‘parentId’).selector;

dojo.event.connect(s, ‘select’, ‘treeNodeSelected’);

});
</script>
</head>
<body>
<h2>

Tree
</h2>
<div style=”float:left; margin-right: 50px;”>
<s:tree label=”parent” id=”parentId” theme=”ajax”

templateCssPath
=”/struts/tree.css” showRootGrid=”true”

showGrid
=”true”>
<s:treenode theme=”ajax” label=”child1″ id=”child1Id”>
<s:treenode theme=”ajax” label=”grandchild1″ id=”grandchild1Id” />
<s:treenode theme=”ajax” label=”grandchild2″ id=”grandchild2Id” />
<s:treenode theme=”ajax” label=”grandchild3″ id=”grandchild3Id” />
</s:treenode>
<s:treenode theme=”ajax” label=”child2″ id=”child2Id” />
<s:treenode theme=”ajax” label=”child3″ id=”child3Id” />
<s:treenode theme=”ajax” label=”child4″ id=”child4Id” />
<s:treenode theme=”ajax” label=”child5″ id=”child5Id”>
<s:treenode theme=”ajax” label=”gChild1″ id=”gChild1Id” />
<s:treenode theme=”ajax” label=”gChild2″ id=”gChild2Id” />
</s:treenode>
</s:tree>
</div>
</body>
</html>

清单10 WebContent/Tree.jsp

因为Dojo的树控件,即使在没有设定“selector”情况下,也会自动生成一个默认的Selector,所以只要将其事件绑定到特定的事件处理函数即可。

struts2 dojo 续2

No Comments

然后是用于获取和过滤数据的Action,代码如下:

package tutorial;

import java.util.ArrayList;
import java.util.List;

import com.opensymphony.xwork2.ActionSupport;

public class AutocompleterAction extends ActionSupport {
private static final long serialVersionUID = -8201401726773589361L;

private List<String[]> names;
private String start;

public void setStart(String start) {
this.start = start;
}


public List<String[]> getNames() {
return names;
}


@Override
public String execute() {
names
= new ArrayList<String[]>();
if(start == null || “”.equals(start.trim())) {
start
= a;
}

for(String s : Datas.NAMES) {
if(s.toLowerCase().startsWith(start.toLowerCase())) {
names.add(
new String[]{ s, s });
}

}

return SUCCESS;
}

}

清单7 src/tutorial/AutocmpleterAction.java

上述Action会以JSON的形式返回以start开头的Datas.NAMES的中字符串,以下是此Action的配置:

<action name=”Autocompleter” class=”tutorial.AutocompleterAction”>
<result type=”json”>
<param name=”root”>names</param>
</result>
</action>

清单8 Autocompleter Action的配置代码片段

在JSON类型结果的参数中加入“root”参数可以设定输出JSON结果的根,以上述情况为例,如果没有“root”参数,输出将为“{ “names”: [ ["xxx", "xxx"]…] }”,加了之后变就会成“[ ["xxx", "xxx"]…] ”。接下来,让我们看看页面的代码:

<%@ page language=java contentType=text/html; charset=utf-8

pageEncoding
=utf-8%>
<%@ taglib prefix=s uri=/struts-tags%>

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
<html xmlns=”http://www.w3.org/1999/xhtml”>
<head>
<title>Struts 2 AJAX – Autocompleter</title>
<s:head theme=”ajax” />
</head>
<body>
<h2>

Autocompleter
</h2>
<s:form action=”autocompleterForm”>
<s:textfield label=”abc” name=”abc” />
<tr>
<td class=”tdLabel”>
<label class=”label”>

No AJAX Autocompleter:
</label>
</td>
<td>
<s:autocompleter theme=”simple” name=”user”

list
=”@tutorial.Datas@NAMES” />
</td>
</tr>
<tr>
<td class=”tdLabel”>
<label class=”label”>

AJAX Autocompleter:
</label>
</td>
<td>
<s:url id=”dataUrl” value=”/Autocompleter.action” />
<s:autocompleter theme=”ajax” name=”start” href=”%{dataUrl}”

loadOnTextChange
=”true” loadMinimumCount=”1″ indicator=”indicator”

autoComplete
=”false” showDownArrow=”false” />
<img id=”indicator”

src
=”${pageContext.request.contextPath}/images/indicator.gif”

alt
=”Loading style=”display:none” />
</td>
</tr>
</s:form>
</body>
</html>

清单9 WebContent/Autocompleter.jsp

上述页面包含两个<s:autocompleter />标志,前者使用“simple”模板,所以不具有AJAX功能,它的数据将以HTML方式输出到最终页面里;而后者则使用了“ajax”模板,每当输入框的值发生改变时,它都向URL“/Autocompleter.action”发送请求,Action根据请求中的start参数的值,返回相当的JSON,在请求完成后页面通过回调函数改变输入框的下拉提示,效果如下图所示:

图2 Autocompleter.jsp页面输出
图2 Autocompleter.jsp页面输出

struts2 dojo 续

No Comments

2、<s:autocompleter />

Autocomplete是比较经典的AJAX应用,虽然谷歌已经停止使用这一功能,但就Autocompleter自身而言的确是很酷的。下面是一个<s:autocompleter />的例子。

首先,我要伪造一些字符串数据,代码如下:

package tutorial;

import java.util.ArrayList;
import java.util.List;

public final class Datas {
public static final List<String> NAMES;
static {
NAMES
= new ArrayList<String>();
NAMES.add(
Alabama);
NAMES.add(
Alaska);
NAMES.add(
American Samoa);
NAMES.add(
Arizona);
NAMES.add(
Arkansas);
NAMES.add(
Armed Forces Europe);
NAMES.add(
Armed Forces Pacific);
NAMES.add(
Armed Forces the Americas);
NAMES.add(
California);
NAMES.add(
Colorado);
NAMES.add(
Connecticut);
NAMES.add(
Delaware);
NAMES.add(
District of Columbia);
NAMES.add(
Federated States of Micronesia);
NAMES.add(
Florida);
NAMES.add(
Georgia);
NAMES.add(
Guam);
NAMES.add(
Hawaii);
NAMES.add(
Idaho);
NAMES.add(
Illinois);
NAMES.add(
Indiana);
NAMES.add(
Iowa);
NAMES.add(
Kansas);
NAMES.add(
Kentucky);
NAMES.add(
Louisiana);
NAMES.add(
Maine);
NAMES.add(
Marshall Islands);
NAMES.add(
Maryland);
NAMES.add(
Massachusetts);
NAMES.add(
Michigan);
NAMES.add(
Minnesota);
NAMES.add(
Mississippi);
NAMES.add(
Missouri);
NAMES.add(
Montana);
NAMES.add(
Nebraska);
NAMES.add(
Nevada);
NAMES.add(
New Hampshire);
NAMES.add(
New Jersey);
NAMES.add(
New Mexico);
NAMES.add(
New York);
NAMES.add(
North Carolina);
NAMES.add(
North Dakota);
NAMES.add(
Northern Mariana Islands);
NAMES.add(
Ohio);
NAMES.add(
Oklahoma);
NAMES.add(
Oregon);
NAMES.add(
Pennsylvania);
NAMES.add(
Puerto Rico);
NAMES.add(
Rhode Island);
NAMES.add(
South Carolina);
NAMES.add(
South Dakota);
NAMES.add(
Tennessee);
NAMES.add(
Texas);
NAMES.add(
Utah);
NAMES.add(
Vermont);
NAMES.add(
Virgin Islands, U.S.);
NAMES.add(
Virginia);
NAMES.add(
Washington);
NAMES.add(
West Virginia);
NAMES.add(
Wisconsin);
NAMES.add(
Wyoming);
}

}

清单6 src/tutorial/Datas.java

Struts 2与Dojo

No Comments

Dojo是开源Javascript工具包,它引了Widget的概念,方便了Javascript面向对象编程(OOP),改进Javascript的事件模型。在此我不打算对此进行深入的讲解,有兴趣的朋友的可以找网上找一些关于Dojo的资料学习。

Struts 2基于Dojo编写一些AJAX标志(在Dojo中称为Widget),要使用这些标志的AJAX功能,需要将标志的“theme”属性设为 “ajax”。同时,亦需要将加入在<head>与</head>之间加入<s:head theme=”ajax” />。当使用这些标志的AJAX功能,有些属性可能会经常用到,所以我会对这些属性稍作解释。

名称 描述
href XHR(XMLHttpRequest)请求的地址
listenTopics 监听的Dojo话题(Topic)以触发自身,如可以在可以通过发布(Publish)相应的话题,通知<s:autocompleter />重新加载其备选项(Options)
notifyTopics 完成远程调用后,发出通知,触发相应的Javascript函数或Dojo Widget
formId 需要提交到服务器的表单的ID
formFilter 过滤表单字段的Javascript函数名称
indicator 在XHR处理过程中,包含用户提示的信息的HTML元素的ID,如图片或DIV等

表1 常用的AJAX标志属性

这些标志包括:<s:a />、<s: submit />、<s:autocompleter />和<s:tree />等,下面我将分别讲解。

1、<s:a />和<s:submit />

这两个标志方便了我们的调用XHR实现AJAX,所以上面的HTML如果使用了这两标志将会变得更简单,因为我们不用再去理会繁锁的XHR创建和设定的工作。下面是示例代码:

<%@ page language=java contentType=text/html; charset=utf-8

pageEncoding
=utf-8%>
<%@ taglib prefix=s uri=/struts-tags%>

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
<html xmlns=”http://www.w3.org/1999/xhtml”>
<head>
<title>JSON Plugin</title>
<s:head theme=”ajax” />
<script type=”text/javascript”>

dojo.addOnLoad(
function() {

dojo.event.topic.subscribe(‘retrieveBook’,
this, function(data, type, e){
if(type == ‘load’) {

showBook(data);

}
else if(type == ‘error’) {

alert(‘Can not retrieve the book’);

}

});

});

  
function showBook(strBook) {
var oBook = eval(‘(‘ + strBook + ‘)’);
var bookHolder = document.getElementById(‘bookHolder’);
var sBook =<p><b>ISBN: </b>+ oBook.ISBN +</p>‘;

sBook
+= (‘<p><b>Title: </b>+ oBook.title +</p>‘);

sBook
+= (‘<p><b>Price: </b>$’ + oBook.price +</p>‘);

sBook
+= (‘<b><i>Comments: </i></b><hr/>‘);
for(i = 0; i < oBook.comments.length; i++) {

sBook
+= (‘<p><b>#’ + (i + 1) +</b>+ oBook.comments[i] +</p>‘);

}

bookHolder.innerHTML
= sBook;

}
</script>
</head>
<body>
<s:url id=”bookUrl” value=”/JsonPlugin.action” />
<s:submit href=”%{bookUrl}” theme=”ajax” indicator=”indicator”

value
=”Retrieve Book” align=”left” notifyTopics=”retrieveBook” />
<s:a theme=”ajax” href=”%{bookUrl}” indicator=”indicator”

notifyTopics
=”retrieveBook”>Retrieve Book</s:a>
<img id=”indicator”

src
=”${pageContext.request.contextPath}/images/indicator.gif”

alt
=”Loading style=”display:none” />
<div id=”bookHolder”></div>
</body>
</html>

清单5 WebContent/LinkButton.jsp

可能上述代码还不够简洁,因为我将HTML格式化的工作都放在Javascript中完成。但如果你的XHR返回的是HTML片段,你可以简单地将<s:a />或<s:submit />的“targets”属性设为“bookHolder”即可,详情大家可以参考Struts 2 Showcase。至于返回HTML片段,可以通过Action + Freemaker完成。

Struts 2与AJAX(第一部分) 续

No Comments
<?xml version=”1.0″ encoding=”UTF-8″?>

<!DOCTYPE struts PUBLIC

“-//Apache Software Foundation//DTD Struts Configuration 2.0//EN”

“http://struts.apache.org/dtds/struts-2.0.dtd”
>

<struts>
<package name=”Struts2_AJAX_DEMO” extends=”json-default”>
<action name=”JsonPlugin” class=”tutorial.JsonPluginAction”>
<result type=”json” />
</action>
</package>
</struts>

清单2 src/struts.xml

上面配置文件的“package”元素和以往不同的是,它扩展了“json-default”而不是“struts-default”。 “json-default”是在jsonplugin-0.11.jar包里的struts-plugin.xml中定义的。该文件同时定义了 “json”的结果类型,有兴趣的朋友可以打开此文件看看。

发布运行应用程序,在浏览器中键入:http://localhost:8080/Struts2_Ajax/JsonPlugin.action,出现下载文件对话框,原因是JSON插件将HTTP响应(Response)的MIME类型设为“application/json”。把文件下载下来,用记事本打开,内容如下:

{ISBN:15645912,comments:["It's no bad!","WOW!","No comment!"],price:0.9999,title:Max On Java}

清单3 例子1输出的JSON串

当然这还不是一个完整的AJAX的例子,下面让我们写一个HTML文件将其完成,HTML代码如下:

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>
<html xmlns=”http://www.w3.org/1999/xhtml” >
<head>
<title>JSON Plugin</title>
<script type=”text/javascript”>
var bXmlHttpSupport = (typeof XMLHttpRequest != undefined || window.ActiveXObject);

if (typeof XMLHttpRequest == undefined && window.ActiveXObject) {
function XMLHttpRequest() {
var arrSignatures = ["MSXML2.XMLHTTP.5.0", "MSXML2.XMLHTTP.4.0",
"MSXML2.XMLHTTP.3.0", "MSXML2.XMLHTTP",
"Microsoft.XMLHTTP"];

for (var i=0; i < arrSignatures.length; i++) {
try {
var oRequest = new ActiveXObject(arrSignatures[i]);
return oRequest;

}
catch (oError) { /*ignore*/ }

}

  
throw new Error(MSXML is not installed on your system.);   

}

}

  
function retrieveBook() {
if(bXmlHttpSupport) {
var sUrl = ‘JsonPlugin.action’;
var oRequest = new XMLHttpRequest();

oRequest.onreadystatechange
= function() {
if(oRequest.readyState == 4) {
var oBook = eval(‘(‘ + oRequest.responseText + ‘)’);
var bookHolder = document.getElementById(‘bookHolder’);
var sBook =<p><b>ISBN: </b>+ oBook.ISBN +</p>‘;

sBook
+= (‘<p><b>Title: </b>+ oBook.title +</p>‘);

sBook
+= (‘<p><b>Price: </b>$’ + oBook.price +</p>‘);

sBook
+= (‘<b><i>Comments: </i></b><hr/>‘);
for(i = 0; i < oBook.comments.length; i++) {

sBook
+= (‘<p><b>#’ + (i + 1) +</b>+ oBook.comments[i] +</p>‘);

}

bookHolder.innerHTML
= sBook;

}

};

oRequest.open(‘POST’, sUrl);

oRequest.send(
null);

}

}
</script>
</head>
<body>
<input type=”button” value=”Retrieve Book” onclick=”retrieveBook()” />
<div id=”bookHolder”></div>
</body>
</html>

清单4 WebContent/JsonPlugin.html

以上代码中,我没有使用任何的AJAX的Javascript包,而是参考《Professional Javascript For Web Developer》手工创建XHR(XMLHttpRequest),并在XHR完成后使用eval()方法将JSON字符串变为JSON对象。需要注意的是,要调用eval函数时,必须使用“(”和“)”将JSON字符串括起来,否则会出错的。

打开http://localhost:8080/Struts2_Ajax/JsonPlugin.html,点击“Retrieve Book”按钮,页面如下图所示:

图1 JsonPlugin.html页面输出
图1 JsonPlugin.html页面输出

Struts 2与AJAX(第一部分)

No Comments

在当今——Web 2.0概念铺天盖地的Internet环境下,简易的AJAX集成对于一个成功的WEB框架来说是不可或缺的。因此,Struts 2其中的一个重要的功能(Feature)就是“First-class AJAX support – Add interactivity and flexibility with AJAX tags that look and feel just like standard Struts tags(大意:一流的AJAX支持——通过AJAX标志增加互动性和灵活性,而且使用这些AJAX标志与普通的Struts标志同样简单)”。

实现原理

基于不重新发明轮子的原则,Struts 2并没有开发新的AJAX框架,而是使用时下Java EE平台中比较流行的AJAX框架——Dojo和DWR。

最近在Musachy Barroso等同志的无私奉献下,开发了Struts 2的JSON插件(Plugin),极大地方便了我们输出JSON结果(Result)。

JSON插件(Plugin)

在Struts 2的showcase中的AJAX部分,JSON的结果输出是通过Freemaker模板实现。这种方法在简易性和灵活性上都比不上JSON插件,所以JSON插件值得向大家五星推荐。

下面让我们看一个JSON插件的例子。

首先到以下网址http://code.google.com/p/jsonplugin/downloads/list下载JSON插件的JAR包,并将其加入你的WebContent\WEB-INF\lib下。

接下是本例子的Action代码:

package tutorial;

import java.util.ArrayList;
import java.util.List;

import com.googlecode.jsonplugin.annotations.JSON;
import com.opensymphony.xwork2.ActionSupport;

public class JsonPluginAction extends ActionSupport {
private static final long serialVersionUID = -6784977600668791997L;

private int bookId;
private String title;
private double price;
private List<String> comments;
private transient String secret1;
private String secret2;

@JSON(name
=ISBN)
public int getBookId() {
return bookId;
}


public void setBookId(int bookId) {
this.bookId = bookId;
}


public List<String> getComments() {
return comments;
}


public void setComments(List<String> comments) {
this.comments = comments;
}


public double getPrice() {
return price;
}


public void setPrice(double price) {
this.price = price;
}


public String getTitle() {
return title;
}


public void setTitle(String title) {
this.title = title;
}


@Override
public String execute() {
bookId
= 15645912;
title
= Max On Java;
price
= 0.9999d;
comments
= new ArrayList<String>(3);
comments.add(
It’s no bad!);
comments.add(
WOW!);
comments.add(
No comment!);
secret1
= You can’t see me!;
secret2
= I am invisible!;
return SUCCESS;
}

}

清单1 src/tutorial/JsonPluginAction.java

以上代码值得注意的是,通过@JSON的JAVA注释(Annotation),我们可以改变JSON结果的属性名称,另外带有transient修饰符与没有Getter方法的字段(field)都不会被串行化为JSON。

然后,我们来配置一下此Action,代码如下:

Struts2下载中文文件

No Comments

JSP文件

package com.trendcom.uploadfile.action; 

import java.io.ByteArrayInputStream;

import java.io.InputStream;

import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.net.URLDecoder;
import org.apache.struts2.ServletActionContext;

public class DownLoadAction extends BaseAction {

private String fileName;// 初始的通过param指定的文件名属性

private String inputPath;// 指定要被下载的文件路径

public InputStream getInputStream() throws Exception {

System.out.println(getRequest().getParameter("fileName"));
// 通过 ServletContext,也就是application 来读取数据
System.out.println(fileName);
System.out.println(URLDecoder.decode(fileName));
return ServletActionContext.getServletContext().getResourceAsStream(inputPath+"\\"+fileName);

}

public String execute() throws Exception {

return SUCCESS;

}

public void setInputPath(String value) {

inputPath = value;

}

public void setFileName(String fileName) {

this.fileName = fileName;

}

/** 提供转换编码后的供下载用的文件名 */

public String getDownloadFileName() {

String downFileName = fileName;

try {

downFileName = new String(downFileName.getBytes(), "ISO8859-1");

} catch (UnsupportedEncodingException e) {

e.printStackTrace();

}

return downFileName;

}

}


XML配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>

<package name="com.trendcom.uploadfile.action.DownLoadAction" namespace="/download" extends="struts-default">

<!-- 文件下载,支持中文附件名 -->

<action name="download"
class="com.trendcom.uploadfile.action.DownLoadAction">
<!-- 初始文件存放路径 -->
<param name="inputPath">/WEB-INF/upload/</param>
<result name="success" type="stream">
<param name="contentType">
application/octet-stream;charset=ISO8859-1
</param>
<param name="inputName">inputStream</param>
<!-- 使用经过转码的文件名作为下载文件名,downloadFileName属性
对应action类中的方法 getDownloadFileName() -->
<param name="contentDisposition">
attachment;filename="${downloadFileName}"
</param>
<param name="bufferSize">4096</param>
</result>
</action>

<!-- Add actions here -->
</package>
</struts>


如何正确在url上传递中文字符串,在url上传递中文字符串需要进行encode

<c:forEach items="${successFileList}" var="fileName">
<%String fileName=(String)pageContext.getAttribute("fileName"); %>
<a href="<%=basePath%>download/download.action?fileName=<%=java.net.URLEncoder.encode(fileName,"utf-8")%>">${fileName}</a>
</c:forEach>

struts2 common-fileupload上传文件大小限制

No Comments

  1. 1. org.apache.commons.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size (2359629) exceeds the configured maximum (2097152)     

关于Struts2中的核心配置文件struts.xml(转)

No Comments
关于Struts2中的核心配置文件struts.xml,就其DTD(Document Type Definition)文件进行一下说明
<?xml version=”1.0″ encoding=”UTF-8″?>
<!– START SNIPPET: strutsDtd –>
<!–

   Struts configuration DTD.

   Use the following DOCTYPE

  

   <!DOCTYPE struts PUBLIC

“-//Apache Software Foundation//DTD Struts Configuration 2.0//EN”

http://struts.apache.org/dtds/struts-2.0.dtd“>

–>
<!ELEMENT struts (package|include|bean|constant)*>
<!–
struts标签下可以出现下面标签0次或多次
package:将多个action组织成一个package的方式。
include:用来包含一个配置文件,目的是为了配置文件能够分离。
bean:被容器的框架创建,并注入到框架内部的对象。主要用来关联第三方类库,比如spring,一般应用程序不需要配置。
contant:用来设置Struts2运行的环境。效果等同于在struts.properties中配置,或者web.xml中配置FilterDispatcher的init param
–>
<!ELEMENT package (result-types?, interceptors?, default-interceptor-ref?, default-action-ref?, global-results?, global-exception-mappings?, action*)>
<!–
package标签下可以出现下面标签0次或者1次
result-types:用来定义结果类型
interceptors:用来定义拦截器
default-interceptor-ref:为package定义默认使用的拦截器,这个package中所有的action(如果这个action没有设置自己使用的拦截器)都会调用设置的默认拦截器
default-action-ref:这个package默认使用的action
global-results:为这个package设置共通使用的result,对这个package下的所有action都有效
global-exception-mappings:为这个package定义共通的当发生异常的时候,所用到的result,需与global-results结合使用
package标签下可以出现下面标签0次或者多次
action:为这个package定义action信息。
–>
<!ATTLIST package

    name CDATA #REQUIRED

    extends CDATA #IMPLIED

    namespace CDATA #IMPLIED

    abstract CDATA #IMPLIED

    externalReferenceResolver NMTOKEN #IMPLIED

>
<!–
package标签可以必须出现下面的属性
name:为此package定义一个唯一的标识
package标签可以出现下面的属性(也可不出现)
extends:此package所继承的package
namespace:此package的命名空间(其下所有的result和action都会在RootContext后加上设置的命名空间),如果不设定,默认为RootContext。
abstract:设置此package为抽象的,抽象的package里不能存在action。此属性的值为true或者false,默认为false
externalReferenceResolver:用来整合第三方类库,如spring
–>
<!ELEMENT result-types (result-type+)>
<!–
result-types标签下必须出现result-type标签1次或者多次
result-type:用来定义一个结果类型
–>
<!ELEMENT result-type (param*)>
<!–
result-type标签下可以出现param标签0次或者多次
用来定义此结果类型需要用到的参数
–>

<!ATTLIST result-type

    name CDATA #REQUIRED

    class CDATA #REQUIRED

    default (true|false) “false”

>
<!–
result-type标签必须包含下面属性
name:用来唯一标识这个结果类型
class:此结果类型的java class的位置
default:是否设置为默认的结果类型,默认值为false(不设置为默认的结果类型)。如果设置为默认的结果类型,则如果一个result没有指定type将会默认使用此result type。
–>
<!ELEMENT interceptors (interceptor|interceptor-stack)+>
<!–
interceptors标签下必须出现下面的标签1次或者多次(两者任一,或者同时)
interceptor:用来定义一个拦截器
interceptor-stack:用来定义一个拦截器栈
–>
<!ELEMENT interceptor (param*)>
<!–
interceptor标签下可以出现param标签0次或者多次
param:用来设置此拦截器需要的参数
–>
<!ATTLIST interceptor

    name CDATA #REQUIRED

    class CDATA #REQUIRED

>
<!–
interceptor必须包含下面属性
name:用来唯一标识此拦截器
class:用来指定此拦截器java class的位置
–>
<!ELEMENT interceptor-stack (interceptor-ref+)>
<!–
interceptor-stack标签下必须出现interceptor-ref标签1次或多次
interceptor-ref:用来指定此拦截器栈使用的拦截器
–>

<!ATTLIST interceptor-stack

    name CDATA #REQUIRED

>
<!–
interceptor-stack标签必须包含name属性,用来唯一标识此拦截器栈
–>
<!ELEMENT interceptor-ref (param*)>
<!–
interceptor-ref标签下可以出现param标签0次或多次,用来设置使用拦截器时所需的参数。
–>

<!ATTLIST interceptor-ref

    name CDATA #REQUIRED

>
<!–
interceptor-ref标签必须包含name属性,用来指定使用的拦截器名称或者拦截器栈的名称。
–>
<!ELEMENT default-interceptor-ref (param*)>

<!–
default-interceptor-ref标签下可以出现param标签0次或多次,用来设置使用默认拦截器时所需的参数。
–>

<!ATTLIST default-interceptor-ref

    name CDATA #REQUIRED

>
<!–
default-interceptor-ref标签必须包含name属性,用来指定默认使用的拦截器名称或者拦截器栈的名称。
–>

<!ELEMENT default-action-ref (param*)>

<!–
default-action-ref标签下可以出现param标签0次或多次,用来设置使用默认action时所需的参数。
–>

<!ATTLIST default-action-ref

    name CDATA #REQUIRED

>
<!–
default-action-ref标签必须包含name属性,用来指定默认使用的action名称。
–>

<!ELEMENT global-results (result+)>
<!–
global-results标签下必须出现result标签1次或者多次,用来设置共通的result
–>
<!ELEMENT global-exception-mappings (exception-mapping+)>
<!–
global-exception-mappings标签下必须出现exception-mapping标签1次或者多次,用来指定共通的,当出现exception时,所参照的result
–>
<!ELEMENT action (param|result|interceptor-ref|exception-mapping)*>
<!–
action标签下可以出现下面标签0次或者多次
param:用来设置调用次action所用到的参数
result:为此action定义结果(可以是一个jsp或者是一个action)
interceptor-ref:为此action设置使用的拦截器
exception-mapping:为此action定义,当有异常发生时,所参照的result
–>

<!ATTLIST action

    name CDATA #REQUIRED

    class CDATA #IMPLIED

    method CDATA #IMPLIED

    converter CDATA #IMPLIED

>
<!–
action标签必须包含下面这些属性
name:用来唯一标识此action
class:用来指定次action的java class的位置
action标签可以包含下面这些属性
method:为此action指定调用的方法,不指定时默认调用execute方法
converter:为此action指定使用的converter,不指定时使用默认的converter
–>
<!ELEMENT param (#PCDATA)>

<!ATTLIST param

    name CDATA #REQUIRED

>
<!–
param标签必须包含name属性
–>
<!ELEMENT result (#PCDATA|param)*>
<!–
result标签下可以出现param标签0次或者多次
–>

<!ATTLIST result

    name CDATA #IMPLIED

    type CDATA #IMPLIED

>
<!–
result标签可以包含下面属性
name:用来标识此result
type:结果的类型
–>
<!ELEMENT exception-mapping (#PCDATA|param)*>

<!–
exception-mapping标签下可以出现param标签0次或者多次
–>

<!ATTLIST exception-mapping

    name CDATA #IMPLIED

    exception CDATA #REQUIRED

    result CDATA #REQUIRED

>
<!–
exception-mapping标签可以包含下面属性
name:用来标识此exception-mapping
exception-mapping标签必须包含下面属性
exception:发生的exception的类型
result:当发生exception时所参照的result
–>

<!ELEMENT include (#PCDATA)>

<!ATTLIST include

    file CDATA #REQUIRED

>
<!–
include标签必须包含file属性,用来指定所要include的文件的位置。
–>
<!ELEMENT bean (#PCDATA)>

<!ATTLIST bean

    type CDATA #IMPLIED

    name CDATA #IMPLIED

    class CDATA #REQUIRED

    scope CDATA #IMPLIED

    static CDATA #IMPLIED

    optional CDATA #IMPLIED

>
<!ELEMENT constant (#PCDATA)>

<!ATTLIST constant

    name CDATA #REQUIRED

    value CDATA #REQUIRED   

>
<!–
constant标签必须包含下面属性
name:指定constant的key
value:指定constant的value
–>
<!– END SNIPPET: strutsDtd –>