苍穹外卖--sky-take-out(三)6-9

苍穹外卖--sky-take-out(一)

苍穹外卖--sky-take-out(一)-CSDN博客icon-default.png?t=N7T8https://blog.csdn.net/kussm_/article/details/138614737?spm=1001.2014.3001.5501

苍穹外卖--sky-take-out(二)

苍穹外卖--sky-take-out(二)3-5-CSDN博客icon-default.png?t=N7T8https://blog.csdn.net/kussm_/article/details/139378730?spm=1001.2014.3001.5501


第六天

HttpClient

介绍

HttpClient 是Apache Jakarta Common 下的子项目,可以用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包,并且它支持 HTTP 协议最新的版本和建议。

HttpClient作用:

发送HTTP请求

接收响应数据

HttpClient应用场景:

当我们在使用扫描支付、查看地图、获取验证码、查看天气等功能时,其实,应用程序本身并未实现这些功能,都是在应用程序里访问提供这些功能的服务,访问这些服务需要发送HTTP请求,并且接收响应数据,可通过HttpClient来实现。

HttpClient的maven坐标:

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>

HttpClient的核心API:

  • HttpClient:Http客户端对象类型,使用该类型对象可发起Http请求。

  • HttpClients:可认为是构建器,可创建HttpClient对象。

  • CloseableHttpClient:实现类,实现了HttpClient接口。

  • HttpGet:Get方式请求类型。

  • HttpPost:Post方式请求类型。

HttpClient发送请求步骤:

  • 创建HttpClient对象

  • 创建Http请求对象

  • 调用HttpClient的execute方法发送请求

入门案例

GET请求

首先,应该导入HttpClient相关的坐标 ,项目中已经引入了aliyun-sdk-oss坐标

<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
</dependency>

进入到sky-server模块,编写测试代码,发送GET请求。

实现步骤:

  1. 创建HttpClient对象

  2. 创建请求对象

  3. 发送请求,接受响应结果

  4. 解析结果

  5. 关闭资源

POST请求

实现步骤:

  1. 创建HttpClient对象

  2. 创建请求对象

  3. 发送请求,接收响应结果

  4. 解析响应结果

  5. 关闭资源

/**
     * 测试通过httpclient发送POST方式的请求
     */
    @Test
    public void testPOST() throws Exception{
        // 创建httpclient对象
        CloseableHttpClient httpClient = HttpClients.createDefault();

        //创建请求对象
        HttpPost httpPost = new HttpPost("http://localhost:8080/admin/employee/login");

        JSONObject jsonObject = new JSONObject();
        jsonObject.put("username","admin");
        jsonObject.put("password","123456");

        StringEntity entity = new StringEntity(jsonObject.toString());
        //指定请求编码方式
        entity.setContentEncoding("utf-8");
        //数据格式
        entity.setContentType("application/json");
        httpPost.setEntity(entity);

        //发送请求
        CloseableHttpResponse response = httpClient.execute(httpPost);

        //解析返回结果
        int statusCode = response.getStatusLine().getStatusCode();
        System.out.println("响应码为:" + statusCode);

        HttpEntity entity1 = response.getEntity();
        String body = EntityUtils.toString(entity1);
        System.out.println("响应数据为:" + body);

        //关闭资源
        response.close();
        httpClient.close();
    }

微信小程序开发

官方网址:微信小程序

准备工作

注册小程序

完善小程序信息

下载开发者工具

1). 注册小程序

注册地址:小程序

2). 完善小程序信息

登录小程序后台:微信公众平台

完善小程序信息、小程序类目

查看小程序的 AppID

3). 下载开发者工具

下载地址: 微信开发者工具(稳定版 Stable Build)下载地址与更新日志 | 微信开放文档

创建小程序项目

设置不校验合法域名,注:开发阶段,小程序发出请求到后端的Tomcat服务器,若不勾选,请求发送失败。

微信登录

导入小程序代码

1.找到资料

2. 导入代码

AppID:使用自己的AppID

3.查看项目结构

主体的文件:app.js app.json app.wxss 项目的页面比较多,主要存放在pages目录。

4.修改配置

因为小程序要请求后端服务,需要修改为自己后端服务的ip地址和端口号(默认不需要修改)

common-->vendor.js-->搜索(ctrl+f)-->baseUri

微信登录流程

微信登录:小程序登录 | 微信开放文档

流程图:

步骤分析:

  1. 小程序端,调用wx.login()获取code,就是授权码。

  2. 小程序端,调用wx.request()发送请求并携带code,请求开发者服务器(自己编写的后端服务)。

  3. 开发者服务端,通过HttpClient向微信接口服务发送请求,并携带appId+appsecret+code三个参数。

  4. 开发者服务端,接收微信接口服务返回的数据,session_key+opendId等。opendId是微信用户的唯一标识。

  5. 开发者服务端,自定义登录态,生成令牌(token)和openid等数据返回给小程序端,方便后绪请求身份校验。

  6. 小程序端,收到自定义登录态,存储storage。

  7. 小程序端,后绪通过wx.request()发起业务请求时,携带token。

  8. 开发者服务端,收到请求后,通过携带的token,解析当前登录用户的id。

  9. 开发者服务端,身份校验通过后,继续相关的业务逻辑处理,最终返回业务数据。

需求分析和设计

产品原型

业务规则:

  • 基于微信登录实现小程序的登录功能

  • 如果是新用户需要自动完成注册

接口设计

表设计

当用户第一次使用小程序时,会完成自动注册,把用户信息存储到user表中。

字段名数据类型说明备注
idbigint主键自增
openidvarchar(45)微信用户的唯一标识
namevarchar(32)用户姓名
phonevarchar(11)手机号
sexvarchar(2)性别
id_numbervarchar(18)身份证号
avatarvarchar(500)微信用户头像路径
create_timedatetime注册时间

代码开发

3.4.1 定义相关配置

配置微信登录所需配置项:

application-dev.yml

sky:
  wechat:
    appid: wxffb3637a228223b8
    secret: 84311df9199ecacdf4f12d27b6b9522d

application.yml

sky:
  wechat:
    appid: ${sky.wechat.appid}
    secret: ${sky.wechat.secret}

配置为微信用户生成jwt令牌时使用的配置项:

application.yml

sky:
  jwt:
    # 设置jwt签名加密时使用的秘钥
    admin-secret-key: itcast
    # 设置jwt过期时间
    admin-ttl: 7200000
    # 设置前端传递过来的令牌名称
    admin-token-name: token
    user-secret-key: itheima
    user-ttl: 7200000
    user-token-name: authentication

3.4.2 DTO设计

根据传入参数设计DTO类:

在sky-pojo模块,UserLoginDTO.java已定义

package com.sky.dto;
​
import lombok.Data;
​
import java.io.Serializable;
​
/**
 * C端用户登录
 */
@Data
public class UserLoginDTO implements Serializable {
​
    private String code;
​
}

3.4.3 VO设计

根据返回数据设计VO类:

在sky-pojo模块,UserLoginVO.java已定义

package com.sky.vo;
​
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
​
import java.io.Serializable;
​
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class UserLoginVO implements Serializable {
​
    private Long id;
    private String openid;
    private String token;
​
}

3.4.4 Controller层

根据接口定义创建UserController的login方法:

package com.sky.controller.user;
​
import com.sky.constant.JwtClaimsConstant;
import com.sky.dto.UserLoginDTO;
import com.sky.entity.User;
import com.sky.properties.JwtProperties;
import com.sky.result.Result;
import com.sky.service.UserService;
import com.sky.utils.JwtUtil;
import com.sky.vo.UserLoginVO;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
import java.util.Map;
​
@RestController
@RequestMapping("/user/user")
@Api(tags = "C端用户相关接口")
@Slf4j
public class UserController {
​
    @Autowired
    private UserService userService;
    @Autowired
    private JwtProperties jwtProperties;
​
    /**
     * 微信登录
     * @param userLoginDTO
     * @return
     */
    @PostMapping("/login")
    @ApiOperation("微信登录")
    public Result<UserLoginVO> login(@RequestBody UserLoginDTO userLoginDTO){
        log.info("微信用户登录:{}",userLoginDTO.getCode());
​
        //微信登录
        User user = userService.wxLogin(userLoginDTO);//后绪步骤实现
​
        //为微信用户生成jwt令牌
        Map<String, Object> claims = new HashMap<>();
        claims.put(JwtClaimsConstant.USER_ID,user.getId());
        String token = JwtUtil.createJWT(jwtProperties.getUserSecretKey(), jwtProperties.getUserTtl(), claims);
​
        UserLoginVO userLoginVO = UserLoginVO.builder()
                .id(user.getId())
                .openid(user.getOpenid())
                .token(token)
                .build();
        return Result.success(userLoginVO);
    }
}

