BlogJava-jeffy-随笔分类-Web Framwork

FreeMarker设计指南 (转载)

Live-in Java — Thu, 02 Mar 2006 09:17:00 GMT

摘要: 1、快速入门（1）模板 + 数据模型 = 输出 l FreeMarker基于设计者和程序员是具有不同专业技能的不同个体的观念 l 他们是分工劳动的：设计者专注于表示——创建HTML文件、图片、W... 阅读全文

Live-in Java 2006-03-02 17:17 发表评论

webwork 相关urls

Live-in Java — Thu, 02 Mar 2006 08:21:00 GMT

扬子江：http://blog.video.com.cn/andy/subject/177.shtml

Live-in Java 2006-03-02 16:21 发表评论

WebWork的interceptor机制 (转载)

Live-in Java — Thu, 02 Mar 2006 08:02:00 GMT

WebWork项目建立在XWork项目上。入口Servlet是WebWork项目中定义的ServletDispatcher，而Action在XWork项目中定义。
XWork Action接口的execute()方法没有参数，不像Struts Action那样接受request, response参数，所以XWork Action能够脱离Web环境被直接调用，便于单元测试。
这里引入了一个问题。没有了request参数，那么XWork Action如何获得request parameters作为输入数据？又通过什么桥梁（Struts用request.setAttribute）把结果数据传送到View层？
在Web Work中，只能通过Action本身的getter, setter属性来传送输入参数和输出结果。
比如，我们有这样一个实现了XWork Action接口的类，

YourAction implements Action{
int productId = null;
String productName = null;
public void setProductId(int productId){this.productId = productId;}
public String getProductName(){return productName;}
public String execute(){
productName = findNameById(productId);
return “success”;
}
}
这个类里面的productId将接受request输入参数，productName是输出到页面显示的结果。
比如，这样的请求，http://yourhost/yourapp/MyAction.action?productId=1
Web Work会把1填到YourAction的productId里面，然后执行execute()方法，JSP里的语句会把YourAction的productName显示在页面上。

如果一个Web Framework采用了这种屏蔽Action的request, response参数的设计方式，一般也同时会采用这种Action和输入输出数据结合成一体的解决方式。类似的情形也存在于Tapestry和Maverick中，后面会讲到。

当WebWork ServletDispatcher接收到HTTP Request的时候，首先把所有相关的信息（包括request, response, session, servlet config, servelt context, 所有request参数）等存放到AcationContext中，然后根据Interceptor配置信息，生成一个YourAction的动态代理类对象。实际上运行的正是这个代理对象，如同Servlet Filter的工作机制一般，所有注入的Interceptor方法会先于Actio方法运行。

我们来看一下Action和Interceptor的地位：Action没有参数，无法获得ActionContext；而Interceptor接受的ActionInvoication参数拥有包括ActionContext在内的所有重要信息。
这种权力分配的不平等，注定了Action的作用非常有限，只限于调用商业逻辑，然后返回一个成功与否标志。所有与外部Web世界打交道、协调内部工作流程的重担，都责无旁贷地落在Interceptor的肩上。
我们可以设想一个极端的例子。我们声明一批不做任何事情的空Action，我们只是需要它们的空壳类名；我们制作一批对应的Interceptor，所有的转发控制、商业逻辑都在Interceptor上实现，然后把Interceptor都注入到对应的空Action。这在理论上是完全可行的。
在Web海洋的包围中，Action可少，Interceptor不可少。Action是一个孤岛,如果没有外来盟友Interceptor的协助，只能在自己的小范围内独立作战（比如Unit Test），而对整体大局的作战目标无法产生影响。
下面我们来看一下Action是如何在Interceptor的全程监管下工作的。
在WebWork中，我们需要如下配置XWork.xml。

YourAction.jsp

webwork-default.xml里面的相关定义如下：

