新增收货地址【项目商城】

新增收货地址
- 1 新增收货地址-数据表创建
- 2 新增收货地址-创建实体类
- 3 新增收货地址-持久层
- - 3.1 各功能的开发顺序
  - 3.2 规划需要执行的SQL语句
  - 3.3 接口与抽象方法
  - 3.4 配置SQL映射
- 测试
- 4 新增收货地址-业务层
- - 4.1 规划异常
  - 4.2 接口与抽象方法
- 测试
- 5 新增收货地址-控制器
- - 5.1 处理异常
  - 5.2 设计请求
  - 5.3 处理请求
- 测试
- 6 新增收货地址-前端页面
- 测试

新增收货地址

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 = InnoDBDEFAULT CHARSET = utf8;

t_address.sql

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

创建一个类Address ，在类中对应表中的相关字段，采用驼峰命名方式。最后再去继承BaseEntity 类

**entity | Address **

package com.cy.store.entity;import java.io.Serializable;
import java.util.Objects;/** 收货地址数据的实体类 */
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;//contructor get set equals hashcode toString //ALT+INSert//..........}

3 新增收货地址-持久层

3.1 各功能的开发顺序

当前的收货地址功能模块：列表的展示、修改、删除、设置默认、新增收货地址。
开发顺序：新增收货地址-列表展示-设置默认收货地址-删除-修改收货地址

3.2 规划需要执行的SQL语句

1.对应的是插入语句：

insert into t_address(除了adi外字段列表) values(字段值列表)

2.一个用户的收货地址规定最多只能有20条数据对应。
在插入用户数据之前先做查询操作。
收货地址逻辑控制方面的一个异常。超过20–异常

select count(*) from t_address where uid=?

3.3 接口与抽象方法

1.创建一个新的接口AddressMapper，在这个接口中来定义两个SQL语句抽象方法。

package com.cy.store.mapper;import com.cy.store.entity.Address;/** 收货地址持久层的接口*/
public interface AddressMapper {/*** 插入用户的收货地址数据* @param address 收货地址数据* @return 影响的行数*/Integer insert(Address address);/*** 根据用户的id统计收货地址数量* @param uid 用户的id* @return 当前用户的收货地址总数*/Integer countByUid(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">
<mapper namespace="com.cy.store.mapper.AddressMapper"><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><insert id="insert" useGeneratedKeys="true" keyProperty="aid">INSERT INTO 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="countByUid" resultType="java.lang.Integer">SELECT count(*) from t_address WHERE uid=#{uid}</select>
</mapper>

AddressMapper

测试

2.在test下mapper下AddressMapperTests

package com.cy.store.mapper;import com.cy.store.entity.Address;
import com.cy.store.entity.User;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;import java.util.Date;//@SpringBootTest：表示标注当前的类是测试类，不会随同项目一块打包
@SpringBootTest
//@RunWith：表示启动这个单元测试类（单元测试类是不能够运行的），需要传递一个参数，必须是SpringRunner的实例类型
//@RunWith(SpringRunner.class)
public class AddressMapperTests {@Autowiredprivate AddressMapper addressMapper;@Testpublic void insert(){Address address=new Address();address.setUid(8);address.setPhone("17858802974");address.setName("女朋友");addressMapper.insert(address);}@Testpublic void countByUid(){Integer count = addressMapper.countByUid(8);System.out.println(count);}}

AddressMapperTests–新增收货地址

4 新增收货地址-业务层

4.1 规划异常

如果用户是第一次插入用户的收货地址，规则：当用户插入的地址是第一条时，需要将第一条地址作为默认收货地址，如果查询的统计总数为0，则将当前的地址的is_default值设置为1。查询统计的结果为0不代表异常。查询到的结果大于20，这时候需要抛出业务控制的异常AddressCountLimitException异常。自行创建这个异常。

package com.cy.store.service.ex;/* 收货地址数量达到上限的异常 */
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);}
}

插入数据时产生的异常InsertException，不再需要重复创建。

4.2 接口与抽象方法

1.创建一个AddressService接口，在其中第定义业务的抽象方法

package com.cy.store.service;import com.cy.store.entity.Address;/**收货地址业务层的接口*/
public interface IAddressService {void addNewAddress(Integer uid,String username,Address address);
}

