兑现一个针对RCP应用的类似Struts的轻量级MVC框架

实现一个针对RCP应用的类似Struts的轻量级MVC框架
趁着公司项目收尾,有些空闲,写了一些回顾性的文章:
http://javatar.iteye.com/blog/258066
基于这篇文章的思考,周未写了一个简单的实现框架:
http://struts4rcp.googlecode.com
服务器端已完成,包括:请求接收,序列化策略,Action实例化工厂策略,拦截器链,异常转换等。
客户端也基本实现,包括:配置加载,传输策略,传输状态事件,同步调用,异步调用,连接监控,连接状态事件,但还差传输队列的实现,以及队列分组,队列改变事件等的处理。

1. 简介
(1) 说明
struts4rcp是一个适用于RCP/RIA应用的轻量级MVC框架,与Struts功能相似,提供远程MVC控制器支持,简化模型与视图的交互过程。
  • MVC: Model View Controller
  • RCP: Rich Client Platform
  • RIA: Rich Internet Application
  • Struts: 一个适用于Web页面"请求-响应"方式的MVC框架

(2) 对比
常规C/S应用中,通常都采用透明化的远程方法调用方式与服务器端通讯,即:将Service接口同时部署于客户端,并在客户端生成Service接口的Stub实现,通过各种协议代理访问服务器端的Service实现,此类工具如:RMI, WebService, XML-RPC/JSON-RPC, HttpInvoker等。为什么还要加一层Action控制器?
  • 远程调用Service接口,相当于MVC中的视图直接调用了模型,增加控制器,使职责更清晰。
  • Serivce域模型通常是无状态的,增加远程控制器,管理服务器端状态。
  • Service接口粒度过细,使得业务逻辑向客户端倾斜,产生过多的请求次数,增加控制器,确保大粒度请求。
  • 客户端部署Service接口比较繁琐,增加控制器作为中介者,简化耦合。
  • 在控制器层,同样可以实现透明化调用,用户同样不需要关心交互层面的信息。
  • 在控制器中更易于处理天然的(不需要反射或字节码增强的)AOP截面和事件模型,方便拦截器,转换器,校验器,安全控制等的扩展。
  • 对于大量长期使用Struts的开发人员,转入RCP开发时,更易于理解和使用,降低学习成本。

(3) 特性
  • 以数据为中心的控制器
  • 友好的执行过程拦截器
  • 完善的集成扩展点
  • 分组队列传输机制
  • 全面的事件通知

2. 使用
(1) 调用
(a) 服务器端
Action实现类:
public class LoginAction implements Action<Account, User> {

    public User execute(Account account) throws Exception {
        // ......
    }

}

Spring配置:
<bean id="loginAction" class="com.xxx.LoginAction">
    <property name="loginService" ref="loginService" />
</bean>

(b) 客户端
同步执行:
Account account = new Account("james", "123456"); // 传入数据模型
Action<Account, User> loginAction = Actions.getAction("loginAction"); // 对应Spring配置中的<bean id="loginAction">
User user = loginAction.execute(account); // 同步执行,并取得结果

异步执行:
Account account = new Account("james", "123456"); // 传入数据模型
Action<Account, User> loginAction = Actions.getAsyncAction("loginAction", new ActionCallback<User>() {
    public void callback(User user) throws Exception {
        // 异步执行完成后,通过此接口回传执行结果
    }
});
loginAction.execute(account); // 异步执行,并立即返回null

同步阻塞执行:
Account account = new Account("james", "123456"); // 传入数据模型
Action<Account, User> loginAction = Actions.getBlockingAction("loginGroup", "loginAction"); // 相同组名的Action将相互阻塞
User user = loginAction.execute(account); // 同步执行并取得结果,当同组的其它Action未完成时,该执行过程进入队列等待,当前线程被阻塞,直到结果返回

