第一课 Spring Cloud分布式微服务实战-构建后端项目

已于 2022-06-09 23:48:07 修改
阅读量295 收藏 4
点赞数
文章标签： spring cloud 微服务 分布式
于 2022-06-09 23:47:57 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/aa18855953229/article/details/125213207
版权

第一课 Spring Cloud分布式微服务实战-构建后端项目

tags:

  • Java
  • 慕课网

categories:

  • 环境搭建

文章目录

第一节 导入数据库

  1. 创建数据库imooc-news-dev, 选择字符集utf8mb4 -- UTF-8 Unicode.
  2. 运行sql文件，导入表如下。
    在这里插入图片描述

第二节 构建maven聚合工程

在这里插入图片描述

  1. common中存放基础的组件、工具类、枚举类等等，一些基础的东西。
  2. model中存放微服务中所涉及到的模型实体类都在此管理可以包含一些*pojo,*Bean,*Entity, vo, bo, dto等。
  3. api中存放我们的所有的接口、文档管理工具和拦截器等。

2.1 构建顶级工程

  1. 选择jdk1.8版本。项目名: imooc-news-dev。创建一个maven工程。
  2. 聚合工程可以分为顶级项目(顶级工程，父工程)与子工程(子module模块)﹐这两者的关系其实就是父子继承的关系，子工程在maven中可以称之为module,模块与模块之间是平级的，是可以相互依赖的。
  3. 子模块可以使用顶级工程中所有的资源（依赖)，子模块之间如果有要使用资源的话, 必须构建依赖.
  4. 一个顶级工程是可以由多个不同的子工程共同组合而成。
    在这里插入图片描述
  5. 以下为顶级pom中的相关依赖。
    • 注意一：springboot的版本和springCloud的版本是相互匹配的。
    • 注意二：dependencyManagement目的是为了保证父工程的干净，也就是说父工程他只负责管理依赖，以及依赖的版本，而不会导入额外的jar依赖。依赖的导入只有在各自的子工程中才会进行导入。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.imooc</groupId>
    <artifactId>imooc-news-dev</artifactId>
    <version>1.0-SNAPSHOT</version>


    <packaging>pom</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.5.RELEASE</version>
        <relativePath />
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>

        <mysql-connector-java.version>5.1.41</mysql-connector-java.version>
        <mybatis-spring-boot-starter.version>2.1.0</mybatis-spring-boot-starter.version>
        <mapper-spring-boot-starter.version>2.1.5</mapper-spring-boot-starter.version>
        <pagehelper-spring-boot-starter.version>1.2.12</pagehelper-spring-boot-starter.version>

        <okhttp.version>4.2.2</okhttp.version>
        <jackson.version>2.10.2</jackson.version>

        <commons-codec.version>1.11</commons-codec.version>
        <commons-lang3.version>3.4</commons-lang3.version>
        <commons-fileupload.version>1.4</commons-fileupload.version>
        <google-guava.version>28.2-jre</google-guava.version>

        <springfox-swagger2.version>2.4.0</springfox-swagger2.version>
        <swagger-bootstrap-ui.version>1.6</swagger-bootstrap-ui.version>
        <fastdfs.version>1.27.2</fastdfs.version>

        <slf4j.version>1.7.21</slf4j.version>
        <joda-time.version>2.10.6</joda-time.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <!-- SpringCloud 依赖 -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Hoxton.SR3</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <!-- 引入 mongodb 依赖 -->
            <dependency>
                <groupId>org.mongodb</groupId>
                <artifactId>mongodb-driver</artifactId>
                <!--mongodb-driver.version-->
                <version>3.11.1</version>
            </dependency>

            <!-- mysql 驱动 -->
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>${mysql-connector-java.version}</version>
            </dependency>
            <!-- mybatis -->
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>${mybatis-spring-boot-starter.version}</version>
            </dependency>
            <!-- 通用mapper逆向工具 -->
            <dependency>
                <groupId>tk.mybatis</groupId>
                <artifactId>mapper-spring-boot-starter</artifactId>
                <version>${mapper-spring-boot-starter.version}</version>
            </dependency>
            <!--pagehelper -->
            <dependency>
                <groupId>com.github.pagehelper</groupId>
                <artifactId>pagehelper-spring-boot-starter</artifactId>
                <version>${pagehelper-spring-boot-starter.version}</version>
            </dependency>

            <dependency>
                <groupId>com.squareup.okhttp3</groupId>
                <artifactId>okhttp</artifactId>
                <version>${okhttp.version}</version>
            </dependency>

            <!-- jackson -->
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-core</artifactId>
                <version>${jackson.version}</version>
            </dependency>
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-annotations</artifactId>
                <version>${jackson.version}</version>
            </dependency>
            <dependency>
                <groupId>com.fasterxml.jackson.core</groupId>
                <artifactId>jackson-databind</artifactId>
                <version>${jackson.version}</version>
            </dependency>

            <!-- apache 工具类 -->
            <dependency>
                <groupId>commons-codec</groupId>
                <artifactId>commons-codec</artifactId>
                <version>${commons-codec.version}</version>
            </dependency>
            <dependency>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-lang3</artifactId>
                <version>${commons-lang3.version}</version>
            </dependency>
            <dependency>
                <groupId>commons-fileupload</groupId>
                <artifactId>commons-fileupload</artifactId>
                <version>${commons-fileupload.version}</version>
            </dependency>

            <!-- google 工具类 -->
            <dependency>
                <groupId>com.google.guava</groupId>
                <artifactId>guava</artifactId>
                <version>${google-guava.version}</version>
            </dependency>

            <!-- swagger2 配置 -->
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger2</artifactId>
                <version>${springfox-swagger2.version}</version>
            </dependency>
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger-ui</artifactId>
                <version>${springfox-swagger2.version}</version>
            </dependency>
            <dependency>
                <groupId>com.github.xiaoymin</groupId>
                <artifactId>swagger-bootstrap-ui</artifactId>
                <version>${swagger-bootstrap-ui.version}</version>
            </dependency>

            <dependency>
                <groupId>com.github.tobato</groupId>
                <artifactId>fastdfs-client</artifactId>
                <version>${fastdfs.version}</version>
            </dependency>

            <!-- joda-time 时间工具 -->
            <dependency>
                <groupId>joda-time</groupId>
                <artifactId>joda-time</artifactId>
                <version>${joda-time.version}</version>
            </dependency>

        </dependencies>
    </dependencyManagement>

    <build>
        <finalName>${project.artifactId}</finalName>
        <plugins>
            <!-- Java 编译 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