其中,JwtClaimsConstant.USER_ID常量已定义。

3.4.5 Service层接口

创建UserService接口:

package com.sky.service;
​
import com.sky.dto.UserLoginDTO;
import com.sky.entity.User;
​
public interface UserService {
​
    /**
     * 微信登录
     * @param userLoginDTO
     * @return
     */
    User wxLogin(UserLoginDTO userLoginDTO);
}

3.4.6 Service层实现类

创建UserServiceImpl实现类:实现获取微信用户的openid和微信登录功能

package com.sky.service.impl;
​
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.sky.constant.MessageConstant;
import com.sky.dto.UserLoginDTO;
import com.sky.entity.User;
import com.sky.exception.LoginFailedException;
import com.sky.mapper.UserMapper;
import com.sky.properties.WeChatProperties;
import com.sky.service.UserService;
import com.sky.utils.HttpClientUtil;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
​
import java.time.LocalDateTime;
import java.util.HashMap;
import java.util.Map;
​
@Service
@Slf4j
public class UserServiceImpl implements UserService {
​
    //微信服务接口地址
    public static final String WX_LOGIN = "https://api.weixin.qq.com/sns/jscode2session";
​
    @Autowired
    private WeChatProperties weChatProperties;
    @Autowired
    private UserMapper userMapper;
​
    /**
     * 微信登录
     * @param userLoginDTO
     * @return
     */
    public User wxLogin(UserLoginDTO userLoginDTO) {
        String openid = getOpenid(userLoginDTO.getCode());
​
        //判断openid是否为空,如果为空表示登录失败,抛出业务异常
        if(openid == null){
            throw new LoginFailedException(MessageConstant.LOGIN_FAILED);
        }
​
        //判断当前用户是否为新用户
        User user = userMapper.getByOpenid(openid);
​
        //如果是新用户,自动完成注册
        if(user == null){
            user = User.builder()
                    .openid(openid)
                    .createTime(LocalDateTime.now())
                    .build();
            userMapper.insert(user);//后绪步骤实现
        }
​
        //返回这个用户对象
        return user;
    }
​
    /**
     * 调用微信接口服务,获取微信用户的openid
     * @param code
     * @return
     */
    private String getOpenid(String code){
        //调用微信接口服务,获得当前微信用户的openid
        Map<String, String> map = new HashMap<>();
        map.put("appid",weChatProperties.getAppid());
        map.put("secret",weChatProperties.getSecret());
        map.put("js_code",code);
        map.put("grant_type","authorization_code");
        String json = HttpClientUtil.doGet(WX_LOGIN, map);
​
        JSONObject jsonObject = JSON.parseObject(json);
        String openid = jsonObject.getString("openid");
        return openid;
    }
}

3.4.7 Mapper层

创建UserMapper接口:

package com.sky.mapper;
​
import com.sky.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;
​
@Mapper
public interface UserMapper {
​
    /**
     * 根据openid查询用户
     * @param openid
     * @return
     */
    @Select("select * from user where openid = #{openid}")
    User getByOpenid(String openid);
​
    /**
     * 插入数据
     * @param user
     */
    void insert(User user);
}

创建UserMapper.xml映射文件:

<?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.sky.mapper.UserMapper">
​
    <insert id="insert" useGeneratedKeys="true" keyProperty="id">
        insert into user (openid, name, phone, sex, id_number, avatar, create_time)
        values (#{openid}, #{name}, #{phone}, #{sex}, #{idNumber}, #{avatar}, #{createTime})
    </insert>
​
</mapper>

3.4.8 编写拦截器

编写拦截器JwtTokenUserInterceptor:统一拦截用户端发送的请求并进行jwt校验

package com.sky.interceptor;
​
import com.sky.constant.JwtClaimsConstant;
import com.sky.context.BaseContext;
import com.sky.properties.JwtProperties;
import com.sky.utils.JwtUtil;
import io.jsonwebtoken.Claims;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.HandlerInterceptor;
​
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
​
/**
 * jwt令牌校验的拦截器
 */
@Component
@Slf4j
public class JwtTokenUserInterceptor implements HandlerInterceptor {
​
    @Autowired
    private JwtProperties jwtProperties;
​
    /**
     * 校验jwt
     *
     * @param request
     * @param response
     * @param handler
     * @return
     * @throws Exception
     */
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        //判断当前拦截到的是Controller的方法还是其他资源
        if (!(handler instanceof HandlerMethod)) {
            //当前拦截到的不是动态方法,直接放行
            return true;
        }
​
        //1、从请求头中获取令牌
        String token = request.getHeader(jwtProperties.getUserTokenName());
​
        //2、校验令牌
        try {
            log.info("jwt校验:{}", token);
            Claims claims = JwtUtil.parseJWT(jwtProperties.getUserSecretKey(), token);
            Long userId = Long.valueOf(claims.get(JwtClaimsConstant.USER_ID).toString());
            log.info("当前用户的id:", userId);
            BaseContext.setCurrentId(userId);
            //3、通过,放行
            return true;
        } catch (Exception ex) {
            //4、不通过,响应401状态码
            response.setStatus(401);
            return false;
        }
    }
}

在WebMvcConfiguration配置类中注册拦截器:

    @Autowired
    private JwtTokenUserInterceptor jwtTokenUserInterceptor;
    /**
     * 注册自定义拦截器
     * @param registry
     */
    protected void addInterceptors(InterceptorRegistry registry) {
        log.info("开始注册自定义拦截器...");
        //.........
​
        registry.addInterceptor(jwtTokenUserInterceptor)
                .addPathPatterns("/user/**")
                .excludePathPatterns("/user/user/login")
                .excludePathPatterns("/user/shop/status");
    }

导入商品浏览功能代码

需求分析和设计

接口设计:

  • 查询分类

  • 根据分类id查询菜品

  • 根据分类id查询套餐

  • 根据套餐id查询包含的菜品

代码导入


第七天

缓存菜品

问题分析

用户端小程序展示的菜品数据都是通过查询数据库获得,如果用户端访问量比较大,数据库访问压力随之增大。

实现思路

通过Redis来缓存菜品数据,减少数据库查询操作。

缓存逻辑分析:

  • 每个分类下的菜品保存一份缓存数据

  • 数据库中菜品数据有变更时清理缓存数据

代码开发

修改用户端接口 DishController 的 list 方法,加入缓存处理逻辑:

	@Autowired
    private RedisTemplate redisTemplate;
	/**
     * 根据分类id查询菜品
     *
     * @param categoryId
     * @return
     */
    @GetMapping("/list")
    @ApiOperation("根据分类id查询菜品")
    public Result<List<DishVO>> list(Long categoryId) {

        //构造redis中的key,规则:dish_分类id
        String key = "dish_" + categoryId;

        //查询redis中是否存在菜品数据
        List<DishVO> list = (List<DishVO>) redisTemplate.opsForValue().get(key);
        if(list != null && list.size() > 0){
            //如果存在,直接返回,无须查询数据库
            return Result.success(list);
        }
		
        Dish dish = new Dish();
        dish.setCategoryId(categoryId);
        dish.setStatus(StatusConstant.ENABLE);//查询起售中的菜品

        //如果不存在,查询数据库,将查询到的数据放入redis中
        list = dishService.listWithFlavor(dish);
        
        redisTemplate.opsForValue().set(key, list);

        return Result.success(list);
    }

为了保证数据库Redis中的数据保持一致,修改管理端接口 DishController 的相关方法,加入清理缓存逻辑。

需要改造的方法:

  • 新增菜品

  • 修改菜品

  • 批量删除菜品

  • 起售、停售菜品

抽取清理缓存的方法:

DishController 添加

@Autowired
    private RedisTemplate redisTemplate;
	/**
     * 清理缓存数据
     * @param pattern
     */
    private void cleanCache(String pattern){
        Set keys = redisTemplate.keys(pattern);
        redisTemplate.delete(keys);
    }

 调用清理缓存的方法,保证数据一致性:

1). 新增菜品优化

    /**
     * 新增菜品
     *
     * @param dishDTO
     * @return
     */
    @PostMapping
    @ApiOperation("新增菜品")
    public Result save(@RequestBody DishDTO dishDTO) {
        log.info("新增菜品:{}", dishDTO);
        dishService.saveWithFlavor(dishDTO);
​
        //清理缓存数据
        String key = "dish_" + dishDTO.getCategoryId();
        cleanCache(key);
        return Result.success();
    }

