新增收货地址

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

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;

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

注意采用驼峰命名

/**
 * @author chenxi
 * @Date 2022/10/12
 * @Description 收货地址数据的实体类
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Address extends BaseEntity{
    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;
}

3新增收货地址-持久层

3.1各功能的开发顺序

当前收货地址功能模块:列表的展示、修改、删除、设置默认、新增收货地址。

开发顺序:新增收货地址-列表展示-设置默认收货地址-删除收货地址-修改收货地址。

3.2规划需要执行的SQL语句

1.插入语句：

insert into t_address(字段列表） value (...)

2.—个用户的收货地址规定最多只能有20条数据对应。在插入用户数据之前先做查询操作。可以后续设置为用户收货地址的一个异常抛出。

select count(*) from t_address where uid = ?

3.3接口与抽象方法

创建一个新接口，来实现上方两个sql语句的定义。

/**
 * 收货地址持久层的接口。
 */
public interface AddressMapper {

    /**
     * 插入用户的收货地址数据
     * @param address 收货地址
     * @return 返回插入行数
     */
    Integer insertAddress(Address address);

    /**
     * 根据用户的id统计收货地址数量
     * @param uid 用户id
     * @return 返回当前用户收货地址总数。
     */
    Integer countAddressById(@Param("uid") Integer uid);
}

3.4配置SQL映射

新建一个AddressMapper.xml文件，并配置SQL映射。

<?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.chenxi.stores.mapper.AddressMapper">
    
    
    <!--type：表示对哪个类进行结果集映射-->
    <resultMap type="com.chenxi.stores.entity.Address" id="AddressEntityMap">
    <id property="aid" column="aid"/>
    <result property="provinceCode" column="province_code"/>
    <result property="provinceName" column="province_name"/>
    <result property="cityCode" column="city_code"/>
    <result property="cityName" column="city_name"/>
    <result property="areaCode" column="area_code"/>
    <result property="areaName" column="area_name"/>
    <result property="isDefault" column="is_default"/>
    <result property="createdUser" column="created_user"/>
    <result property="createdTime" column="created_time"/>
    <result property="modifiedUser" column="modified_user"/>
    <result property="modifiedTime" column="modified_time"/>
</resultMap>
    
    <insert id="insertAddress" parameterType="address">
    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>
    
    <select id="countAddressById">
        select count(*) from store.t_address where uid = #{uid}
    </select>
</mapper>

3.5单元测试 

/**
 * @author chenxi
 * @Date 2022/10/12
 * @Description AddressMapper的测试类
 */
//@SpringBootTest 表示是一个测试类，不会随同代码打包发送
@SpringBootTest
//@RunWith 表示启动这个单元测试类，参数必须为SpringRunner的实例对象
//@RunWith(SpringRunner.class)
public class AddressMapperTests {

    @Resource
    AddressMapper addressMapper;

    @Test
    public void insertAddress(){
        Address address = new Address();
        address.setUid(1);
        address.setName("chenxi");
        address.setAddress("hnzyydx");
        address.setPhone("110");
        Integer row = addressMapper.insertAddress(address);
        System.out.println(row);
    }

    @Test
    public void countAddressById(){
        Integer row = addressMapper.countAddressById(1);
        System.out.println(row);
    }
}

4增收货地址-业务层

如果用户是第一插入用户的收货地址，规则:当用户插入的地址是第一条时，需要将当前地址作为默认的收货地址，如果查询到统计总数为0则将当前地址的is_default值设置为1。查询统计的结果为0不代表异常。

4.1规划异常

查询到的结果大于20了，这时候需要抛出业务控制的异常AddressCountLimitException异常。自行创建这个异常

/**
 * @author chenxi
 * @Date 2022/10/8
 * @Description 用户收货地址超过20异常
 */
public class AddressCountLimitException extends ServiceException {
    public AddressCountLimitException(String message) {
        super(message);
    }

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

4.2接口与抽象方法

创建AddressService 接口。

/**
 * @author chenxi
 * @Date 2022/10/8
 * @Description 用户业务层接口
 */
public interface AddressService {


    /**
     * 插入用户的收货地址数据，其中内部包括了mapper层中的查询操作。整合在其中
     * @param address 收获地址数据
     * @param uid 用户id
     * @param username 当前用户姓名
     * @return
     */
    void addNewAddress(Address address,Integer uid,String username);
}

4.3实现抽象方法

在验证数据条数不超过20时，我们可以采用在springboot配置文件中设定一个值为20的常量来比较，这样做时方便后续修改更新，调用方法为现在配置文件中配置

user:
  address:
    max-count: 20

然后通过@Value注解来获取  @Value("$user.address.max-count")

/**
 * @author chenxi
 * @Date 2022/10/8
 * @Description 用户业务层实现类
 */
@Service
public class AddressServiceImpl implements AddressService {

    @Resource
    AddressMapper addressMapper;

    @Value("$user.address.max-count")
    Integer maxCount;