2.2 构建模块工程

在这里插入图片描述

  1. imooc-news-dev-common通用工程
    包含了一些工具类，枚举类，封装的一些公共方法以及一些第三方组件等。
  2. imooc-news-dev-model模型工程，所有的子工程以及微服务中所涉及到的模型实体类都在此管理可以包含一些*pojo,*Bean,*Entity, vo, bo, dto等。
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-nH0TbysM-1654789413804)(.\printscreen\1节_5.png)]
  3. imooc-news-dev-service-api接口工程，集中管理所有的controller中的接口，为了更好的统一管理微服务。
  4. model要去依赖common, api需要依赖model。一层一层如上图所示。
    <dependencies>
        <dependency>
            <groupId>com.imooc</groupId>
            <artifactId>imooc-news-dev-common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>

-------------------------------
    <dependencies>
        <dependency>
            <groupId>com.imooc</groupId>
            <artifactId>imooc-news-dev-model</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>
  1. imooc-news-dev-service-user用户工程，引入一些基础依赖。写一个hello用来测试架构是否成功。依赖、路由、配置、启动类。
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
        </dependency>
    </dependencies>

package com.imooc.user.controller;


import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public Object hello() {
        return "hello";
    }
}

############################################################
#
# 用户微服务
# web访问端口号  约定：8003
#
############################################################
server:
  port: 8003
  tomcat:
    uri-encoding: UTF-8
    max-swallow-size: -1  # tomcat默认大小2M，超过2M的文件不会被捕获，需要调整此处大小为100MB或者-1即可

############################################################
#
# 配置项目信息
#
############################################################
spring:
  application:
    name: service-user
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    time-zone: GMT+8

package com.imooc.user;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

2.3 api接口暴露

  1. 第一步：imooc-news-dev-service-user中的依赖移到imooc-news-dev-service-api中去。让user去依赖api
# user中
    <dependencies>
        <dependency>
            <groupId>com.imooc</groupId>
            <artifactId>imooc-news-dev-service-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>

# api中
    <dependencies>
        <dependency>
            <groupId>com.imooc</groupId>
            <artifactId>imooc-news-dev-model</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

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

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
        </dependency>
    </dependencies>
  1. 第二步：imooc-news-dev-service-api创建类com.imooc.api.controller.user.HelloControllerApi 写一个接口。注意：路径在这管理
package com.imooc.api.controller.user;


import org.springframework.web.bind.annotation.GetMapping;

public interface HelloControllerApi {

    @GetMapping("/hello")
    public Object hello();
}
  1. 第三步：imooc-news-dev-service-user修改接口com.imooc.user.controller.HelloController。这里路由去掉了。
package com.imooc.user.controller;


