极速WEB应用开发平台(XWA_v4.0)-快速入门

目录
1. 建立开发环境 (4)
1.1. 安装应用服务器 (4)
1.2. 安装数据库 (4)
1.3. 安装JDK (6)
1.4. 安装Eclipse (6)
1.5. 安装建模工具 (6)
1.6. 安装XWA平台 (7)
2. 新建一个业务系统项目 (8)
2.1. 建立和配置项目 (8)
2.2. 打包应用系统 (15)
2.3. 部署并运行系统 (16)
2.4. 登陆使用系统 (17)
3. 开发准备 (19)
3.1. 启动Eclipse，导入项目 (19)
3.2. 设置项目属性 (22)
4. 设计业务模型 (24)
4.1. 新建业务模型 (24)
4.2. 组织模型设计 (33)
4.2.1. 组织结构 (33)
4.2.2. 组织类型 (36)
4.2.3. 岗位 (38)
4.2.4. 人员 (41)
4.2.5. 权限组 (44)
4.3. 业务对象模型设计 (46)
4.3.1. 建立包（Package）结构 (47)
4.3.2. 建立类及其关联关系 (52)
4.3.3. 增加业务功能 (53)
4.4. 模型分析与校正 (55)
4.4.1. 业务对象模型分析 (55)
4.4.2. 生成物理模型 (56)
4.4.3. 物理模型分析 (58)
5. 生成或同步应用系统 (60)
5.1. 生成系统同步文件 (60)
5.2. 更新数据库定义 (61)
5.3. 更新系统元数据到数据库 (62)
6. 部署与运行应用系统 (63)
6.1. 编译应用系统 (63)
6.2. 重新发布应用系统 (63)
7. 使用应用系统 (64)
7.1. 登录 (64)
7.2. 个人首页 (64)
7.2.1. 个人首页模板定义 (65)
7.2.2. 个人首页定义 (71)
7.3. 初识基于XWA开发的应用程序 (72)
7.3.1. 标题栏 (72)
7.3.2. 主菜单 (73)
7.3.3. 工作桌面 (73)
7.3.4. 应用程序 (73)
8. 完善页面定义 (75)
9. 实现业务逻辑 (81)
10. 结束语 (83)
本快速入门手册，将以开发“企业合同管理系统”为例，讲解基于XWA平台的基本的开发过程和方法，以期让读者对此有个基本认识，快速上手，更详尽更系统的阐述见《XWA-开发指南》。

1.建立开发环境
1.1.安装应用服务器
XWA平台支持以下常用应用程序服务器：
✧WebLogic 9.x及跟高版本
✧WebShere 6.x及跟高版本
✧JBoss 4.x及更高版本
本入门手册使用WebLogic 9.1，按正常的安装方法安装该应用服务器即可，安装细节查看相关资料；
1.2.安装数据库
XWA平台支持以下常用的大型数据库：
✧MS SQL Server 2000及更高版本
✧Oracle 9.x及更高版本
✧DB2 7.x及更高版本
本入门手册使用的是MS SQL Server 2008，按正常的安装方法安装该数据库即可，但要求安装数据库的全文检索模块，细节查看相关资料；
安装完MS SQL Server 2008，缺省情况下，并未启用TCP/IP协议，需要使用SQL Server 配置管理器，启用该协议，如下图：
选取TCP/IP协议，点击右键，启动该协议
先停止、再重新启动“SQL Server服务”，如下图：
1.3.安装JDK
XWA平台需要版本是Java1.5（5.0）及以后版本JDK支持，JDK下载地址：/javase/downloads/index.jsp，按正常方法安装即可，右击电脑桌面上“我的电脑”图标，选取“属性->环境变量”，在系统变量中，新建并设置JAVA_HOME 系统环境变量，如：
JAVA_HOME = C:\Program Files\Java\jdk1.6.0_20
1.4.安装Eclipse
XWA平台支持Eclipse、JBuilder等Java开发环境；本入门手册使用Eclipse 3.4.2，按正常的安装方法安装即可，安装细节查看相关资料；
1.5.安装建模工具
XWA平台使用PowerDesigner作为系统建模工具，支持12.5、15.0及15.1等版本，本手册使用PowerDesigner 15.1，按正常的安装方法安装即可，如果选取Ecplise插件，安装细节查看相关资料；
1.6.安装XWA平台
安装完数据库、应用程序服务器、建模工具和Java编译工具后，执行安装包中的setup.exe，进行安装：
依据安装向导，输入相应的信息，很容易完成安装过程：
至此，基于XWA平台的基本开发环境就建立完成了，可以使用XWA平台进行应用程序开发了；
至于工作流、邮件、短信等调试需要的环境，以及开发环境与生产环境协同等更高级的开发环境问题，见本产品的《开发指南》。