2). 菜品批量删除优化

    /**
     * 菜品批量删除
     *
     * @param ids
     * @return
     */
    @DeleteMapping
    @ApiOperation("菜品批量删除")
    public Result delete(@RequestParam List<Long> ids) {
        log.info("菜品批量删除:{}", ids);
        dishService.deleteBatch(ids);
​
        //将所有的菜品缓存数据清理掉,所有以dish_开头的key
        cleanCache("dish_*");
​
        return Result.success();
    }

3). 修改菜品优化

    /**
     * 修改菜品
     *
     * @param dishDTO
     * @return
     */
    @PutMapping
    @ApiOperation("修改菜品")
    public Result update(@RequestBody DishDTO dishDTO) {
        log.info("修改菜品:{}", dishDTO);
        dishService.updateWithFlavor(dishDTO);
​
        //将所有的菜品缓存数据清理掉,所有以dish_开头的key
        cleanCache("dish_*");
​
        return Result.success();
    }

4). 菜品起售停售优化

    /**
     * 菜品起售停售
     *
     * @param status
     * @param id
     * @return
     */
    @PostMapping("/status/{status}")
    @ApiOperation("菜品起售停售")
    public Result<String> startOrStop(@PathVariable Integer status, Long id) {
        dishService.startOrStop(status, id);
​
        //将所有的菜品缓存数据清理掉,所有以dish_开头的key
        cleanCache("dish_*");
​
        return Result.success();
    }

缓存套餐

Spring Cache

Spring Cache 是一个框架,实现了基于注解的缓存功能,只需要简单地加一个注解,就能实现缓存功能。

Spring Cache 提供了一层抽象,底层可以切换不同的缓存实现:

EHCache

Caffeine

Redis(常用)

起步依赖:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-cache</artifactId>                                          <version>2.7.3</version> 
</dependency>

常用注解:

举例演示:

1.引导类上加@EnableCaching

2.@CachePut注解

说明:key的写法如下

#user.id : #user指的是方法形参的名称, id指的是user的id属性 , 也就是使用user的id属性作为key ;

#result.id : #result代表方法返回值,该表达式 代表以返回对象的id属性作为key ;

#p0.id:#p0指的是方法中的第一个参数,id指的是第一个参数的id属性,也就是使用第一个参数的id属性作为key ;

#a0.id:#a0指的是方法中的第一个参数,id指的是第一个参数的id属性,也就是使用第一个参数的id属性作为key ;

#root.args[0].id:#root.args[0]指的是方法中的第一个参数,id指的是第一个参数的id属性,也就是使用第一个参数

的id属性作为key ;

3.@Cacheable注解  

4.@CacheEvict注解

缓存套餐的实现思路

实现步骤:

1). 导入Spring Cache和Redis相关maven坐标

2). 在启动类上加入@EnableCaching注解,开启缓存注解功能

3). 在用户端接口SetmealController的 list 方法上加入@Cacheable注解

4). 在管理端接口SetmealController的 save、delete、update、startOrStop等方法上加入CacheEvict注解

代码开发

1). 导入Spring Cache和Redis相关maven坐标(已实现)

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
​
<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-cache</artifactId>
</dependency>

2). 在启动类上加入@EnableCaching注解,开启缓存注解功能

package com.sky;
​
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cache.annotation.EnableCaching;
import org.springframework.transaction.annotation.EnableTransactionManagement;
​
@SpringBootApplication
@EnableTransactionManagement //开启注解方式的事务管理
@Slf4j
@EnableCaching
public class SkyApplication {
    public static void main(String[] args) {
        SpringApplication.run(SkyApplication.class, args);
        log.info("server started");
    }
}

3). 在用户端接口SetmealController的 list 方法上加入@Cacheable注解

    /**
     * 条件查询
     *
     * @param categoryId
     * @return
     */
    @GetMapping("/list")
    @ApiOperation("根据分类id查询套餐")
    @Cacheable(cacheNames = "setmealCache",key = "#categoryId") //key: setmealCache::100
    public Result<List<Setmeal>> list(Long categoryId) {
        Setmeal setmeal = new Setmeal();
        setmeal.setCategoryId(categoryId);
        setmeal.setStatus(StatusConstant.ENABLE);
​
        List<Setmeal> list = setmealService.list(setmeal);
        return Result.success(list);
    }

4). 在管理端接口SetmealController的 save、delete、update、startOrStop等方法上加入CacheEvict注解

    /**
     * 新增套餐
     *
     * @param setmealDTO
     * @return
     */
    @PostMapping
    @ApiOperation("新增套餐")
    @CacheEvict(cacheNames = "setmealCache",key = "#setmealDTO.categoryId")//key: setmealCache::100
    public Result save(@RequestBody SetmealDTO setmealDTO) {
        setmealService.saveWithDish(setmealDTO);
        return Result.success();
    }
    /**
     * 批量删除套餐
     *
     * @param ids
     * @return
     */
    @DeleteMapping
    @ApiOperation("批量删除套餐")
    @CacheEvict(cacheNames = "setmealCache",allEntries = true)
    public Result delete(@RequestParam List<Long> ids) {
        setmealService.deleteBatch(ids);
        return Result.success();
    }
    /**
     * 修改套餐
     *
     * @param setmealDTO
     * @return
     */
    @PutMapping
    @ApiOperation("修改套餐")
    @CacheEvict(cacheNames = "setmealCache",allEntries = true)
    public Result update(@RequestBody SetmealDTO setmealDTO) {
        setmealService.update(setmealDTO);
        return Result.success();
    }
​
    /**
     * 套餐起售停售
     *
     * @param status
     * @param id
     * @return
     */
    @PostMapping("/status/{status}")
    @ApiOperation("套餐起售停售")
    @CacheEvict(cacheNames = "setmealCache",allEntries = true)
    public Result startOrStop(@PathVariable Integer status, Long id) {
        setmealService.startOrStop(status, id);
        return Result.success();
    }

添加购物车

接口设计

表设计

用户的购物车数据,也是需要保存在数据库中的,购物车对应的数据表为shopping_cart表,具体表结构如下:

字段名数据类型说明备注
idbigint主键自增
namevarchar(32)商品名称冗余字段
imagevarchar(255)商品图片路径冗余字段
user_idbigint用户id逻辑外键
dish_idbigint菜品id逻辑外键
setmeal_idbigint套餐id逻辑外键
dish_flavorvarchar(50)菜品口味
numberint商品数量
amountdecimal(10,2)商品单价冗余字段
create_timedatetime创建时间
  • 购物车数据是关联用户的,在表结构中,我们需要记录,每一个用户的购物车数据是哪些
  • 菜品列表展示出来的既有套餐,又有菜品,如果用户选择的是套餐,就保存套餐ID(setmeal_id),如果用户选择的是菜品,就保存菜品ID(dish_id)
  • 对同一个菜品/套餐,如果选择多份不需要添加多条记录,增加数量number即可

代码开发

DTO设计

在sky-pojo模块,ShoppingCartDTO.java已定义

package com.sky.dto;
​
import lombok.Data;
import java.io.Serializable;
​
@Data
public class ShoppingCartDTO implements Serializable {
​
    private Long dishId;
    private Long setmealId;
    private String dishFlavor;
​
}

Controller层

根据添加购物车接口创建ShoppingCartController:

package com.sky.controller.user;
​
​
import com.sky.dto.ShoppingCartDTO;
import com.sky.result.Result;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
​
/**
 * 购物车
 */
@RestController
@RequestMapping("/user/shoppingCart")
@Slf4j
@Api(tags = "C端-购物车接口")
public class ShoppingCartController {
​
    @Autowired
    private ShoppingCartService shoppingCartService;
​
    /**
     * 添加购物车
     * @param shoppingCartDTO
     * @return
     */
    @PostMapping("/add")
    @ApiOperation("添加购物车")
    public Result<String> add(@RequestBody ShoppingCartDTO shoppingCartDTO){
        log.info("添加购物车:{}", shoppingCartDTO);
        shoppingCartService.addShoppingCart(shoppingCartDTO);//后绪步骤实现
        return Result.success();
    }
}

Service层接口

创建ShoppingCartService接口:

package com.sky.service;
​
import com.sky.dto.ShoppingCartDTO;
import com.sky.entity.ShoppingCart;
import java.util.List;
​
public interface ShoppingCartService {
​
    /**
     * 添加购物车
     * @param shoppingCartDTO
     */
    void addShoppingCart(ShoppingCartDTO shoppingCartDTO);
}