import com.imooc.api.controller.user.HelloControllerApi;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController implements HelloControllerApi {

    public Object hello() {
        return "hello";
    }
}
  1. imooc-news-dev-service-user启动运行。访问测试。
  2. imooc-news-dev-service-api总结：
    • 所有的api 接口就是统一在这里进行管理和调度的，微服务也是如此
    • 现在的所有接口都在此暴露，实现都是在各自的微服务中
    • 本项目只写接口，不写实现，实现在各自的微服务工程中，因为以业务来划分的微服务有很多，controller也会分散在各个微服务工程中，一旦多了就很难统一管理和查看
    • 其次，微服务之间的调用都是基于接口的。如果不这么做，微服务之间的调用就需要相互依赖了，耦合度也就高了，接口的目的为了能够提供解耦。
    • 此外，本工程的接口其实就是一套规范。实现都是由各自的工程去做的处理。目前我们使用springboot作为接口的实现的。如果未来以后出现新的java web框架，那么我们不需要修改接口，只需要去修改对应的实现就可以了。这其实也是解耦的一个体现。
    • Swagger2，基于接口的自动文档生成。所有的配置文件只需要一份，就能在当前项目中去构建了。管理起来很方便。

第三节 工程的基本配置

3.1 配置logback日志

  1. logback日志配置。之前已经引入了依赖，创建resources\logback-spring.xml.
<?xml version="1.0" encoding="UTF-8"?>

<configuration>
    <!-- 指定日志文件的存储地址，使用绝对路径 -->
    <property name="LOG_HOME" value="/workspaces/logs/imooc-news-dev/service-user"/>

    <!-- Console 输出设置 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern>%white(%d{mm:ss.SSS}) %green([%thread]) %cyan(%-5level) %yellow(%logger{36}) %magenta(-) %black(%msg%n)</pattern>
            <charset>utf8</charset>
        </encoder>
    </appender>

    <!-- 按照每天生成日志文件 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 日志文件输出的文件名 -->
            <fileNamePattern>${LOG_HOME}/service-user.%d{yyyy-MM-dd}.log</fileNamePattern>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!--<logger name="org.apache.ibatis.cache.decorators.LoggingCache" level="DEBUG" additivity="false">-->
        <!--<appender-ref ref="CONSOLE"/>-->
    <!--</logger>-->

    <root level="info">
        <appender-ref ref="FILE"/>
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>
  1. 使用一下日志模块。启动运行。查看日志文件生成。
package com.imooc.user.controller;


import com.imooc.api.controller.user.HelloControllerApi;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController implements HelloControllerApi {

    final static Logger logger = LoggerFactory.getLogger(HelloController.class);

    public Object hello() {

        logger.debug("debug: hello~");
        logger.info("info: hello~");
        logger.warn("warn: hello~");
        logger.error("error: hello~");

        return "hello";
    }
}

3.2 多环境profile

  1. 选择配置文件application-dev.yml
  profiles:
    active: dev # yml中配置文件的环境配置

3.3 优雅返回封装结果

  1. 不论是网页还是app，后端都需要构建一个json对象的封装，来让前端人员对接。imooc-news-dev-common 的文件夹下\java\com\imooc\grace\result\GraceJSONResult.java
package com.imooc.grace.result;

import java.util.Map;

/**
 * 自定义响应数据类型枚举升级版本
 */
public class GraceJSONResult {

    // 响应业务状态码
    private Integer status;

    // 响应消息
    private String msg;

    // 是否成功
    private Boolean success;

    // 响应数据，可以是Object，也可以是List或Map等
    private Object data;

    /**
     * 成功返回，带有数据的，直接往OK方法丢data数据即可
     * @param data
     * @return
     */
    public static GraceJSONResult ok(Object data) {
        return new GraceJSONResult(data);
    }
    /**
     * 成功返回，不带有数据的，直接调用ok方法，data无须传入（其实就是null）
     * @return
     */
    public static GraceJSONResult ok() {
        return new GraceJSONResult(ResponseStatusEnum.SUCCESS);
    }
    public GraceJSONResult(Object data) {
        this.status = ResponseStatusEnum.SUCCESS.status();
        this.msg = ResponseStatusEnum.SUCCESS.msg();
        this.success = ResponseStatusEnum.SUCCESS.success();
        this.data = data;
    }


    /**
     * 错误返回，直接调用error方法即可，当然也可以在ResponseStatusEnum中自定义错误后再返回也都可以
     * @return
     */
    public static GraceJSONResult error() {
        return new GraceJSONResult(ResponseStatusEnum.FAILED);
    }

    /**
     * 错误返回，map中包含了多条错误信息，可以用于表单验证，把错误统一的全部返回出去
     * @param map
     * @return
     */
    public static GraceJSONResult errorMap(Map map) {
        return new GraceJSONResult(ResponseStatusEnum.FAILED, map);
    }

    /**
     * 错误返回，直接返回错误的消息
     * @param msg
     * @return
     */
    public static GraceJSONResult errorMsg(String msg) {
        return new GraceJSONResult(ResponseStatusEnum.FAILED, msg);
    }