从上述的配置信息中可以看出，YourAction执行execute()方法的前后，会被
defaultStack所定义的三个Intercepter截获。这些Interceptor的任务之一就是把输入参数设置到Action的对应属性当中。
如果我们需要加入对YourAction的属性的验证功能，只要把上述定义中的validation Interceptor加入到defaultStack中就可以了。当然，实际工作还没有这么简单，一般来说，还要为每个进行属性验证的Action的都配置一份validation.xml。
XWork Interceptor能够在Package和Action级别上，进行截获处理。
Servlet Filter能够在URL Patten级别上，进行截获处理。虽然实际上，Servlet Filter截获的是Servlet，但某些情况下，可以达到和截获一批Action的同样效果。
比如，在Web Work中，我们可以为所有admin package的Action，加入一个Interceptor，当检查到当前Session的用户没有admin权限时，统一返回一个警告页面：您没有足够的权限执行这个操作。
我们看到也可以为所有URL Pattern为“admin/*.action”的URL定义一个Servlet Filter，当检查到当前Session的用户没有admin权限时，统一返回一个警告页面：您没有足够的权限执行这个操作。
WebWork的Interceptor配置是相当灵活的，相当于对Action实现了AOP。Interceptor相当于Aspect，基类AroundInterceptor的before(), after()方法相当于Advice。
另外，XWork也提供了从XML配置文件装配Component的机制，相当于实现了对于Component的IoC。
（申明：本文来源于网络，摘录于此，仅为日后方便查看）

Live-in Java 2006-03-02 16:02 发表评论

Webwork2 的Action Result Type 的定义 (转载)

Live-in Java — Thu, 02 Mar 2006 07:45:00 GMT

和Webwork1.x不同，Webwork2的Action执行完后，其Result对应一个 Result Type，而这个Result Type完全可以根据具体应用或环境自己进行定义，只需实现com.opensymphony.xwork.Result接口。Result Type使得Action的执行结果表现形式可以灵活多变！下面这会举例说明，这里先看看Webwork2提供的几种Result Type的定义，该定义在webwork-default.xml中，xwork.xml文件包含了该文件，自定义的Result Type可以直接写在 xwork.xml中：

其大多都有location和parse两个参数，location指明action执行后接着去哪里，parse指明是否对location进行OGNL表达式解析。

1) dispatcher
action执行完后，请求会导向对应的View，Webwork2幕后其实是用RequestDispatcher来处理的，所以原Request/Response对象会接着传递，原Request中的Atrributes不会丢失，这点与下面的redirect是不同的。

2) redirect
对上次的响应将重定向到指定的位置，redirect是重新产生一个新的Request，原来Request保存的东西将不再有效，比如不能通过requet.getAtrribute 取得原来set的对象，也不能取得action的实例，errors，field errors等，因为Action是建立在Single-thread model上的。

3) chain
action链，特殊的View调用方式，一个action执行完接着调用另一个action。有个必须的参数actionName，指明紧接着调用的另一action对象。如：

bar
/foo

执行后接着调用下面的action:

...

4) velocity
5) freemarker
6) jasperreports
7) xslt
以上都是用不同技术的产生不同的View。

下面我举个自定义Result Type的示例，假如我有个Action testSendmail，根据处理结果将给指用户发送一份email。自定义一个Result Type，实现Result接口。

com.mycompany.webwork.example.SendmailResult
有三个必须参数：from ,to, subject,一个可选参数 body。
在xwork.xml中定义如下：

action定义：

root@sina.com
user@sina.com
hello,webwork!

error.jsp

SendmailResult.java

package com.opensymphony.webwork.example;

import com.opensymphony.xwork.ActionInvocation;
import com.opensymphony.xwork.Result;

public class SendmailResult implements Result {
private String to;
private String from;
private String subject;
private String body;

public void execute(ActionInvocation invocation) throws Exception {
//TODO 实现Email发送部分
System.out.println("sending mail....");
System.out.println(" To:" + to);
System.out.println(" From:" + from);
System.out.println("Subject:" + subject);
}

public String getBody() {
return body;
}

public void setBody(String body) {
this.body = body;
}

public String getFrom() {
return from;
}

public void setFrom(String from) {
this.from = from;
}

public String getSubject() {
return subject;
}

public void setSubject(String subject) {
this.subject = subject;
}

public String getTo() {
return to;
}

public void setTo(String to) {
this.to = to;
}
}

写个简单的测试Action：
package com.opensymphony.webwork.example;

import com.opensymphony.xwork.ActionSupport;

public class TestSendMailAction extends ActionSupport {
public String execute() throws Exception {
return SUCCESS;
}
}

测试jsp,把它放在webwork-example/下：

testsendmail.jsp

<%@ taglib prefix="ww" uri="webwork" %>

Test sendmail restul type

（申明：本文来源于网络，摘录于此，仅为日后方便查看）

Live-in Java 2006-03-02 15:45 发表评论

Tapestry和ognl

Live-in Java — Wed, 01 Mar 2006 03:43:00 GMT

OGNL(Object Graph Navigation Language)Tapestry和OGNL结合的很完美。OGNL是一种Java表达式语言，它被用来读取和更新对象的属性。OGNL比建立在JSP2.0标签库之上的表达式语言更简单功能也更强大。OGNL不仅仅提供属性的访问，它包括了精确的表达式和方法的调用。也能访问类的静态域。也可以创建新的对象，包括List和Map对象。简单的OGNL表达式是属性的名字。如：foo，这就等同于调用了方法getFoo()（或者是setFoo()如果表达式是用来更新属性的）。当属性的名字是连续的属性名时，导航功能就起作用了。如：foo.bar.baz，它就等于getFoo().getBar().getBaz() 。不过要注意的是foo和bar这些属性不能为空。 OGNL允许两个对象（如页和页所包含的组件）来共享信息。

Live-in Java 2006-03-01 11:43 发表评论

Tapestry简介－转载 (转自java-cn)

Live-in Java — Mon, 27 Feb 2006 09:46:00 GMT

介绍Tapestry的相关中文网址：
http://www.netbei.com/Article/jsp/Tapestry/Index.html

Tapestry是一个开源的基于servlet的应用程序框架，它使用组件对象模型来创建动态的，交互的web应用。一个组件就是任意一个带有jwcid属性的html标记。其中jwc的意思是Java Web Component。Tapestry使得java代码与html完全分离，利用这个框架开发大型应用变得轻而易举。并且开发的应用很容易维护和升级。Tapestry支持本地化，其错误报告也很详细。Tapestry主要利用javabean和xml技术进行开发。

第一个应用程序

在介绍第一个应用之前，先介绍一下Tapestry的安装。从sourceforge下载其最新版，解压后，将lib目录下的jar文件放到CLASSPATH中，将其中的war文件放到tomcat的webapp目录下。然后就可以通过http://localhost:8080/tutorial访问其tutorial应用。
在Tapestry中一个应用程序有以下几部分组成，我们以其自身带的HelloWorld程序为例介绍：

Servlet：
这是一个应用的主体部分：servlet类，这个类必须是ApplicationServlet的子类，并且必须实现getApplicationSpecificationPath()方法。示例如下：

import com.primix.tapestry.*;
public class HelloWorldServlet extends ApplicationServlet
{
protected String getApplicationSpecificationPath()
{
return "/tutorial/hello/HelloWorld.application";
}
}

/tutorial/hello/HelloWorld.application是一个应用的说明文件。
Application Specification：
其实就是描述这个应用的一个xml文件，在这个应用中有许多参数需要设置，engine-class将在下面介绍，page中的name属性指定html文件名，specification-path指定对这个页面的说明文件。在一个应用中可以有很多个page，但必须有一个page的name为"Home"，因为当访问你的应用时，首先显示的就是这个page。

;
;

;

;
;

Application Engine：

当客户连接到Tapestry应用时，Tapestry将会创建一个Engine对象（类似于session）。通常我们程序中的application engine 一般是SimpleEngine类的一个实例，当然这个类的子类也可以。

Page Specification：
跟应用说明相似，页说明也是一个xml描述文件：

;
;
;

因为这个应用是静态的，所以使用com.primix.tapestry.BasePage即可，如果是动态的应用，则需在这个文件中定义一些component，当然使用BasePage为基类的派生类也可以。
html页面：
这个应用的html页面非常简单：

;
;
;Hello World;
;
;
;HelloWorld;
;
;

注意上面所讲到的各种文件都要放到放在WAR的WEB-INF/classes目录下。
一个复杂的应用

在这个应用中我们以一个简单的学生管理系统为例介绍一下Tapestry的常用功能。我们要实现学生的增加和显示，因此我们需要两个html页面。至于StudentServlet类和Student.application我们就不描述了，在Student.application中定义了两个page：Home和EditStudent，具体看附件。学生数据存放在数据库中，我们用Student类表示数据中的一条记录，用StudentFactory类检索学生数据，这两个类用到了一个JDBC包装器，关于这个JDBC包装器可以见我的另外一篇文章<<对一个简单的 JDBC 包装器的扩展及应用>;>;。
首先看一下Home.html

;
;
;学生管理;

;
;
;
;学生列表

;
;
;
;学号;
;姓名;
;性别;
;班级;
;
;
;
;;20012400;;
;;宗锋;;
;;男;;
;;计算机研一;;
;
;
;
;20011389;
;桑一珊;
;男;
;计算机研一;
;
;
;添加学生;
;
;

与前面的简单应用不同，我们在这个页面中定义了七个组件，下面看一下部分Home.jwc文件，我们将详细讲述一下怎样描述这些组件。

;
;

;

;
;
;

;EditStudent;
;
;

在这里，我们的specification的class属性值不再是BasePage，而是其派生类ListStudent。对于每一个组件，id属性指定唯一的标识符，这个值与html文件中的jwcid值相对应，type 指定组件名，binding指定组件怎得到数据，property-path是一系列属性的集合，这些属性一般定义在javabean中，例如上面的property-path="student"，则在相应的javabean类ListStudent中应该有个函数getStudent。liststudent是一个Foreach组件，这个组件其实是一个for循环，它从source中读入一个数组，将其一个一个的赋值给value参数指定的属性。id，name，gender，department四个是Insert组件，这个组件用来插入文本数据，参数value指定要插入的值，property-path指定怎样获取这些值，eachstudent.id相当于调用javabean的getEachstudent().getId()。add是一个Page组件，page属性指定页面名（定义在application文件中），static-binding表明要绑定的数据是不可修改的。$remove$组件没有在这个文件中描述，因为Tapestry运行时会自动删除这种组件。
下面看一下ListStudent类：

package test;
import com.primix.tapestry.*;
import sun.jdbc.odbc.JdbcOdbcDriver ;

/**
* 返回每个学生的数据
*
*/

