flex j2ee整合

本文摘自http://www.ibm.com/developerworks/cn/java/j-lo-jeeflex/#listing1

 

将 Flex 集成到 Java EE 应用程序的最佳实践

传统的 Java EE 应用程序通常使用某种 MVC 框架（例如，Struts）作为前端用户界面，随着 Flex 的兴起，基于 RIA 的客户端能够给用户带来更酷的界面，更短的响应时间，以及更接近于桌面应用程序的体验。本文将讲述如何将 Flex 集成至一个现有的 Java EE 应用程序中，以及如何应用最佳实践高效率地并行开发 Java EE 和 Flex。

开发环境

本文的开发环境为 Windows 7 Ultimate，Eclipse 3.4，Flex Builder 3（从 参考资源 获得下载链接）。Java EE 服务器使用 Resin 3.2，当然，您也可以使用 Tomcat 等其他 Java EE 服务器。

 

现有的 Java EE 应用

假定我们已经拥有了一个管理雇员信息的 Java EE 应用，名为 EmployeeMgmt-Server，结构如 图 1 所示：

图 1. Java EE 工程结构

这是一个典型的 Java EE 应用，使用了流行的 Spring 框架。为了简化数据库操作，我们使用了内存数据库 HSQLDB。对这个简单的应用，省略了 DAO，直接在 Façade 中通过 Spring 的 JdbcTemplate 操作数据库。最后，EmployeeMgmt 应用通过 Servlet 和 JSP 页面为用户提供前端界面：

图 2. EmployeeMgmt Web 界面

该界面为传统的 HTML 页面，用户每次点击某个链接都需要刷新页面。由于 Employee Management 系统更接近于传统的桌面应用程序，因此，用 Flex 重新编写界面会带来更好的用户体验。

 

 

集成 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

public class FlexServiceImpl implements FlexService {     private static final Employee[] EMPTY_EMPLOYEE_ARRAY = new Employee[0];     private Facade facade;       public void setFacade(Facade facade) {         this.facade = facade;     }       public Employee createEmployee(String name, String title, boolean gender,         Date birth) {         return facade.createEmployee(name, title, gender, birth);     }       public void deleteEmployee(String id) {         facade.deleteEmployee(id);     }       public Employee[] queryAll() {         return facade.queryAll().toArray(EMPTY_EMPLOYEE_ARRAY);     }       public Employee[] queryByName(String name) {         return facade.queryByName(name).toArray(EMPTY_EMPLOYEE_ARRAY);     } }

 

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

清单 3. BlazeDS 依赖的 Jar

backport-util-concurrent.jar commons-httpclient.jar commons-logging.jar flex-messaging-common.jar flex-messaging-core.jar flex-messaging-proxy.jar flex-messaging-remoting.jar

 

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

清单 4. 定义 Flex Listener

<listener>     <listener-class>flex.messaging.HttpFlexSession</listener-class> </listener>

 

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

清单 5. 定义 Flex servlet

<servlet>     <servlet-name>messageBroker</servlet-name>     <servlet-class>flex.messaging.MessageBrokerServlet</servlet-class>     <init-param>         <param-name>services.configuration.file</param-name>         <param-value>/WEB-INF/flex/services-config.xml</param-value>     </init-param>     <load-on-startup>0</load-on-startup> </servlet>   <servlet-mapping>     <servlet-name>messageBroker</servlet-name>     <url-pattern>/messagebroker/*</url-pattern> </servlet-mapping>

 

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="flexService">     <properties>         <source>org.expressme.employee.mgmt.flex.FlexServiceImpl</source>         <scope>application</scope>     </properties> </destination>

 

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

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

清单 7. 通过 factory 定义 flexService

<destination id="flexService">     <properties>         <factory>flexFactory</factory>         <source>flexService</source>         <scope>application</scope>     </properties> </destination>

 

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

清单 8. 定义 flexFactory

<factories>     <factory id="flexFactory" class="org.expressme.employee.mgmt.flex.FlexFactoryImpl"/> </factories>

 

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

1         创建 FactoryInstance 对象；

2         通过 FactoryInstance 对象查找我们需要的 FlexService。

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

清单 9. SpringFactoryInstance class

class SpringFactoryInstance extends FactoryInstance {     private Log log = LogFactory.getLog(getClass());       SpringFactoryInstance(FlexFactory factory, String id, ConfigMap properties) {         super(factory, id, properties);     }       public Object lookup() {         ApplicationContext appContext = WebApplicationContextUtils.                 getRequiredWebApplicationContext(                     FlexContext.getServletConfig().getServletContext()         );         String beanName = getSource();         try {             log.info("Lookup bean from Spring ApplicationContext: " + beanName);             return appContext.getBean(beanName);         }         catch (NoSuchBeanDefinitionException nex) {             ...         }         catch (BeansException bex) {             ...         }         catch (Exception ex) {             ...         }     } }

 

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

清单 10. FlexFactoryImpl class

public class FlexFactoryImpl implements FlexFactory {     private Log log = LogFactory.getLog(getClass());       public FactoryInstance createFactoryInstance(String id, ConfigMap properties) {         log.info("Create FactoryInstance.");         SpringFactoryInstance instance = new SpringFactoryInstance(this, id, properties);         instance.setSource(properties.getPropertyAsString(SOURCE, instance.getId()));         return instance;     }       public Object lookup(FactoryInstance instanceInfo) {         log.info("Lookup service object.");         return instanceInfo.lookup();     }       public void initialize(String id, ConfigMap configMap) {     } }

 

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

1.     BlazeDS 将首先创建 FlexFactory 的实例—— FlexFactoryImpl；

2.     当接收到

Flex