添加收货地址

新增收货地址-创建数据表

CREATE TABLE t_address (
	aid INT AUTO_INCREMENT COMMENT '收货地址id',
	uid INT COMMENT '归属的用户id',
	name VARCHAR(20) COMMENT '收货人姓名',
	province_name VARCHAR(15) COMMENT '省-名称',
	province_code CHAR(6) COMMENT '省-行政代号',
	city_name VARCHAR(15) COMMENT '市-名称',
	city_code CHAR(6) COMMENT '市-行政代号',
	area_name VARCHAR(15) COMMENT '区-名称',
	area_code CHAR(6) COMMENT '区-行政代号',
	zip CHAR(6) COMMENT '邮政编码',
	address VARCHAR(50) COMMENT '详细地址',
	phone VARCHAR(20) COMMENT '手机',
	tel VARCHAR(20) COMMENT '固话',
	tag VARCHAR(6) COMMENT '标签',
	is_default INT COMMENT '是否默认：0-不默认，1-默认',
	created_user VARCHAR(20) COMMENT '创建人',
	created_time DATETIME COMMENT '创建时间',
	modified_user VARCHAR(20) COMMENT '修改人',
	modified_time DATETIME COMMENT '修改时间',
	PRIMARY KEY (aid)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

新增收货地址-创建实体类

创建com.cy.store.entity.Address新增收获地址的实体类，继承自BaseEntity类，在类中声明与数据表中对应的属性，添加Getters and Setters方法，基于唯一标识aid生成hashCode()和equals()方法。

package com.cy.store.entity;

@AllArgsConstructor
@Data
@NoArgsConstructor
/** 收货地址数据的实体类 */
public class Address extends BaseEntity implements Serializable {
    private Integer aid;
    private Integer uid;
    private String name;
    private String provinceName;
    private String provinceCode;
    private String cityName;
    private String cityCode;
    private String areaName;
    private String areaCode;
    private String zip;
    private String address;
    private String phone;
    private String tel;
    private String tag;
    private Integer isDefault;

    // Generate: Getter and Setter、Generate hashCode() and equals()、toString()
}

新增收货地址-持久层

各功能开发顺序：
关于收货地址数据的管理，涉及的功能有：增加，删除，修改，设为默认，显示列表。这些功能的开发顺序为：增加-显示列表-设为默认-删除-修改。

1.规划需要执行的SQL语句

1.1 增加收货地址的本质是插入新的收货地址数据，需要执行的SQL语句大致是：

INSERT INTO t_address (除了aid以外的字段列表) VALUES (匹配的值列表)

1.2 一般电商平台都会限制每个用户可以创建的收货地址的数量，如“每个用户最多只允许创建20个收货地址”，也可以通过以上查询来实现。

SELECT count(*) FROM t_address WHERE uid=?

2.接口与抽象方法

创建com.cy.store.mapper.AddressMapper接口，并在接口中添加抽象方法。

package com.cy.store.mapper;

import com.cy.store.entity.Address;

/** 处理收货地址数据的持久层接口 */
public interface AddressMapper {
    /**
     * 插入收货地址数据
     *@param address 收货地址数据
     *@return 受影响的行数
     */
    Integer insert(Address address);

    /**
     * 统计某用户的收货地址数据的数量
     * @param uid 用户的id
     * @return 该用户的收货地址数据的数量
     */
    Integer countByUid(Integer uid);

}

3.配置SQL映射

3.1 在src/main/resources/mapper文件夹下复制粘贴得到AddressMapper.xml映射文件，修改根节点mapper的namespace属性的值为com.cy.store.mapper.AddressMapper，并在根节点中配置pojo类属性与数据库中表的字段映射。

 <resultMap id="AddressEntityMap" type="com.cy.store.entity.Address">
        <id column="aid" property="aid"/>
        <result column="province_code" property="provinceCode"/>
        <result column="province_name" property="provinceName"/>
        <result column="city_code" property="cityCode"/>
        <result column="city_name" property="cityName"/>
        <result column="area_code" property="areaCode"/>
        <result column="area_name" property="areaName"/>
        <result column="is_default" property="isDefault"/>
        <result column="created_user" property="createdUser"/>
        <result column="created_time" property="createdTime"/>
        <result column="modified_user" property="modifiedUser"/>
        <result column="modified_time" property="modifiedTime"/>
    </resultMap>

3.2. 在AddressMapper.xml映射文件的根节点中配置以上两个抽象方法的映射。

  <!-- 插入收货地址数据：Integer insert(Address address) -->
    <insert id="insert" useGeneratedKeys="true" keyProperty="aid">
    INSERT INTO store.t_address (
        uid, name, province_name, province_code, city_name, city_code, area_name, area_code, zip,
        address, phone, tel,tag, is_default, created_user, created_time, modified_user, modified_time
    ) VALUES (
                 #{uid}, #{name}, #{provinceName}, #{provinceCode}, #{cityName}, #{cityCode}, #{areaName},
                 #{areaCode}, #{zip}, #{address}, #{phone}, #{tel}, #{tag}, #{isDefault}, #{createdUser},
                 #{createdTime}, #{modifiedUser}, #{modifiedTime})
</insert>

    <!-- 统计某用户的收货地址数据的数量：Integer countByUid(Integer uid) -->
    <select id="countByUid" resultType="java.lang.Integer">
        SELECT COUNT(*) FROM store.t_address WHERE uid=#{uid}
    </select>

4.单元测试

3.在src/test/java下创建com.cy.store.mapper.AddressMapperTests测试类，在类定义之前添加测试的两个注解，在类中编写并执行以上两个抽象方法的测试。

 @Test
    public void insert(){
        Address address = new Address();
        address.setUid(1);
        address.setPhone("17858802974");
        address.setName("猫咪1号");
        addressMapper.insert(address);
    }
    @Test
    public void countByUid(){
        Integer integer = addressMapper.countByUid(1);
        System.out.println(integer);
    }

新增收货地址-业务层

1. 规划异常

1.无论用户将要增加的收货地址是不是默认收货地址，都需正常增加。即通过countByUid()方法统计的结果不管是不是0，都不能代表是错误的操作。

2.在执行插入收货地址数据之前，需判断countByUid()方法返回值是否超出上限值，如果超出上限值则抛AddressCountLimitException异常。

3.在执行插入数据时，还可能抛出InsertException异常，此异常无需再次创建。

4.创建com.cy.store.service.ex.AddressCountLimitException类后，需继承自ServiceException类。

package com.cy.store.service.ex;
/** 收货地址数量达到上限20的异常 */
public class AddressCountLimitException extends ServiceException{
    public AddressCountLimitException() {
        super();
    }

    public AddressCountLimitException(String message) {
        super(message);
    }

    public AddressCountLimitException(String message, Throwable cause) {
        super(message, cause);
    }

    public AddressCountLimitException(Throwable cause) {
        super(cause);
    }

    protected AddressCountLimitException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
        super(message, cause, enableSuppression, writableStackTrace);
    }
}

2.接口与抽象方法

创建com.cy.store.service.IAddressService业务层接口，并添加抽象方法。

package com.cy.store.service;

import com.cy.store.entity.Address;
/** 收货地址业务层接口 */
public interface IAddressService {
    //在插入地址之前需要查询地址条数整合成一个接口就可以
    /**
     * 创建新的收货地址
     * @param uid 当前登录的用户的id
     * @param username 当前登录的用户名
     * @param address 用户提交的收货地址数据
     */
    void addNewAddress(Integer uid, String username, Address address);
}

3. 实现抽象方法

创建com.cy.store.service.impl.AddressServiceImpl业务层实现类，在类定义之前添加@Service注解，并实现IAddressService接口，最后在类中添加持久层对象并使用@Autowired注解修饰。

3.1 在application.properties文件中添加收货地址数据上限值的配置。

user.address.max-count=20

3.2 在实体类中显现业务配置

package com.cy.store.service.impl;


import com.cy.store.entity.Address;
import com.cy.store.mapper.AddressMapper;
import com.cy.store.service.AddressService;
import com.cy.store.service.ex.AddressCountLimitException;
import com.cy.store.service.ex.InsertException;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;

import java.util.Date;

//新增收货地址的实现类
public class AddressServiceImpl implements IAddressService {
    @Autowired
    private AddressMapper addressMapper;
    @Value("${user.address.max-count}")
    private  Integer maxCount;
    @Override
    public void addNewAddress(Integer uid, String username, Address address) {
        Integer count = addressMapper.countByUid(uid);
      if (count > maxCount){
            throw new AddressCountLimitException("用户收货地址超过上限");
        }
        // 补全数据：将参数uid封装到参数address中
        address.setUid(uid);
        // 补全数据：根据以上统计的数量，得到正确的isDefault值(是否默认：0-不默认，1-默认)，并封装
        Integer isDefault = count == 0 ? 1 : 0;
        address.setIsDefault(isDefault);
        // 补全数据：4项日志
        Date now = new Date();
        address.setCreatedUser(username);
        address.setCreatedTime(now);
        address.setModifiedUser(username);
        address.setModifiedTime(now);
        // 调用addressMapper的insert(Address address)方法插入收货地址数据，并获取返回的受影响行数
        Integer rows = addressMapper.insert(address);
        // 判断受影响行数是否不为1
        if (rows != 1) {
            // 是：抛出InsertException
            throw new InsertException("插入收货地址数据时出现未知错误，请联系系统管理员！");
        }
    }
}

4.单元测试

package com.cy.store.service;

import com.cy.store.entity.Address;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

@SpringBootTest
@RunWith(SpringRunner.class)
public class AddressServiceTests {
    @Autowired
    private AddressService addressService;
    @Test
    public void addNewAddress(){
        Address address = new Address();
        address.setPhone("23421342352");
        address.setName("猫咪2号");
        addressService.addNewAddress(2, "管理员", address);
    }
}

新增收货地址-控制层

1.处理异常

在控制器层新增收货地址时，如果收货地址已经达到上限值，则抛出AddressCountLimitException异常，并在BaseController类中添加处理AddressCountLimitException的异常。

else if (e instanceof AddressCountLimitException) {
            result.setState(4003);
            result.setMessage("用户收货地址超出上限的异常");}

2. 设计请求

设计用户提交的请求，并设计响应的方式。

请求路径：/addresses/add_new_address
请求参数：Address address, HttpSession session
请求类型：POST
响应结果：JsonResult<Void>

3. 处理请求

1.创建com.cy.store.controller.AddressController控制器类继承自BaseController类，在类的声明添加@RequestMapping(“addresses”)和@RestController注解，在类中声明业务层对象并添加Autowired注解修饰。

package com.cy.store.controller;

import com.cy.store.entity.Address;
import com.cy.store.service.IAddressService;
import com.cy.store.util.JsonResult;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpSession;

@RestController
@RequestMapping("address")
public class AddressController extends BaseController{
    @Autowired
    private IAddressService addressService;
@RequestMapping("add_new_address")
    public JsonResult<Void> addNewAddress(Address address, HttpSession session){
    Integer uid = getuidFromSession(session);
    String username = getUsernameFromSession(session);
        addressService.addNewAddress(uid,username,address);
        return  new JsonResult<>(ok);
    }
}

完成后启动项目，打开浏览器先登录，再访问http://localhost:8080/address/add_new_address?name=tom&phone=1223423423

新增收货地址-前端页面

1.在address.html页面中body标签内部的script标签内，添加设置用户默认收货地址的代码。

<script type="text/javascript">
		$("#btn-add-new-address").click(function () {
			$.ajax({
				url: "/addresses/add_new_address",
				type: "POST",
				dataType: "JSON",
				success: function (json) {
					if (json.state == 200) {
						alert("新增收货地址成功")
					} else {
						alert("新增收货地址失败！" + json.message);
					}
				},
				error: function (xhr) {
					alert("新增收货地址产生未知的异常" + xhr.status);
				}
			});
		});
		</script>

获取省市区列表

CREATE TABLE t_dict_district (
  id int(11) NOT NULL AUTO_INCREMENT,
  parent varchar(6) DEFAULT NULL,
  code varchar(6) DEFAULT NULL,
  name varchar(16) DEFAULT NULL,
  PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

parent表示的是父区域代码号，省的父代码号+86.

1.获取省市区列表-实体类

创建个District实体类

package com.cy.store.entity;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
//省市区的实体类
public class District extends BaseEntity{
    private Integer id;
    private String parent;
    private String code;
    private String name;
}

2.获取省市区列表-持久层

2.1查询语句：根据父代号查询

SELECT *from t_dict_district where parent=？order by code ASC

2.2抽象方法定义

package com.cy.store.mapper;

import com.cy.store.entity.District;

import java.util.List;

public interface DistrictMapper {
   /**
    * 根据父代号查询区域信息
    * @param parent    父代号
    * @return       某个父区域下的所有区域列表
    */
   List<District> findByParent(Stringparent);
}

2.3 映射文件编写

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!--namespace属性：用于指定当前的映射文件和哪个接口进行映射，需要指定接口的文件路径，需要标注包的完整路径接口欧-->
<mapper namespace="com.cy.store.mapper.DistrictMapper">
  <select id="findByParent" resultType="com.cy.store.entity.District">
      select *from store.t_dict_district where parent=#{parent} order by code ASC
  </select>
</mapper>

2.4 单元测试

package com.cy.store.mapper;

import com.cy.store.entity.Address;
import com.cy.store.entity.District;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

import java.util.List;

@SpringBootTest
@RunWith(SpringRunner.class)
public class DsitrictMapperTests {
    @Autowired
    private DistrictMapper districtMapper ;
    @Test
    public void insert() {
        List<District> byParent = districtMapper.findByParent("210100");
        for (District d:
             byParent) {
            System.out.println(d);
        }
    }
}

3.获取省市区列表-业务层

3.1 创建接口IDistrictService，并定义抽象方法

package com.cy.store.service;

import com.cy.store.entity.District;

import java.util.List;

public interface IDistrictService {
    /**
     * 根据父代号来查询区域信息（省市区）
     * @param parent     父代号
     * @return           多个区域信息
     */
    List<District> getByParent(String parent);
}

3.2 IDistrictService实现类，实现抽象方法

package com.cy.store.service.impl;

import com.cy.store.entity.District;
import com.cy.store.mapper.DistrictMapper;
import com.cy.store.service.IDistrictService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;
@Service
public class DistrictServiceImpl implements IDistrictService {
    @Autowired
    private DistrictMapper districtMapper;
    @Override
    public List<District> getByParent(String parent) {
        List<District> list = districtMapper.findByParent(parent);
        //在进行网络数据传输时，为了尽量避免无效数据的传递，可以将无效数据设置为null
        //可以节省流量，提升效率
        for (District d:
             list) {
            d.setId(null);
            d.setParent(null);
        }
        return list;
    }
}

3.3 单元测试

package com.cy.store.service;

import com.cy.store.entity.Address;
import com.cy.store.entity.District;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

import java.util.List;

@SpringBootTest
@RunWith(SpringRunner.class)
public class DistrictServiceTests {
    @Autowired
    private IDistrictService districtService;
    @Test
    public void getByParent(){
        //86表示中国，所有省的父代号都是86
        List<District> list = districtService.getByParent("86");
        for (District d:
             list) {
            System.out.println(d);//所有省份
        }
    }
}

获取省市区列表-控制层

1.设计请求

/districts/
get
String parent
JsonResult<List>

2.请求请求

创建一个DistrictController类，在类中编写处理请求的方法

package com.cy.store.controller;

import com.cy.store.entity.District;
import com.cy.store.service.IDistrictService;
import com.cy.store.util.JsonResult;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
@RequestMapping("districts")
public class DistrictController extends BaseController{
    @Autowired
    private IDistrictService districtService;
    @RequestMapping({"/",""})
    public JsonResult<List<District>> getByParent(String parent){
        List<District> data = districtService.getByParent(parent);
        return new JsonResult<>(ok,data);
    }
}

districts请求添加到白名单

  patterns.add("/districts/**");

启动服务器:http://localhost:8080/districts?parent=86

获取省市区列表-页面层

1.检查前端页面在提交省市区数据时是否有相关name属性和id属性

2.运行前端是否可以正常保存数据（除省市区之外）