新增收货地址
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 sessionJsonResult<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>