当前位置：首页 > news >正文

SpringBoot项目--电脑商城【新增收货地址】

news 2025/7/3 17:36:25

1.新增收货地址

t_address

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;

注意name是关键字,所以需要用``

2.创建收货地址的实体类

在entity包下创建实体类Address继承BaseEntity类

/*** 收货地址的实体类*/
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Address extends BaseEntity {private Integer aid;//收货地址idprivate Integer uid;//归属用户idprivate 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;//是否默认  0-不默认，1-默认
}

3.持久层[Mapper]

1 各功能的开发顺序

当前收货地址功能模块:

第一个页面:列表的展示,修改,删除,设置默认
第二个页面:新增收货地址

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

2 需要规划要执行的sql语句

1.新增收货地址对应的是插入语句:

insert into t_address (aid以外的所有字段) values (字段值)

2. 大部分平台都会规定一个用户的收货地址数量,这里规定最多20个.那么在插入用户新的地址之前就要先做查询操作.如果查询到的是刚好20,这并不是一个java语法的异常,可以认为是业务控制的异常,这个异常随后在service抛,在controller捕获

select count(*) from t_address where uid=?

2.设置接口和抽象方法

创建接口AddressMapper,在这个接口中定义上面两个SQL语句抽象方法定义

//收货地址持久层接口
public interface AddressMapper {/*** 插入用户的收货地址数据** @param address 收货地址* @return 受影响的行数*/Integer insertAddress(Address address);/*** 获取收货地址的数量（不能超过20），根据用户的uid** @param uid 用户uid* @return 收货地址数量*/Integer countAddress(Integer uid);
}

3.编写映射

1.在mapper标签中配置Address类属性与数据库中表的字段映射

    <resultMap id="AddressEntityMap" type="com.example.mycomputerstore.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>

判断该映射是否配置成功:按着ctrl并点击type="com.cy.store.entity.Address"中的Address,如果能跳转到Address类说明映射成功

2.在AddressMapper.xml中配置以上两个抽象方法的映射

    <insert id = "insertAddress" 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="countAddress" resultType="java.lang.Integer">SELECT count(*) FROM t_address WHERE uid = #{uid}</select>

4.单元测试

@SpringBootTest
@RunWith(SpringRunner.class)
public class AddressMapperTests {@Autowiredprivate AddressMapper addressMapper;@Testpublic void insert() {Address address = new Address();address.setUid(11);address.setPhone("133336");address.setName("女朋友");addressMapper.insert(address);}@Testpublic void countByUid() {Integer count = addressMapper.countByUid(11);System.out.println(count);}
}

4.业务层[service]

1. 规划异常

插入数据时用户不存在(被管理员误删等等),抛UsernameNotFoundException异常(已经有了,不需要重复创建)
当用户插入的地址是第一条时,需要将当前地址作为默认收货地址
实现办法:如果查询到统计总数为0则将当前地址的is_default值设置为1
如果查询的结果>=20,这时需要抛出业务控制的异常AddressCountLimitException

/**收货地址总数超出限制的异常(20条)*/
public class AddressCountLimitException extends ServiceException {/**重写ServiceException的所有构造方法*/
}

插入数据时产生未知的异常InsertException(已经有了,不需要重复创建)

2 设计接口和抽象方法及实现

1.创建一个IAddressService接口,在接口中定义业务的抽象方法

因为mapper层接口该功能模块定义了两个抽象方法,所以就要在service层接口该功能模块也定义两个抽象方法?不是这样的,要看mapper层的这两个方法是依赖关系还是独立关系,如果某一个抽象方法依赖于另一个抽象方法,那就需要在业务层将这两个方法整合到一个方法中.一句话来说就是:一个功能模块可能需要多条sql语句

//收货地址业务层接口
public interface IAddressService {/***这三个参数的由来:* 1.首先肯定要有address* 2.业务层需要根据uid查询该用户收货地址总数及新建地址时给字段uid赋值* 但新建收货地址的表单中并没有哪个控件让输入用户uid,所以需要控制层将uid传给业务层* 3.业务层在创建/修改收货地址时需要同时修改数据库中创建人/修改人的字段* 但新建收货地址的表单中并没有哪个控件让输入用户username,所以需要控制层将username传给业务层* 注意:> 可以用HttpSession session代替Integer uid, String username,但* 这样写的话就需要把BaseController类下获取uid,username的方法重新封装到一个* 类中并让IAddressServiceImp实现类继承该类,这样就需要微调一下代码逻辑,太麻* 烦,并且,最好每一层只处理该层需要做的事情,session对象是控制层传递的,所以就* 把session对象定义封装在控制层中,不需要在业务层中额外处理以降低耦合*/void addAddress(Integer uid, String username, Address address);
}

