pafa3应用开发入门教程

PAFA3应用开发入门教程

创建日期：2005-4-8 定版日期：2004-4-20

中国平安保险（集团）股份有限公司 信息管理中心

目录

1.文档概述 (4)

1.1读者定位 (4)

1.2限制与约定 (4)

1.3相关参考文档 (4)

1.4软、硬件要求 (4)

1.5示例应用的功能设定 (4)

1.6页面预览 (5)

2.开发环境配置 (7)

2.1安装E CLIPSE (7)

2.2下载PAFA3类库和项目模板 (9)

2.3数据库表的设计 (10)

2.4配置W EBLOGIC数据源 (11)

3.使用项目模板 (13)

3.1在E CLIPSE中导入项目模板 (13)

3.2A NT视图的配置与使用 (15)

3.3E CLIPSE 自动编译设置 (16)

3.4配置文件的分类、目的与作用 (18)

4.页面布局设计与实现 (19)

4.1.DO和.SCREEN (19)

4.2布局分析与设计 (19)

4.3布局的配置 (21)

4.4利用A NT构建部署目录 (22)

4.5W EBLOGIC部署测试 (23)

5.“增加用户”功能的设计与实现 (25)

5.1功能分析 (25)

5.2公用层设计与实现 (25)

5.3W EB层开发与实现 (27)

5.4配置I BATIS S QL M APPING (29)

5.5B IZ层开发与实现 (29)

5.6编辑配置文件 (32)

5.7W EBLOGIC部署测试 (33)

6.“检索用户”功能的设计与实现 (35)

6.1功能分析 (35)

6.2公用层设计与实现 (35)

6.3W EB层开发与实现 (36)

6.4配置I BATIS S QL M APPING (37)

6.5B IZ层开发与实现 (38)

6.6编辑配置文件 (41)

6.7W EBLOGIC部署测试 (42)

7.生产环境下的部署 (43)

7.1禁止D EV L OG输出 (43)

7.2构建EAR发布包 (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

●源文件请参考文档对应的源代码

1.4软、硬件要求

本文基于以下基本软、硬件设定：

●Windows 操作系统【2000、XP】

●J2SDK 1.4.2【本机安装】

●Weblogic 8.1 Application Server【本机安装】

●Oracle Database 【8i 以上版本，拥有连接和资源权限即可，不要求本机安装】

●建议内存> 512M

以上指定系统或软件的安装请参考其相关文档，本文不做讨论。

1.5示例应用的功能设定

在这个PAFA3应用入门教程中，将利用pafa3的项目模版构建一个很小的例子用于示范。这个例子的主要功能是添加和检索用户。在这个例子中，假设系统名称为“userapp”，模块名称为

“management”。在用户利用模版构建自己真实应用的时候，请注意系统与模块的命名应该符合公司相关规范。简单的流程如下图所示：

在后续章节中将给出功能的分析和设计模型。

1.6页面预览

为了对功能设定有直观的理解，在下面的图形中展示了开发完成之后所得到的显示界面：

a)输入新用户信息

b)成功录入

c)输入检索条件

d)检索结果

2.开发环境配置

2.1安装Eclipse

在安装Eclipse之前，需要获得两个相关的安装包，如下图所示：

上图所示Eclipse的版本号为“3.0.2”以及相对应的语言包。这两个安装文件均为ZIP格式，解压缩到指定目录即可，注意应该先解压缩Eclipse的安装文件包“eclipse-SDK-3.0.2-win32.zip”，再解压缩相应的语言包到Eclipse的安装目录，下图即为解压缩后的情况，Eclipse和语言包安装目录为

“E:\eclipse”：

此时基本的Eclipse安装就完成了，如果需要其它Eclipse插件，可以以后再安装。安装完成后点击“eclipse.exe”即可启动Eclipse，Eclipse会自动寻找本机所安装的JDK；还可以在桌面上创建一个链接到“eclipse.exe”的快捷方式。Eclipse启动时会提示选择工作空间的存储位置，使用默认即可，启动后的界面如下图所示：

在上图界面的链接中包括关于Eclipse的简介和教程，此外，通过Eclipse帮助也可以学习Eclipse的使用。关闭“欢迎使用”窗口后，显示界面如下图所示，从下图开始，我们将利用Eclipse进行一个简单应用的开发。

2.2下载PAFA3类库和项目模板

在进行PAFA3应用项目的开发前，首先应该获取相应的资源，包括：

●项目模板：一个已经格式化的目录ZIP压缩包，专门用于使用Eclipse进行PAFA3应用开发。

●Pafa类库：PAFA3应用的基本支持库，包括PAFA3类库和第三方类库。

●访问其它系统的所需的类库：如访问UM、CIF2等所需的类库。

资源的下载位置为“IT工作站/Pafa新架构”下相关位置。

在获取了相关资源后，按照下图的方式解压缩并进行组织，其中用红色框出的是应该按照项目要求进行重命名的部分：

在上图中，以“D:\MyProject\pafa3Template”为项目根目录，Pafa库和外部系统库均放置在“D:\MyProject\lib”目录下。关于PAFA3应用模板下目录的结构定义和每个目录的作用部分会在本文的后续部分提及，完成参考请查阅“PAFA3 文档库”中的相关说明。

