stripes快速入门.doc

Stripes 快速入门指南[翻译]
说明:这是Stripes文档中的一篇叫Quick Start Guide的文章,看着顺眼,就翻译过来给大家看一下啦。
译者：lighter, 转载注明出于：

Stripes 快速入门指南
tfenne于2006年八月27号作最后编辑

介绍:
这一篇指南编写的目的是为了让你尽可能地以最快的速度把Stripes运行起来.这里面包含了一些关于Stripes有开发Web应用程序时的配置说明,同时也让你快速地搭建第一个Stripes应用程序.

开发环境:
Stripes充分利用了Java1.5中一些非常重要的特征,比如Annotations,还有泛型。同样它也很依赖一些Servlet2.4/JSP2.0的特征。所以你需要一个1.5版本的JDK(现在适用于大多数的平台),和一个可以支持Servlet2.4的Servlet容器,例如免费的Tomcat5.x和Caucho最新版本的、非常出色的Resin(对非商业用户免费提供)
这里希望读者有一定的JSP的开发经验，而且能理解一些常用的EL表达式,虽然没有必要去了解过于深入.

Stripes配置：
Stripes被设计成尽可能地只需要最少的配置文件。为了让其运行，你只需要在web应用程序的web.xml上简单地配置Stripes过滤器和Stripes Dispatcher。一个非常标准的配置文件如下所示：
web.xml
Java代码
1.      
2.      
7.      
8.          
9.         Stripes Filter     
10.         StripesFilter     
11.         net.sourceforge.stripes.controller.StripesFilter     
12.          
13.           
14.          
15.         StripesFilter     
16.         *.jsp     
17.         REQUEST     
18.          
19.           
20.          
21.         StripesFilter     
22.         StripesDispatcher     
23.         REQUEST     
24.          
25.           
26.          
27.         StripesDispatcher     
28.         net.sourceforgestripes.controller.DispatcherServlet   
29.             
30.         1     
31.          
32.           
33.          
34.         StripesDispatcher     
35.         *.action     
36.          
37.     

Stripes Filter
StripesFilter
net.sourceforge.stripes.controller.StripesFilter

StripesFilter
*.jsp
REQUEST

StripesFilter
StripesDispatcher
REQUEST

StripesDispatcher
net.sourceforge.stripes.controller.DispatcherServlet

1

pping>
StripesDispatcher
*.action

    下一步你必须把stripes.jar放进classpath路径中去，通常放在/WEB-INF/lib目录下。在编译的时候必须依赖Stripes的开发包，在发布和运行的时候，同样也需要复制下面的lib文件放到你的classpath路径中去.

1、commons-logging.jar (1.1) - Apache Commons Logging通常被用来提供一个日志接口,
2、cos.jar - 是com.oreilly.servlets包,Jason Hunter的免费礼物，通常作为form提交、用来实现文件的上传功能。

    上面的lib文件已全部在Stripes的分发包里提供好，而且都经过了Stripes的测试。用越新版本的lib包或许也会工作正常,但这可能偏离我们想达到的目的。

     另外，可以看到Stripes的日志输出,这一点对我们非常有帮助。为了达到目的,你须提供一个给Log4J的工作环境，或者对其他的日志公用包供给一个适用环境。Log4J的jar文件,log4j-1.2.9.jar,是Stripes是一个分发包。一个Commons Logging样本和Log4J配置文件如下所示：
     commons-logging.properties
Java代码
1. mons.logging.Log=mons.logging.impl.Log4JLogger    
mons.logging.Log=mons.logging.impl.Log4JLogger

    log4j.properties
Java代码
1. ### direct log messages to stdout ###      
2. log4j.appender.stdout=org.apache.log4j.ConsoleAppender      
3. log4j.appender.stdout.Target=System.out      
4. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout      
5. log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n        
6. # direct messages to file ###      
7. log4j.appender.file=org.apache.log4j.FileAppender      
8. log4j.appender.file.File=/tmp/stripes.log      
9. log4j.appender.file.layout=org.apache.log4j.PatternLayout      
10. log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n      
11. ### set log levels - for more verbose logging change 'info' to 'debug' ###      
12. log4j.rootLogger=INFO, stdout, file      
13. .sourceforge.stripes=DEBUG    
### direct log messages to stdout ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n
### direct messages to file ###
log4j.appender.file=org.apache.log4j.FileAppender
log4j.appender.file.File=/tmp/stripes.log
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n
### set log levels - for more verbose logging change 'info' to 'debug' ###
log4j.rootLogger=INFO, stdout, file
.sourceforge.stripes=DEBUG

日志配置文件需要放在classpath路径中去，例如在/WEB-INF/classes