    /**
     * 错误返回，token异常，一些通用的可以在这里统一定义
     * @return
     */
    public static GraceJSONResult errorTicket() {
        return new GraceJSONResult(ResponseStatusEnum.TICKET_INVALID);
    }

    /**
     * 自定义错误范围，需要传入一个自定义的枚举，可以到[ResponseStatusEnum.java[中自定义后再传入
     * @param responseStatus
     * @return
     */
    public static GraceJSONResult errorCustom(ResponseStatusEnum responseStatus) {
        return new GraceJSONResult(responseStatus);
    }
    public static GraceJSONResult exception(ResponseStatusEnum responseStatus) {
        return new GraceJSONResult(responseStatus);
    }

    public GraceJSONResult(ResponseStatusEnum responseStatus) {
        this.status = responseStatus.status();
        this.msg = responseStatus.msg();
        this.success = responseStatus.success();
    }
    public GraceJSONResult(ResponseStatusEnum responseStatus, Object data) {
        this.status = responseStatus.status();
        this.msg = responseStatus.msg();
        this.success = responseStatus.success();
        this.data = data;
    }
    public GraceJSONResult(ResponseStatusEnum responseStatus, String msg) {
        this.status = responseStatus.status();
        this.msg = msg;
        this.success = responseStatus.success();
    }

    public GraceJSONResult() {
    }

    public Integer getStatus() {
        return status;
    }

    public void setStatus(Integer status) {
        this.status = status;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public Object getData() {
        return data;
    }

    public void setData(Object data) {
        this.data = data;
    }

    public Boolean getSuccess() {
        return success;
    }

    public void setSuccess(Boolean success) {
        this.success = success;
    }
}
  1. imooc-news-dev-common 的文件夹下\java\com\imooc\grace\result\esponseStatusEnum.java
package com.imooc.grace.result;

/**
 * 响应结果枚举，用于提供给GraceJSONResult返回给前端的
 * 本枚举类中包含了很多的不同的状态码供使用，可以自定义
 * 便于更优雅的对状态码进行管理，一目了然
 */
public enum ResponseStatusEnum {

    SUCCESS(200, true, "操作成功！"),
    FAILED(500, false, "操作失败！"),

    // 50x
    UN_LOGIN(501,false,"请登录后再继续操作！"),
    TICKET_INVALID(502,false,"会话失效，请重新登录！"),
    NO_AUTH(503,false,"您的权限不足，无法继续操作！"),
    MOBILE_ERROR(504,false,"短信发送失败，请稍后重试！"),
    SMS_NEED_WAIT_ERROR(505,false,"短信发送太快啦~请稍后再试！"),
    SMS_CODE_ERROR(506,false,"验证码过期或不匹配，请稍后再试！"),
    USER_FROZEN(507,false,"用户已被冻结，请联系管理员！"),
    USER_UPDATE_ERROR(508,false,"用户信息更新失败，请联系管理员！"),
    USER_INACTIVE_ERROR(509,false,"请前往[账号设置]修改信息激活后再进行后续操作！"),
    FILE_UPLOAD_NULL_ERROR(510,false,"文件不能为空，请选择一个文件再上传！"),
    FILE_UPLOAD_FAILD(511,false,"文件上传失败！"),
    FILE_FORMATTER_FAILD(512,false,"文件图片格式不支持！"),
    FILE_MAX_SIZE_ERROR(513,false,"仅支持500kb大小以下的图片上传！"),
    FILE_NOT_EXIST_ERROR(514,false,"你所查看的文件不存在！"),
    USER_STATUS_ERROR(515,false,"用户状态参数出错！"),
    USER_NOT_EXIST_ERROR(516,false,"用户不存在！"),

    // 自定义系统级别异常 54x
    SYSTEM_INDEX_OUT_OF_BOUNDS(541, false, "系统错误，数组越界！"),
    SYSTEM_ARITHMETIC_BY_ZERO(542, false, "系统错误，无法除零！"),
    SYSTEM_NULL_POINTER(543, false, "系统错误，空指针！"),
    SYSTEM_NUMBER_FORMAT(544, false, "系统错误，数字转换异常！"),
    SYSTEM_PARSE(545, false, "系统错误，解析异常！"),
    SYSTEM_IO(546, false, "系统错误，IO输入输出异常！"),
    SYSTEM_FILE_NOT_FOUND(547, false, "系统错误，文件未找到！"),
    SYSTEM_CLASS_CAST(548, false, "系统错误，类型强制转换错误！"),
    SYSTEM_PARSER_ERROR(549, false, "系统错误，解析出错！"),
    SYSTEM_DATE_PARSER_ERROR(550, false, "系统错误，日期解析出错！"),

