快递代取系统Demo - SpringBoot新手项目后端（订单管理系统）: 功能：（相当于一个订单管理系统/订单发布系统） 1、基础：登录、注册、注销 2. 认证：拦截器，过滤器 3、发单：发布订单、取消订单、确认完成 4、接单：浏览可接订单、接单、取消接单、确认送达技术：前后端分离后端：SpringBoot 数据库：mysql 前端：JQuery，BootStrap

# 快递代取系统

## 介绍

-   前后端分离
-   前端用jquery：ajax发送请求
-   后端用springboot：提供json数据

## 体验一把

http://139.196.237.82/DeliveryTakingSystemFrontEnd/Index.html

## 软件架构

springboot服务+mysql5.7

## 运行后端

1. 在项目下启动mysql，跑一下table.sql文件，创建表

```shell
   mysql -uroot -p #进入mysql
   ```
   ```sql
   create database deliverytakingsystem;
   use deliverytakingsystem;
   source delivery.sql;
   ```

2. 改一下delivery-web/src/main/resources/application.yml（改一下db的地址，用户名，密码）

3. 用idea打开直接运行Application即可

## 后端打jar包

打开IDEA，点击右边的maven->delivery-taking-system->package即可打成jar包

![](README.assets/image-20220406145912191.png)

jar包的位置在delivery-web/target下

![](README.assets/image-20220406150015449.png)

## 运行前端

前端代码在：[点击查看步骤](https://gitee.com/earth_wyz/DeliveryTakingSystemFrontEnd)

-   一体化部署：

直接把前端代码放在delivery-web/src/main/resources/static下，跟后端一起启动，然后访问 http://localhost:8081/Index.html 进入主页

-   **分离部署（推荐）：**

把前端代码放在**nginx**或者tomcat里，如果遇到跨域问题，请修改后端代码[CorsFilter](https://gitee.com/earth_wyz/DeliveryTakiingSystem/blob/master/delivery-web/src/main/java/com/wyz/web/filter/CorsFilter.java)中的这行：

```java
    // 把前端的"http://ip:port"写入第二个参数，如果有多个，用逗号隔开
    response.setHeader("Access-Control-Allow-Origin", "http://127.0.0.1");
    ```

# 开发日志

## 登录

### 用户id如何生成？

新建用户时（后端拿到了用户名&密码），用户id肯定是要由后端生成一个的，不能让数据库通过自增的方式自己生成（通过用户名去db查用户id？这不好）

id生成方案：

-   数据库自增：天然不佳，而且增加了db的压力
-   redis自增

-   uuid：网卡信息+时间+随机值 生成id
    -   缺点：太长，16字节128位

### 认证框架

常用登录验证框架：

-   spring-security
-   shiro

-   jwt

### 简易方案

在拦截器中看看当前session里面有没有userId

```java
@Component
@Slf4j
public class AuthInterceptor implements HandlerInterceptor {

@Value("${delivery.auth.activate}")
    private boolean activate;

@Autowired
    private HttpSession sess;

@Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception {

// 根据session的用户是否登录
        if (request.getSession().getAttribute("userId") == null) {
            response.setCharacterEncoding("UTF-8");
            response.setContentType("application/json; charset=utf-8");
            try (PrintWriter out = response.getWriter()) {
                Message msg = Message.fail("用户未登录");
                out.append(JSON.toJSONString(msg));
                return false;
            } catch (Exception e) {
                log.error(e.getMessage());
                response.sendError(500);
                return false;
            }
        }
        return true;
    }
}
```

```java
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private AuthInterceptor interceptor;

/**
     * 开启自己的拦截器
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 添加拦截器，配置拦截地址
        registry.addInterceptor(interceptor).excludePathPatterns("/user/**");
    }
}
```

## 关于跨域的大坑！！！

已经设置了@CrossOrigin，但是提交新的订单的时候，一直报跨域错误，没设置origin，然而登录都能成功啊。。

仔细debug，这是因为user模块我对所有请求都放行，即使一开始不带cookie，@CrossOrigin也能成功的加上

然而order模块请求是不放行的，一开始没带cookie，就被拦下来了，@CrossOrigin就加不上

那就直接在过滤器中又设置了一下跨域，终于ok了

```java
import javax.servlet.Filter;

@Component
public class CorsFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        response.setHeader("Access-Control-Allow-Origin", "http://127.0.0.1");
        response.setHeader("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept");
        response.setHeader("Access-Control-Allow-Methods", "POST, GET, OPTIONS, DELETE, PUT, GET");
        response.setHeader("Access-Control-Allow-Credentials", "true");
        response.setHeader("Access-Control-Max-Age", "3600");
        chain.doFilter(req, res);
    }
}
```

## 后端允许前端跨域请求

以防xrcf攻击，浏览器默认拒绝跨域请求的响应

如果前端发过来的是POST请求，还要设置method

```java
@Slf4j
@RestController
@RequestMapping("/user")
// 跨域cookie
@CrossOrigin(origins = "http://127.0.0.1", allowCredentials = "true")
@CrossOrigin(origins = {"http://127.0.0.1","http://127.0.0.1/"}, allowCredentials = "true", methods = {RequestMethod.GET,RequestMethod.POST,RequestMethod.DELETE,RequestMethod.PUT})
public class UserController {
}
```

## 前端跨域发送cookie

以防泄露，浏览器默认是不让跨域传cookie的

```html
<script>
    $(function () {
        // 允许跨域传cookie
        $.ajaxSetup({crossDomain: true, xhrFields: {withCredentials: true}});
	})
</script>
```

## 拦截器放行静态资源

注意exclude的写法。。。

```java
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private AuthInterceptor interceptor;

@Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**");
    }

/**
     * 开启自己的拦截器
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 添加拦截器，配置拦截地址
        registry.addInterceptor(interceptor)
//                .addPathPatterns("/order/**")
                // 放行静态资源
                .excludePathPatterns("/user/**", "/**/*.html", "/**/*.css", "/**/*.js", "/**/*.woff", "/custom/**");
    }
}
```

## 前端获取后端返回的json

又碰到一个坑。。。

按理说ajax这么写就行了，我还特意加了async:false来取消异步

![](README.assets/image-20210109102502329.png)

结果前端执行的是error函数。。。

后来发现：

**前端设置了希望后端发来的类型（dataType："application/json"）**

**但是后端没有设置返回类型**

把dataType删了就行

## mybatis一级缓存的禁用

因为mybatis有一级缓存，作同一个查询时，会复用上次的结果

自己通过cmd操作mysql（修改表中的数据），不会使缓存失效

只有通过mybatis修改数据，才会使一级缓存失效

所以怎么禁用一级缓存呢？

**配置文件**

```yaml
mybatis:
  configuration:
    cache-enabled: false  #禁用二级缓存
    local-cache-scope: session  #一级缓存指定为session级别
    local-cache-scope: statement #一级缓存指定为statement级别, 相当于禁用一级缓存
```

**手动清除**

```java
session.clearCache();
```

# 杂

## 自定义Message码（废弃）

### 错误码

-1 登录：用户名不存在

-2 登录：密码错误

-3 注册：用户名已存在

-4 检查session：用户还未登录

### 正确码

1 登录成功

2 注册成功

3 用户已经登录

## 自定义订单状态

0：未接单 unpick

1：已接单 pick

2：已送达 arrived

3：已完成 completed

4：已取消 canceled

5：已中止 terminated

VirtuosoQ/快递代取系统Demo - SpringBoot新手项目后端（订单管理系统）

简介

发行版

贡献者

近期动态