宅急送 项目第六天 定区管理

1. 定区管理业务

定区管理 （和分区有何区别） ：
区域管理针对自然行政区， 行政区域比较大，不可能让取派员去负责整个行政区域， 需要进行分区，将行政区域细分 ，成为很多小区域（分区）， 需要为分区知道取派人员 ， 在分配分区和取派员对应关系时， 可能几个取派员共同负责几个分区 （定区 ）

定区就是 取派员 负责几个固定分区 物流取货和送货 ！！
—- 定区 关联分区 、关联取派员
—- 定区 需要管理客户信息 ，当客户下单时 ，自动进行分单操作 （为客户自动找到负责取派人员 ）

2. 添加定区

关联分区和取派员

2.1. 定区关联取派员

<input 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">
    <![CDATA[from Staff where deltag = '0']]>
 </query>

配置返回结果

<!-- json列表，添加定区时使用 -->
<result name="ajaxlistSUCCESS" type="json">
    <param name="root">staffs</param>
    <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">
    <![CDATA[from Subarea where decidedZone is null]]>
</query>

配置返回结果

<!-- 关联定区列表 -->
<result name="findnoassciactionsSUCCESS" type="json">
    <param name="root">subareas</param>
    <param name="includeProperties">
        \[\d+\]\.id,
        \[\d+\]\.addresskey,
        \[\d+\]\.position
    </param>
</result>

2.3. 定区添加功能

<form id="decidedzoneForm"          action="${pageContext.request.contextPath }/decidedzone_saveOrUpdate.action" method="post">

点击保存按钮，提交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">subareas</param>
    <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 方法

<!-- 定区分页查询 -->
<result name="pageQuerySUCCESS" type="json">
    <param name="root">pageResponseBean</param>
    <param name="includeProperties">
        total,
        rows\[\d+\]\.id,
        rows\[\d+\]\.name,
        rows\[\d+\]\.staff\.name,
        rows\[\d+\]\.staff\.telephone,
        rows\[\d+\]\.staff\.station
    </param>
</result>

未完成 ： 双击定区，查询关联分区

$('#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 映射文件 -->
<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.caucho</groupId>
    <artifactId>hessian</artifactId>
    <version>4.0.33</version>
</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">customers</param>
</result>
<!-- 查询已经关联 客户信息-->
<result name="findHasAssociationCustomersSUCCESS" type="json">
                <param name="root">customers</param>
</result>

2、 关联操作 左右移动

<input type="button" value="》》" id="toRight"><br/>
<input 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 添加关联的方法 ！

其它

课后资料

定区关联客户（分布式系统数据集成）

课程视频内容