public class ListStudent extends BasePage
{
private Student eachstudent;
private Student[] student;
public void detach()
{
eachstudent=null;
student=null;
super.detach();
}

public Student getEachstudent()
{
return eachstudent;
}
public void setEachstudent(Student value)
{
eachstudent = value;
}
public Student[] getStudent()
{
try{
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
student=StudentFactory.findAllStudents();
}catch(Exception e){
e.printStackTrace();
}
return student;

}

}

这个类有四个函数，其中detach函数是将页面放入缓冲池时执行的操作，getStudent函数返回所有的学生记录，这是给jwc文件中liststudent组件的source参数赋值，getEachstudent给这个组件的value参数赋值，因为source是一个数组，每次循环需要从中取出一条记录赋值给eachstudent,所以还有一个函数为setEachstudent，你会注意到这个函数很简单，其实是Tapestry帮你做了大部分工作。
至此，显示学生的部分已经完成，下面看一下EditStudent.html

;
;
;增加学生;

;
;
;

;; 学生管理系统

;
;
;
;;;
;

;学号：
;

;

;姓名：
;

;
;

;性别：
;
男
;
女

;
;

;班级：
;

;

;
;

;
;
;
;

在这个文件中，用到了另外一些常用的组件，先看一下EditStudent.jwc中的这些组件的描述：