Service层实现类

创建ShoppingCartServiceImpl实现类,并实现add方法:

package com.sky.service.impl;
​
​
import com.sky.context.BaseContext;
import com.sky.dto.ShoppingCartDTO;
import com.sky.entity.Dish;
import com.sky.entity.Setmeal;
import com.sky.entity.ShoppingCart;
import com.sky.mapper.DishMapper;
import com.sky.mapper.SetmealMapper;
import com.sky.service.ShoppingCartService;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.time.LocalDateTime;
import java.util.List;
​
@Service
public class ShoppingCartServiceImpl implements ShoppingCartService {
​
    @Autowired
    private ShoppingCartMapper shoppingCartMapper;
    @Autowired
    private DishMapper dishMapper;
    @Autowired
    private SetmealMapper setmealMapper;
    
    /**
     * 添加购物车
     *
     * @param shoppingCartDTO
     */
    public void addShoppingCart(ShoppingCartDTO shoppingCartDTO) {
        ShoppingCart shoppingCart = new ShoppingCart();
        BeanUtils.copyProperties(shoppingCartDTO, shoppingCart);
        //只能查询自己的购物车数据
        shoppingCart.setUserId(BaseContext.getCurrentId());
​
        //判断当前商品是否在购物车中
        List<ShoppingCart> shoppingCartList = shoppingCartMapper.list(shoppingCart);
​
        if (shoppingCartList != null && shoppingCartList.size() == 1) {
            //如果已经存在,就更新数量,数量加1
            shoppingCart = shoppingCartList.get(0);
            shoppingCart.setNumber(shoppingCart.getNumber() + 1);
            shoppingCartMapper.updateNumberById(shoppingCart);
        } else {
            //如果不存在,插入数据,数量就是1
​
            //判断当前添加到购物车的是菜品还是套餐
            Long dishId = shoppingCartDTO.getDishId();
            if (dishId != null) {
                //添加到购物车的是菜品
                Dish dish = dishMapper.getById(dishId);
                shoppingCart.setName(dish.getName());
                shoppingCart.setImage(dish.getImage());
                shoppingCart.setAmount(dish.getPrice());
            } else {
                //添加到购物车的是套餐
                Setmeal setmeal = setmealMapper.getById(shoppingCartDTO.getSetmealId());
                shoppingCart.setName(setmeal.getName());
                shoppingCart.setImage(setmeal.getImage());
                shoppingCart.setAmount(setmeal.getPrice());
            }
            shoppingCart.setNumber(1);
            shoppingCart.setCreateTime(LocalDateTime.now());
            shoppingCartMapper.insert(shoppingCart);
        }
    }
}

Mapper层

创建ShoppingCartMapper接口:

package com.sky.mapper;
​
import com.sky.entity.ShoppingCart;
import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Update;
import java.util.List;
​
@Mapper
public interface ShoppingCartMapper {
    /**
     * 条件查询
     *
     * @param shoppingCart
     * @return
     */
    List<ShoppingCart> list(ShoppingCart shoppingCart);
​
    /**
     * 更新商品数量
     *
     * @param shoppingCart
     */
    @Update("update shopping_cart set number = #{number} where id = #{id}")
    void updateNumberById(ShoppingCart shoppingCart);
​
    /**
     * 插入购物车数据
     *
     * @param shoppingCart
     */
    @Insert("insert into shopping_cart (name, user_id, dish_id, setmeal_id, dish_flavor, number, amount, image, create_time) " +
            " values (#{name},#{userId},#{dishId},#{setmealId},#{dishFlavor},#{number},#{amount},#{image},#{createTime})")
    void insert(ShoppingCart shoppingCart);
​
}

创建ShoppingCartMapper.xml:

<?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.sky.mapper.ShoppingCartMapper">
    <select id="list" parameterType="ShoppingCart" resultType="ShoppingCart">
        select * from shopping_cart
        <where>
            <if test="userId != null">
                and user_id = #{userId}
            </if>
            <if test="dishId != null">
                and dish_id = #{dishId}
            </if>
            <if test="setmealId != null">
                and setmeal_id = #{setmealId}
            </if>
            <if test="dishFlavor != null">
                and dish_flavor = #{dishFlavor}
            </if>
        </where>
        order by create_time desc
    </select>
</mapper>

查看购物车

产品原型

接口设计

代码开发

Controller层

在ShoppingCartController中创建查看购物车的方法

	/**
     * 查看购物车
     * @return
     */
    @GetMapping("/list")
    @ApiOperation("查看购物车")
    public Result<List<ShoppingCart>> list(){
        return Result.success(shoppingCartService.showShoppingCart());
    }

Service层接口

在ShoppingCartService接口中声明查看购物车的方法

	/**
     * 查看购物车
     * @return
     */
    List<ShoppingCart> showShoppingCart();

在ShoppingCartServiceImpl中实现查看购物车的方法:

/**
     * 查看购物车
     * @return
     */
    public List<ShoppingCart> showShoppingCart() {
        return shoppingCartMapper.list(ShoppingCart.
                                       builder().
                                       userId(BaseContext.getCurrentId()).
                                       build());
    }

清空购物车

产品原型

接口设计

代码开发

Controller层

在ShoppingCartController中创建清空购物车的方法
    /**
     * 清空购物车商品
     * @return
     */
    @DeleteMapping("/clean")
    @ApiOperation("清空购物车商品")
    public Result<String> clean(){
        shoppingCartService.cleanShoppingCart();
        return Result.success();
    }
 

Service层接口

在ShoppingCartService接口中声明清空购物车的方法:


    /**
     * 清空购物车商品
     */
    void cleanShoppingCart();
 

Service层实现类

在ShoppingCartServiceImpl中实现清空购物车的方法:


    /**
     * 清空购物车商品
     */
    public void cleanShoppingCart() {
        shoppingCartMapper.deleteByUserId(BaseContext.getCurrentId());
    }
 

Mapper层

在ShoppingCartMapper接口中创建删除购物车数据的方法:


    /**
     * 根据用户id删除购物车数据
     *
     * @param userId
     */
    @Delete("delete from shopping_cart where user_id = #{userId}")
    void deleteByUserId(Long userId);
 


第八天

导入地址簿功能代码

需求分析与接口设计

产品原型

功能:

- 查询地址列表
- 新增地址
- 修改地址
- 删除地址
- 设置默认地址
- 查询默认地址

接口设计

- 新增地址
- 查询登录用户所有地址
- 查询默认地址
- 根据id修改地址
- 根据id删除地址
- 根据id查询地址
- 设置默认地址

表设计

用户的地址信息会存储在address_book表,即地址簿表中。具体表结构如下:

字段名数据类型说明备注
idbigint主键自增
user_idbigint用户id逻辑外键
consigneevarchar(50)收货人
sexvarchar(2)性别
phonevarchar(11)手机号
province_codevarchar(12)省份编码
province_namevarchar(32)省份名称
city_codevarchar(12)城市编码
city_namevarchar(32)城市名称
district_codevarchar(12)区县编码
district_namevarchar(32)区县名称
detailvarchar(200)详细地址信息具体到门牌号
labelvarchar(100)标签公司、家、学校
is_defaulttinyint(1)是否默认地址1是 0否

这里面有一个字段is_default,实际上我们在设置默认地址时,只需要更新这个字段就可以了。

代码开发

用户下单

需求分析与接口设计

效果流程图:

接口设计

表设计

用户下单业务对应的数据表为orders表和order_detail表(一对多关系,一个订单关联多个订单明细):

表名含义说明
orders订单表主要存储订单的基本信息(如: 订单号、状态、金额、支付方式、下单用户、收件地址等)
order_detail订单明细表主要存储订单详情信息(如: 该订单关联的套餐及菜品的信息)

具体的表结构如下:

1). orders订单表

字段名数据类型说明备注
idbigint主键自增
numbervarchar(50)订单号
statusint订单状态1待付款 2待接单 3已接单 4派送中 5已完成 6已取消
user_idbigint用户id逻辑外键
address_book_idbigint地址id逻辑外键
order_timedatetime下单时间
checkout_timedatetime付款时间
pay_methodint支付方式1微信支付 2支付宝支付
pay_statustinyint支付状态0未支付 1已支付 2退款
amountdecimal(10,2)订单金额
remarkvarchar(100)备注信息
phonevarchar(11)手机号冗余字段
addressvarchar(255)详细地址信息冗余字段
consigneevarchar(32)收货人冗余字段
cancel_reasonvarchar(255)订单取消原因
rejection_reasonvarchar(255)拒单原因
cancel_timedatetime订单取消时间
estimated_delivery_timedatetime预计送达时间
delivery_statustinyint配送状态1立即送出 0选择具体时间
delivery_timedatetime送达时间
pack_amountint打包费
tableware_numberint餐具数量
tableware_statustinyint餐具数量状态1按餐量提供 0选择具体数量