2.新建一个业务系统项目
2.1.建立和配置项目
点击桌面上的“XWA-应用系统配置向导”快捷方式，启动XWA应用程序配置向导，可以快速建立系统项目：
步骤一、输入项目基本信息：
✧项目代码：本例为ECM（E nterprise C ontract M anagement）
✧项目名称：本例为企业合同管理系统；
✧安装路径：配置向导在该目录下，为“企业合同管理系统”建立一个开发环境；
步骤二、选择数据库：
步骤三、输入所选数据库信息，本例是SQL Server 2008
点击测试数据库连接，检验参数是否设置正确，如果正确，点击“下一步”；
步骤四、选择应用服务器
步骤五、输入所选服务器信息，本例是weblogic 9.x
步骤六、选择Java编辑编译器
步骤七、输入所选Java编辑编译工具信息
步骤八、输入系统管理员信息
该信息是合同管理系统运行时，需要的参数；步骤九、检查配置信息
这一步将前面输入的信息全部显示在一个文本框中，做“创建应用”前的最后检查，如果不正确，点击“上一步”进行修改，如果正确，点击“创建应用”，并确认：
步骤十、创建应用
至此，配置向导已经在项目安装路径(本例中是d:\xwa_projects)下，建立了一个基于XWA平台的开发环境，如下图所示：
提示：配置程序生成的项目环境的目录结构不要随意改变，包括名称、调整位置，但，可以在此基础上扩展；项目目录结构说明：
2.2.打包应用系统
XWA平台提供了一个组件插拔式的开放的系统架构，一个完整的基于XWA平台的应用系统（我们成为XWA_Based Application - XBA），包含一个基础技术架构和若干各种业务组件构成；
实际上，配置向导执行完成以后，就已经建立了一个可以运行的系统基础框架，目前，这个框架还没有涉及任何业务逻辑，但已经为实现和运行业务逻辑提供了完整的底层架构，我们称为基础架构，而实现各种业务逻辑的模块，我们称为业务组件插件，如本例中的企业合同管理；
可见，基于XWA平台开发的主要任务，事实上就是各种业务组件的开发，后面会详细讲解，这里按下不表；
执行deployment目录下的buildear命令，建立企业合同应用系统的xba_ecm.ear 文件，该文件存放在<项目根目录>\deployment\default目录下；如图：
2.3.部署并运行系统
接下来，就可以部署上面建立的ear文件了，依据项目配置时所选的应用程序服务器部署xba_ecm.ear文件，本例中，我们前面选用的是WebLogic。

启动Weblogic，在浏览器中输入http://localhost:7001/console，发布该ear文件，发布过程参见weblogic技术文档，这里不详述，发布后的结果如下：
至于不同环境下、不同数据库与不同中间件搭配的部署，以及群集部署和性能调优部署等更高级的部署问题，详见《XBA-安装与部署指南》；
2.4.登陆使用系统
在网络浏览器中输入http://localhost:7001/sems，或直接打开<项目根目录>下的“start_application.html”文件，进入合同管理系统，如图：
目前，系统中只有系统管理员帐号，缺省的名称和密码为：maxadmin/maxadmin，登陆后进入系统，如图：
至此，开发企业合同管理系统的所有准备工作全部完成；可以开始进行合同管理业务组件的设计开发了。