2.创建一个AddressServiceImpl实现类，去实现接口的抽象方法。
在配置文件中定义数据。

# Spring 读取配置文件的数据：@Value(${user.address.max-count})
user.address.max-count=20

在实现类中实现业务控制

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

测试

3.测试业务层的过程是否正常。AddressServiceTests测试业务功能。

package com.cy.store.service;import com.cy.store.entity.Address;
import com.cy.store.entity.User;
import com.cy.store.service.ex.ServiceException;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;//@SpringBootTest：表示标注当前的类是测试类，不会随同项目一块打包
@SpringBootTest
//@RunWith：表示启动这个单元测试类（单元测试类是不能够运行的），需要传递一个参数，必须是SpringRunner的实例类型
//@RunWith(SpringRunner.class)
public class AddressServiceTests {@Autowiredprivate IAddressService addressService;@Testpublic void addNewAddress(){Address address=new Address();address.setUid(8);address.setPhone("17858809999");address.setName("女朋友");addressService.addNewAddress(8,"管理员",address);}}

AddressServiceTests–addNewAddress

5 新增收货地址-控制器

5.1 处理异常

业务层抛出了收货地址总数超标的异常，在BaseController中进行处理。

package com.cy.store.controller;import com.cy.store.controller.ex.*;
import com.cy.store.service.ex.*;
import com.cy.store.util.JsonResult;
import org.springframework.web.bind.annotation.ExceptionHandler;import javax.servlet.http.HttpSession;/*** 控制层类的基类*/
public class BaseController {/**操作成功的状态码 */public static final int OK=200;//请求处理方法，这个方法的返回值就是需要传递给前端的数据//自动将异常对象传递给此方法的参数列表上//当前项目中产生的异常会被拦截到此方法中，这个方法此时充当的是请求处理方法，方法的返回值直接给前端@ExceptionHandler({ServiceException.class,FileUploadException.class})//用于统一处理抛出的异常public JsonResult<Void> handleException(Throwable e){JsonResult<Void> result=new JsonResult<>(e);if (e instanceof UsernameDuplicatedException){result.setState(4000);result.setMessage("用户名已经被占用的异常");}else if (e instanceof UserNotFoundException){result.setState(4001);result.setMessage("用户数据不存在的异常");}else if (e instanceof PasswordNotMatchException){result.setState(4002);result.setMessage("用户密码错误的异常");}else if (e instanceof AddressCountLimitException){result.setState(4003);result.setMessage("用户的收货地址超出上限异常");}else if (e instanceof InsertException){result.setState(5000);result.setMessage("插入数据时产生未知的异常");}else if (e instanceof UpdateException){result.setState(5001);result.setMessage("更新数据时产生未知的异常");}else if (e instanceof FileEmptyException) {result.setState(6000);} else if (e instanceof FileSizeException) {result.setState(6001);} else if (e instanceof FileTypeException) {result.setState(6002);} else if (e instanceof FileStateException) {result.setState(6003);} else if (e instanceof FileUploadIOException) {result.setState(6004);}return result;}/*** 获取session对象的uid* @param session session对象* @return 当前登录得到用户uid的值*/protected final Integer getuidFromSession(HttpSession session){return Integer.valueOf(session.getAttribute("uid").toString());}/*** 获取session对象的username* @param session session对象* @return 当前登录得到用户username的值** 在实现类中重写了父类中的toString()方法，不是句柄信息的输出@xxx*/protected final String getUsernameFromSession(HttpSession session){return session.getAttribute("username").toString();}
}

BaseController–AddressCountLimitException

5.2 设计请求

/address/add_new_address
post
Address address,HttpSession session
JsonResult<Void>

5.3 处理请求

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

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;@RequestMapping("address")
@RestController
public class AddressController extends BaseController{@Autowiredprivate 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);}
}

AddressController–addNewAddress

测试

先登录用户，再进行测试
http://localhost:8080/address/add_new_address?name=tom&phone=17858802222

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

addAddress.html

     <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("新增收货地址成功！");location.href = "address.html";} else {alert("新增收货地址失败！" + json.message);}},error: function(xhr) {alert("您的登录信息已经过期，请重新登录！HTTP响应码：" + xhr.status);location.href = "login.html";}});});</script>

addAddress–add_new_address

测试

README–新增收货地址