2). order_detail订单明细表

字段名数据类型说明备注
idbigint主键自增
namevarchar(32)商品名称冗余字段
imagevarchar(255)商品图片路径冗余字段
order_idbigint订单id逻辑外键
dish_idbigint菜品id逻辑外键
setmeal_idbigint套餐id逻辑外键
dish_flavorvarchar(50)菜品口味
numberint商品数量
amountdecimal(10,2)商品单价

说明:用户提交订单时,需要往订单表orders中插入一条记录,并且需要往order_detail中插入一条或多条记录。

代码开发

1.DTO设计

OrdersSubmitDTO.java

package com.sky.dto;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.io.Serializable;
import java.math.BigDecimal;
import java.time.LocalDateTime;

@Data
public class OrdersSubmitDTO implements Serializable {
    //地址簿id
    private Long addressBookId;
    //付款方式
    private int payMethod;
    //备注
    private String remark;
    //预计送达时间
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime estimatedDeliveryTime;
    //配送状态  1立即送出  0选择具体时间
    private Integer deliveryStatus;
    //餐具数量
    private Integer tablewareNumber;
    //餐具数量状态  1按餐量提供  0选择具体数量
    private Integer tablewareStatus;
    //打包费
    private Integer packAmount;
    //总金额
    private BigDecimal amount;
}

2.VO设计 

OrderSubmitVO.java

package com.sky.vo;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import java.math.BigDecimal;
import java.time.LocalDateTime;

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class OrderSubmitVO implements Serializable {
    //订单id
    private Long id;
    //订单号
    private String orderNumber;
    //订单金额
    private BigDecimal orderAmount;
    //下单时间
    private LocalDateTime orderTime;
}

3.controller层

OrderController

package com.sky.controller.user;

import com.sky.dto.OrdersPaymentDTO;
import com.sky.dto.OrdersSubmitDTO;
import com.sky.result.PageResult;
import com.sky.result.Result;
import com.sky.service.OrderService;
import com.sky.vo.OrderPaymentVO;
import com.sky.vo.OrderSubmitVO;
import com.sky.vo.OrderVO;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

/**
 * 订单
 */
@RestController("userOrderController")
@RequestMapping("/user/order")
@Slf4j
@Api(tags = "C端-订单接口")
public class OrderController {

    @Autowired
    private OrderService orderService;

    /**
     * 用户下单
     *
     * @param ordersSubmitDTO
     * @return
     */
    @PostMapping("/submit")
    @ApiOperation("用户下单")
    public Result<OrderSubmitVO> submit(@RequestBody OrdersSubmitDTO ordersSubmitDTO) {
        log.info("用户下单:{}", ordersSubmitDTO);
        OrderSubmitVO orderSubmitVO = orderService.submitOrder(ordersSubmitDTO);
        return Result.success(orderSubmitVO);
    } 

}

4.service层

OrderService

package com.sky.service;

import com.sky.dto.*;
import com.sky.vo.OrderSubmitVO;

public interface OrderService {

    /**
     * 用户下单
     * @param ordersSubmitDTO
     * @return
     */
    OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO);
}

OrderServiceImpl

package com.sky.service.impl;

/**
 * 订单
 */
@Service
@Slf4j
public class OrderServiceImpl implements OrderService {
    @Autowired
    private OrderMapper orderMapper;
    @Autowired
    private OrderDetailMapper orderDetailMapper;
    @Autowired
    private ShoppingCartMapper shoppingCartMapper;
    @Autowired
    private AddressBookMapper addressBookMapper;


    /**
     * 用户下单
     *
     * @param ordersSubmitDTO
     * @return
     */
    @Transactional
    public OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO) {
        //异常情况的处理(收货地址为空、超出配送范围、购物车为空)
        AddressBook addressBook = addressBookMapper.getById(ordersSubmitDTO.getAddressBookId());
        if (addressBook == null) {
            throw new AddressBookBusinessException(MessageConstant.ADDRESS_BOOK_IS_NULL);
        }

        Long userId = BaseContext.getCurrentId();
        ShoppingCart shoppingCart = new ShoppingCart();
        shoppingCart.setUserId(userId);

        //查询当前用户的购物车数据
        List<ShoppingCart> shoppingCartList = shoppingCartMapper.list(shoppingCart);
        if (shoppingCartList == null || shoppingCartList.size() == 0) {
            throw new ShoppingCartBusinessException(MessageConstant.SHOPPING_CART_IS_NULL);
        }

        //构造订单数据
        Orders order = new Orders();
        BeanUtils.copyProperties(ordersSubmitDTO,order);
        order.setPhone(addressBook.getPhone());
        order.setAddress(addressBook.getDetail());
        order.setConsignee(addressBook.getConsignee());
        order.setNumber(String.valueOf(System.currentTimeMillis()));
        order.setUserId(userId);
        order.setStatus(Orders.PENDING_PAYMENT);
        order.setPayStatus(Orders.UN_PAID);
        order.setOrderTime(LocalDateTime.now());

        //向订单表插入1条数据
        orderMapper.insert(order);

        //订单明细数据
        List<OrderDetail> orderDetailList = new ArrayList<>();
        for (ShoppingCart cart : shoppingCartList) {
            OrderDetail orderDetail = new OrderDetail();
            BeanUtils.copyProperties(cart, orderDetail);
            orderDetail.setOrderId(order.getId());
            orderDetailList.add(orderDetail);
        }

        //向明细表插入n条数据
        orderDetailMapper.insertBatch(orderDetailList);

        //清理购物车中的数据
        shoppingCartMapper.deleteByUserId(userId);

        //封装返回结果
        OrderSubmitVO orderSubmitVO = OrderSubmitVO.builder()
                .id(order.getId())
                .orderNumber(order.getNumber())
                .orderAmount(order.getAmount())
                .orderTime(order.getOrderTime())
                .build();

        return orderSubmitVO;
    }
    
}

5.mapper层

OrderMapper.java

package com.sky.mapper;

@Mapper
public interface OrderMapper {
    /**
     * 插入订单数据
     * @param order
     */
    void insert(Orders order);
}

OrderMapper.xml

