[转]纯粹的MVC - 实战 PureMVC
如何使用 PureMVC 快速开发 J2SE 应用
PureMVC 是一个通用的 MVC 框架,广泛适用于多种语言多种平台,是一个成熟的、耦合性很低的优秀框架,本文将结合实例来介绍如何使用它来进行 J2SE 的开发。
https://www.ibm.com/developerworks/cn/java/j-lo-puremvc/
2011 年 1 月 06 日
PureMVC 的简介
PureMVC 是在基于模型、视图和控制器 MVC 模式建立的一个轻量级的应用框架,这是一个开源框架,它最初是被用于 ActionScript 3 语言使用的 Adobe Flex、Flash 和 AIR 之上,现在已经移植到几乎所有主要的软件平台之上见表 1。
表 1. PureMVC 支持平台语言的一览表
Language | Targets |
---|---|
ActionScript 2 | Flex 1.5, Flash 8, FlashLite |
ActionScript 3 | Flex 2, 3, Flash 9/CS3, AIR. |
C# | .NET 1.0/2.0 Silverlight, Windows Mobile and Pocket PC. |
ColdFusion | ColdFusion 8 |
haXe | JavaScript, Flash 8, Flash 9 and the Neko VM. |
Java | Java Mobile, Standard and Enterprise Editions (ME, SE, EE), JavaFX, Servlets, Applets, and GWT |
JavaScript | Browser neutral |
Objective C | Apple iPhone and Mac |
PHP | PHP 5 |
Python | Python 2.5 for wxPython, Google App Engine, Pyjamas [13] |
Ruby | |
C++ | MSVC 8.0/9.0/10.0, MinGW 3.4.5, GNU G++, Embarcadero C++ 6.21 |
PureMVC 框架有两个分支版本:标准和多核。标准版提供了一种简单的编码分离的方法,按照基本的 MVC 概念设计而成。多核版本支持模块化编程,允许多个 PureMVC 应用运行在一起。本文我们主要介绍标准版的功能和使用。
PureMVC 基本结构
在 MVC 模式中,应用程序被分为低耦合的三层:Model、View 和 Controller。PureMVC 在此基础上有所扩充,通过模块化设计,致力于进一步降低模块间耦合性,创建了一个易于扩展限制很小的通用框架,图一是 PureMVC 的设计图。
图 1. PureMVC 框架示意图(摘自 PureMVC 官方网站)
(查看图 1 的 清晰版本。)
在 PureMVC 实现的经典 MVC 元设计模式中,Model、View 和 Controller 分别由一个单例类来管理,合称为核心层或核心角色。 另外,在 PureMVC 中还提供了一个单例类 —— Façade,主要作用是作为与核心层通信的唯一接口,简化开发复杂度。
从上图中可以看出,除了这几个主要对象以外,框架还有如下类 Proxy、Mediator 和 Command,以下简单介绍一下他们的作用。
- Proxy 对象负责操作数据模型,与远程服务通信存取数据,这样可以保证 Model 层的可移植性。通常 Proxy 对象的引用保存在 Model 中。
- View 保存对 Mediator 对象的引用。由 Mediator 对象来操作具体的视图组件(View Component,它的作用还包括:添加事件监听器,发送或接收 Notification,直接改变视图组件的状态。通过这样,就可以把视图和控制它的逻辑分离开来。
- Command 对象是无状态的,只在需要时才被创建。Command 可以获取 Proxy 对象并与之交互,发送 Notification,执行其他的 Command。经常用于复杂的或系统范围的操作,如应用程序的“启动”和“关闭”。应用程序的业务逻辑应该在这里实现。
除了基本的对象结构以外,为了解耦合,PureMVC 框架中引入了事件机制,这是个非常简单观察者设计模式,所有的事件都是一个 Notification,不同对象之间通过 Notification 来同步操作和交换信息。例如如果想更新界面中某个 Mediator,首先我们定义 Notification 用于此目的,然后注册 Mediator 监听该 Notification,然后就可以在程序中任何地方生成一个 Notification,通过事件机制,Mediator 就会接收到 Notification,然后更新需要的部分。整个过程 Mediator 只和 Notification 有关,没有其他依赖,有效的降低了对象之间的依赖程度。
介绍完 PureMVC 的基本结构和事件模型,我们来看看一个典型的 PureMVC 应用如何构造。首先实际的应用程序都有一个 Façade 子类,这个 Façade 类对象负责初始化 Controller(控制器),建立 Command 与 Notification 名之间的映射,并执行一个 Command 注册所有的 Model 和 View,一旦初始化的工作做完,对象之间的关系建立好以后,应用程序就可以正常运行了。
PureMVC Java 版本的基本结构
首先我们看看 PureMVC Java 标准的核心类图,如图 2 所示:
图 2. Java 版本主类图
核心类的实现完全体现了框架的设计意图,由 IController、IView 和 IModel 三个接口来规范 MVC 三种角色的行为,同时又提供了三个默认的实现类。
然后我们在看看辅助性类的类图:
图 3. Java 版本辅助类图
(查看图 3 的 清晰版本。)
从中可以看出 IFaçade 是整个程序的入口和负责管理所有对象的类,其中可以注册 proxy、command 和 Mediator,通过 IFaçade 的子类,系统的各种资源得到统一管理和调度。
然后可以看到 INotification 是整个事件驱动模型的核心类,通过事件模型,整个应用程序的各个部分的耦合度变得非常低,同时用户可以自定义 INotification 的子类,从而实现最大的可定制性。
PureMVC 样例程序 —— 用户登陆
下面我们用 PureMVC 来实现一个典型的应用程序通讯录,这个程序因为只是示范,所以只实现了基本的编辑和管理功能,下图是程序运行时的截图。
图 4. 主界面
当用户填写正确的用户名和密码的时候,就显示登陆成功的消息:
图 5. 登陆成功
当用户填写错误的用户名和密码的时候,就显示登陆不成功的消息:
图 6. 登陆失败
首先,我们来看看程序的入口代码,即 main 函数所在的类 LoginFacade,这个类是 Façade 的子类,同时继承了 IFacade 接口。
清单 1. LoginFacade.java 的源码
package login; import org.puremvc.java.patterns.facade.Facade; import org.puremvc.java.patterns.observer.Notification; public class LoginFacade extends Facade { public static final String STARTUP = "startup"; public static final String SUBMIT_LOGIN = "submitLogin"; public static final String LOGIN_SUCCESSFUL = "loginSuccessful"; public static final String LOGIN_FAIL = "loginFail"; public static LoginFacade getInstance(){ if (instance == null) instance = new LoginFacade(); return (LoginFacade)instance; } protected void initializeController() { super.initializeController(); registerCommand(STARTUP, StartupCommand.class); registerCommand(SUBMIT_LOGIN, LoginCommand.class); } @Override protected void initializeModel() { super.initializeModel(); registerProxy(new UsersProxy()); } @Override protected void initializeView() { super.initializeView(); registerMediator(new LoginScreenMediator()); } public static void main(String[] args) { getInstance().notifyObservers(new Notification(STARTUP, null, null)); } }
LoginFacade 覆盖父类的三个初始化方法:initializeController、initializeModel 和 initializeView,作为单例,通过父类的构造函数分别调用了这三个函数,从而完成初始化工作。三个函数也很简单,只是在 initializeController 中注册所有的 Command 类,在 initializeModel 中注册所有的 Proxy 类,在 initializeView 中注册所有 Mediator 类。
Main 函数很简单只是发送了一个 STARTUP 的消息,该消息会被 StartupCommand 类接受,从而执行相应的初始化动作。
然后,我们来看 StartupCommand 类,这个类很简单,在 StartupCommand 中只是设置了 lookandfeel,然后就调用系统中已经注册了的 LoginScreenMediator 类的对象,然后让其显示在桌面上,限于 Swing 的 EDT 特性,所有这些工作都放在 SwingUtilities.invokeLater 中执行。
本例中 StartupCommand 没有执行太复杂的工作,但是实际运行的系统,就可以根据需要在 StartupCommand 中各种需要执行的初始化工作。
清单 2. StartupCommand.java 的源码
package login; import javax.swing.SwingUtilities; import javax.swing.UIManager; import javax.swing.UIManager.LookAndFeelInfo; import org.puremvc.java.interfaces.INotification; import org.puremvc.java.patterns.command.SimpleCommand; public class StartupCommand extends SimpleCommand implements Runnable{ @Override public void run() { try { for (LookAndFeelInfo info : UIManager.getInstalledLookAndFeels()) { if ("Nimbus".equals(info.getName())) { UIManager.setLookAndFeel(info.getClassName()); break; } } LoginScreenMediator mediator = (LoginScreenMediator) this.facade. retrieveMediator(LoginScreenMediator.NAME); mediator.show(); } catch (Exception e) {} } @Override public void execute(INotification notification) { SwingUtilities.invokeLater(this); } }
下面我们接着看 LoginScreenMediator 类。
清单 3. LoginScreenMediator.java 的源码
package login; import java.awt.event.*; import javax.swing.*; import org.puremvc.java.interfaces.INotification; import org.puremvc.java.patterns.mediator.Mediator; import org.puremvc.java.patterns.observer.Notification; public class LoginScreenMediator extends Mediator implements ActionListener{ public static final String NAME = "LoginScreenMediator"; private LoginScreen dialog; public LoginScreenMediator() { super(NAME, null); } public void show(){ dialog = new LoginScreen(new javax.swing.JFrame(), true); dialog.addWindowListener(new java.awt.event.WindowAdapter() { public void windowClosing(java.awt.event.WindowEvent e) { System.exit(0); } }); dialog.btnLogin.addActionListener(this); dialog.setVisible(true); } public String[] listNotificationInterests() { return new String[] { LoginFacade.LOGIN_SUCCESSFUL, LoginFacade.LOGIN_FAIL }; } public void handleNotification(INotification note) { String noteName = note.getName(); if (LoginFacade.LOGIN_SUCCESSFUL.equals(noteName)) { JOptionPane.showMessageDialog(null, "Login ok!"); System.exit(0); } else if (LoginFacade.LOGIN_FAIL.equals(noteName)) { JOptionPane.showMessageDialog(null, "Login failed, try again"); } } @Override public void actionPerformed(ActionEvent e) { String name = dialog.userName.getText(); String pass = new String(dialog.password.getPassword()); LoginVO userInfo = new LoginVO( name, pass ); this.facade.notifyObservers(new Notification(LoginFacade.SUBMIT_LOGIN, userInfo, null)); } }
一般来说,Mediator 这个类负责管理视图,即 Swing 控件或者控件组,同时响应用户的操作。本例中的 LoginScreenMediator 管理了 LoginScreen 这个 Swing 控件。LoginScreenMediator 的 show 函数的工作首先初始化 LoginScreen,LoginScreen 就是我们显示给用户看的 JDialog 子类,其中有两个 JLabel,一个 JText Field,一个 JPassword Field 和一个按钮,这里就不列出 LoginScreen 的代码,可以在附件中的源码查看详细代码。
LoginScreenMediator 的 show 函数然后注册了 Login 按钮的 ActionEvent 事件,然后就显示了 LoginScreen 控件。到此为止,用户界面的显示工作就完成了。LoginScreenMediator 类中另外一个需要注意的地方是 listNotificationInterests,在这个方法中该类说明了它所关注的 Notification:LOGIN_SUCCESSFUL 和 LOGIN_FAIL。以后一旦有出现了这两个 Notification,LoginScreenMediator 类的 handleNotification 函数就会被调用。
下面我们来看用户事件处理部分,界面显示之后,一旦用户点击填入用户名和密码,然后点击 Login 按钮,就会触发 LoginScreenMediator 的 public void actionPerformed(ActionEvent e) 函数,在这个函数中只是获取用户名和密码,然后把得到的信息,通过 SUBMIT_LOGIN 这个 Notification 发送出去,因为本类的工作只是负责管理 View,具体如何验证登陆信息则不是它关注的范围,自然有其他 Command 处理。
在前面的 LoginFacade 中注册了一个 LoginCommand 类来处理 SUBMIT_LOGIN 这种类型的 Notification,下面是 LoginCommand 的源码。
清单 4. LoginCommand.java 的源码
package login; import org.puremvc.java.interfaces.INotification; import org.puremvc.java.patterns.command.SimpleCommand; public class LoginCommand extends SimpleCommand { @Override public void execute(INotification notification) { UsersProxy usersProxy = (UsersProxy) his.facade.retrieveProxy(UsersProxy.NAME); LoginVO userInfo = (LoginVO) notification.getBody(); if(usersProxy.checkLogin(userInfo)){ sendNotification(LoginFacade.LOGIN_SUCCESSFUL, null, null); } else { sendNotification(LoginFacade.LOGIN_FAIL, null, null); } } }
LoginCommand 接收到 Notification 之后,首先获取其中的附加信息(用户名和密码),然后通过系统中已经注册的 UsersProxy 来检查用户名和密码是否,如果正确,就发送 LOGIN_SUCCESSFUL 的 Notification,否则就发送 LOGIN_FAIL 的 Notification。本例中 UsersProxy 的功能非常简单,只是检查一个内存中 map,看看接收的用户名和密码,是否和已经保存在 map 中预设值数据是否一致,实际上,这里也可以通过检查 LDAP 或者数据库之类的 UserStore 来执行,效果是类似的。
下面我们看 LOGIN_SUCCESSFUL 和 LOGIN_FAIL 的 Notification 的处理,前面提到 LoginScreenMediator 类关注这两个 Notification,所以它会在 handleNotification 函数中处理这两个 Notification,限于示例,程序的功能就只是给用户提示一个登陆成功或失败的消息。
以上就是演示代码的所有功能,从基本的代码结构来看,类比较多,但是大家可以看到每个类都很简单,职责也很清楚,同时每个 Command、Proxy 和 Mediator 类之间的耦合度很小,Mediator 和 Proxy 甚至都不知道对方的存在,也依赖 Command 类,这样一来,Proxy 和 Mediator 的复用程度变高了。
另外 Notification 机制,大家可以看到程序有很强的类似工作流的性质,其实在实际使用过程中,完全可以根据需求分析的结果,结合工作流来定义 Notification。 Notification 和 Swing 事件不一样,它不关注于用户的键盘等 UI 事件,它关注业务流程,所以也是一个非常有力帮助需求人员和设计人员之间的沟通。
总结
PureMVC 框架作为一个成熟的通用框架,具有以下优点:
- 轻量级的库,简洁适度的设计
- 极大的降低耦合度
- 大量的文档和成熟的应用范例
- 平台语言无关
- 减少复杂度,让熟悉 MVC 概念的设计人员之间沟通更容易
- 代码简洁,简单易学
- 不依赖任何第三方的库
从上面的介绍中,我们可以看到,在一个项目中根据实际情况整合 PureMVC 框架,可以让可以使得和 UI(不限于 Swing)相关部分设计更简洁,并提供更多的可复用组件,增强需求和设计之间的沟通效果,有效提高项目的设计质量。