3.开发准备
3.1.启动Eclipse，导入项目
步骤一、选择File->Import
步骤二、选择“General –>Existing Projects into workspace”
步骤三、选择前面配置的项目根目录下applications\biz目录
步骤四、选取项目，点击“Finish”
步骤五、项目已经导入到了Eclipse
3.2.设置项目属性
步骤一、选取Eclipse中“window –> Show View -> Other…”，启用XWA View
步骤二、选中项目，选取主菜单“Project -> Properties”,在项目属性页中，选取XWA Properties，并设置项目安装的根目录，如图：
步骤三、点击OK，项目就已经支持XWA了，如图：
4.设计业务模型
我们以开发一个企业合同管理系统为例，讲解基于XWA开发的过程，我们假设，客户是一家工程企业，例如是广西xx工程总公司，该合同的主要类型有工程承包合同、材料采购合同、设备租赁合同、工程及劳务分包合同、工程保险合同等等；
4.1.新建业务模型
步骤一、点击“File -> New -> Other…”,在Select a wizard窗口中，选择“PowerDesigner -> Model”，新建模型，如图：
点击“Next”，在ModelType中选取“Object Oriented Model”,如图：
点击“Next”，选取将该模型文件所在的项目，如图：
点击“Next”，输入模型名称，这里我们输入“ecms”，如图：
点击“Next”，在扩张模型定义对话框中，选取“XWA400”，如图：
点击OK，完成模型新建，如图：
步骤二、初始化OOM模型
切换到“PowerDesigner -> Model Explorer”，如图：
选取模型名称“ecms”，单击右键，在弹出菜单中，选取“XWA-初始化模型”，对模型进行初始化，如图：
模型初始化为基于XWA的模型设计建立工作环境，并建立或设置了一些基本对象或属性，主要包括：
✧常用域（Domain）
✧用于组织模型设计的UseCase Diagram
✧可能会用到的平台保留类，如组织机构（Organization），人员（Person）等
步骤三、设置模型扩展属性
选取模型名称“ecms”，单击右键，在弹出菜单中，选取“Properties”，在模型属性页的“XWA”标签页，根据本手册“2.1建立和配置项目”时的设置，设置扩展属性如下：
✧系统代码：ecms（必须与“2.1建立和配置项目”步骤一设置一致）
✧系统名称：企业合同管理系统
✧公司代码：用于命名java包，如com.ibm.tivoli.report.ReportEngine.class中的
IBM，正式使用时，可以使之为贵公司的英文名称或英文名的缩写，本例中
smartersoft
✧项目根目录：必须与“2.1建立和配置项目”步骤一设置一致
✧组织模型中的根组织：企业组织架构树中的顶级节点，点击“”，进入组织
模型设计，见下一章节：
4.2.组织模型设计
企业经营过程中的任何业务都是由某个部门某个人来完成，作为企业级管理系统，建立一个科学合理的组织模型，对于描述和实现企业管理思想和业务需求是十分必要的；在XWA 平台的组织模型中，主要包含组织、组织类型、岗位、人员和权限组等要素；具体说明和操作如下：
4.2.1.组织结构
本例中组织结构，只考虑总公司,基本信息如下：
下面我们为上述组织建模，首先建立总公司这个组织，操作过程如下：
步骤一、在模型根目录下，单击右键，在弹出菜单中，选取“new –> OrganizationUnit”，新建一个组织，如图：
步骤二、在该组织单元的属性对话框的General标签页，设置属性如下：
✧名称：广西路桥工程总公司
✧代码：GXLQ
✧StereoType：组织机构
如图所示：
步骤三、在XWA标签页，设置属性如下：
步骤四、在“Posts（岗位）”标签页下，设置该组织的岗位；
点击“Add Objects”，显示岗位列表，如图：
选取该组织设置的岗位，单击OK，完成“总公司”岗位设置，如图；
重复上面的操作，建立其他组织；
4.2.2.组织类型
企业中各种组织机构的分类，如总公司、分公司、子公司、部门、项目部、工厂、车间等，本例中，在本教程中，为让您尽快熟悉基于XWA的开发流程，我们对模型进行简化，只设置一个组织类型：总公司、分公司；
首先，建立总公司这个组织类型，操作过程如下：
步骤一、在模型根目录下，单击右键，在弹出菜单中，选取“new –> OrganizationType”，新建一个组织类型，如图：
步骤二、在这个OrganizationType属性对话框的General标签页下，设置属性如下：
✧Name：公司
✧Code：10 (注意：组织类型的编码必须是4位以内的数值)
重复上面的操作，建立组织类型：分公司，如图：
4.2.3.岗位
现实生活中，一个企业参与合同管理的岗位很多，如采购、财务、仓管、各级领导等等，同样，为突出XWA开发流程方法，对模型进行简化，只为总公司设置一个合同管理岗：总公司合同主管，岗位体系是按组织类型设置的，例如，广西路桥为例：
◆总公司设有工程部、合同成本部、财务部、人事部、设备物资部、技术中心等等；
领导层：总经理、副总经理、三总师等等；
工程部：部长、工程主管、质量主管、安全主管等等
合同成本部：部长、成本主管、合同主管、诉讼主管等
设备物资部：部长、物资主管、设备主管等
◆分公司设有工程科、合同成本科、财务科、人事科、设备物资科、技术分中心等等；
领导层：总经理、副总经理、三总师等等
工程科：科长、工程主管、质量主管、安全主管等
合同成本科：科长、成本主管、合同主管、诉讼主管等
设备物资科：科长、物资主管、设备主管等
◆项目部设有工程室、合同成本室、财务室、质量安全室、设备物资室等等；
项目班子：项目经理、副经理、总工等等；
工程室：施工员等
合同成本室：成本员、合同员等
财务室：财务员等
质量安全室：质量员、安全员等
设备物资室：材料员、设备员等
现以总公司这种组织类型为例，说明岗位建立的过程；
步骤一、在“OragnizationTYpe Objects”包下，选取并打开“总公司”的属性页，点击“Posts”标签页，如图：
步骤二、点击“”，新建一个岗位，并在其属性对话框的General标签页设置
如下：
步骤三、在XWA标签页设置如下：
✧个人首页模板编号：01（可以是除9999外的任意数值）
✧所属组织类型：总司
步骤四、在“Permission”标签页设置岗位授权
点击“Add Objects”，显示可授权的权限组，如图：
选取合同管理和基础管理，表示把合同管理和基础管理两权限组授给当前岗位，点击Ok，完成授权，如图：
重复上面的步骤，建立“分公司”这种组织类型的岗位体系等
4.2.4.人员
现实中，一个企业里面参与合同管理的人，同样的，为简化模型，我们假设参与合同管理的人员名单如下：
以新建“周星驰”用户为例，操作过程如下：
步骤一、在“OragizationUnit”包下，打开“广西路桥总公司”的属性页，选取“LoginUser”标签页，如图：
步骤二、点击“”，新建一个用户，并在其属性对话框的General标签页中，设置属性如下：
在XWA标签页设置属性如下：
在Posts标签页下，设置该用户在组织中所任职的岗位，可以一人多岗，如图：
为组织模型中的的组织：广西路桥总公司，设置负责人，操作过程如下：找到“广西路桥工程总公司”组织，在其属性页的XWA标签中，设置单位负责人为周星驰，如图：
4.2.
5.权限组
在实施管理系统，权限组会话的比较细，但在开发阶段可以适当的粗一些，只要能反映授权控制的要求即可，本例中，我们划分两个权限组：合同管理和基础管理：
✧合同管理权限组将被授予全部处理合同业务的功能；
✧基础管理权限组将被授予基础数据管理维护功能，如计量单位、资源编码等；
下面以合同管理权限组为例，说明权限组的建模过程：
步骤一、在模型根目录下，选取“New -> SecurityGroup”，新建一个权限组，
并在其属性对话框的general标签页中，设置如下：
类似地，基础管理权限组定义如下：
至此，用于合同管理的组织模型就基本建立完毕，可以点击选取“模型名称”，单击右键，选取“XWA-模型分析”检查模型设计是否正确和完整，如图：
检查结果如下：
如果有错误或警告信息，请根据提示进行修正，如果没有，接下来就可以进行业务对象模型设计；
4.3.业务对象模型设计
合同管理是每个企业经营所必需，不同行业的不同企业管理方式会有所不同，为便于讲解XWA的开发过程，我们只使用其最基本的核心部分，以下是合同管理的一个简化业务模型的一个草案，我们将在本教程中实现它：
4.3.1.建立包（Package）结构
根据上述模型，我们将其中的业务对象做如下分类：
✧基础数据，如：计量单位、资源；
✧合同相关数据，如：合同及其合同清单、合同类型、供应商数据；
我们将这个小系统模块划分如下，灰色模块仅用于扩展说明和构图美观，暂不实现：
0..1
0..*
0..1
0..*
0..1
0..*
0..*
0..*
0..1
0..*
0..1
0..*
合同
-
-
合同
合同总价
: VA16
: MN
合同清单
-
-
-
单价
数量
金额
: MN
: DC19,2
: MN
资源
(30.资源)
-
-
资源
规格型号
: VA16
: VA64
计量单位
(10.计量单位)
-
-
-
-
计量单位
转换因子
类型
制式
: VA8
: DC19,4
: VA8
: VA8
货币
(20.货币)
-货币: VA8
供应商
(10.供应商)
-供应商: VA8
合同类型
-合同类型: VA8
XWA将应用系统划分为三类模块：系统模块（Module）、应用程序组（AppGroups）和应用程序（App），模块的组织形式有：
✧系统模块–> 应用程序(系统模块直接包含应用程序)；
✧系统模块-> 应用程序组-> 应用程序(系统模块包含应用程序组、应用程序
组再包含应用程序)；
✧类只能在StereoType为“应用程序”的Package下建立；
XWA中，应用程序类型有三种，它们的作用和区别见《开发手册》有关章节：
1.标准应用程序
2.单页面应用程序
3.自助服务应用程序
最佳实践：
1、系统模块命名：MD_打头；
2、应用程序组命名：AG_打头；
3、应用程序命名：短单词（不能包含特殊字符）；
在PowerDesigner中，按上表建立Package，操作过程如下：
4.3.1.1.新建系统模块包
具体操作过程如下：
步骤一、在模型根目录下，新建一个Package，并在其属性页的General标签页中，设置属性如下：
StereoType：系统模块；
特别说明：XWA借用Package的name属性作菜单顺序编码，因此，Package的name 都采用如下格式命名：
<菜单序号>.<模块名称>
菜单序号：数值表示，1-99、10000系统保留，可以使用除此之外的任何数值；
模块名称：按正常命名即可；
应用程序组包的建立与系统模块类似，不重复；
4.3.1.2.新建应用程序包
步骤一、在基础管理包下，新建一个Package，应在其属性对话框的General标签页中，设置属性如下：
步骤二、在XWA标签页下，设置扩展属性如下：
除“应用程序类型”、“主业务对象”外，其他属性暂时不用理会，后面再谈；步骤三、在SecurityGroup标签页下，设置授权如下：。