在接下来的应用开发中，上图中标识出的目录名称变化为：

●pafa3Template → userProj : 项目名称，应符合项目命名规范

●appname → userapp：应用名称，应符合应用命名规范

●modulename → management：Java模块名称，应符合模块命名规范

●module1 → management：Web模块名称，应符合模块命名规范

从此处开始，除特别说明外，所给出的文件路径均相对于“D:\MyProj\userProj”。

2.3数据库表的设计

从之前给出的预览可以看出，在这个例子中所需的表结构比较简单，下面即为相对应的Oracle SQL脚本的内容：

CREATE TABLE USERS(

ID VARCHAR2(10) NOT NULL,

NAME VARCHAR2(20) NOT NULL,

DESCRIPTION VARCHAR2(200) NOT NULL);

将上述脚本存入文件“src\schema\user.sql”，然后通过Oracle Sqlplus客户端创建此表，如下图所示：

2.4配置Weblogic数据源

在这个示例应用中，将使用数据源（Data Source）获得到数据库的连接，因此需要在Weblogic中进行数据源的配置，配置数据源之前则应该首先配置“连接缓冲池”。

缓冲池配置完成之后，就可以配置数据源了，如下图中所示，其中“Pool Name”就是指之前配置的缓冲池的名称：

记住数据源的JNDI名称“jdbc/pafademoDS”，这个名称将会在后续开发设置数据源时用到。

3.使用项目模板

3.1在Eclipse中导入项目模板

使用项目模板可以提高PAFA3应用项目的可管理性、提高开发效率。在之前所准备的开发目录中，用文本编辑器打开项目模板根目录下的“.project”和“build.properties”两个文件，如下图所示，修改属性值或确认属性设置是否与本机环境相符，需要检查的包括下面几项：

?项目名称：.project中的“”域

?以目录形式部署时的目录：deploy.single.dir属性

?存放EAR的目录：deploy.ear.dir属性

?PAFA3类库的位置：pafa.lib属性

?其它项目类库的位置：project.lib属性

?Weblogic.jar的位置：weblogic.jar属性

保存修改后的文件并保存，打开Eclipse，在Eclipse的菜单中选择“文件→导入…”，将出现下图

中所示的导航界面：

选择“现有项目到工作空间中”后，点击“下一步”，在如下图界面中选择重命名过的项目根目录，“确定”后点击“完成”：

操作完成后，重命名过的模板项目即被导入到Eclipse环境之中。

3.2Ant视图的配置与使用

通过Eclipse菜单，选择“窗口”→“显示视图”→“Ant”，就可以在Eclipse界面中显示出Ant视图，在Ant视图中点击第一个有加号的图标以增加构建文件，如下图所示：

在将项目的构建文件加入Ant视图后，就可以看到构建文件“build.xml”所提供的所有“Task”，在“usage”任务上双击（执行），则可获得关于用法的提示，如下图所示：

执行某个目标时只需要双击或在【target】上点击鼠标右键并选择“Run”即可。【注意，项目下的“dist”部署目录需要执行“刷新”后才看得到，在项目根节点“userapp”的右键弹出菜单中选择“刷

新”即可。】

3.3Eclipse 自动编译设置

Eclipse具有自动编译Java源文件的功能，这在编写代码阶段对于编译错误的发现是很有用的。为了利用Eclipse的这项功能，需要“设置对类库的引用”。

导入完成之后，在下图中选择项目名称“userapp”，点击鼠标右键，在弹出菜单中选择“属性”，将弹出项目属性框：

为了利用Eclipse的自动编译功能，需要设置对类库的引用，如上图中“Java Build Path”的“Libraries”中就定义了对项目外部类库的引用，图标上有感叹号“！”意思是路径配置有误；选择有误的类包，通过“Edit”修正类包路径，如下图所示，直至所有类包图标正常显示；在后续的开发中，如果用到类库中的其它类包，为使用Eclipse的自动编译，仍需要通过这个界面中的“Add External JARs”进行外部类包的引入。

3.4配置文件的分类、目的与作用

PAFA3本身是一种各层松散耦合的框架结构，这种形式大大提高了应用的灵活性和适应性。各层次和功能的联系通过配置文件联系在一起，下表列出了项目模板提供的示例配置文件及其功用，这些配置文件的路径起点均为“config”：

4.页面布局设计与实现

4.1.do和.screen

在用户没有执行任何功能之前，访问我们的应用就应该有一个起始页面，如下图所示：

.do和.screen是PAFA3应用规范中的定义的两种请求类型，.screen请求意味着纯粹的页面显示请求，不包含后台Biz层的业务处理；而.do则意味着需要后台的Biz层进行业务处理，数据将会在不同逻辑层中传递。

4.2布局分析与设计

如前所示，为简单起见，页面布局设定为左右结构，左边显示功能链接，右边为功能页面。为构建这个布局，需要编写下列文件：

以下给出各文件的具体内容，其中代码的含义请参考相应的注释。