中国平安保险（集团）股份有限公司
信息管理中心
名称 PingAn PAFA3 编 号 版本号 密 级 版本 v0.1 v0.5 v1.0 秘密 共 42 页 拟 制 审 核 批 准 马骏、Richard Jin 更改日期 2005-04-11 2005-04-13 2005-04-19
更改信息 部门及更改人 Richard Jin Richard Jin, 马骏，刘申岭 Richar Jin 版本说明 初版 重构 Review & Formatting
PAFA3应用开发入门教程
创建日期：2005-4-8 定版日期：2004-4-20
本文内容涉及中国平安保险（集团）股份有限公司商业秘密，未经书面许可，不得以任何形式披露、传播或扩散。
?中国平安保险（集团）股份有限公司，版权所有，不得侵犯
第 1 页 共 43 页
目录
1. 文档概述 ............................................................................................................................................................... 4 1.1 1.2 1.3 1.4 1.5 1.6
读者定位 ....................................................................................................................................................... 4 限制与约定 ................................................................................................................................................... 4 相关参考文档 ............................................................................................................................................... 4 软、硬件要求 ............................................................................................................................................... 4 示例应用的功能设定 ................................................................................................................................... 4 页面预览 ....................................................................................................................................................... 5
2. 开发环境配置 ....................................................................................................................................................... 7 2.1 2.2 2.3 2.4
安装ECLIPSE ................................................................................................................................................. 7 下载PAFA3类库和项目模板 ..................................................................................................................... 9 数据库表的设计 ......................................................................................................................................... 10 配置WEBLOGIC数据源 .............................................................................................................................. 11
3. 使用项目模板 ..................................................................................................................................................... 13 3.1 3.2 3.3 3.4
在ECLIPSE中导入项目模板 ....................................................................................................................... 13 ANT视图的配置与使用 .............................................................................................................................. 15 ECLIPSE 自动编译设置 ............................................................................................................................... 16 配置文件的分类、目的与作用.................................................................................................................. 18
4. 页面布局设计与实现 ......................................................................................................................................... 19 4.1 4.2 4.3 4.4 4.5
.DO和.SCREEN .............................................................................................................................................. 19 布局分析与设计 ......................................................................................................................................... 19 布局的配置 ................................................................................................................................................. 21 利用ANT构建部署目录 ............................................................................................................................. 22 WEBLOGIC部署测试 ................................................................................................................................... 23
5. “增加用户”功能的设计与实现 ..................................................................................................................... 25 5.1 5.2 5.3 5.4 5.5 5.6 5.7
功能分析 ..................................................................................................................................................... 25 公用层设计与实现 ..................................................................................................................................... 25 WEB层开发与实现 ..................................................................................................................................... 27 配置IBATIS SQLMAPPING ........................................................................................................................... 29 BIZ层开发与实现 ....................................................................................................................................... 29 编辑配置文件 ............................................................................................................................................. 32 WEBLOGIC部署测试 ................................................................................................................................... 33
6. “检索用户”功能的设计与实现 ..................................................................................................................... 35 6.1 6.2 6.3 6.4 6.5 6.6 6.7
功能分析 ..................................................................................................................................................... 35 公用层设计与实现 ..................................................................................................................................... 35 WEB层开发与实现 ..................................................................................................................................... 36 配置IBATIS SQLMAPPING ........................................................................................................................... 37 BIZ层开发与实现 ....................................................................................................................................... 38 编辑配置文件 ............................................................................................................................................. 41 WEBLOGIC部署测试 ................................................................................................................................... 42
7. 生产环境下的部署 ............................................................................................................................................. 43 7.1
禁止DEVLOG输出 ..................................................................................................................................... 43
本文内容涉及中国平安保险（集团）股份有限公司商业秘密，未经书面许可，不得以任何形式披露、传播或扩散。
?中国平安保险（集团）股份有限公司，版权所有，不得侵犯
第 2 页 共 43 页
7.2
构建EAR发布包........................................................................................................................................ 43
本文内容涉及中国平安保险（集团）股份有限公司商业秘密，未经书面许可，不得以任何形式披露、传播或扩散。
?中国平安保险（集团）股份有限公司，版权所有，不得侵犯
第 3 页 共 43 页
1.
1.1
文档概述
读者定位
本文档的目的是为了使用户初步了解PAFA3应用的基本开发环境和开发模式
1.2 ? ? ?
限制与约定
本文档涉及很多的pafa 和 j2ee 的概念和术语，请参考相关文档。
当涉及到其它技术和工具时，只会提示查阅相关资料，在本文中不做讨论。
Eclipse是本文所使用的集成开发环境，由于本文的主要目的并非讨论Eclipse本身，所以只会介绍安装和配置最基本的功能，使用建立文件的方式进行开发。有关Eclipse更多的使用方法和增加插件进行功能增强，请参考其相关文档。
有关Weblogic的安装、使用和配置，请参考其产品文档，本文只简要介绍与本例相关的内容。文档不提供DataSource 等配置的说明文档，请找熟悉j2ee的同事帮助配置DataSource。 本文不涉及关于调试的内容。
由于本文不涉及如何利用Eclipse的增强功能进行源文件编辑，所以之后所提到的所有文件均以纯文本文件的形式创建并给出，参考时可以按照代码框中的内容编辑或拷贝。Java源文件的路径起点为“src\\java”，Web资源如JSP等的源文件路径起点为“src\\webroot”。在Eclipse目录浏览框中相应的目录节点上，点击鼠标右键，选择“新建”? “文件”来创建上述文件，如果包含多重目录，则应该先创建“目录”。 相关参考文档
? ? ?
1.3 ? ? ? ?
本文只介绍最基本的开发环境与过程，其它内容请参考标准文档和演示程序，如： PAFA3开发规范与指南
PAFA Demos（Web Demo，App Demo） FAQ
源文件请参考文档对应的源代码
软、硬件要求
本文基于以下基本软、硬件设定：
Windows 操作系统【2000、XP】 J2SDK 1.4.2【本机安装】
Weblogic 8.1 Application Server【本机安装】
Oracle Database 【8i 以上版本，拥有连接和资源权限即可，不要求本机安装】 建议内存 > 512M
以上指定系统或软件的安装请参考其相关文档，本文不做讨论。
1.4
? ? ? ? ?
1.5 示例应用的功能设定
在这个PAFA3应用入门教程中，将利用pafa3的项目模版构建一个很小的例子用于示范。这个例子的主要功能是添加和检索用户。在这个例子中，假设系统名称为“userapp”，模块名称为
“management”。在用户利用模版构建自己真实应用的时候，请注意系统与模块的命名应该符合公司相关规范。简单的流程如下图所示：
本文内容涉及中国平安保险（集团）股份有限公司商业秘密，未经书面许可，不得以任何形式披露、传播或扩散。
?中国平安保险（集团）股份有限公司，版权所有，不得侵犯
第 4 页 共 43 页
在后续章节中将给出功能的分析和设计模型。 1.6
页面预览
为了对功能设定有直观的理解，在下面的图形中展示了开发完成之后所得到的显示界面：
a) 输入新用户信息
b) 成功录入 本文内容涉及中国平安保险（集团）股份有限公司商业秘密，未经书面许可，不得以任何形式披露、传播或扩散。
?中国平安保险（集团）股份有限公司，版权所有，不得侵犯
第 5 页 共 43 页