Cordys BOP 4平台开发入门实战演练——Webservices开发（0基础）
0.文章导读
本文档针对Cordys BOP-4 WS-AppServer基础功能进行验证和高速开发指导。（高级实践文档请參考兴许文档）。
0.1.WS-AppServer概述
WS-AppServer是Web Service Application Server的简称，是Cordys平台中基于数据库的Java业务逻辑开发层，其最根本的特性例如以下：
（1）连接数据库
- WS-Apps通过连接池訪问数据库，能够从数据库表结构直接产生对应的Java代码，并公布成Web服务；
- 提供事务处理(transaction)和查询（query）的API，便于面向数据库开发。
（2）实现Java应用逻辑
- 能够在自己主动产生的Java代码以外。编写独立的逻辑作为新的Java方法，并公布成Web服务。新的Java方法甚至能够不訪问数据库。相当于一个Javacall；
- 更重要的是，Ws-Apps提供一种事件驱动的编程模式，数据库事务、记录、字段的变化都能够有对应的event handler。可供嵌入各种逻辑。
（3）与XForm紧密集成，能够用后端逻辑控制前端展现。比方某页面控件是否隐藏或仅仅读，某个下拉列表有哪些选择，某个字段输入是否合法
- 在WS-Apps中，详细的逻辑在对应event handler中实现。
- 触发event handler，并依照结果进行展现，由Xform负责。详细的接口通过SOAP request/response中传递的额外信息描写叙述。自己开发的connector，假设实现了这些接口，也能够达到相同的效果。
（4）与Orchestrator的紧密集成
- 对于WS-Apps管理的数据库对象模板。也能够定义Orchestrator的规则。
这样，对于数据库记录的增删改，不但能触发Java编程的业务逻辑，也能够同一时候触发业务规则。能够分别针对性能和灵活性作优化。实现复杂的业务需求Orchestrator的全套Java API，都能够在Ws-AppServer中调用。
0.2.文档导读文件夹及结构
0.3.WS-AppServer结构
WS-AppServer组件相互依赖。主要由例如以下几部分组成：
- Database Metadata
- WS-AppServer Package
- Object Schema
- Java Model
- Java Archive Package
- Web Service
1. Workspace的新建
（1）在租户中新建Workspace
新建Workspace，例如以下图所看到的，填写“Name”。我这里新建名称是“Training_xiaoyw201503”。
（2）为Workspace配置SVN
2. WS-Appserver Container的配置
（1.1）首先选择“System Resource Manager”
（1.2）选择Application Connectors新建
Application Connectors链接点是WS-AppServer。
（2）配置Service Group细节
（3）配置Service Container细节
（4）为WS-AppServer配置细项
（4.1）.配置数据库连接
（5）.配置连接点Connection Point
手动启动新建Service Container
3. DB Metadata的新建
通常在项目中建立例如以下目录：
WEB
Java
DB Meterdata
BPM
Web Service
WS-AppServer Packeage
（1）在DB Meterdata上，点击鼠标右键。例如以下图操作。新建DB Meterdata。
上图中，第4步输入“data”是为了高速查询对象，鼠标点击“Database Metadata”。配置数据库链接。
如上图所看到的，输入“Database Metadata”名称为“xiaoyw Database Metadata”，WS-AppServer Service选择新建的“test_xiaoyw” Service Container（数据库链接）。
接着。选择数据源，通过鼠标点击“Retrieve all tables”能够检索所以数据库表。也能够通过中间的Search in database输入框检索，输入“*”，也是表示所有表的检索。假设检索某个或某些表。直接输入名称或部分，再鼠标点击“Search in database”button查询检索就可以。
按上图所看到的。选中dept、test_zss表。使用button“>”转移到右側。
4. 基于WS-Appserver的开发和使用
（1）新建WS-AppServer Packeage
（2）基于新建的WS-AppServer生成Java源码、Jar包
在上图中，鼠标点击图标。弹出下图所看到的窗体“Update Packeage from Database Metadata”，从数据库对象“Select
Database Matadata”中选择“xiaoyw Database Metadata”。
在上图中选择表dept、test_zss。鼠标点击“Update”button。
按上图。通过选择框来选择由Cordys平台生成所需get方法。
按上图，通过Cordys平台生成Java及其JAR包代码，鼠标点击图标，弹出例如以下图所看到的。
按上图所看到的。先选择数据表对象dept、test_zss，再鼠标点击图中下部button“Generate”，生成Java代码。
例如以下图所看到的。通过操作界面页底。鼠标点击“Workspace Documents”页面来回看Java代码。
上图展示出生成Java代码。
（3）基于新建的WS-AppServer生成Webservices
按上图所看到的，鼠标点击图标，由Cordys平台来自己主动生成Webservices代码。
按上图所看到的，先通过选择框选择数据库表对象dept和test_zss，再鼠标点击“Next”button。
按上图所看到的。先输入Web Service Name为“getDept”，然后调整Web Services Folder Name为“WebService”（图中第3步）。最后。鼠标点击“Generate”button。
通过操作界面页底。鼠标点击“Workspace Documents”页面来切换回看Webservices列表。
（4）公布Java类到租户中（当前开发环境）
注意，最好选中整个“Java”目录进行Java代码公布，按鼠标右键弹出上图公布菜单，鼠标点击“Publish to Organization”公布。
（5）公布Webservice到租户中
按上图所看到的，选中整个WebService目录，击鼠标右键弹出如图所看到的菜单，鼠标点击“Publish to Organization”选项，公布Webservices。
（6）自己主动/手动绑定到Web Service Interfaces中
正常顺序操作时，Webservices自己主动绑定到Web Service Interfaces中，可是。本次实践过程中，频繁删除已经公布的Webservices，这样，会有Webservices残留。
如上图所看到的，我所建立的“test_xiaoyw” Service Groups，通过鼠标右键弹出菜单选择“Properties”选项，能够看到先前所绑定大量Webservices，选中全部选择框。点击“红叉”操作，删除涉及到我的Webservices。
（7）手动绑定到Web Service Interfaces中
在删除对应的Webservices后，鼠标点击“绿色加号”，如图所看到的弹出窗体，通过“-Select Organization/Package-”选择开发人员所处的租户“mssoa”，从其海量Webservices中。选择我所开发的Webservices “getDept.xiaoyw...”，通过加入button“Add”。加入到下表中。最后鼠标点击“Done”button。完毕绑定工作。
按上图所看到的方式，又一次启动Service Containers “xiaoyw_WS_AppServer”。
5.通过SVN使用Eclipse
代码导入到Eclipse中
（1）上传代码到SVN
为了保证代码最新及准确。请先更新代码到本地再提交。
（2）在Eclipse中，检出代码（首次须要检出项目）
（2.1）从SVN中检出项目到Eclipse中新建项目
（2.2）把Java代码导入src为源文件
（2.3）配置Build Path资源（依赖类库和外部包）
（2.4）更新代码
6. 单表的增删改查
（1）測试所公布的Webservices有效性，查询
在Webservice目录中要进行測试的Web service，按右键弹出窗体。选中“Test Web Service Operation”。（注：重建Webservices名称为getDept，自此不又一次更新插图）
如上图所看到的选中GetDeptObject，击鼠标右键弹出菜单，选择“Test Web Service Operation”进行測试。
如上图所看到的，把SOAP Request中<ID>中的Parameter替换成“5”。再鼠标点击button“Invoke”。然后查看SOAP Response。
（2）插入操作
測试请求报文例如以下：
<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP:Body>
<UpdateDept xmlns="http://schemas.cordys.com/xiaoywWSAppServerPackage" reply="yes" commandUpdate="no" preserveSpace="no" batchUpdate="no">
<tuple>
<old>
<dept qConstraint="0">
<id>5</id>
<name>xiaoyw</name>
</dept>
</old>
<new>
<dept qAccess="0" qConstraint="0" qInit="0" qValues="">
<id>5</id>
<name>xiaoyw20150329</name>
</dept>
</new>
</tuple>
</UpdateDept>
</SOAP:Body>
</SOAP:Envelope>
在測试查询结果如上图所看到的，id=5的更新name为xiaoyw20150329。
上面报文中<old>为删除操作。<new>为插入操作。
7.自己定义Webservices开发
（1）自己定义插入操作Webservice。
仍回到“xiaoywWSAppServerPackage” WS-AppServer Packeage操作窗体。
按上图所看到的，选择dept表。击鼠标右键弹出如图所看到的菜单，选择“Add”菜单。再选“Method”选项。
（2）编辑新方法属性
注：上图为旧图。Package是“xiaoywWSAppServerPackage”。方法命名为insertDept。插入操作无返回值，并选中“SOAP”选择框。
（3）为方法提供參数
按上图所看到的操作。鼠标点击绿色“+”，添加输入參数。本例使用两个參数，分别为v_id和v_name。最后保存。
（4）接下来生产Java代码、Webservices。
因为本次是新增方法，这样须要重写扩展类。须要选中“Overwrite Extension Classes”。也要选中相关的表，最后鼠标点击“Generate”button，生成Java代码。
（注：此图代码中第一个參数设置时错误，更新为int）
如上图所看到的，新的Java代码中新增insertDept方法，须要在此编写自己定义代码，新增内容例如以下所看到的：
public static void insertDept(int v_id, String v_name)
{
// TODO implement body
String sql="insert into dept (id,name) values("+v_id+",'"+v_name+"')";
DMLStatement DML = new DMLStatement(sql);
DML.execute();
}
而且须要导入：
import com.cordys.cpc.bsf.busobject.DMLStatement;
上述代码编写。最好是Eclipse，以及配合SVN协调代码同步。
（5）公布Webservice
因为Webservices已经存在。在上图中须要选中“Existing”。再通过弹出窗体选择Web Service Interface。
如上图所看到的，在WebService中，能够看到新增“insertDept”方法，接着再对WebService进行总体公布。公布结果例如以下图所看到的。
（6）測试插入操作
选中WebService中insertDept方法进行測试。測试报文例如以下。
<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP:Body>
<InsertDept xmlns="http://schemas.cordys.com/xiaoywWSAppServerPackage" preserveSpace="no" qAccess="0" qValues="">
<v_id>51</v_id>
<v_name>new xiaoyw</v_name>
</InsertDept>
</SOAP:Body>
</SOAP:Envelope>
再查询測试刚刚插入内容，结果例如以下，成功。
草稿完毕于2015年3月29日。
完好于2015年4月1日
參考：
《WS-AppServer Fundamental Practice in BOP-4》Cordys公司 2012年
