集成 BlazeDS

如何将 Flex 集成至该 Java EE 应用呢？现在，我们希望用 Flex 替换掉原有的 Servlet 和 JSP 页面，就需要让 Flex 和 Java EE 后端通信。Flex 支持多种远程调用方式，包括 HTTP，Web Services 和 AMF。不过，针对 Java EE 开发的服务器端应用，可以通过集成 BlazeDS，充分利用 AMF 协议并能轻易与 Flex 前端交换数据，这种方式是 Java EE 应用程序集成 Flex 的首选。

BlazeDS 是 Adobe LifeCycle Data Services 的开源版本，遵循 LGPL v3 授权，可以免费使用。BlazeDS 为 Flex 提供了基于 AMF 二进制协议的远程调用支持，其作用相当于 Java 的 RMI。有了 BlazeDS，通过简单的配置，一个 Java 接口就可以作为服务暴露给 Flex，供其远程调用。

尽管现有的 EmployeeMgmt 应用程序已经有了 Façade 接口，但这个接口是暴露给 Servlet 使用的，最好能再为 Flex 定义另一个接口 FlexService，并隐藏 Java 语言的特定对象（如 清单 1 所示）：

清单 1. FlexService interface

public interface FlexService { 
    Employee createEmployee(String name,String title,boolean gender,Date birth); 
    void deleteEmployee(String id); 
    Employee[] queryByName(String name); 
    Employee[] queryAll(); 
}

现在，Java EE 后端与 Flex 前端的接口已经定义好了，要完成 Java EE 后端的接口实现类非常容易，利用 Spring 强大的依赖注入功能，可以通过几行简单的代码完成：

清单 2. FlexServiceImpl class

然后，我们将 BlazeDS 所需的 jar 包放至 /WEB-INF/lib/。BlazeDS 需要如下的 jar：

清单 3. BlazeDS 依赖的 Jar

在 web.xml 中添加 HttpFlexSession 和 Servlet 映射。HttpFlexSession 是 BlazeDS 提供的一个 Listener，负责监听 Flex 远程调用请求，并进行一些初始化设置：

清单 4. 定义 Flex Listener

MessageBrokerServlet 是真正处理 Flex 远程调用请求的 Servlet，我们需要将其映射到指定的 URL：

清单 5. 定义 Flex servlet

BlazeDS 所需的所有配置文件均放在 /WEB-INF/flex/ 目录下。BlazeDS 将读取 services-config.xml 配置文件，该配置文件又引用了 remoting-config.xml、proxy-config.xml 和 messaging-config.xml 这 3 个配置文件，所以，一共需要 4 个配置文件。

由于 BlazeDS 需要将 Java 接口 FlexService 暴露给 Flex 前端，因此，我们在配置文件 remoting-config.xml 中将 FlexService 接口声明为一个服务：

清单 6. 定义 flexService 服务

服务名称通过 destination 的 id 属性指定，Flex 前端通过该服务名称来进行远程调用。scope 指定为 application，表示该对象是一个全局对象。

然而，按照默认的声明，BlazeDS 会去实例化 FlexService 对象。对于一个 Java EE 应用来说，通常这些服务对象都是被容器管理的（例如，Spring 容器或 EJB 容器），更合适的方法是查找该服务对象而非直接实例化。因此，需要告诉 BlazeDS 通过 Factory 来查找指定的 FlexService 对象，修改配置如下：

清单 7. 通过 factory 定义 flexService

现在，Flex 如何才能通过 BlazeDS 调用 FlexService 接口呢？由于 FlexService 对象已经被 Spring 管理，因此，我们需要编写一个 FlexFactory 告诉 BlazeDS 如何找到 Spring 管理的 FlexService 的实例。flexFactory 在 services-config.xml 中指定：

清单 8. 定义 flexFactory

FlexFactoryImpl 实现了 FlexFactory 接口，该接口完成两件事情：

1. 创建 FactoryInstance 对象；
2. 通过 FactoryInstance 对象查找我们需要的 FlexService。

因此，需要一个 FactoryInstance 的实现类，我们编写一个 SpringFactoryInstance，以便从 Spring 的容器中查找 FlexService：

清单 9. SpringFactoryInstance class

FlexFactoryImpl 负责实例化 SpringFactoryInstance 并通过 SpringFactoryInstance 的 lookup() 方法查找 FlexService 接口对象：

清单 10. FlexFactoryImpl class

以下是 BlazeDS 查找 FlexService 接口的过程：

1. BlazeDS 将首先创建 FlexFactory 的实例—— FlexFactoryImpl；
2. 当接收到 Flex 前端的远程调用请求时，BlazeDS 通过 FlexFactory 创建 FactoryInstance 对象，并传入请求的 Service ID。在这个应用程序中，被创建的 FactoryInstance 实际对象是 SpringFactoryInstance；
3. FactoryInstance 的 lookup() 方法被调用，在 SpringFactoryInstance 中，首先查找 Spring 容器，然后，通过 Bean 的 ID 查找 Bean，最终，FlexService 接口的实例被返回。

注意到 destination 的 id 并没有写死在代码中，而是通过以下语句获得的：

清单 11. 获取 destination 的 ID

Property 的 SOURCE 属性由 BlazeDS 读取 XML 配置文件获得：

清单 12. 配置 destination 的 id

 开发 Flex 客户端 
      
 首先安装 Flex Builder 3，可以在 Adobe 的官方网站获得 30 天免费试用版。然后，打开 Flex Builder 3，创建一个新的 Flex Project，命名为 EmployeeMgmt-Flex：
 
      
 图 3. 新建 Flex 工程 - 第一步
 
      
 Flex Project 需要指定 Server 端的配置文件地址：
 
      
 图 4. 新建 Flex 工程 - 第二步
 
      
 因此，需要填入 EmployeeMgmt-Server 项目的 web 根目录，该目录下必须要存在 /WEB-INF/flex/。点击“Validate Configuration”验证配置文件是否正确，只有通过验证后，才能继续。默认地，Flex Builder 将会把生成的 Flash 文件放到 EmployeeMgmt-Server 项目的web/EmployeeMgmt-Flex-debug 目录下。
 
      
 一个 Flex Project 的目录结构如下：
 
      
 图 5. Flex 工程的目录结构
 
      
 用 Flex Builder 做出漂亮的用户界面非常容易。Flex Builder 提供了一个可视化的编辑器，通过简单的拖拽，一个毫无经验的开发人员也能够设计出漂亮的布局。如果熟悉一点 XML 的知识，编辑 MXML 也并非难事。我们设计的 Employee Management 系统界面的最终效果如下：
 
      
 图 6. 用 Flex Builder 的可视化编辑器设计界面
 
      
 本文不打算讨论如何编写 Flex 界面，而是把重点放在如何实现远程调用。
 
      
 为了能在 Flex 中实现远程调用，我们需要定义一个 RemoteObject 对象。可以通过 ActionScript 编码创建该对象，也可以直接在 MXML 中定义一个 RemoteObject 对象，并列出其所有的方法：
 
      
 清单 13. 定义 flexServiceRO
 
      
 
       @H_301_106@<mx:RemoteObject id="flexServiceRO" destination="flexService"> 
    <mx:method name="queryAll" result="handleQueryAll(result : ResultEvent)"/> 
</mx:RemoteObject>

现在，就可以调用这个名为 flexServiceRO 的 RemoteObject 对象的方法了：

清单 14. 调用 FlexServiceRO.queryAll()

运行该 Flex Application，雇员信息已经被正确获取了：

图 7. 在浏览器中运行 Flex application