宅急送 项目第六天 定区管理
1. 定区管理业务
定区管理 （和分区有何区别） ：
区域管理针对自然行政区， 行政区域比较大，不可能让取派员去负责整个行政区域， 需要进行分区，将行政区域细分 ，成为很多小区域（分区）， 需要为分区知道取派人员 ， 在分配分区和取派员对应关系时， 可能几个取派员共同负责几个分区 （定区 ）
定区就是 取派员 负责几个固定分区 物流取货和送货 ！！
—- 定区 关联分区 、关联取派员
—- 定区 需要管理客户信息 ，当客户下单时 ，自动进行分单操作 （为客户自动找到负责取派人员 ）
2. 添加定区
关联分区和取派员
2.1. 定区关联取派员
class="easyui-combobox" name="staff.id" data-options="valueField:'id',textField:'name',url:'${pageContext.request.contextPath }/staff_ajaxlist.action'" /> 在 StaffAction 中添加 ajaxlist的方法
<query name="Staff.findNoDelete">
query>配置返回结果
<result name="ajaxlistSUCCESS" type="json">
<param name="root">staffsparam>
<param name="includeProperties">
\[\d+\]\.id,
\[\d+\]\.name
param>
result>2.2. 定区关联分区
使用datagrid ，显示所有未指定定区的分区
decidedzone_id is null 的分区
将 分区表格url 改为
data-options="url:'${pageContext.request.contextPath }/subarea_findnoassociations.action'在 SubareaAction 中添加 findnoassociations 方法
<query name="Subarea.findassociations">
query>配置返回结果
<result name="findnoassciactionsSUCCESS" type="json">
<param name="root">subareasparam>
<param name="includeProperties">
\[\d+\]\.id,
\[\d+\]\.addresskey,
\[\d+\]\.position
param>
result>2.3. 定区添加功能
点击保存按钮，提交form 表单
// 为添加修改定区 ，保存按钮 添加 click事件
$('#save').click(function(){
// 提交前，先校验 form 输入
if($('#decidedzoneForm').form('validate')){
$('#decidedzoneForm').submit();
}else{
$.messager.alert('警告','表单存在非法数据项，请重新输入','warning');
}
});问题： 当form 提交时，定区编号和分区编号 冲突了
修改分区表格id 的field
<th data-options="field:'subareaId',width:30,checkbox:true">编号th>
使返回分区数据json能够和field 关联
<result name="findnoassciactionsSUCCESS" type="json">
<param name="root">subareasparam>
<param name="includeProperties">
\[\d+\]\.subareaId,
\[\d+\]\.addresskey,
\[\d+\]\.position
param>
result>需要在Subarea类 提供 getSubareaId
public String getSubareaId() {
return id;
}
编写定区管理Action —- DecidedZoneAction
public class DecidedZoneAction extends BaseAction implements ModelDriven<DecidedZone> {
}
public interface DecidedZoneService {
}
public class DecidedZoneServiceImpl extends BaseService implements DecidedZoneService {
}将DAO 注入 BaseService
将Service 注入 BaseAction
业务代码
public void saveOrUpdate(DecidedZone decidedZone, String[] subareaIds) {
// 保存定区数据
decidedZoneDAO.save(decidedZone);
// 实现定区和分区关联（用分区 对象 关联 定区 多方关联一方）
for (String id : subareaIds) {
Subarea subarea = subareaDAO.findById(id); // 分区持久对象
subarea.setDecidedZone(decidedZone);
}
}配置
<action name="decidedzone_*" class="decidedZoneAction" method="{1}">
<result name="saveOrUpdateSUCCESS">
/WEB-INF/pages/base/decidedzone.jsp
result>
action>3. 定区列表查询（分页查询）
分页列表查询，使用 PageRequestBean 和 PageResponseBean 、 BaseService 的 pageQuery 方法 ！
$('#grid').datagrid( {
url : "${pageContext.request.contextPath}/decidedzone_pageQuery.action",
});在 DecidedZoneAction 添加 pageQuery 方法
pageResponseBean
total,
rows\[\d+\]\.id,
rows\[\d+\]\.name,
rows\[\d+\]\.staff\.name,
rows\[\d+\]\.staff\.telephone,
rows\[\d+\]\.staff\.station
未完成 ： 双击定区，查询关联分区
$('#association_subarea').datagrid( {
url : "subarea_xxx.action",
queryParams : {"decidedZone.id": rowData.id},4. 定区关联客户（远程调用）
BOS的定区管理模块，需要定区关联客户的功能，实际中 客户数据在CRM系统中，BOS系统需要从CRM系统中获取数据，进行数据交互 ！！！
4.1. RMI 技术分析
使用Hessian技术，完成BOS和CRM的系统整合
Hessian是一个轻量级的remoting onhttp工具，使用简单的方法提供了RMI（Java Remote Method Invocation 方法远程调用 ）的功能。 相比WebService，Hessian更简单、快捷。采用的是二进制RPC（（RemoteProcedureCallProtocol）——远程过程调用协议）协议，因为采用的是二进制协议，所以它很适合于发送二进制数据。
RMI 是 Java 首选远程调用协议，非常高效稳定，特别是在数据结构复杂，数据量大的情况下，与其他通讯协议的差距尤为明显。但不能跨语言
HttpInvoker 使用 java 的序列化技术传输对象，与 RMI 在本质上是一致的，不能跨语言
Hessian 性能比RMI 慢20% ，但是通过二进制传输，跨语言
Burlap 采用 xml 格式传输。仅在传输 1 条数据时速度尚可，通常情况下，它的毫时是 RMI 的 3 倍。
WebService通讯毫时是 RMI 的 10 倍，传输xml数据，基于soap协议 （Axis2、 CXF ）
这次定区关联客户功能，选择Hessian
下载网址： http://hessian.caucho.com/ hessian-4.0.33.jar
[2]Dubbo是[3]阿里巴巴公司开源的一个高性能优秀的服务框架，使得应用可通过高性能的 RPC 实现服务的输出和输入功能，可以和 [4]Spring框架无缝集成。
调用 淘宝和支付宝 的接口 ，通常使用 Dubbo ，Dubbo底层使用Hessian
4.2. 编写Hessian入门程序
Hessian.mht 使用文档
开发步骤 ：
1、 建立服务器和客户端两个工程， 导入hessian的jar包
2、 服务器编写
定义业务接口
public interface HelloService {
public String sayHello(String name);
}
public class HelloServiceImpl implements HelloService {
@Override
public String sayHello(String name) {
return "hello hessian , name: " + name;
}
}将业务接口注册为一个Hessian服务
将myserver 发布到tomcat 运行
3、 编写客户端
如果是java客户端，直接将业务接口复制到客户端程序
编写客户端测试程序
// 编写Hessian客户端
String url = "http://localhost:8080/myserver/hello";
HessianProxyFactory hessianProxyFactory = new HessianProxyFactory();
// 创建接口代理程序
HelloService proxy = (HelloService) hessianProxyFactory.create(HelloService.class, url);
String result = proxy.sayHello("itcast");
System.out.println(result);4.3. 使用Hessian 完成定区管理客户的功能
4.3.1. 定区关联客户功能分析
查询定区的列表
选择一个定区，点击上面 关联客户的按钮 ，需要显示form表单
查询所有未指定定区的客户 （查询CRM）
查询当前选中定区已经关联的客户 （查询CRM ）
将 “关联客户form表单.txt” 整合 decidedzone.jsp 页面中
// 在关联客户的方法
function doAssociations(){
// 先判断用户是否选择 定区数据
var rowData = $('#grid').datagrid('getSelected');
if(rowData == null){
// 未选中
$.messager.alert('警告','定区关联客户前，必须要先选中一个定区','warning');
}else{
// 已经选中
// 显示关联客户的窗口
$('#customerWindow').window('open');
}
}
需要查询所有未关联定区的客户和 已经关联当前定区的客户
提交表单，将客户关联到定区上， 通过Hessian， 将定区信息保存到 CRM 中！
4.3.2. 编写CRM系统
新建 web project — crm
* 操作数据库 使用Hibernate 框架
* 提供远程服务 使用Hessian
导入jar包和配置文件
编写 Customer 实体类
编写 Customer.hbm.xml
在hibernate.cfg.xml 引入 hbm文件
<mapping resource="cn/itcast/crm/domain/Customer.hbm.xml"/>输入一些测试数据
根据业务编写业务接口
提供 CustomerServiceImpl 实现类
发布Hessian 服务， 配置web.xml
Hessian服务器端和客户端，进行发布时，都可以和Spring集成（整合）
参加 “Hessian - thinking-in-programming - Hessian配置步骤 - Think & Summing - Google Project Hosting.mht ”
访问 http://localhost:8080/crm/customerService
4.3.3. 编写BOS项目客户端代码
1、 导入 Hessian的jar包
<dependency>
<groupId>com.cauchogroupId>
<artifactId>hessianartifactId>
<version>4.0.33version>
dependency>2、 编写Hessian客户端 （和Spring整合 ）
如果 不整合Spring ， 使用 HessianProxyFactory 为目标接口 建立代理
整合Spring
将 cn.itcast.crm.service 、 cn.itcast.crm.domain 复制 BOS项目
在applicationContext-remoting.xml 中配置Hessian客户端代理
3、 编写测试用例，远程接口调试
别忘了，要启动 CRM的Hessian服务！！
三个业务方法，全部调试通过
4.3.4. 定区管理客户功能实现
Maven 运行 mavenbos ，保证端口 不要和CRM 使用Tomcat端口相同 ！
1、 弹出关联客户到定区窗口时，发起两次Ajax请求，获取未关联列表和选中定区已经关联列表 ，显示到关联Select 元素中
$.post("${pageContext.request.contextPath}/decidedzone_findNoAssociationCustomers.action", function(data){
$.post("${pageContext.request.contextPath}/decidedzone_findHasAssociationCustomers",{id : rowData.id}, function(data){发起两次Ajax请求 ，需要在DecidedZoneAction 添加两个业务方法
将customerService 注入 BaseAction !!
配置返回结果
<result name="findNoAssociationCustomersSUCCESS" type="json">
<param name="root">customersparam>
result>
<result name="findHasAssociationCustomersSUCCESS" type="json">
<param name="root">customersparam>
result>
2、 关联操作 左右移动
type="button" value="》》" id="toRight">
type="button" value="《《" id="toLeft">为左移和右移添加点击事件
// 添加左右 移动关联客户事件
$('#toRight').click(function(){
// 将未关联 移到 已经关联
$('#associationSelect').append($('#noassociationSelect option:selected'));
});
$('#toLeft').click(function(){
$('#noassociationSelect').append($('#associationSelect option:selected'));
});3、 点击关联客户，提交form表单
// 点击关联客户，提交表单
$('#associationBtn').click(function(){
// 关联select 中所有option 选中
$('#associationSelect option').attr('selected','selected');
// 提交表单 $('#customerDecidedZoneId').val($('#grid').datagrid('getSelected').id); // 为定区隐藏域设置id
$('#customerForm').submit();
});服务器 在 DecidedZoneAction 添加关联的方法 ！
其它
课后资料
定区关联客户（分布式系统数据集成）
课程视频内容