异步阻塞执行:
Account account = new Account("james", "123456"); // 传入数据模型
Action<Account, User> loginAction = Actions.getAsyncBlockingAction(("loginGroup", "loginAction", new ActionCallback<User>() {
    public void callback(User user) throws Exception {
       // 异步执行完成后,通过此接口回传执行结果
    }
});
loginAction.execute(account); // 异步执行,当同组的其它Action未完成时,该执行过程进入队列等待,阻塞异步线程,但不阻塞当前线程

(c) Web页面
同步执行:
var account = {username: "james", password: "123456", class: "com.xxx.Account"}; // 传入数据模型,若不指定class属性,表示使用Map类型
var loginAction = Actions.getAction("loginAction"); // 对应Spring配置中的<bean id="loginAction">
var user = loginAction.execute(account); // 同步执行并取得结果

异步执行:
var account = {username: "james", password: "123456", class: "com.xxx.Account"}; // 传入数据模型,若不指定class属性,表示使用Map类型
var loginAction = Actions.getAsyncAction("loginAction", function(user) {
    // 异步执行完成后,通过此接口回传执行结果
});
loginAction.execute(account); // 异步执行

(2) 导入
(a) 服务器端
struts4rcp-server.jar
import com.googlecode.struts4rcp.*;
import com.googlecode.struts4rcp.server.*;

(b) 客户端
struts4rcp-client.jar
import com.googlecode.struts4rcp.*;
import com.googlecode.struts4rcp.client.*;

(c) Web页面
struts4rcp.js
<script type="text/javascript" src="struts4rcp.js"></script>

(3) 配置
(a) 服务器端 (web.xml)
最简配置:
 <servlet>
     <servlet-name>actionServlet</servlet-name>
     <servlet-class>com.googlecode.struts4rcp.server.ActionServlet</servlet-class>
     <load-on-startup>1</load-on-startup>
 </servlet>
 <servlet-mapping>
     <servlet-name>actionServlet</servlet-name>
     <url-pattern>*.data</url-pattern>
 </servlet-mapping>
 <servlet-mapping>
     <servlet-name>actionServlet</servlet-name>
     <url-pattern>*.json</url-pattern>
 </servlet-mapping>

全部配置:
 <servlet>
     <servlet-name>actionServlet</servlet-name>
     <servlet-class>com.googlecode.struts4rcp.server.ActionServlet</servlet-class>
     <init-param>
         <param-name>serializers</param-name>
         <param-value>
             data: com.googlecode.struts4rcp.util.serialize.JavaSerializer,
             json: com.googlecode.struts4rcp.util.serialize.JsonSerializer
         </param-value>
     </init-param>
     <init-param>
         <param-name>actionFactory</param-name>
         <param-value>
             com.googlecode.struts4rcp.server.factory.SpringActionFactory
         </param-value>
     </init-param>
     <init-param>
         <param-name>actionInterceptors</param-name>
         <param-value>
             com.xxx.XXXActionInterceptor,
             com.yyy.YYYActionInterceptor
         </param-value>
     </init-param>
     <init-param>
         <param-name>exceptionConverters</param-name>
         <param-value>
             com.xxx.XXXExceptionConverter,
             com.yyy.YYYExceptionConverter
         </param-value>
     </init-param>
     <load-on-startup>1</load-on-startup>
 </servlet>
 <servlet-mapping>
     <servlet-name>actionServlet</servlet-name>
     <url-pattern>*.data</url-pattern>
 </servlet-mapping>
 <servlet-mapping>
     <servlet-name>actionServlet</servlet-name>
     <url-pattern>*.json</url-pattern>
 </servlet-mapping>

Spring配置:
<context-param>
	<param-name>contextConfigLocation</param-name>
	<param-value>/WEB-INF/beans.xml</param-value>
</context-param>
<listener>
	<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<listener>
	<listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
</listener>

(b) 客户端 (transport.properties)
最简配置:
server.host=127.0.0.1
server.port=8080
context.path=xxx

全部配置:
transporter=com.googlecode.struts4rcp.client.transport.HttpClientTransporter
serializer=com.googlecode.struts4rcp.util.serialize.JavaSerializer
listeners=com.xxx.XXXListener,com.yyy.YYYListener
exceptionCatchers=com.xxx.XXXExceptionCatcher,com.yyy.YYYExceptionCatcher
server.host=127.0.0.1
server.port=8080
context.path=xxx
action.suffix=data

(c) Web页面 (struts4rcp.js)
最简配置:
// 不需要配置

全部配置:
Actions.suffix='json';

3. 扩展
(1) 序列化器
扩展点:
客户端(包括Web页面)与服务器端之间传递的数据格式转换。
扩展接口:
  • com.googlecode.struts4rcp.util.serialize.Serializer
  • com.googlecode.struts4rcp.util.serialize.AbstractSerializer

内置实现:
  • com.googlecode.struts4rcp.util.serialize.JavaSerializer
  • com.googlecode.struts4rcp.util.serialize.JsonSerializer
  • com.googlecode.struts4rcp.util.serialize.JBossSerializer
  • com.googlecode.struts4rcp.util.serialize.XmlSerializer
  • com.googlecode.struts4rcp.util.serialize.XStreamSerializer

注册方式:
[list]
  • 客户端:struts4rcp.properties配置:serializer=com.xxx.XxxSerializer
  • [*] 服务器端:web.xml配置:
    <init-param><param-name>serializers</param-name><param-value>data:com.xxx.XxxSerializer</param-value></init-param>

    [/list]
    (2) 服务器端Action实例化工厂
    扩展点:
    服务器端Action实例的创建和装配。
    扩展接口:
    • com.googlecode.struts4rcp.server.ActionFactory

    内置实现:
    • com.googlecode.struts4rcp.server.factory.SpringActionFactory
    • com.googlecode.struts4rcp.server.factory.GuiceActionFactory
    • com.googlecode.struts4rcp.server.factory.ReflectActionFactory

    注册方式:
    [list]
  • ActionFactoryContext.getContext().setActionFactory(actionFactory);
  • [*] web.xml配置:
    <init-param><param-name>actionFactory</param-name><param-value>com.xxx.XxxActionFactory</param-value></init-param>

    [/list]
    (3) 服务器端Action拦截器
    扩展点:
    服务器端Action实例执行过程的前后拦截,可用于权限控制,前端检验等。
    扩展接口:
    • com.googlecode.struts4rcp.server.ActionInterceptor

    注册方式:
    [list]
  • ActionFactoryContext.getContext().addActionInterceptor(actionInterceptor);
  • [*] web.xml配置:
    <init-param><param-name>actionInterceptors</param-name><param-value>com.xxx.XxxActionInterceptor</param-value></init-param>

    [/list]
    (4) 服务器端异常转换器
    扩展点:
    转换客户端无法反序列化的服务器端异常,如:将Spring的事务异常转换为客户端识别的异常。
    扩展接口:
    • com.googlecode.struts4rcp.server.ExceptionConverter

    注册方式:
    [list]
  • ActionFactoryContext.getContext().addExceptionConverter(exceptionConverter);
  • [*] web.xml配置:
    <init-param><param-name>exceptionConverters</param-name><param-value>com.xxx.XxxExceptionConverter</param-value></init-param>

    [/list]
    (5) 客户端传输器
    扩展点:
    客户端与服务器端数据交换协议与策略实现。
    扩展接口:
    • com.googlecode.struts4rcp.client.Transporter
    • com.googlecode.struts4rcp.client.transport.AbstractTransporter
    • com.googlecode.struts4rcp.client.transport.HttpTransporter

    内置实现:
    • com.googlecode.struts4rcp.client.transport.HttpClientTransporter
    • com.googlecode.struts4rcp.client.transport.HttpURLConnectionTransporter

    注册方式:
    • struts4rcp.properties配置:transporter=com.xxx.XxxTransporter
    • Actions.init(transporter, config);

    (6) 客户端异常捕获器
    扩展点:
    当异步执行Action时,业务未处理的异常,由全局捕获器统一处理。
    扩展接口:
    • com.googlecode.struts4rcp.client.ExceptionCatcher

    注册方式:
    • struts4rcp.properties配置:exceptionCatchers=com.xxx.XxxExceptionCatcher
    • Actions.addExceptionCatcher(exceptionCatcher);

    (7) 客户端连接状态事件监听器
    扩展点:
    客户端的网络状态改变时触发此事件。
    扩展接口:
    • com.googlecode.struts4rcp.client.event.ConnectionListener
    • com.googlecode.struts4rcp.client.event.ConnectionAdapter

    注册方式:
    • struts4rcp.properties配置:listeners=com.xxx.XXXConnectionListener
    • Actions.getTransporter().addConnectionListener(listener);

    (8) 客户端传输状态事件监听器
    扩展点:
    客户端正在与服务器传输数据时以及传输结束时触发此事件。
    扩展接口:
    • com.googlecode.struts4rcp.client.event.TransportListener
    • com.googlecode.struts4rcp.client.event.TransportAdapter

    注册方式:
    • struts4rcp.properties配置:listeners=com.xxx.XXXTransportListener
    • Actions.getTransporter().addTransportListener(listener);

    (9) 客户端Action队列事件监听器
    扩展点:
    客户端的Action队列中的任务数改变时触发此事件。
    扩展接口:
    • com.googlecode.struts4rcp.client.event.ActionQueueListener
    • com.googlecode.struts4rcp.client.event.ActionQueueAdapter

    注册方式:
    • struts4rcp.properties配置:listeners=com.xxx.XXXActionQueueListener
    • Actions.getActionQueue().addActionQueueListener(listener);

    4. 设计
    (1) 部署图
    兑现一个针对RCP应用的类似Struts的轻量级MVC框架
    struts4rcp-client.jar组件:部署于客户端,包括:
    • com.googlecode.struts4rcp包
    • com.googlecode.struts4rcp.util包
    • com.googlecode.struts4rcp.client包

    struts4rcp-server.jar组件:部署于服务器端,包括:
    • com.googlecode.struts4rcp包
    • com.googlecode.struts4rcp.util包
    • com.googlecode.struts4rcp.server包

    (2) 类图
    兑现一个针对RCP应用的类似Struts的轻量级MVC框架
    包说明
    • com.googlecode.struts4rcp包:客户端与服务器端交互面,共享模型。(中心接口:Action)
    • com.googlecode.struts4rcp.client包:客户端实现。(入口类:Actions)
    • com.googlecode.struts4rcp.server包:服务器端实现。(入口类:ActionServlet)
    • com.googlecode.struts4rcp.util包:通用工具包,辅助实现。

    领域说明
    • 黄色:服务域
    • 红色:会话域
    • 绿色:实体域

    (3) 序列图
    兑现一个针对RCP应用的类似Struts的轻量级MVC框架
    • Client:调用者
    • Actions:客户端Action门面
    • ActionProxy:客户端Action代理实现
    • Transporter:客户端请求发送传输器(缺省采用HttpClientTransporter)
    • Serializer:传输序列化器(缺省采用JavaSerializer)
    • ActionServlet:服务器端请求接收器
    • ActionFactory:服务器端Action实例化工厂(缺省采用SpringActionFactory)
    • ActionIntercepter:服务器端Action执行过程拦截器链
    • Action:服务器端Action实例(调用目标)

    项目地址:
    http://struts4rcp.googlecode.com
    SVN地址:
    http://struts4rcp.googlecode.com/svn/trunk/code/struts4rcp