    @Override
    public void addNewAddress(Address address, Integer uid, String username) {
        Integer rows = addressMapper.countAddressById(uid);
        if (rows > maxCount) {
            throw new AddressCountLimitException("用户插入数据过多！");
        }
        if (rows.equals(1)) {
            address.setIsDefault(1);
        }
        address.setUid(uid);
        address.setCreatedTime(new Date());
        address.setCreatedUser(username);
        address.setModifiedTime(new Date());
        address.setModifiedUser(username);
        Integer row = addressMapper.insertAddress(address);
        if (row != 1) {
            throw new InsertException("收货地址保存异常！")；
        }
    }
}

 4.4单元测试

/**
 * @author chenxi
 * @Date 2022/10/8
 * @Description UserMapper测试类
 */
//@SpringBootTest 表示是一个测试类，不会随同代码打包发送
@SpringBootTest
//@RunWith 表示启动这个单元测试类，参数必须为SpringRunner的实例对象
//@RunWith(SpringRunner.class)
public class AddressServiceTests {
    @Resource
    AddressService addressService;

    @Test
    public void addNewAddress(){
        Address address = new Address();
        address.setPhone("120");
        addressService.addNewAddress(address,1,"管理员");
    }
}

5新增收货地址-控制器

5.1处理异常

添加我们新的AddressCountLimitException

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

5.2设计请求

/addresses/add_new_address

post
Address address，Httpsession session

JsonResult<void>

5.3处理请求

在控制层创建AddressController来处理用户收货地址的请求和响应。
 

/**
 * @author chenxi
 * @Date 2022/10/12
 * @Description 用户收货管理控制器
 */
@RestController
public class AddressController extends BaseController{

    @Resource
    AddressService addressService;

    @RequestMapping("/addresses/add_new_address")
    public JsonResult<Void> addNewAddress(Address address, HttpSession session){
        Integer uid = getUidFromSession(session);
        String username = getUsernameFromSession(session);
        addressService.addNewAddress(address,uid,username);
        return new JsonResult<>(OK,"收货地址设置成功！",null);
    }
}

然后访问 http://localhost:8080/addresses/add_new_address?name=xixi&phone=17858802222

6新增收货地址-前端页面

类似与之前功能，代码相似，不过多介绍

        <script type="text/javascript">
			$("#btn-add-new-address").click(function () {
				$.ajax({
					url: "/addresses/add_new_address",
					type: "POST",
					data: $("#form-add-new-address").serialize(),
					dataType: "JSON",
					success: function (json) {
						if (json.state == 200) {
							alert("添加地址成功！");
						} else {
							alert("添加地址失败！" + json.message);
						}
					},
					error: function (xhr) {
						alert("添加地址时产生的位置异常：" + xhr.message);
					}
				})
			})
		</script>

获取省市列表

现在增加地址界面的省市列表都是保存至前端js文件下的，数据量非常大。为了简化前端传递的数据大小，使效率更高，我们在数据库中保存省市的值，前端调用，优化加速。

1.获取省市列表-数据库

 parent属性表示的是父区域代码号，省的父代码号+86。

2.获取省市列表-实体类创建

创建个District实体类。
 

/**
 * @author chenxi
 * @Date 2022/10/12
 * @Description 省市内容实体类
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class District {
    Integer id ;
    String parent;
    String code;
    String name;
}

 3.获取省市列表-持久层

3.1 SQL规划

查询语句，根据父代号进行查询。
 

3.2 接口和抽象方法定义

在mapper包下创建DistrictMapper接口

public interface DistrictMapper {

    /**
     * 根据父代号查询区域信息
     * @param id
     * @return
     */
    List<District> findByParent(Integer id);
}

3.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.chenxi.stores.mapper.DistrictMapper">
   <select id="findByParent" resultType="district">
       select *
       from store.t_dict_district where parent = #{parent}
        order by code ASC
   </select>
</mapper>

3.4 单元测试 

//@SpringBootTest 表示是一个测试类，不会随同代码打包发送
@SpringBootTest
//@RunWith 表示启动这个单元测试类，参数必须为SpringRunner的实例对象
//@RunWith(SpringRunner.class)
public class DistrictMapperTests {

    @Resource
    DistrictMapper districtMapper;

    @Test
    public void countAddressById(){
        List<District> districts = districtMapper.findByParent("120110");
        System.out.println(districts);
    }
}

 4.获取省市列表-业务层

4.1 规划异常

无需再次开发

4.2 接口和抽象方法

public interface DistrictService {

    /**
     * 根据父代号来查询区域信息(省市区)
     * @param parent 父代号
     * @return 查询到的区域信息
     */
    List<District> getByParent(String parent);
}

4.3 实现抽象方法

在进行网络数据传输时，为了尽量避免无效数据的传递，可以将无效数据设置null,可以节省流量，另一方面提升了效率

/**
 * @author chenxi
 * @Date 2022/10/8
 * @Description 用户业务层实现类
 */
@Service
public class DistrictServiceImpl implements DistrictService {

