使用 Parsley 框架构建 Flex 应用程序

在最近研究了“Swiz”和“Spring ActionScript”（1、2、3）之后，我决定在新的 Parsley 框架版本中试验一下，构建 inSync（简单的 Contact Management 应用程序，我经常用于试验和演示 Flex 和 Adobe AIR 中的不同特性和技术）的 Parsley 版本。

Parsley 最初是一个依赖注入（Dependency Injection）框架。它还提供了一个非常有趣的消息传递基础结构。我不打算在此详细介绍依赖性注入：以前的 Swiz 和 Spring ActionScript 文章提供了一些背景信息，还详细列出了许多资源。
如果您只想运行应用程序并深入研究代码，可以访问以下链接：
单击此处运行应用程序。
单击此处查看源代码。
对象配置
Parsley 支持使用 MXML（比如 Swiz）、XML（比如 Spring ActionScript）、ActionScript 或者任意组合这些方法来配置应用程序的核心对象。可以扩展该框架并创建自己的配置机制。
对于 inSync 应用程序，我使用了一个简单的 MXML 配置（Config.mxml），其定义如下：

 <?xml version="1.0" encoding="utf-8"?> <Object xmlns="*" xmlns:mx="http://www.adobe.com/2006/mxml" xmlns:services="insync.parsley.services.*"> <mx:RemoteObject id="contactRO" destination="contacts" endpoint="http://localhost:8400/samples/messagebroker/amf" showBusyCursor="true" /> <services:ContactService /> </Object>

注意：在实际的应用程序中，您可能不希望在源代码中硬编码服务的端点。可以使用 XML 配置选项以更加“具体化”的形式配置端点。单击此处了解关于此主题的更多信息。
框架初始化
使用对应于所选配置方法的 ContextBuilder 类来初始化 Parsley 框架。下面是 inSync 应用程序的主应用程序文件。Parsley 在应用程序的 preinitialize 事件中初始化。 

<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns:views="insync.parsley.views.*" paddingTop="0" paddingLeft="0" paddingRight="0" paddingBottom="0" preinitialize="FlexContextBuilder.build(Config)"> <mx:Script> <!--[CDATA[ import org.spicefactory.parsley.flex.FlexContextBuilder; ]]--> </mx:Script> <mx:Style source="styles.css" /> <views:MainView /> </mx:Application>

依赖注入
 Parsley 支持构造函数注入、方法注入和属性注入（根据类型或 id 进行注入）。
在下面的例子（ContactForm.mxml）中，框架将注入 IContactService 接口的一个特定实现。在本例中，将注入在 Config.mxml 中创建的 ContactService 实例。这是一个按类型注入的示例。对接口进行编码可以将视图从特定的 IContactService 实现中解耦出来。
注意：Parsley 不会强迫您使用任何特定的设计模式。为了简单起见，在本示例应用程序中，我将一个服务直接注入到视图中。使用接口可以提供一定的解耦级别，但是您也可以使用其他模式（比如 Presentation Model）来获得更高的抽象级别。Parsley  的依赖注入（Dependency Injection）和消息传递（Messaging）基础结构使这些模式的实现更加简单。

<?xml version="1.0" encoding="utf-8"?> <mx:Canvas xmlns:mx="http://www.adobe.com/2006/mxml" addedToStage="dispatchEvent(new Event('configureIOC', true))"> <mx:Script> <!--[CDATA[ import insync.parsley.model.Contact; import insync.parsley.services.IContactService; [Inject] public var service:IContactService; [Bindable] public var contact:Contact; private function save():void { contact.firstName = firstName.text; contact.lastName = lastName.text; contact.email = email.text; service.save(contact); } private function remove():void { service.remove(contact); } ]]--> </mx:Script> <mx:Form> <mx:FormItem label="Id"> <mx:TextInput text="{contact.id}" enabled="false"/> </mx:FormItem> <mx:FormItem label="First Name"> <mx:TextInput id="firstName" text="{contact.firstName}"/> </mx:FormItem> <mx:FormItem label="Last Name"> <mx:TextInput id="lastName" text="{contact.lastName}"/> </mx:FormItem> <mx:FormItem label="Email"> <mx:TextInput id="email" text="{contact.email}"/> </mx:FormItem> </mx:Form> <mx:HBox left="12" bottom="12"> <mx:Button label="Save" click="save()"/> <mx:Button label="Delete" click="remove()"/> </mx:HBox> </mx:Canvas>

注意，为了在将视图添加到舞台上时注入其依赖性，视图必须分派“configureIOC”事件。
消息传递
Parsley 提供了一种通用消息传递基础结构，支持以一种解耦的、灵活且易用的方式在对象之间交换消息：
事件分派程序和时间处理程序彼此互不了解。
事件分派程序和事件处理程序已从框架中解耦出来：可以以 Flex 的方式分派事件。
作为一个示例，我们看一下 inSync 中的搜索特性：
Toolbar 类包含一个简单的 TextInput，支持用户指定一个搜索条件。
ContactList 类在一个 DataGrid 中显示搜索结果。
Toolbar 类定义如下（为了保持条理清晰，已删除不重要的代码）：

