黑马程序员苍穹外卖项目笔记Day1

Day1

后端环境搭建：

sky-pojo子模块中存放的是一些entity、DTO、VO

名称	说明
Entity	实体，通常和数据库中的表对应
DTO	数据传输对象，通常用于程序中各层之间传递数据
VO	视图对象，为前端展示数据提供的对象
POJO	普通Java对象，只有属性和对应的getter和setter

前端发送的请求，是如何请求到后端服务的？

前端请求地址：http://localhost/api/employee/login

后端接口地址：http://localhost:8080/admin/employee/login

**
nginx反向代理**，将前端发送的动态请求由nginx转发到后端服务器

nginx反向代理的好处：

O 提高访问速度

O 进行负载均衡，把大量的请求按照指定的方式均衡地分配给集群中的每台服务器

O 保证后端服务的安全

nginx反向代理的配置方式，修改nginx.conf文件：

server{
    listen 80;
    server_name localhost;
    location /api/{
        proxy_pass http://localhost:8080/admin/; #反向代理
    }
}

nginx负载均衡的配置方法（多台后端服务器）：

upstream webservers{
    server 192.168.100.128:8080;
    server 192.168.100.129:8080;
}

server{
    listen 80;
    server_name localhost;
    
    location /api/{
        proxy_pass http://webservers/admin/; # 负载均衡
    }
}

nginx负载均衡策略（服务器分配方式）：

名称	说明
轮询	默认方式
weight	权重方式，默认为1，权重越高，被分配的客户端请求就越多
ip_hash	依据IP分配方式，这样每个访客可以固定访问一个后端服务
least_conn	依据最少连接方式，把请求优先分配给连接数少的后端服务
url_hash	依据url分配方式，这样相同的url会被分配到同一个后端服务
fair	依据响应时间方式，响应时间短的服务将会被优先分配

完善登录功能

员工表中的密码是明文存储，安全性太低。

1、将密码加密后存储，提高安全性；

2、使用MD5加密方式对明文密码加密（MD5信息摘要算法）

解决步骤：

1、修改数据库中明文密码，改为MD5加密后的密文；

2、修改Java代码，前端提交的密码进行MD5加密后再跟数据口中的密码比对。

// 对前端传过来的明文密码进行md5加密处理，再进行比对
password =  DigestUtils.md5DigestAsHex(password.getBytes());

导入接口文档

前后端分离开发流程：

接口管理平台：

YAPI打开🔗：https://yapi.pro

如下图：

Swagger介绍：

使用Swagger只需要按照规范去定义接口以及接口相关的信息，就可以做到生成接口文档，以及在线接口调试页面。

官网：https://swagger.io/

knife4j 是为Java MVC框架集成Swagger生成Api文档的增强解决方案，在pom.xml中添加依赖即可。

<dependency>
    <groupId>com.github.xiaomin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>3.0.2</version>
</dependency>

代替postman进行接口测试，添加到WebMvcConfiguration.java中去：

/**
 * 注册自定义拦截器
 *
 * @param registry
 */
protected void addInterceptors(InterceptorRegistry registry) {
    log.info("开始注册自定义拦截器...");
    registry.addInterceptor(jwtTokenAdminInterceptor)
            .addPathPatterns("/admin/**")
            .excludePathPatterns("/admin/employee/login");
}

/**
 * 通过knife4j生成接口文档
 * @return
 */
@Bean
public Docket docket() {
    log.info("准备生成接口文档...");
    ApiInfo apiInfo = new ApiInfoBuilder()
            .title("苍穹外卖项目接口文档")
            .version("2.0")
            .description("苍穹外卖项目接口文档")
            .build();
    Docket docket = new Docket(DocumentationType.SWAGGER_2)
            .apiInfo(apiInfo)
            .select()
            //指定生成接口需要扫描的包
            .apis(RequestHandlerSelectors.basePackage("com.sky.controller"))
            .paths(PathSelectors.any())
            .build();
    return docket;
}

/**
 * 设置静态资源映射
 * @param registry
 */
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
    log.info("开始设置静态资源映射");
    registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");
    registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
}

通过Swagge就可以生成接口文档，那么我们就不需要YAPI了吗？

1、Yapi 是设计阶段使用的工具，管理和维护接口

2、Swagger 是开发阶段使用的框架，帮助后端开发人员做后端的接口测试

Swagger_常用注解：

通过注解可以控制生成的接口文档，使接口文档拥有更好的可读性，常用注解如下：

注解	说明
@Api	用在类上，例如Controller，表示对类的说明
@ApiModel	用在类上，例如entity、DTO、VO
@ApiModelProperty	用在属性上，描述属性的信息
@ApiOperation	用在方法上，例如Controller的方法，说明方法的用途、作用