    @Resource
    DistrictMapper districtMapper;

    //在进行网络数据传输时，为了尽量避免无效数据的传递，可以将无效数据设置null,可以节省流量，另一方面提升了效率

    @Override
    public List<District> getByParent(String parent) {
        List<District> districts = districtMapper.findByParent(parent);

        for (District district : districts) {
            district.setParent(null);
            district.setId(null);
        }
        return districts;
    }
}

4.4 单元测试

/**
 * @author chenxi
 * @Date 2022/10/8
 * @Description UserMapper测试类
 */
//@SpringBootTest 表示是一个测试类，不会随同代码打包发送
@SpringBootTest
//@RunWith 表示启动这个单元测试类，参数必须为SpringRunner的实例对象
//@RunWith(SpringRunner.class)
public class DistrictServiceTests {
    @Resource
    DistrictService districtService;

    @Test
    public void getByParent(){
        //所有省的父代号都是86
        List<District> districts = districtService.getByParent("86");
        for (District district : districts) {
            System.err.println(district);
        }
    }
}

 5.获取省市列表-控制层

5.1 设计请求

请求路径： /districts/

请求方式： GET

请求参数： String parent

返回类型： JsonResult<District>

5.2 处理请求 

创建DistrictController

/**
 * @author chenxi
 * @Date 2022/10/13
 * @Description 省市信息列表控制类
 */
@RequestMapping("districts")
@RestController
public class DistrictController extends BaseController{

    @Resource
    DistrictService districtService;

    @RequestMapping({"/",""})
    public JsonResult<List<District>> getByParent(String parent){
        List<District> data = districtService.getByParent(parent);
        return new JsonResult<>(OK,"",data);
    }
}

5.3 单元测试

这部分单元测试需先将url加入拦截器的白名单中

启动项目，输入http://localhost:8080/districts?parent=86

 6.获取省市列表-前端页面

将本来从js代码中获取省市信息的代码注释掉。

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

3.运行前端看是否还可以正常保存数据(除了省市区之外)|。

显示省市区

1 显示省市区-持久层

1.1 规划sql语句

select name from store.t_dict_district where code = #{code};

1.2 接口和抽象方法

String findNameByCode(@Param("code") String code);

1.3 实现抽象方法

    <select id="findNameByCode" resultType="java.lang.String">
        select name
        from store.t_dict_district where code = #{code};
    </select>

1.4 单元测试

    @Test
    public void findNameByCode(){
        String name = districtMapper.findNameByCode("610000");
        System.out.println(name);
    }

2 显示省市区-业务层

2.1 规划异常

无需再次开发

2.2 接口和抽象方法

    String getNameByCode(String code);

2.3 实现抽象方法

    @Override
    public String getNameByCode(String code) {
        return districtMapper.findNameByCode(code);
    }

2.4 单元测试

 代码较少，无需测试

3 显示省市区-控制层

将该业务层和添加地址的业务层

    @RequestMapping("/addresses")
    public JsonResult<List<Address>> getAddressList(HttpSession session){
        Integer uid = getUidFromSession(session);
        List<Address> list = addressService.getAddressListByUid(uid);
        return new JsonResult<>(OK,"",list);
    }

4.显示省市区-前端页面

<script>
		$(document).ready(function () {
			showAddressList()
		});

		function showAddressList() {
			$.ajax({
				url: "/addresses",
				type: "POST",
				dataType: "JSON",
				success: function (json) {
					if (json.state == 200) {
						console.log(json.data)
						let list = json.data
						for (let i = 0; i < list.length; i++) {

							let address = '<tr>'
									+ '<td>#{tag}</td>'
									+ '<td>#{name}</td>'
									+ '<td>#{province}#{city}#{area}#{address}</td>'
									+ '<td>#{phone}</td>'
									+ '<td><a class="btn btn-xs btn-info"><span class="fa fa-edit"></span> 修改</a></td>'
									+ '<td><a onclick="deleteByAid(#{aid})" class="btn btn-xs add-del btn-info"><span class="fa fa-trash-o"></span> 删除</a></td>'
									+ '<td><a onclick="setDefault(#{aid})" class="btn btn-xs add-def btn-default">设为默认</a></td>'
									+ '</tr>';
							address = address.replace(/#{aid}/g, list[i].aid);
							address = address.replace(/#{tag}/g, list[i].tag);
							address = address.replace("#{name}", list[i].name);
							address = address.replace("#{province}", list[i].provinceName);
							address = address.replace("#{city}", list[i].cityName);
							address = address.replace("#{area}", list[i].areaName);
							address = address.replace("#{address}", list[i].address);
							address = address.replace("#{phone}", list[i].phone);

							$("#address-list").append(address)
						}
						//隐藏第一个设置默认按钮
						$(".add-def:eq(0)").hide()
					} else {
						alert("省市区信息加载失败！" + json.message);
					}
				},
				error: function (xhr) {
					alert("显示信息的异常：" + xhr.message);
				}
			})
		}
	</script>