基于Maven的Flex/Webapp项目示例
这是一个配置为多模块maven项目的Flex3/J2EE项目示例。你可以以这种结构为基础来构建自己的项目。Flex项目应当看作是Web应用项目(WAR)的依赖项。使用Maven Dependency插件，SWF构件就会被自动复制到web应用项目的根目录中。
此示例项目包括三个模块：
- flex-gui :SWF构件，
- java-service : Java facade 示例，
- web-app : Web应用程序，同时依赖于flex-ui和java-services构件.
flex-gui 项目
“flex-gui”项目是一个典型的包含.as和.mxml源文件的Flex项目。这个模块产生SWF构件（组装：SWF）。
java-service 项目
“java-service”项目是一个包含java facade的标准java项目，该java façade为GUI提供原始数据源。这个模块产生JAR构件（组装：JAR）。
web-app 项目
“web-app”项目是包含配置文件的Web应用程序项目，这些配置文件需部署到Tomcat等应用服务器容器中。其他资源如JSP, Servlet，图片等也需要包括进来。这个模块产生WAR构件（组装：WAR）。
在你自己的项目中也可以添加其他模块进来，进一步增强业务层或持久层。
必要条件
创建这个项目需要 :
- Maven 2.0.x,
- 最新版的BlazeDS-Turnkey或者Tomcat 实例.
依赖项
- 示例基于Maven Flex Plugin 2.1.1. 更多信息请参见项目主页.
- Flex SDK版本3.2.0.3958.
- FlexBuilder 3.0.2.xxx集成开发环境,或其它文本编辑器.
多模块项目布局
...
+sampleProject
-pom.xml ( the parent pom )
+flex-gui
-pom.xml
+src
+main
+flex
+ org.servebox.sample ( All as/mxml sources here )
+resources
+test
+flex
+ org.servebox.test.sample ( All classes for unit test here )
+java-service
-pom.xml
+src
+main
+java
+ org.servebox.sample ( All java sources here )
+test
+java
+ org.servebox.test.sample ( All classes for unit tests here )
+web-app
-pom.xml
+src
+main
+resources
- additional resources for webapp ( such as images, video etc... )
+webapp
+WEB-INF
+flex
-services-config.xml
-web.xml
POM概述
父类POM
Main部分
父类pom使用这个pom组装(这是“aggregator project”) :
<modelVersion>4.0.0</modelVersion>
<groupId>org.servebox.sample.multi-module-app</groupId>
<artifactId>multi-module-sample</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging>
<name>Flex3-J2EE-MultiModules-Sample-Application</name>
Modules部分
模块部分定义以下三个子模块:
<modules>
<module>flex-gui</module>
<module>java-service</module>
<module>web-app</module>
</modules>
插件存储库和存储库
以下插件存储库直接定义了Maven Flex 插件的位置：
<pluginRepositories>
<pluginRepository>
<id>servebox</id>
<name>ServeBox Plugin Repository</name>
<url>http://maven.servebox.org/repository</url>
</pluginRepository>
</pluginRepositories>
以下存储库定义了Flex SDK和ActionScript Foundry依赖项的位置：
<repositories>
<repository>
<id>servebox</id>
<name>ServeBox Plugin Repository</name>
<url>http://maven.servebox.org/repository</url>
</repository>
</repositories>
Build部分
将项目导入到Eclipse/FlexBuilder工作空间
通过Maven Eclipse插件和Maven Flex插件， Maven可以针对Flex、Java特性自动生成eclipse项目属性文件。下载实例项目，加压到你的工作空间目录，为这个多模块项目另外创建一个工作空间目录，然后在该多模块项目的根目录下运行以下命令行代码：
mvn flex:eclipse eclipse:eclipse
在导入“现有项目”到工作空间后，你需要定义M2_REPO变量便于Flex和Java使用，参看以下两个截图：
构建项目
首先, 你得在根项目的pom.xml中定义相关属性：
<properties>
<tomcat.managerurl>http://localhost:8400/manager</tomcat.managerurl>
<tomcat.serverprofile></tomcat.serverprofile>
<webapp.name>sample-multi-project</webapp.name>
<tomcat.server.root>D:\dev\blazeds-turnkey-3.2.0.3978\tomcat\webapps\${webapp.name}</tomcat.server.root>
<tomcat.server.user>tomcat</tomcat.server.user>
<tomcat.server.password>tomcat</tomcat.server.password>
</properties>
上述配置可以根据自己的实际环境加以更改。
这个项目可能使用单个命令就可以构建。使用命令行工具，从根目录运行“mvn clean install”：包含在reactor中的所有项目将会被构建，并安装在你本地Maven存储库中 (默认情况下： ~/.m2/repository).
如果你想要这个应用程序自动部署到tomcat中，使用 “tomcat：exploded”，并确保：
- Tomcat实例处于运行中，
- 配置文件${tomcat.root]/conf/tomcat-users.xml包含“tomcat”用户 (这个对象用户Mavean管理Tomcat实例) :
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="tomcat"/>
<role rolename="manager"/>
<role rolename="admin"/>
<user username="tomcat" password="tomcat" roles="tomcat,admin,manager"/>
<user username="admin" password="" roles="admin,manager"/>
</tomcat-users>
下载源代码
使用以下路径下载本文使用的源代码文件: multi-module-sample-10-snapshot-source
Tags: flex-gui, java-service, web-app