SpringBoot项目--电脑商城【收货地址列表展示和设置默认地址】

1.收货地址列表展示

1.1 持久层[Mapper]

a. 规划需要执行的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是为了让非默认收货地址创建的越晚越展示在上面

b.设计接口和抽象方法

在AddressMapper接口追加抽象方法findByUid

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

c.编写映射

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

d.单元测试

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

1.2 业务层[Service]

a.规划异常

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

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

1.定义抽象方法

    /**
     * 获取uid对应用户的所有地址信息,用于展示
     * @param uid 用户uid
48     * @return 地址信息list
     */
    List<Address> getByUid(Integer uid);

2.实现该方法

    /**
     * 获取uid对应用户的所有地址信息,用于展示
     *
     * @param uid 用户uid
     * @return 地址信息list
     */
    @Override
    public List<Address> getByUid(Integer uid) {
        List<Address> list = addressMapper.findByUid(uid);
        for (Address address :list){
            //因为就只需要展示4条数据，则将其他不用的不展示
            //address.setUid(null);
            //address.setAid(null);
            address.setProvinceName(null);
            address.setProvinceCode(null);
            address.setCityName(null);
            address.setCityCode(null);
            address.setAreaName(null);
            address.setAreaCode(null);
            address.setZip(null);
            address.setPhone(null);
            address.setTel(null);
            address.setCreatedTime(null);
            address.setIsDefault(null);
            address.setCreatedUser(null);
            address.setModifiedTime(null);
            address.setModifiedUser(null);
        }
        return list;
    }

c.单元测试

这里省略

1. 3.控制层[controller]

a. 处理异常

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

b. 设计请求

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

c.处理请求

    /**
     * 根据用户id展示用户已经填写的地址数据
     *
     * @param session
     * @return
     */
    @GetMapping({"", ""})
    public JsonResult<List<Address>> getByUid(HttpSession session) {
        Integer uid = getuidFromSession(session);
        List<Address> data = addressService.getByUid(uid);
        return new JsonResult<>(OK, data);
    }

1.4 前端页面

在address.html中编写js代码

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

/**展示用户收货地址数据列表*/
function showAddressList() {
    $("#address-list").empty();
    $.ajax({
        url: "/addresses",
        type: "get",
        //data: "parent=86",//不需要提交数据,所以data可以删去
        dataType: "JSON",
        success: function (json) {
            if (json.state == 200) {
                var list = json.data;
                console.log(list);//调试用
                for (var i = 0; i < list.length; i++) {
                    //先写一个var tr = ''; 然后去上面的地址展示中找一个tr标签复制粘贴到单引号里面,再删去多余的制表符
                    var tr = '<tr>\n' +
                        '<td>#{tag}</td>\n' +
                        '<td>#{name}</td>\n' +
                        '<td>#{address}</td>\n' +
                        '<td>#{phone}</td>\n' +
                        '<td><a class="btn btn-xs btn-info"><span class="fa fa-edit"></span> 修改</a></td>\n' +
                        '<td><a class="btn btn-xs add-del btn-info"><span class="fa fa-trash-o"></span> 删除</a></td>\n' +
                        '<td><a class="btn btn-xs add-def btn-default">设为默认</a></td>\n' +
                        '</tr>';
                    //下面用正则表达式更改字符串,上面的#{tag}#{name}等等只
                    //是占位符,没有任何意义,我也可以把#{tag}写成任何想写的东西
                    //replace的第一个参数/占位符/g可以,"占位符"也可以
                    tr = tr.replace(/#{tag}/g,list[i].tag);
                    tr = tr.replace(/#{name}/g,list[i].name);
                    tr = tr.replace("#{address}",list[i].address);
                    tr = tr.replace("#{phone}",list[i].phone);

                    $("#address-list").append(tr);
                }

                //用hide方法将第一个收货地址的"设为默认"元素隐藏,.add-def:eq(0)表
                //示第一个class为add-def的标签,这样就可以保证隐藏的是第一个收货地址
                $(".add-def:eq(0)").hide();
            } else {
                <!--这个其实永远不会执行,因为没有编写
                异常,控制层返回的状态码永远是OK-->
                alert("用户收货地址数据加载失败")
            }
        }
    });
}
</script>

2.设置默认地址

2.1 持久层[Mapper]

a. 规划需要执行的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=?

b.设计接口和抽象方法

在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);

c.编写映射

在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>

d.单元测试

    @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.业务层[Service]

1规划异常

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

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

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

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

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("更新数据时产生未知的异常");
        }
    }

3单元测试

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

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

3.控制层[controller]

1处理异常

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

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

2设计请求

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

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);
}

4.前端页面

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

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

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

<td><a onclick="setDefault(#{aid})" class="btn btn-xs add-def btn-default">设为默认</a></td>

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

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

3.完成setDefault方法的声明

function setDefault(aid) {
    $.ajax({
        url: "/addresses/"+aid+"/set_default",
        type: "POST",
        //data: $("#form-change-password").serialize(),
        dataType: "JSON",
        success: function (json) {
            if (json.state == 200) {
                //重新加载收货地址列表页面
                showAddressList();
            } else {
                alert("设置默认收货地址失败")
            }
        },
        error: function (xhr) {
            alert("设置默认收货地址时产生未知的异常!"+xhr.message);
        }
    });
}