    // admin 管理系统 56x
    ADMIN_USERNAME_NULL_ERROR(561, false, "管理员登录名不能为空！"),
    ADMIN_USERNAME_EXIST_ERROR(562, false, "管理员登录名已存在！"),
    ADMIN_NAME_NULL_ERROR(563, false, "管理员负责人不能为空！"),
    ADMIN_PASSWORD_ERROR(564, false, "密码不能为空后者两次输入不一致！"),
    ADMIN_CREATE_ERROR(565, false, "添加管理员失败！"),
    ADMIN_PASSWORD_NULL_ERROR(566, false, "密码不能为空！"),
    ADMIN_NOT_EXIT_ERROR(567, false, "管理员不存在或密码错误！"),
    ADMIN_FACE_NULL_ERROR(568, false, "人脸信息不能为空！"),
    ADMIN_FACE_LOGIN_ERROR(569, false, "人脸识别失败，请重试！"),
    CATEGORY_EXIST_ERROR(570, false, "文章分类已存在，请换一个分类名！"),

    // 媒体中心 相关错误 58x
    ARTICLE_COVER_NOT_EXIST_ERROR(580, false, "文章封面不存在，请选择一个！"),
    ARTICLE_CATEGORY_NOT_EXIST_ERROR(581, false, "请选择正确的文章领域！"),
    ARTICLE_CREATE_ERROR(582, false, "创建文章失败，请重试或联系管理员！"),
    ARTICLE_QUERY_PARAMS_ERROR(583, false, "文章列表查询参数错误！"),
    ARTICLE_DELETE_ERROR(584, false, "文章删除失败！"),
    ARTICLE_WITHDRAW_ERROR(585, false, "文章撤回失败！"),
    ARTICLE_REVIEW_ERROR(585, false, "文章审核出错！"),
    ARTICLE_ALREADY_READ_ERROR(586, false, "文章重复阅读！"),

    // 人脸识别错误代码
    FACE_VERIFY_TYPE_ERROR(600, false, "人脸比对验证类型不正确！"),
    FACE_VERIFY_LOGIN_ERROR(601, false, "人脸登录失败！"),

    // 系统错误，未预期的错误 555
    SYSTEM_ERROR(555, false, "系统繁忙，请稍后再试！"),
    SYSTEM_OPERATION_ERROR(556, false, "操作失败，请重试或联系管理员"),
    SYSTEM_RESPONSE_NO_INFO(557, false, "");


    // 响应业务状态
    private Integer status;
    // 调用是否成功
    private Boolean success;
    // 响应消息，可以为成功或者失败的消息
    private String msg;

    ResponseStatusEnum(Integer status, Boolean success, String msg) {
        this.status = status;
        this.success = success;
        this.msg = msg;
    }

    public Integer status() {
        return status;
    }
    public Boolean success() {
        return success;
    }
    public String msg() {
        return msg;
    }
}
  1. imooc-news-dev-service-user测试一下。
package com.imooc.user.controller;


import com.imooc.api.controller.user.HelloControllerApi;
import com.imooc.grace.result.GraceJSONResult;
import com.imooc.grace.result.IMOOCJSONResult;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController implements HelloControllerApi {

    final static Logger logger = LoggerFactory.getLogger(HelloController.class);

    public Object hello() {

        logger.debug("debug: hello~");
        logger.info("info: hello~");
        logger.warn("warn: hello~");
        logger.error("error: hello~");

        return GraceJSONResult.ok();
    }
}

3.4 配置数据库逆向生成工具

  1. 把数据库的表逆向生成到实体类中。
  2. mybatis-generator-database复制到工程中，添加成模块。
    在这里插入图片描述
  3. 修改数据库密码。imooc\mybatis\utils\UserGenerator.java。直接运行这个即可生成对应的代码。
  4. 如果重复生成去resources\mapper\user\AppUserMapper.xml中去看是否重复，如果有重复就删除。

3.5 整合mybatis

