10天手敲一个SpringBoot网上商城项目(五)——收货地址列表展示功能及设置默认收货地址功能的实现

比眉伴天荒 2023-10-02 19:07 4阅读 0赞

> 静态资源及sql文件分享  
> 链接：https://pan.baidu.com/s/1X-yjmQcPD3PqS21x0HplNA?pwd=23gr  
> 提取码：23gr

#### 文章目录 ####

*   *  收货地址列表展示
     *   *  1.收货地址列表展示-持久层
         *   *  1.1规划需要执行的SQL语句
             *  1.2设计接口和抽象方法
             *  1.3编写映射
             *  1.4单元测试
         *  2.收货地址列表展示-业务层
         *   *  2.1规划异常
             *  2.2设计接口和抽象方法及实现
             *  2.3单元测试
         *  3.收货地址列表展示-控制层
         *   *  3.1处理异常
             *  3.2设计请求
             *  3.3处理请求
     *  设置默认收货地址
     *   *  1.设置默认收货地址-持久层
         *   *  1.1规划需要执行的SQL语句
             *  1.2设计接口和抽象方法
             *  1.3编写映射
             *  1.4单元测试
         *  2.设置默认收货地址-业务层
         *   *  2.1规划异常
             *  2.2设计接口和抽象方法及实现
             *  2.3单元测试
         *  3.设置默认收货地址-控制层
         *   *  3.1处理异常
             *  3.2设计请求
             *  3.3处理请求
         *  4.设置默认收货地址-前端页面

### 收货地址列表展示 ###

#### 1.收货地址列表展示-持久层 ####

##### 1.1规划需要执行的SQL语句 #####

数据库数据的查询操作

select * from t_address where uid ? order by is_default DESC,created_time DESC

其中order by is\_default DESC是为了让默认收货地址展示在最上面,order by可以有多个字句,中间用逗号隔开,后面加的create\_time DESC是为了让非默认收货地址创建的越晚越展示在上面

##### 1.2设计接口和抽象方法 #####

在AddressMapper接口追加抽象方法findByUid

/**
    * 根据用户的uid查询用户的收货地址数据
    * @param uid 用户uid
    * @return 收货地址数据
    */
    List<Address> findByUid(Integer uid);

##### 1.3编写映射 #####

在xml文件添加相应的sql语句映射

<select id="findByUid" resultMap="AddressEntityMap">
            select * from t_address where uid=#{uid}
            order by is_default DESC,created_time DESC
        </select>

##### 1.4单元测试 #####

@Test
    public void findByUid () {
        
        List<Address> list = addressMapper.findByUid(11);
        System.out.println(list);
    }

#### 2.收货地址列表展示-业务层 ####

##### 2.1规划异常 #####

该模块只是为了展示列表,不涉及到增删改,即便没有拿到任何数据,那无非就是不展示呗,所以不涉及到异常,不需要在业务层抛出异常

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

1.定义抽象方法

List<Address> getByUid(Integer uid);

2.实现该方法

@Override
    public List<Address> getByUid(Integer uid) {
        
        List<Address> list = addressMapper.findByUid(uid);
        /**
        * 收货地址列表在前端只展示了四个数据,这里让其他值为空降低数据量
        * ProvinceName,CityName,AreaName,aid,tel(确认订单页展示展示用户地
        * 址时用到tel)在展示地址列表用不到,但是后面提交订单时的地址会用到,所以这里不设为null
        * */
        for (Address address : list) {
        
            //address.setAid(null);
            address.setUid(null);
            //address.setProvinceName(null);
            address.setProvinceCode(null);
            //address.setCityName(null);
            address.setCityCode(null);
            //address.setAreaName(null);
            address.setAreaCode(null);
            address.setZip(null);
            //address.setTel(null);
            address.setIsDefault(null);
            address.setCreatedTime(null);
            address.setCreatedUser(null);
            address.setModifiedTime(null);
            address.setModifiedUser(null);
        }
        return list;
    }

##### 2.3单元测试 #####

这里不再进行单元测试

#### 3.收货地址列表展示-控制层 ####

##### 3.1处理异常 #####

因为业务层没有抛出异常,所以这里不需要处理异常