<?xml version="1.0" encoding="utf-8"?> <mx:Canvas xmlns:mx="http://www.adobe.com/2006/mxml" width="100%" addedToStage="dispatchEvent(new Event('configureIOC', true))"> <mx:Metadata> [ManagedEvents("search")] </mx:Metadata> <mx:Script> <!--[CDATA[ import insync.parsley.events.SearchEvent; ]]--> </mx:Script> <mx:Label text="Search:" top="18" right="164"/> <mx:TextInput id="searchBox" right="0" top="16" change="dispatchEvent(new SearchEvent(SearchEvent.SEARCH, searchBox.text))"/> </mx:Canvas>

注意，它在搜索输入字段的内容发生变化时分派一个 SearchEvent 事件。
该事件被定义为一个托管事件（使用 ManagedEvents 注释），表示框架将确保关注该事件的所有实体都会收到该事件。
如何注册托管事件的监听器呢？只需使用 [MessageHandler] 注释一个函数，无论显示对象层次结构如何，或者无论事件是否浮升（bubble），该函数都会自动成为该事件的事件处理程序。
下面展示了如何在 ContactList 中注册监听器（为了保持条理清晰，已删除不重要的代码）：

<?xml version="1.0" encoding="utf-8"?> <mx:Canvas xmlns:mx="http://www.adobe.com/2006/mxml" width="100%" height="100%" addedToStage="dispatchEvent(new Event('configureIOC', true))"> <mx:Script> <!--[CDATA[ import mx.controls.Alert; import mx.collections.ArrayCollection; import mx.rpc.events.FaultEvent; import mx.rpc.AsyncToken; import mx.rpc.AsyncResponder; import mx.rpc.events.ResultEvent; import insync.parsley.events.SearchEvent; import insync.parsley.services.IContactService; [Inject] [Bindable] public var service:IContactService; [Bindable] public var contacts:ArrayCollection; [MessageHandler] public function searchHanlder(event:SearchEvent):void { service.getContactsByName(searchStr).addResponder(new AsyncResponder(getContacts_result, faultHandler)); } private function getContacts_result(event:ResultEvent, token:AsyncToken):void { contacts = event.result as ArrayCollection; } private function faultHandler(event:FaultEvent):void { Alert.show(event.fault.faultString); } ]]--> </mx:Script> <mx:DataGrid id="dg" dataProvider="{contacts}" width="100%" top="0" left="0" right="0" bottom="0"/> </mx:Canvas> 

借助简单的 [MessageHandler] 注释，每次在应用程序中分派函数参数的数据类型时都将调用该处理程序。如果您需要更严格的控制，可以使用选择器符号来指定事件类型。例如，在 MainView.mxml 中，我们将 contactDeleted 函数注册为 ContactEvent.DELETED 事件的一个处理程序，如下所示。

[MessageHandler(selector="contactDeleted")] public function contactDeletedHandler(event:ContactEvent):void { }  

Parsley 框架还有更多消息传递功能。例如，可以使用 [MessageBinding] 将一个对象的属性绑定到一个事件的对应属性。

[MessageBinding(messageProperty="result",type=" mx.rpc.events.ResultEvent")] public var contacts:ArrayCollection;  

安装说明
1 从此处下载项目
2 将其导入 Flex Builder
3 运行应用程序。应用程序默认配置为使用 MockService (ContactServiceMock)，所以它运行时不需要任何后端。
 如果希望使用 Remoting service 代替 MockService：
4 将 Config.mxml 中的 <services:ContactServiceMock/> 替换为 <services:ContactServiceRemote/>
5 安装功能全面的 BlazeDS 服务器。
6 下载 insync-parsley-java.zip 并将其解压到本地文件系统中。
7将 classes/insync 复制到 blazeds/tomcat/webapps/samples/WEB-INF/classes/insync 文件夹中。
8 将以下目标添加到 blazeds/tomcat/webapps/samples/WEB-INF/flex/remoting-config.xml 文件中：

 <destination id="contacts"> <properties> <source>insync.dao.ContactDAO</source> <scope>application</scope> </properties> </destination>

9 将 insync/sampledb/insync 复制到 blazeds/sampledb/insync 文件夹中
10 编辑 blazeds/sampledb 文件夹中的 server.properties，修改文件（如下所示），将 insync 数据库添加到启动步骤中。

server.database.0=file:flexdemodb/flexdemodb server.dbname.0=flexdemodb server.database.1=file:insync/insync server.dbname.1=insync server.port=9002 server.silent=true server.trace=false

11 启动数据库（startdb.bat 或 startdb.sh）
12 启动 BlazeDS
13 运行应用程序

本文来自：

http://coenraets.org/blog/2009/07/building-a-flex-application-with-the-parsley-framework/