  1. 配置imooc-news-dev-model依赖
<!-- mysql 驱动 -->
<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- mybatis -->
<dependency>
	<groupId>org.mybatis.spring.boot</groupId>
	<artifactId>mybatis-spring-boot-starter</artifactId>
</dependency>
<!-- 通用mapper逆向工具 -->
<dependency>
	<groupId>tk.mybatis</groupId>
	<artifactId>mapper-spring-boot-starter</artifactId>
</dependency>
<!--pagehelper -->
<dependency>
	<groupId>com.github.pagehelper</groupId>
	<artifactId>pagehelper-spring-boot-starter</artifactId>
</dependency>

在这里插入图片描述
2. 根据上图复制一下refernce, 在imooc-news-dev-model\src\main\java,右键创建包，把上面内容com.imooc.pojo复制过去。并把文件复制过去。
3. 按照上面的方法把mybatis-generator-database中com.imooc.my.mapper的内容复制过去imooc-news-dev-service-api。主要提供给下面服务用。
4. 把mybatis-generator-database中com.imooc.user.mapper的内容复制过去imooc-news-dev-service-user。
5. 把mybatis-generator-database中resources\mapper\user的下xml文件复制过去imooc-news-dev-service-user的resources/mapper
6. imooc-news-dev-service-user配置数据源application.yml。

spring:
  datasource:                                         # 数据源的相关配置
    type: com.zaxxer.hikari.HikariDataSource          # 数据源类型：HikariCP
    driver-class-name: com.mysql.jdbc.Driver          # mysql驱动
    url: jdbc:mysql://localhost:3306/imooc-news-dev?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true
    username: root
    password: root
    hikari:
      connection-timeout: 30000       # 等待连接池分配连接的最大时长（毫秒），超过这个时长还没可用的连接则发生SQLException， 默认:30秒
      minimum-idle: 5                 # 最小连接数
      maximum-pool-size: 20           # 最大连接数
      auto-commit: true               # 自动提交
      idle-timeout: 600000            # 连接超时的最大时长（毫秒），超时则被释放（retired），默认:10分钟
      pool-name: DateSourceHikariCP     # 连接池名字
      max-lifetime: 1800000           # 连接的生命时长（毫秒），超时而且没被使用则被释放（retired），默认:30分钟 1800000ms
      connection-test-query: SELECT 1
  1. imooc-news-dev-service-user配置mybatis application.yml。
############################################################
#
# mybatis 配置
#
############################################################
mybatis:
  type-aliases-package: com.imooc.pojo          # 所有POJO类所在包路径
  mapper-locations: classpath:mapper/*.xml      # mapper映射文件


############################################################
#
# mybatis mapper 配置
#
############################################################
# 通用 Mapper 配置
mapper:
  mappers: com.imooc.my.mapper.MyMapper
  not-empty: false    # 在进行数据库操作的的时候，判断表达式 username != null, 是否追加 username != ''
  identity: MYSQL
# 分页插件配置
pagehelper:
  helperDialect: mysql
  supportMethodsArguments: true
  1. 添加启动类的扫描注解。 一定选tk下的不要选org下的，启动测试。
import tk.mybatis.spring.annotation.MapperScan; // 一定选tk下的不要选org下的
// 扫描 mybatis 通用 mapper 所在的包
@MapperScan(basePackages = "com.imooc.user.mapper")
// 扫描所有包以及相关组件包
@ComponentScan("com.imooc")

3.6 Swagger2文档生成工具

  1. imooc-news-dev-service-api中配置Swagger2的依赖
<!-- swagger2配置一->
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger2</artifactId>
</dependency>
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger-ui</artifactId>
</dependency>
<dependency>
	<groupId>com.github.xiaoymin</groupId>
	<artifactId>swagger-bootstrap-ui</artifactId>
</dependency>
  1. 创建配置类com.imooc.api.config.Swagger2
package com.imooc.api.config;

import com.google.common.base.Predicate;
import com.google.common.base.Predicates;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.RequestHandler;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class Swagger2 {

//    http://localhost:8088/swagger-ui.html     原路径
//    http://localhost:8088/doc.html     原路径

    // 配置swagger2核心配置 docket
    @Bean
    public Docket createRestApi() {

        //Predicate<RequestHandler> adminPredicate = RequestHandlerSelectors.basePackage("com.imooc.admin.controller");
        //Predicate<RequestHandler> articlePredicate = RequestHandlerSelectors.basePackage("com.imooc.article.controller");
        Predicate<RequestHandler> userPredicate = RequestHandlerSelectors.basePackage("com.imooc.user.controller");
        //Predicate<RequestHandler> filesPredicate = RequestHandlerSelectors.basePackage("com.imooc.files.controller");

        return new Docket(DocumentationType.SWAGGER_2)  // 指定api类型为swagger2
                .apiInfo(apiInfo())                 // 用于定义api文档汇总信息
                .select()
                //.apis(Predicates.or(adminPredicate, articlePredicate, userPredicate, filesPredicate))
                .apis(Predicates.or(userPredicate))
                .paths(PathSelectors.any())         // 所有controller
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("慕课新闻·自媒体接口api")                       // 文档页标题
                .contact(new Contact("imooc",
                        "https://www.imooc.com",
                        "abc@imooc.com"))                   // 联系人信息
                .description("专为慕课新闻·自媒体平台提供的api文档")      // 详细信息
                .version("1.0.1")                               // 文档版本号
                .termsOfServiceUrl("https://www.imooc.com")     // 网站地址
                .build();
    }

}
  1. imooc-news-dev-service-api中接口和方法加上api注解：
package com.imooc.api.controller.user;


import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;

/**
 *  一 为controller添加api注解
 *  @Api(value = "controller标题", tags = {"xx功能controller"})
 *  二 为接口添加注解
 *  @ApiOperation(value = "hello方法", notes = "hello方法", httpMethod = "GET")
 */

@Api(value = "controller标题", tags = {"hello功能controller"})
public interface HelloControllerApi {