<?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.sky.mapper.OrderMapper">

    <insert id="insert" parameterType="Orders" useGeneratedKeys="true" keyProperty="id">
        insert into orders
        (number, status, user_id, address_book_id, order_time, checkout_time, pay_method, pay_status, amount, remark,
         phone, address, consignee, estimated_delivery_time, delivery_status, pack_amount, tableware_number,
         tableware_status)
        values (#{number}, #{status}, #{userId}, #{addressBookId}, #{orderTime}, #{checkoutTime}, #{payMethod},
                #{payStatus}, #{amount}, #{remark}, #{phone}, #{address}, #{consignee},
                #{estimatedDeliveryTime}, #{deliveryStatus}, #{packAmount}, #{tablewareNumber}, #{tablewareStatus})
    </insert>
</mapper>

创建OrderDetailMapper接口和对应的xml映射文件:

OrderDetailMapper.java

package com.sky.mapper;

import com.sky.entity.OrderDetail;
import java.util.List;

@Mapper
public interface OrderDetailMapper {

    /**
     * 批量插入订单明细数据
     * @param orderDetails
     */
    void insertBatch(List<OrderDetail> orderDetails);

}

OrderDetailMapper.xml

<?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.sky.mapper.OrderDetailMapper">

    <insert id="insertBatch" parameterType="list">
        insert into order_detail
        (name, order_id, dish_id, setmeal_id, dish_flavor, number, amount, image)
        values
        <foreach collection="orderDetails" item="od" separator=",">
            (#{od.name},#{od.orderId},#{od.dishId},#{od.setmealId},#{od.dishFlavor},
             #{od.number},#{od.amount},#{od.image})
        </foreach>
    </insert>

</mapper>

订单支付

要实现微信支付就需要注册微信支付的一个商户号,这个商户号是必须要有一家企业并且有正规的营业执照。只有具备了这些资质之后,才可以去注册商户号,才能开通支付权限。

小程序付款:

https://pay.weixin.qq.com/static/product/product_index.shtmlicon-default.png?t=N7T8https://pay.weixin.qq.com/static/product/product_index.shtml

微信支付相关接口:

代码导入

相关配置:

application-dev.yml

sky:
  wechat:
    appid: wxcd2e39f677fd30ba  //改成自己的
    secret: 84fbfdf5ea288f0c432d829599083637  //改成自己的
    mchid : 1561414331
    mchSerialNo: 4B3B3DC35414AD50B1B755BAF8DE9CC7CF407606
    privateKeyFilePath: D:\apiclient_key.pem
    apiV3Key: CZBK51236435wxpay435434323FFDuv3
    weChatPayCertFilePath: D:\wechatpay_166D96F876F45C7D07CE98952A96EC980368ACFC.pem
    notifyUrl: https://www.weixin.qq.com/wxpay/pay.php
    refundNotifyUrl: https://www.weixin.qq.com/wxpay/pay.php

application.yml

sky:
  wechat:
    appid: ${sky.wechat.appid}
    secret: ${sky.wechat.secret}
    mchid : ${sky.wechat.mchid}
    mchSerialNo: ${sky.wechat.mchSerialNo}
    privateKeyFilePath: ${sky.wechat.privateKeyFilePath}
    apiV3Key: ${sky.wechat.apiV3Key}
    weChatPayCertFilePath: ${sky.wechat.weChatPayCertFilePath}
    notifyUrl: ${sky.wechat.notifyUrl}
    refundNotifyUrl: ${sky.wechat.refundNotifyUrl}

WeChatProperties.java:读取配置(已定义)

package com.sky.properties;

import lombok.Data;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "sky.wechat")
@Data
public class WeChatProperties {

    private String appid; //小程序的appid
    private String secret; //小程序的秘钥
    private String mchid; //商户号
    private String mchSerialNo; //商户API证书的证书序列号
    private String privateKeyFilePath; //商户私钥文件
    private String apiV3Key; //证书解密的密钥
    private String weChatPayCertFilePath; //平台证书
    private String notifyUrl; //支付成功的回调地址
    private String refundNotifyUrl; //退款成功的回调地址
}

 

PS:跳过微信支付的方法

苍穹外卖项目微信支付(没有商户号)的解决方法,超详细!!!_没有微信商户号怎么实现支付-CSDN博客


第九天为实战项目:以下为参考答案

用户端历史订单模块

1. 查询历史订单

1.1 需求分析和设计

产品原型:

业务规则

  • 分页查询历史订单
  • 可以根据订单状态查询
  • 展示订单数据时,需要展示的数据包括:下单时间、订单状态、订单金额、订单明细(商品名称、图片)

接口设计:参见接口文档

1.2 代码实现

1.2.1 user/OrderController

/**

* 历史订单查询

*

* @param page

* @param pageSize

* @param status 订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消

* @return

*/

@GetMapping("/historyOrders")

@ApiOperation("历史订单查询")

public Result<PageResult> page(int page, int pageSize, Integer status) {

PageResult pageResult = orderService.pageQuery4User(page, pageSize, status);

return Result.success(pageResult);

}

1.2.2 OrderService

/**

* 用户端订单分页查询

* @param page

* @param pageSize

* @param status

* @return

*/

PageResult pageQuery4User(int page, int pageSize, Integer status);

1.2.3 OrderServiceImpl

/**

* 用户端订单分页查询

*

* @param pageNum

* @param pageSize

* @param status

* @return

*/

public PageResult pageQuery4User(int pageNum, int pageSize, Integer status) {

// 设置分页

PageHelper.startPage(pageNum, pageSize);

OrdersPageQueryDTO ordersPageQueryDTO = new OrdersPageQueryDTO();

ordersPageQueryDTO.setUserId(BaseContext.getCurrentId());

ordersPageQueryDTO.setStatus(status);

// 分页条件查询

Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);

List<OrderVO> list = new ArrayList();

// 查询出订单明细,并封装入OrderVO进行响应

if (page != null && page.getTotal() > 0) {

for (Orders orders : page) {

Long orderId = orders.getId();// 订单id

// 查询订单明细

List<OrderDetail> orderDetails = orderDetailMapper.getByOrderId(orderId);

OrderVO orderVO = new OrderVO();

BeanUtils.copyProperties(orders, orderVO);

orderVO.setOrderDetailList(orderDetails);

list.add(orderVO);

}

}

return new PageResult(page.getTotal(), list);

}

1.2.4 OrderMapper

/**

* 分页条件查询并按下单时间排序

* @param ordersPageQueryDTO

*/

Page<Orders> pageQuery(OrdersPageQueryDTO ordersPageQueryDTO);

1.2.5 OrderMapper.xml

<select id="pageQuery" resultType="Orders">

select * from orders

<where>

<if test="number != null and number!=''">

and number like concat('%',#{number},'%')

</if>

<if test="phone != null and phone!=''">

and phone like concat('%',#{phone},'%')

</if>

<if test="userId != null">

and user_id = #{userId}

</if>

<if test="status != null">

and status = #{status}

</if>

<if test="beginTime != null">

and order_time &gt;= #{beginTime}

</if>

<if test="endTime != null">

and order_time &lt;= #{endTime}

</if>

</where>

order by order_time desc

</select>

1.2.6 OrderDetailMapper

/**

* 根据订单id查询订单明细

* @param orderId

* @return

*/

@Select("select * from order_detail where order_id = #{orderId}")

List<OrderDetail> getByOrderId(Long orderId);

1.3 功能测试

2. 查询订单详情

2.1 需求分析和设计

产品原型:

接口设计:参见接口文档

2.2 代码实现

2.2.1 user/OrderController

/**

* 查询订单详情

*

* @param id

* @return

*/

@GetMapping("/orderDetail/{id}")

@ApiOperation("查询订单详情")

public Result<OrderVO> details(@PathVariable("id") Long id) {

OrderVO orderVO = orderService.details(id);

return Result.success(orderVO);

}

2.2.2 OrderService

/**

* 查询订单详情

* @param id

* @return

*/

OrderVO details(Long id);

2.2.3 OrderServiceImpl

/**

* 查询订单详情

*

* @param id

* @return

*/

public OrderVO details(Long id) {

// 根据id查询订单

Orders orders = orderMapper.getById(id);

// 查询该订单对应的菜品/套餐明细

List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());

// 将该订单及其详情封装到OrderVO并返回

OrderVO orderVO = new OrderVO();

BeanUtils.copyProperties(orders, orderVO);

orderVO.setOrderDetailList(orderDetailList);

return orderVO;

}

2.2.4 OrderMapper

/**

* 根据id查询订单

* @param id

*/

@Select("select * from orders where id=#{id}")

Orders getById(Long id);

2.3 功能测试

3. 取消订单

3.1 需求分析和设计

产品原型:

业务规则:

  • 待支付和待接单状态下,用户可直接取消订单
  • 商家已接单状态下,用户取消订单需电话沟通商家
  • 派送中状态下,用户取消订单需电话沟通商家
  • 如果在待接单状态下取消订单,需要给用户退款
  • 取消订单后需要将订单状态修改为“已取消”

接口设计:参见接口文档

3.2 代码实现

3.2.1 user/OrderController

/**

* 用户取消订单

*

* @return

*/

@PutMapping("/cancel/{id}")

@ApiOperation("取消订单")

public Result cancel(@PathVariable("id") Long id) throws Exception {

orderService.userCancelById(id);

return Result.success();

}

3.2.2 OrderService

/**

* 用户取消订单

* @param id

*/

void userCancelById(Long id) throws Exception;

3.2.3 OrderServiceImpl

/**

* 用户取消订单

*

* @param id

*/

public void userCancelById(Long id) throws Exception {

// 根据id查询订单

Orders ordersDB = orderMapper.getById(id);

// 校验订单是否存在

if (ordersDB == null) {

throw new OrderBusinessException(MessageConstant.ORDER_NOT_FOUND);

}

//订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消

if (ordersDB.getStatus() > 2) {

throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);

}

Orders orders = new Orders();

orders.setId(ordersDB.getId());

// 订单处于待接单状态下取消,需要进行退款

if (ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)) {

//调用微信支付退款接口

weChatPayUtil.refund(

ordersDB.getNumber(), //商户订单号

ordersDB.getNumber(), //商户退款单号

new BigDecimal(0.01),//退款金额,单位 元

new BigDecimal(0.01));//原订单金额

//支付状态修改为 退款

orders.setPayStatus(Orders.REFUND);

}

// 更新订单状态、取消原因、取消时间