方法addNewAddress中三个参数的由来:

首先肯定要有address
业务层需要根据uid查询该用户收货地址总数及新建地址时给字段uid赋值
但新建收货地址的表单中并没有哪个控件让输入用户uid,所以需要控制层将uid传给业务层并在业务层封装到address对象中
业务层在创建/修改收货地址时需要同时修改数据库中创建人/修改人的字段
但新建收货地址的表单中并没有哪个控件让输入用户username,所以需要控制层将username传给业务层并在业务层封装到address对象中

可以用HttpSession session代替Integer uid, String username,但这样写的话就需要把BaseController类下获取uid,username的方法重新封装到一个类中并让AddressServiceImpl实现类继承该类,这样就需要微调一下代码逻辑,太麻烦,并且,最好每一层只处理该层需要做的事情,session对象是控制层传递的,所以就把session对象定义封装在控制层中,不需要在业务层中额外处理,这样可以降低耦合

2.创建一个AddressServiceImpl类实现接口中抽象方法

@Service
public class IAddressServiceImpl implements IAddressService {@Autowiredprivate AddressMapper addressMapper;//在添加用户的收货地址的业务层依赖于DistrictService的业务层接口@Autowiredprivate IDistrictService districtService;/*** 为了方便日后修改最大收货地址数量,可以在配置文件* application.properties中定义user.address.max-count=20*/@Value("${user.address.max-count}")private Integer MaxAddress ;@Overridepublic void addAddress(Integer uid, String username, Address address) {//查询收货地址信息是否大于20Integer count = addressMapper.countAddress(uid);if(count >= MaxAddress) {throw new AddressCountLimitException("收货地址不能超过20条");}//设置信息address.setUid(uid);Integer isDelete = count == 0 ? 1 : 0;//1表示默认收货地址,0反之address.setIsDefault(isDelete);address.setCreatedTime(new Date());address.setCreatedUser(username);address.setModifiedTime(new Date());address.setModifiedUser(username);//对address对象中的数据进行补全:省市区String provinceName = districtService.getNameByCode(address.getProvinceCode());String cityName = districtService.getNameByCode(address.getCityCode());String areaName = districtService.getNameByCode(address.getAreaCode());address.setProvinceName(provinceName);address.setCityName(cityName);address.setAreaName(areaName);//插入收货地址Integer row = addressMapper.insertAddress(address);if(row != 1) {throw new InsertException("未知错误 在 新建收货地址");}}
}

别忘了在配置文件application.properties中定义user.address.max-count=20

3 单元测试

在test下的service文件夹下创建AddressServiceTests测试类

@SpringBootTest
@RunWith(SpringRunner.class)
public class AddressServiceTests {@Autowiredprivate IAddressService addressService;@Testpublic void addNewAddress() {Address address = new Address();address.setPhone("175726");address.setName("男朋友");addressService.addNewAddress(11,"mxy",address);}
}

5.控制层[Controller]

1 处理异常

义务层抛出了收货地址总数超出上限的异常,在BaseController中进行捕获处理

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

2 设计请求

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

3. 处理请求

在controller包下创建AddressController并继承BaseController,该类用来处理用户收货地址的请求和响应

/*** 用户收货地址*/
@RestController
@RequestMapping("/address")
public class AddressController extends BaseController {@Autowiredprivate IAddressService addressService;/*** 新增用户收货地址** @param address* @param session：这里使用session 是为了获取用户的uid和username* @return*/@PostMapping("/add_new_address")public JsonResult<Void> addAddress(Address address, HttpSession session) {//先获取用户uid和usernameInteger uid = getuidFromSession(session);String username = getUsernameFromSession(session);addressService.addAddress(uid, username, address);return new JsonResult<>(OK);}
}

6.前端页面

		$("#btn-add-new-address").click(function (){$.ajax({url:"/address/add_new_address",type:"POST",data:$("#form-add-new-address").serialize(),dataType:"JSON",success(e){if(e.state==200){alert("新增收货地址成功")}else{alert("新增收货地址失败")}},error(xhr){alert("新增收货地址产生未知的异常"+xhr.status)}})})