    @ApiOperation(value = "hello方法的接口", notes = "hello方法的接口", httpMethod = "GET")
    @GetMapping("/hello")
    public Object hello();
}
  1. 启动user, 访问
    • http://127.0.0.1t:8003/swagger-ui.html 原路径
    • http://127.0.0.1t:8003/doc.html 新路径(这个页面比较清晰好看)
道教儒佛电磁波
关注
  • 0
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
springcloud分布式实战
05-30
springcloud分布式实战，包括springeureka，springhystrix，springribbon，springgateway
实话告诉你吧！没有7年开发经验你真学不会这份SpringCloud实战演练文档！还是躺着吧！
程序员高级码农
11-12 448
前言 Spring Boot 的优势是不言而喻的，它简化了 Spring MVC架构，将其核心代码封装起来，井且基于注解，摒弃了烦琐的 XML ，大大增强了代码的可读性及可维护性，提升了开发效率。此外SpringBoot 集成了 Tomcat ，使项目部署变得容易，不需要单独部署 Tomcat ，使用 Java 命令即可完成项目的发布。 然而SpringBoot 不是分布式架构，随着我公司项目的用户量不断增加，并发数不断增大，基于Spring Boot 的系统架构遇到了瓶颈。无巧不成书，这时微服...
一个基于SpringCloud的实战项目，堪称最佳实践！
最新发布
MarkerHub的博客
05-27 110
微服务版本上线啦！这是一个基于springboot、spring cloud的前后端分离的微商城项目，包括手机端微商城项目和后台管理系统，整个电商购物流程已经能流畅支持，涵盖商品浏览、搜索、商品评论、商品规格选择、加入购物车、立即购买、下单、订单支付、后台发货、退货等。功能强大，主流技术栈，非常值得学习。项目包含2个版本：基于springboot的单体版本基于spring cloud aliaba...
Spring-cloud微服务实战【九】：分布式配置中心config
batt1234的博客
02-24 920
  回忆一下,在前面的文章中,我们使用了spring cloud eureka/ribbon/feign/hystrix/zuul搭建了一个完整的微服务系统,不管是队内还是对外都已经比较完善了,那我们的系统是否还有值得继续优化的地方呢?答案肯定是有的,那就是分布式配置中心config.那什么是分布式配置中心,我们为什么又需要分布式配置中心呢? 什么是分布式配置中心? &emsp...
Spring Cloud 微服务实战
Hunter_Sense的博客
09-07 226
Spring Cloud 微服务实战 1. 什么是微服务 微服务是小的、松耦合的分布式服务，可以分解和分离大型单体应用的功能，使它们完全独立。 谨记：小型的、简单的和解耦的服务=可伸缩的、有弹性的和灵活的应用程序 2. 用Spring Boot 和 Java 构建微服务 2.1 编写Maven脚本 从骨架项目开始，为项目编写Maven脚本。这个POM脚本有以下几个关键点： 告诉Maven包含Spring Boot起步工具包依赖项：spring-boot-starter-parent 告诉Maven包含
SpringCloud微服务实战
ZzzzjQqqq的博客
05-31 448
Java Spring Cloud 是全球范围内最成熟、最完善、最流行的微服务架构体系。 被众多的互联网大公司采用，包括阿里巴巴、腾讯、支付宝、网易、IBM、谷歌、京东、 百度、滴滴等。Spring Cloud 微服务架构体系， 微服务架构模式、算法与典型场景、框架、优缺点，Spring Cloud 2020 的重大变化、扩展 Netflix、Spring Cloud Alibaba 阿里巴巴体系，Dubbo 等架构选型对比，淘宝微服务架构案例。另附一张思维导图供大家参考学习。 阿里等一线互联网公司微服务架
SpringCloud分布式微服务项目Common通用依赖模块抽离示例代码
05-07
SpringCloud分布式微服务项目Common通用依赖模块抽离示例代码 SpringCloud分布式微服务项目Common通用依赖模块抽离示例代码 SpringCloud分布式微服务项目Common通用依赖模块抽离示例代码 SpringCloud分布式微服务...
基于Spring Boot和Spring Cloud的RuoYi-Cloud分布式微服务架构设计源码
04-06
本项目是一个基于Spring Boot和Spring Cloud的RuoYi-Cloud分布式微服务架构设计，包含671个文件，主要文件类型包括Java源代码、Vue组件、SVG图形、JavaScript脚本、XML配置文件、文本文件、VM配置文件、BAT批处理...
简易的SpringCloud分布式微服务项目
02-21
本项目名为"简易的SpringCloud分布式微服务项目"，它旨在提供一个简单易懂的入门示例，帮助开发者理解如何利用SpringCloud实现微服务的搭建和管理。 1. **微服务概念**：微服务是一种软件开发方法，它提倡将单一...
基于Spring Cloud项目实战
热门推荐
zhang_jiayuan的博客
03-20 4万+
（2018年10月2日，从git上移到这里）通过案例学习了基于Spring cloud进行web微服务项目的开发，干货很多。Spring cloud体系提供了完整的微服务开发的解决方案，整合了多个优秀组件，能够很好的帮助我们提高开发效率。在此做以下总结。 Spring Cloud简介 Spring Cloud是一个基于Spring Boot实现的微服务架构开发工具。它...
Spring Cloud项目实战详
Rushinger
09-17 355
项目需求 客户端：针对普通用户，用户登录、用户退出、菜品订购、我的订单。 后台管理系统：针对管理员，管理员登录、管理员退出、添加菜品、查询菜品、修改菜品、删除菜品、订单处理、添加用户、查询用户、删除用户。 [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-20rG643r-1600324884910)(/Users/southwind/我的文件/商务合作/ai/项目实战/笔记/images/1.png)] account 提供账户服务：用户和管理的登录退出。 menu 提供菜品服
spring cloud 分布式实战（三）-- Zuul
呼吸吐纳的博客
08-13 411
Zuul – 服务网关 反向代理和负载均衡，大前置的感觉 pom &lt;dependency&gt; &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt; &lt;artifactId&gt;spring-cloud-starter-zuul&lt;/ar...
spring-cloud 基础实战
CHENGXUYUAN09的博客
03-10 429
微服务是一种架构风格，是以开发一组小型服务的方式来作为一个独立的应用系统，每个服务都运行在自己的进程中，服务之间采用轻量级的http通信机制（通常是采用http的restful api）进行通信，这些服务都是围绕具体业务进行构建的，并且可以独立部署到生产环境上。这些服务可以用不同的变成语言编写，并且可以使用不同的数据存储技术。对这些微服务我们只需要使用一个非常轻量级的集中式管理来进行协调。 1. ...
一篇文章带你玩转SpringCloud实战
qq_41539088的博客
11-04 2183
包含Spring Cloud Netflix以及Spring Cloud Alibaba所有组件
springcloud搭建实战（一）
weixin_52380943的博客
02-24 952
首先创建3个服务 一 1.创建一个父项目（maven项目），用于管理 2.pom.xml <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apa.
SpringCloud微服务项目实战(一)---搭建SpringBoot项目
xiaobai178的博客
06-28 4574
问题：新建子模块后，pom文件的图标是xml文件标识，而不是m标识，而且目录结构是com-xxx-xxx这样一层一层的，而不是package包名一起的解决：idea工作台左侧右键pom文件，点击Add As Maven Project，如下图问题：删除子模块后，再新增同样名称的子模块，pom文件不生效且出现了删除线。解决：File–Settings–Build–Maven–IgnoredFiles中将对勾取消，如下图。
swift项目实战小项目_SpringCloud实战：项目准备，构建大型实战项目
weixin_28285943的博客
01-25 691
项目准备阶段本章中，我们将开始一个大型实战项目——博客网站。通过“以战代练”的方式来学习如何构建Spring Cloud微服务架构，让读者走出理论的丛林，在实践中玩转微服务架构。我们知道，在正式开始搭建框架之前，首先应分析项目需求，再进行原型和UI设计，接着设计数据库结构，最后根据项目特点进行技术选型。本章将依次为大家介绍框架搭建前的准备事宜。项目介绍相信大家都使用过博客，一个完整的博客网站大多包...
springcloud入门实战：Feign+Ribbon实现客户端负载均衡
m0_64205415的博客
11-19 1269
1.随机策略（RandomRule） RandomRule实现类从Provider服务列表清单中随机选择一个Provider服务实例，作为RPC请求的目标Provider。 2.线性轮询策略（RoundRobinRule） RoundRobinRule和RandomRule相似，只是每次都取下一个Provider服务器。假设一共有5台Provider服务节点，使用线性轮询策略，第1次取第1台，第2次取第2台，第3次取第3台，以此类推。 3.响应时间权重策略（WeightedResponseTimeRule）
springcloud分布式微服务
09-02
Spring Cloud 是一个用于构建分布式系统的开发框架，它基于 Spring Boot 进行了扩展，提供了一系列解决分布式系统常见问题的组件和工具。通过 Spring Cloud，你可以更加方便地构建、部署和管理微服务架构。 Spring ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值