;
;

;
;
;

;
;
;

form是一个Form组件，它的参数listener指定submit这个form时有那个函数处理。ifError是一个Conditional组件，这个组件指定当condition满足时才会显示，在本例中，如果error不为空，则condition满足。在这个组件中，有嵌套了一个Insert类型的组件，用于将错误显示。这是Tapestry中经常用到的处理错误的方式。gender是一个RadioGroup组件，它绑定了javabean中的gender属性，selected参数指定那个radio被选中，在这个组件中，又嵌套了两个Radio组件，分别用来表示男，女。Radio的value参数指定当用户选定这个radio时，RadioGroup绑定的属性值将会等于field-name中指定的值（这个值必须是static的），在本例中，gender=test.EditStudent.MALE。id是一个TextField组件，其参数value绑定到javabean中的id属性。
下面是相应的EditStudent类：

package test;
import com.primix.tapestry.*;

public class EditStudent extends BasePage
{
public static final int MALE = 1;
public static final int FEMALE = 2;

private int gender;
private String error;
private String id;
private String sname;
private String department;

public void detach()
{
error = null;
id=null;
sname=null;
gender=0;
department=null;
super.detach();
}

public int getGender()
{
return gender;
}
public String getId()
{
return id;
}
public String getSname()
{
return sname;
}
public String getDepartment()
{
return department;
}

public void setGender(int value)
{
gender = value;
fireObservedChange("gender", value);
}
public void setId(String value)
{
id = value;
fireObservedChange("id", value);
}
public String getError()
{
return error;
}
public void setSname(String value)
{
sname = value;
fireObservedChange("sname", value);
}
public void setDepartment(String value)
{
department = value;
fireObservedChange("department", value);
}
public void formSubmit(IRequestCycle cycle)
{
//判断用户是否添完了所有数据
if (gender== 0||id==null||id.equals("")||sname==null||sname.equals("")||
department==null||department.equals(""))
{
error = "请填充完所有选项";
return;
}
//将学生保存
try{
Student student=new Student();
student.setId(id);
student.setName(sname);
if(gender==1)
student.setGender("男");
else
student.setGender("女");
student.setDepartment(department);
student.save(null);
}catch(Exception e){
e.printStackTrace();
}
//清空当前的各个属性，以免再次进入此页面时，各属性仍旧保留原来的值
setSname(null);
setDepartment(null);
setId(null);
setGender(0);
//重定向到Home页面
cycle.setPage("Home");
}

}