orders.setStatus(Orders.CANCELLED);

orders.setCancelReason("用户取消");

orders.setCancelTime(LocalDateTime.now());

orderMapper.update(orders);

}

3.3 功能测试

4. 再来一单

4.1 需求分析和设计

产品原型:

接口设计:参见接口文档

业务规则:

  • 再来一单就是将原订单中的商品重新加入到购物车中

4.2 代码实现

4.2.1 user/OrderController

/**

* 再来一单

*

* @param id

* @return

*/

@PostMapping("/repetition/{id}")

@ApiOperation("再来一单")

public Result repetition(@PathVariable Long id) {

orderService.repetition(id);

return Result.success();

}

4.2.2 OrderService

/**

* 再来一单

*

* @param id

*/

void repetition(Long id);

4.2.3 OrderServiceImpl

/**

* 再来一单

*

* @param id

*/

public void repetition(Long id) {

// 查询当前用户id

Long userId = BaseContext.getCurrentId();

// 根据订单id查询当前订单详情

List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(id);

// 将订单详情对象转换为购物车对象

List<ShoppingCart> shoppingCartList = orderDetailList.stream().map(x -> {

ShoppingCart shoppingCart = new ShoppingCart();

// 将原订单详情里面的菜品信息重新复制到购物车对象中

BeanUtils.copyProperties(x, shoppingCart, "id");

shoppingCart.setUserId(userId);

shoppingCart.setCreateTime(LocalDateTime.now());

return shoppingCart;

}).collect(Collectors.toList());

// 将购物车对象批量添加到数据库

shoppingCartMapper.insertBatch(shoppingCartList);

}

4.2.4 ShoppingCartMapper

/**

* 批量插入购物车数据

*

* @param shoppingCartList

*/

void insertBatch(List<ShoppingCart> shoppingCartList);

4.2.5 ShoppingCartMapper.xml

<insert id="insertBatch" parameterType="list">

insert into shopping_cart

(name, image, user_id, dish_id, setmeal_id, dish_flavor, number, amount, create_time)

values

<foreach collection="shoppingCartList" item="sc" separator=",">

(#{sc.name},#{sc.image},#{sc.userId},#{sc.dishId},#{sc.setmealId},#{sc.dishFlavor},#{sc.number},#{sc.amount},#{sc.createTime})

</foreach>

</insert>

4.3 功能测试

商家端订单管理模块

1. 订单搜索

1.1 需求分析和设计

产品原型:

业务规则:

  • 输入订单号/手机号进行搜索,支持模糊搜索
  • 根据订单状态进行筛选
  • 下单时间进行时间筛选
  • 搜索内容为空,提示未找到相关订单
  • 搜索结果页,展示包含搜索关键词的内容
  • 分页展示搜索到的订单数据

接口设计:参见接口文档

1.2 代码实现

1.2.1 admin/OrderController

在admin包下创建OrderController

/**

* 订单管理

*/

@RestController("adminOrderController")

@RequestMapping("/admin/order")

@Slf4j

@Api(tags = "订单管理接口")

public class OrderController {

@Autowired

private OrderService orderService;

/**

* 订单搜索

*

* @param ordersPageQueryDTO

* @return

*/

@GetMapping("/conditionSearch")

@ApiOperation("订单搜索")

public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {

PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);

return Result.success(pageResult);

}

}

1.2.2 OrderService

/**

* 条件搜索订单

* @param ordersPageQueryDTO

* @return

*/

PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO);

1.2.3 OrderServiceImpl

/**

* 订单搜索

*

* @param ordersPageQueryDTO

* @return

*/

public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {

PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());

Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);

// 部分订单状态,需要额外返回订单菜品信息,将Orders转化为OrderVO

List<OrderVO> orderVOList = getOrderVOList(page);

return new PageResult(page.getTotal(), orderVOList);

}

private List<OrderVO> getOrderVOList(Page<Orders> page) {

// 需要返回订单菜品信息,自定义OrderVO响应结果

List<OrderVO> orderVOList = new ArrayList<>();

List<Orders> ordersList = page.getResult();

if (!CollectionUtils.isEmpty(ordersList)) {

for (Orders orders : ordersList) {

// 将共同字段复制到OrderVO

OrderVO orderVO = new OrderVO();

BeanUtils.copyProperties(orders, orderVO);

String orderDishes = getOrderDishesStr(orders);

// 将订单菜品信息封装到orderVO中,并添加到orderVOList

orderVO.setOrderDishes(orderDishes);

orderVOList.add(orderVO);

}

}

return orderVOList;

}

/**

* 根据订单id获取菜品信息字符串

*

* @param orders

* @return

*/

private String getOrderDishesStr(Orders orders) {

// 查询订单菜品详情信息(订单中的菜品和数量)

List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());

// 将每一条订单菜品信息拼接为字符串(格式:宫保鸡丁*3;)

List<String> orderDishList = orderDetailList.stream().map(x -> {

String orderDish = x.getName() + "*" + x.getNumber() + ";";

return orderDish;

}).collect(Collectors.toList());

// 将该订单对应的所有菜品信息拼接在一起

return String.join("", orderDishList);

}

1.3 功能测试

2. 各个状态的订单数量统计

2.1 需求分析和设计

产品原型:

接口设计:参见接口文档

2.2 代码实现

2.2.1 admin/OrderController

/**

* 各个状态的订单数量统计

*

* @return

*/

@GetMapping("/statistics")

@ApiOperation("各个状态的订单数量统计")

public Result<OrderStatisticsVO> statistics() {

OrderStatisticsVO orderStatisticsVO = orderService.statistics();

return Result.success(orderStatisticsVO);

}

2.2.2 OrderService

/**

* 各个状态的订单数量统计

* @return

*/

OrderStatisticsVO statistics();

2.2.3 OrderServiceImpl

/**

* 各个状态的订单数量统计

*

* @return

*/

public OrderStatisticsVO statistics() {

// 根据状态,分别查询出待接单、待派送、派送中的订单数量

Integer toBeConfirmed = orderMapper.countStatus(Orders.TO_BE_CONFIRMED);

Integer confirmed = orderMapper.countStatus(Orders.CONFIRMED);

Integer deliveryInProgress = orderMapper.countStatus(Orders.DELIVERY_IN_PROGRESS);

// 将查询出的数据封装到orderStatisticsVO中响应

OrderStatisticsVO orderStatisticsVO = new OrderStatisticsVO();

orderStatisticsVO.setToBeConfirmed(toBeConfirmed);

orderStatisticsVO.setConfirmed(confirmed);

orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);

return orderStatisticsVO;

}

2.2.4 OrderMapper

/**

* 根据状态统计订单数量

* @param status

*/

@Select("select count(id) from orders where status = #{status}")

Integer countStatus(Integer status);

2.3 功能测试

3. 查询订单详情

3.1 需求分析和设计

产品原型:

业务规则:

  • 订单详情页面需要展示订单基本信息(状态、订单号、下单时间、收货人、电话、收货地址、金额等)
  • 订单详情页面需要展示订单明细数据(商品名称、数量、单价)

接口设计:参见接口文档

3.2 代码实现

3.2.1 admin/OrderController

/**

* 订单详情

*

* @param id

* @return

*/

@GetMapping("/details/{id}")

@ApiOperation("查询订单详情")

public Result<OrderVO> details(@PathVariable("id") Long id) {

OrderVO orderVO = orderService.details(id);

return Result.success(orderVO);

}

3.3 功能测试

4. 接单

4.1 需求分析和设计

产品原型:

业务规则:

  • 商家接单其实就是将订单的状态修改为“已接单”

接口设计:参见接口文档

4.2 代码实现

4.2.1 admin/OrderController

/**

* 接单

*

* @return

*/

@PutMapping("/confirm")

@ApiOperation("接单")

public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {

orderService.confirm(ordersConfirmDTO);

return Result.success();

}

4.2.2 OrderService

/**

* 接单

*

* @param ordersConfirmDTO

*/

void confirm(OrdersConfirmDTO ordersConfirmDTO);

4.2.3 OrderServiceImpl

/**

* 接单

*

* @param ordersConfirmDTO

*/

public void confirm(OrdersConfirmDTO ordersConfirmDTO) {

Orders orders = Orders.builder()

.id(ordersConfirmDTO.getId())

.status(Orders.CONFIRMED)

.build();

orderMapper.update(orders);

}

4.3 功能测试

5. 拒单

5.1 需求分析和设计

产品原型:

业务规则:

  • 商家拒单其实就是将订单状态修改为“已取消”
  • 只有订单处于“待接单”状态时可以执行拒单操作
  • 商家拒单时需要指定拒单原因
  • 商家拒单时,如果用户已经完成了支付,需要为用户退款

接口设计:参见接口文档

5.2 代码实现

5.2.1 admin/OrderController

/**

* 拒单

*

* @return

*/

@PutMapping("/rejection")

@ApiOperation("拒单")

public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) throws Exception {

orderService.rejection(ordersRejectionDTO);

return Result.success();

}

5.2.2 OrderService

/**

* 拒单

*

* @param ordersRejectionDTO

*/

void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception;

5.2.3 OrderServiceImpl

/**

* 拒单

*

* @param ordersRejectionDTO

*/

public void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception {

// 根据id查询订单

Orders ordersDB = orderMapper.getById(ordersRejectionDTO.getId());

// 订单只有存在且状态为2(待接单)才可以拒单

if (ordersDB == null || !ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)) {

throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);

}

//支付状态

Integer payStatus = ordersDB.getPayStatus();

if (payStatus == Orders.PAID) {

//用户已支付,需要退款

String refund = weChatPayUtil.refund(

ordersDB.getNumber(),

ordersDB.getNumber(),

new BigDecimal(0.01),

new BigDecimal(0.01));

log.info("申请退款:{}", refund);

}

// 拒单需要退款,根据订单id更新订单状态、拒单原因、取消时间

Orders orders = new Orders();

orders.setId(ordersDB.getId());

orders.setStatus(Orders.CANCELLED);

orders.setRejectionReason(ordersRejectionDTO.getRejectionReason());

orders.setCancelTime(LocalDateTime.now());

orderMapper.update(orders);

}

5.3 功能测试

6. 取消订单

6.1 需求分析和设计

产品原型:

业务规则:

  • 取消订单其实就是将订单状态修改为“已取消”
  • 商家取消订单时需要指定取消原因
  • 商家取消订单时,如果用户已经完成了支付,需要为用户退款

接口设计:参见接口文档

6.2 代码实现

6.2.1 admin/OrderController

/**

* 取消订单

*

* @return

*/

@PutMapping("/cancel")

@ApiOperation("取消订单")

public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) throws Exception {

orderService.cancel(ordersCancelDTO);

return Result.success();

}

6.2.2 OrderService

/**

* 商家取消订单

*

* @param ordersCancelDTO

*/

void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception;

6.2.3 OrderServiceImpl

/**

* 取消订单

*

* @param ordersCancelDTO

*/

public void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception {

// 根据id查询订单

Orders ordersDB = orderMapper.getById(ordersCancelDTO.getId());

//支付状态

Integer payStatus = ordersDB.getPayStatus();

if (payStatus == 1) {

//用户已支付,需要退款

String refund = weChatPayUtil.refund(

ordersDB.getNumber(),

ordersDB.getNumber(),

new BigDecimal(0.01),

new BigDecimal(0.01));

log.info("申请退款:{}", refund);

}

// 管理端取消订单需要退款,根据订单id更新订单状态、取消原因、取消时间

Orders orders = new Orders();

orders.setId(ordersCancelDTO.getId());

orders.setStatus(Orders.CANCELLED);

orders.setCancelReason(ordersCancelDTO.getCancelReason());

orders.setCancelTime(LocalDateTime.now());

orderMapper.update(orders);

}

6.3 功能测试

7. 派送订单

7.1 需求分析和设计

产品原型:

业务规则:

  • 派送订单其实就是将订单状态修改为“派送中”
  • 只有状态为“待派送”的订单可以执行派送订单操作

接口设计:参见接口文档

7.2 代码实现

7.2.1 admin/OrderController

/**

* 派送订单

*

* @return

*/

@PutMapping("/delivery/{id}")

@ApiOperation("派送订单")

public Result delivery(@PathVariable("id") Long id) {

orderService.delivery(id);

return Result.success();

}

7.2.2 OrderService

/**

* 派送订单

*

* @param id

*/

void delivery(Long id);

7.2.3 OrderServiceImpl

/**

* 派送订单

*

* @param id

*/

public void delivery(Long id) {

// 根据id查询订单

Orders ordersDB = orderMapper.getById(id);

// 校验订单是否存在,并且状态为3

if (ordersDB == null || !ordersDB.getStatus().equals(Orders.CONFIRMED)) {

throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);

}

Orders orders = new Orders();

orders.setId(ordersDB.getId());

// 更新订单状态,状态转为派送中

orders.setStatus(Orders.DELIVERY_IN_PROGRESS);

orderMapper.update(orders);

}

7.3 功能测试

8. 完成订单

8.1 需求分析和设计

产品原型:

业务规则:

  • 完成订单其实就是将订单状态修改为“已完成”
  • 只有状态为“派送中”的订单可以执行订单完成操作

接口设计:参见接口文档

8.2 代码实现

8.2.1 admin/OrderController

/**

* 完成订单

*

* @return

*/

@PutMapping("/complete/{id}")

@ApiOperation("完成订单")

public Result complete(@PathVariable("id") Long id) {

orderService.complete(id);

return Result.success();

}

8.2.2 OrderService

/**

* 完成订单

*

* @param id

*/

void complete(Long id);

8.2.3 OrderServiceImpl

/**

* 完成订单

*

* @param id

*/

public void complete(Long id) {

// 根据id查询订单

Orders ordersDB = orderMapper.getById(id);

// 校验订单是否存在,并且状态为4

if (ordersDB == null || !ordersDB.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)) {

throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);

}

Orders orders = new Orders();

orders.setId(ordersDB.getId());

// 更新订单状态,状态转为完成

orders.setStatus(Orders.COMPLETED);

orders.setDeliveryTime(LocalDateTime.now());

orderMapper.update(orders);

}

8.3 功能测试

校验收货地址是否超出配送范围

1. 环境准备

注册账号:注册百度账号

登录百度地图开放平台:百度地图-百万开发者首选的地图服务商,提供专属的行业解决方案

进入控制台,创建应用,获取AK:

相关接口:

地理编码 | 百度地图API SDK

百度地图-百万开发者首选的地图服务商,提供专属的行业解决方案

2. 代码开发

2.1 application.yml

配置外卖商家店铺地址和百度地图的AK:

2.2 OrderServiceImpl

改造OrderServiceImpl,注入上面的配置项:

@Value("${sky.shop.address}")

private String shopAddress;

@Value("${sky.baidu.ak}")

private String ak;

在OrderServiceImpl中提供校验方法:

/**

* 检查客户的收货地址是否超出配送范围

* @param address

*/

private void checkOutOfRange(String address) {

Map map = new HashMap();

map.put("address",shopAddress);

map.put("output","json");

map.put("ak",ak);

//获取店铺的经纬度坐标

String shopCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);

JSONObject jsonObject = JSON.parseObject(shopCoordinate);

if(!jsonObject.getString("status").equals("0")){

throw new OrderBusinessException("店铺地址解析失败");

}

//数据解析

JSONObject location = jsonObject.getJSONObject("result").getJSONObject("location");

String lat = location.getString("lat");

String lng = location.getString("lng");

//店铺经纬度坐标

String shopLngLat = lat + "," + lng;

map.put("address",address);

//获取用户收货地址的经纬度坐标

String userCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);

jsonObject = JSON.parseObject(userCoordinate);

if(!jsonObject.getString("status").equals("0")){

throw new OrderBusinessException("收货地址解析失败");

}

//数据解析

location = jsonObject.getJSONObject("result").getJSONObject("location");

lat = location.getString("lat");

lng = location.getString("lng");

//用户收货地址经纬度坐标

String userLngLat = lat + "," + lng;

map.put("origin",shopLngLat);

map.put("destination",userLngLat);

map.put("steps_info","0");

//路线规划

String json = HttpClientUtil.doGet("https://api.map.baidu.com/directionlite/v1/driving", map);

jsonObject = JSON.parseObject(json);

if(!jsonObject.getString("status").equals("0")){

throw new OrderBusinessException("配送路线规划失败");

}

//数据解析

JSONObject result = jsonObject.getJSONObject("result");

JSONArray jsonArray = (JSONArray) result.get("routes");

Integer distance = (Integer) ((JSONObject) jsonArray.get(0)).get("distance");

if(distance > 5000){

//配送距离超过5000米

throw new OrderBusinessException("超出配送范围");

}

}

在OrderServiceImpl的submitOrder方法中调用上面的校验方法:

  • 17
    点赞
  • 15
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值