编译整个 MedRec 项目

前面的教程说明了如何编译、生成和部署各个 MedRec 应用程序的组成部分。在本教程中，使用项目级别 build.xml 文件编译和生成整个 MedRec 应用程序套件。编译整个应用程序套件对于在系统上部署所有组件以及验证 MedRec 是否正在运行且可用是必要的。

本教程包括：

* 前提条件
* 过程
* 最佳实践
* 重点
* 相关内容

[@more@]前提条件

按照教程 5：创建 MedRec 项目目录中的说明创建项目目录。


过程

项目目录包含一个 build.xml 主脚本，该脚本以正确的顺序编译和暂存所有 MedRec 应用程序。要运行此脚本，请执行下列操作：

1. 打开命令外壳并设置开发环境：

prompt> c:beauser_projectsdomainsMedRecDomainbinsetDomainEnv.cmd

2. 移至 MedRec 项目目录的 src 子目录：

prompt> cd c:medrec_tutorialsrc

3. 使用 Ant 命令执行具有 deploy.dev 目标的 build.xml 主脚本：

prompt> ant deploy.dev

生成过程显示指明每个应用程序进度的消息。整个生成过程大约需要 2 到 5 分钟才能完成，具体取决于计算机的速度。脚本完成后应该显示以下信息：

build:
[echo] #### E N D M E D R E C ####

BUILD SUCCESSFUL
Total time: 2 minutes 22 seconds


最佳实践

* 并非所有项目都需要主生成脚本。如果只是创建单个企业应用程序或企业应用程序的单个组件，则使用 WebLogic Ant 任务的单个 build.xml 文件就已足够。
* 如果项目需要按特定顺序编译多个企业应用程序（因为共享的实用工具类或 Web Service 依赖关系），则可以使用 build.xml 源级主文件在每个应用程序的 build.xml 文件之间迭代。


重点

MedRec 应用程序套件有许多需要在生成过程中协调的依赖关系。当您运行主生成文件时，将发生以下事件：

1. 使用 wlcompile 任务编译 startBrowserEar 和 initEar 的内容。
2. 使用 javac 任务编译 security 目录的内容。
3. 编译 common 的内容。common 目录包含不同的 MedRec 应用程序所用的几种对象的 Java 源代码。
* 实用工具类 - 在整个应用程序套件、异常、工厂和 ServiceLocator 类中使用的常量。MedRec 应用程序套件 Web 层中的 Servlet 使用 ServiceLocator 查找 Enterprise JavaBean 等一般服务。
* 值对象 - 表示在 MedRec 套件的层之间传递的数据的类。
* 操作类 - Struts 框架用来控制 MedRec 套件 Web 层中页面流的类。
* JavaBean - 在 Web 层中使用的组件 Bean。
4. 编译 medrecEar 企业应用程序。尽管 medrecEar 使用拆分开发目录结构并在生成脚本中使用 WebLogic Ant 任务，应用程序还是有几个内部依赖关系硬编码在它的 build.xml 脚本中，对 wlcompile 使用 include 和 exclude 选项。
5. 编译 physicianEar 应用程序。该应用程序中的 Web Service 客户端调用 physicianEar 和 medrecEar 应用程序的 Web Service，这些客户端从先前由 jwsc Web Service Ant 任务生成到 build 目录的 .wsdl 文件生成。
6. 编译位于 clients 目录的 MedRec 应用程序套件客户端应用程序。

build.xml 主文件的 deploy.dev 目标采用附加步骤为每个应用程序（initEar、medrecEar 等等）打包 build 目录的内容，并且在 dist 目录中为每个应用程序创建展开的目录。这些展开的目录可以用标准方法部署到 WebLogic Server，在拆分开发目录框架之外。此套件中接下来的教程（教程 14：打包 MedRec 进行分发和教程 15：使用 WLST 和管理控制台部署 MedRec 包进行生产）将对此进行深入的探讨。