在本类的一些设置属性的函数中使用了fireObservedChange这个函数，这个函数激发一个改变事件，通知当前的属性的值已经改变。
其他应用

Tapestry中自带的例子中的Workbench中的localization例子演示了怎样使用本地化，你只需要创建不同语言的html模板，还有图形等其它一些html中用到的资源。例如创建一个法语版的EditStudent.html，则相应的html文件名为EditStudent_fr.html，而jwc中定义的组件的描述不用有多个版本。这里要介绍一下Tapestry本地化中经常用到的一个概念：assets。assets是一些web应用中用到的资源，如图象，视频。assets有三种：external, internal 和private。External类型的assets来源于任意的URL。Internal类型的assets来源于和Tapestry应用在同一个服务器上的URL。Private 类型的assets允许部署在WAR的WEB-INF/classes目录下（同上面的html模板，jwc文件一样），这个目录对于web服务器来说是不可见的。
看一下Workbench中localization例子中的localization.jwc文件的片断：

;

;
;

;

在changeButton组件中就使用了private assets，而这些图像文件就放在WAR的WEB-INF/classes下，注意图像跟html一样也有多个语言的版本。
注意jwc文件中的inputLocale这个组件，其实localization应用就是通过这个组件来实现本地化。具体参数请看其Developer guide。

;

;

;
;

Tapestry还支持创建自己的可重用组件，其自身带了一个这样的例子：Border。同时它还有其它一些例子：Inspector展示了怎样监视你的应用程序。vlib是一个用tapestry作表示层的j2ee应用程序（用jboss作为应用服务器）。

Tapestry的功能非常强大，本文只是介绍了其一小部分，还有很多方面没有涉及到，例如javascript在Tapestry中的应用。具体可以看其文档，相信如果你用一下这个框架，你就会被它深深吸引。Tapestry的文档做的不是很全，不过经过不断的摸索，相信你会很快掌握它。

Live-in Java 2006-02-27 17:46 发表评论

BlogJava-jeffy-随笔分类-Web Framwork

FreeMarker设计指南 (转载)

webwork 相关urls

WebWork的interceptor机制 (转载)

Webwork2 的Action Result Type 的定义 (转载)

Tapestry和ognl

Tapestry简介－ 转载 (转自java-cn)

Tapestry简介－转载 (转自java-cn)