最后一件需要放置的是StripesResources.properties文件;你现在可以复制到/WEB-INF/classes中去。StripesResources.properties用来(默认)查找显示Stripes验证出错时提示的错误信息,同样这必须放在Classpath路径中。举一个例子的片段如下所如：
例如 StripesResources.properties
Java代码
1. # Validation error messages used by Stripes' built in type converters      
2. converter.number.invalidNumber=The value ({1}) entered in field{0}must be a valid number      
3. converter.byte.outOfRange=The value ({1}) entered in field{0}was out of the range{2}to{3}      
4. converter.short.outOfRange=The value ({1}) entered in field {0}was out of the range{2}to{3}      
5. converter.integer.outOfRange=The value ({1}) entered in field {0}was out of the range{2}to{3}      
6. converter.float.outOfRange=The value ({1}) entered in field {0}was out of the range{2}to{3}      
7. converter.enum.notAnEnumeratedValue=The value "{1}" is not a valid value for field{0}      
8. converter.date.invalidDate=The value ({1}) entered in field {0 must be a valid date      
9. converter.email.invalidEmail=The value ({1})entered is not a valid email address      
10. ...    
# Validation error messages used by Stripes' built in type converters
converter.number.invalidNumber=The value ({1}) entered in field{0}must be a valid number
converter.byte.outOfRange=The value ({1}) entered in field{0}was out of the range{2}to{3}
converter.short.outOfRange=The value ({1}) entered in field {0}was out of the range{2}to{3}
converter.integer.outOfRange=The value ({1}) entered in field {0}was out of the range{2}to{3}
converter.float.outOfRange=The value ({1}) entered in field {0}was out of the range{2}to{3}
converter.enum.notAnEnumeratedValue=The value "{1}" is not a valid value for field{0}
converter.date.invalidDateThe value ({1}) entered in field {0 must be a valid date
converter.email.invalidEmail=The value ({1})entered is not a valid email address
...

我的第一个Stripe:
   作为第一个应用程序,我们会建立一个简单的页面,用来计算两个数,把它们加起来,在后面的描述中,可能添加其他的一些操作。首先，建立一个JSP文件用来显示界面。如下所示是一个简单的JSP页面代码。在web应用程序的根目录中,把以下文件放进一个名叫"quickstart"的目录下。
    JSP文件:"index.jsp"
Java代码
1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>      
2. <%@ taglib prefix="stripes" uri="      
3.      
4.       
5       
6.   My First Stripe      
7.         
8.     r things?      
12.      
13.           
14.          me="addition" value="Add"/>                          
26.                       
27.              
33.           
34.         
35.     
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="stripes" uri="

tml>
My First Stripe

"/examples/quickstart/Calculator.action" focus="">
>Result:
ickstart/Calculator.action" focus="">  

展开讨论一下stripes:form标签。Stripes form标签在背地里地为我们做了一些事情、但在这里暂不深入讨论，它最终解析生成一组规则的html form标签。同时focus=""告诉Stripes自动地把焦点设置在第一个可见的域[field](或者在发生错误的时候指向第一个出错的域)

下一步，我们再看两个标签,如下所示
Java代码
1.   

这一个标签等同于,但可以提供prepopulating,re-populating等功能,同时在验证出错的时候可以改变显示的信息。如果字段numberOne的名字与ActionBean里面的属性名相对应,ActionBean就会接受其请求。

为了替代,我们可以用：
Java代码
1. alue="Add"/>  

Stripes的submit标签有一个附加的实用功能就是在按钮上设置字符串的国际化显示,但我们可以做得更多，不止只有这一种需求,所以submit标签简单地运用了其值的属性。submit按钮的名字，addition，非常重要一点就是，当接受请求的时候会调用ActionBean里面的与之相绑定的方法。

最后，如果ActionBean里面存在result属性,这一条简单的EL表达式就把其结果打印出来
Java代码
1. ${actionBean.result}  
${actionBean.result}
我们现在准备演示一下页面!这时还不能提交页面, 因ActionBean还没有编写完毕(这不是简单地只用form标签做演示，我们现在也不会提交这一个表单)。

写完JSP文件后，看下面的Calculator例子的显示页面：
[img] [/img]

ActionBean类: 
    ActionBean是一个接收请求提交数据的对象,处理用户的输入信息。它定义了表单form的属性,同时也进行逻辑处理。与Struts相比，ActionBean就像把ActionForm和Action结合在同一个类中。

    这里需要提出的一点就是不需要任何额外的配置就可以让Stripes知道关于ActionBean在应用程序里的执行情况,也不用把JSP页面与ActionBean绑定在一起。所有必要的信息都在ActionBean自身。现在就让我们看一下简单的接受计算请求AcionBean：
Java代码
1. package net.sourceforge.stripes.examples.quickstart;      
2.      
3. import net.sourceforge.stripes.action.DefaultHandler;      

4. import net.sourceforge.stripes.action.Resolution;      
5. import net.sourceforge.stripes.action.ForwardResolution;      
6. import net.sourceforge.stripes.action.ActionBean;      
7. import net.sourceforge.stripes.action.ActionBeanContext;      
8.      
9. /**    
10.  * A very simple calculator action.    
11.  * @author Tim Fennell    
12.  */     
13. public class CalculatorActionBean implements ActionBean {      
14.     private ActionBeanContext context;      
15.     private double numberOne;      
16.     private double numberTwo;      
17.     private double result;      
18.      
19.     public ActionBeanContext getContext() { return context; }      
20.     public void setContext(ActionBeanContext context) { this.context = context; }      
21.      
22.     public double getNumberOne() { return numberOne; }      
23.     public void setNumberOne(double numberOne) { this.numberOne = numberOne; }      
24.      
25.     public double getNumberTwo() { return numberTwo; }      
26.     public void setNumberTwo(double numberTwo) { this.numberTwo = numberTwo; }      
27.      
28.     public double getResult() { return result; }      
29.     public void setResult(double result) { this.result = result; }      
30.      
31.     @DefaultHandler     
32.     public Resolution addition() {      
33.         result = getNumberOne() + getNumberTwo();      
34.         return new ForwardResolution("/quickstart/index.jsp");      
35.     }      
36. }    
package net.sourceforge.stripes.examples.quickstart;

import net.sourceforge.stripes.action.DefaultHandler;
import net.sourceforge.stripes.action.Resolution;
import net.sourceforge.stripes.action.ForwardResolution;
import net.sourceforge.stripes.action.ActionBean;
import net.sourceforge.stripes.action.ActionBeanContext;

/**
* A very simple calculator action.
* @author Tim Fennell
*/
public class CalculatorActionBean implements ActionBean {
private ActionBeanContext context;
private double numberOne;
private double numberTwo;
private double result;

public ActionBeanConte