##### 3.2设计请求 #####

*  /addresses
 *  HttpSession session
 *  get(该功能模块只需要uid,不需要别的数据,而且uid也是在后端封装的,所以前端没有提交什么数据,体量很小可以用get)
 *  JsonResult<List<Address>>

##### 3.3处理请求 #####

实现请求方法的编写

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

启动服务,登录账号后在地址栏输入http://localhost:8080/addresses测试能否拿到数据

\#\#\#4.收货地址列表展示-前端页面

在address.html中编写js代码

### 设置默认收货地址 ###

#### 1.设置默认收货地址-持久层 ####

##### 1.1规划需要执行的SQL语句 #####

无论选择的是哪一条数据,都把所有的数据设为非默认,再把当前数据设为默认

> 我们可能会想着把第一条设为非默认,再将该条设为默认,但这样处理的话需要额外做一条查询语句拿到默认地址的数据

1.检测当前用户想设置为默认收货地址的这条数据是否存在

select * from t_address where aid=?

2.在修改用户的默认收货地址之前先将所有的收货地址设置为非默认

update t_address set is_default=0 where uid=?

3.将用户选中的这条记录设置为默认收货地址

update t_address set is_default=1,modified_user=?,modified_time=? where aid=?

##### 1.2设计接口和抽象方法 #####

在AddressMapper接口中来定义实现该模块所需的三个方法

/**
    * 根据aid查询收货地址数据
    * @param aid 收货地址aid
    * @return 收货地址数据,如果没有找到则返回null值
    */
    Address findByAid(Integer aid);
    
    /**
    * 根据用户uid修改用户的收货地址统一设置为非默认
    * @param uid 用户uid
    * @return 受影响的行数
    */
    Integer updateNonDefault(Integer uid);
    
    
    Integer updateDefaultByAid(
        @Param("aid") Integer aid,
        @Param("modifiedUser") String modifiedUser,
        @Param("modifiedTime") Date modifiedTime);

##### 1.3编写映射 #####

在AddressMapper.xml中编写映射

<select id="findByAid" resultMap="AddressEntityMap">
        select * from t_address where aid=#{aid}
    </select>
    
    <update id="updateNonDefault">
        update t_address
        set is_default=0
        where uid=#{uid}
    </update>
    
    <update id="updateDefaultByAid">
        update t_address
        set is_default=1,
        modified_user=#{modifiedUser},
        modified_time=#{modifiedTime}
        where aid=#{aid}
    </update>

##### 1.4单元测试 #####

@Test
        public void findByAid() {
        
            System.err.println(addressMapper.findByAid(9));
        }
    
        @Test
        public void updateNonDefault() {
        
            System.out.println(addressMapper.updateNonDefault(11));//有几条数据影响行数就输出几
        }
    
        @Test
        public void updateDefaultByAid() {
        
            addressMapper.updateDefaultByAid(9,"明明",new Date());
        }

#### 2.设置默认收货地址-业务层 ####

##### 2.1规划异常 #####

*  在执行更新时产生未知的UpdateException异常,已经创建无需重复创建
 *  访问的数据不是当前登录用户的收货地址数据,属于非法访问,AccessDeniedException异常(就比如说,展示收货地址列表的sql语句写错了,然后这里展示的是别人的收货地址,此时想要将某个收货地址改为默认就属于非法访问了)
 *  收货地址可能不存在的AddressNotFoundException异常,(比如,刚展示完收货地址列表,管理员误删地址了,此时地址就不存在了)

在业务层的ex包下创建如下两个异常类,并使其继承ServiceException类

/**收货地址数据不存在的异常*/
    public class AddressNotFoundException extends ServiceException {
        
        /**重写ServiceException的所有构造方法*/
    }

/**非法访问的异常*/
    public class AccessDeniedException extends ServiceException {
        
        /**重写ServiceException的所有构造方法*/
    }

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

1.在IAddressService接口中编写抽象方法setDefault,并使其在方法内部统一实现持久层的三个方法

分析一下该方法需要什么参数:

> 先看持久层的三个方法需要什么参数:aid,uid,modifiedUser,modifiedTime.
> 
> 其中aid是从前端一步一步传到业务层的,所以需要该参数
> 
> uid和modifiedUser是一样的,都是由控制层从session获取的uid并传给业务层,所以需要该参数
> 
> modifiedTime可以在业务层new Date,所以不需要该参数

/**
    * 修改某个用户的某条收货地址数据为默认收货地址
    * @param aid 收货地址的id
    * @param uid 用户id
    * @param username 修改执行人
    */
    void setDefault(Integer aid,Integer uid,String username);

2.在AddressServiceImpl类编写该方法的实现

@Override
        public void setDefault(Integer aid, Integer uid, String username) {
        
    
            //1.检测是否有该条收货地址数据
            Address result = addressMapper.findByAid(aid);
            if (result == null) {
        
                throw new AddressNotFoundException("收货地址不存在");
            }
    
            //2.检测当前获取到的收货地址数据的归属
            if (!result.getUid().equals(uid)) {
        
                throw new AccessDeniedException("非法数据访问");
            }
    
            //3.先将所有的收货地址设置为非默认
            Integer rows = addressMapper.updateNonDefault(uid);
            if (rows < 1) {
        
                throw new UpdateException("更新数据时产生未知的异常");
            }
    
            //4.将用户选中的地址设置为默认收货地址
            rows = addressMapper.updateDefaultByAid(aid, username, new Date());
            if (rows != 1) {
        
                throw new UpdateException("更新数据时产生未知的异常");
            }
        }

##### 2.3单元测试 #####

在AddressServiceTests类中编写单元测试方法

@Test
    public void setDefault() {
        
        addressService.setDefault(9,11,"管理员");
    }

#### 3.设置默认收货地址-控制层 ####

##### 3.1处理异常 #####

在BaseController类中处理业务层抛出的两个异常

else if (e instanceof AddressNotFoundException) {
        
        result.setState(4004);
        result.setMessage("用户的收货地址数据不存在的异常");
    } else if (e instanceof AccessDeniedException) {
        
        result.setState(4005);
        result.setMessage("收货地址数据非法访问的异常");
    }

##### 3.2设计请求 #####

*  /addresses/\{aid\}/set\_default(以前的数据是通过表单直接提交的,还有一种提交方式就是RestFul风格,这种提交方式可以提交更多的数据,这里用这个提交方式)
 *  GET
 *  Integer aid,HttpSession session(如果这里是id那就必须在Integer aid前加@PathVariable(“aid”)强行将aid的值注入到id中)
 *  JsonResult<Void>

##### 3.3处理请求 #####

在AddressController类中编写请求处理方法.

**RestFul编写时不管参数名和占位符是否一致都必须加@PathVariable(“aid”)**

//RestFul风格的请求编写
    @RequestMapping("{aid}/set_default")
    public JsonResult<Void> setDefault(
        @PathVariable("aid") Integer aid,HttpSession session) {
        
        addressService.setDefault(
            aid,
            getUidFromSession(session),
            getUsernameFromSession(session));
        return new JsonResult<>(OK);
    }

启动服务,登录账号后在地址栏输入http://localhost:8080/addresses/8/set\_default进行测试

#### 4.设置默认收货地址-前端页面 ####

观察address.html代码发现"设为默认"按钮没有id属性,那应该怎么获取"设为默认"按钮以监听是否被点击了呢?

法一:给"设为默认"的标签添加id属性(我觉得不对,因为id必须是唯一的,如果给该按钮加id属性,那么该用户有几个收货地址就会给几个按钮加同样的id,这显然不对,我认为可以用按钮上本就存在的class属性)。

法二:给"设置默认"按钮添加一个onclick属性,指向一个方法的调用,在这个方法中来完成ajax请求的方法

在这里用第二种方法:

1.展示用户收货地址数据列表的js函数中用for循环给页面增加地址数据的tr标签,我们需要在for循环中为每一个tr标签增加onclick属性并指向setDefault(\#\{aid\})函数,括号里面占位符是为了给外部的setDefault函数传参,可以随便写,只要给占位符赋值时对应就可以了,.**注意,即使调用的是无参函数也要加括号**

2.在for循环中为占位符赋值:

tr = tr.replace("#{aid}",list[i].aid);

3.完成setDefault方法的声明