快速搭建一个SpringCloud、SpringBoot项目 || 项目搭建要点

1. 基本结构

在这里插入图片描述

  • 建立springcloud项目从表入手，分析好需求建立表结构后，使用mybatis-plux生成POJO类，在对应的model模块中。

2. 微服务部分架构

在这里插入图片描述

2.1 依赖

  • service 微服务模块的依赖仅包含如下，数据库等依赖包含在model中，service引入了model模块，因此也可以调用数据库服务。
<dependencies><!-- 引入依赖模块,有model和common --><dependency><groupId>com.heima</groupId><artifactId>heima-leadnews-model</artifactId></dependency><dependency><groupId>com.heima</groupId><artifactId>heima-leadnews-common</artifactId></dependency><dependency><groupId>com.heima</groupId><artifactId>heima-leadnews-feign-api</artifactId></dependency><!-- Spring boot starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId></dependency></dependencies>

2.2 配置

  • 建立UserApplication启动类
    @SpringBootApplication 注解是在 Spring Boot 应用程序的入口类上使用的，它组合了多个注解的功能，包括 @Configuration、@EnableAutoConfiguration 和 @ComponentScan。
    @EnableDiscoveryClient 注解用于在 Spring Cloud 应用中启用服务发现功能，它会向服务注册中心注册服务，并且能够从服务注册中心获取其他服务的信息。
    @MapperScan 注解是 MyBatis 框架提供的，在 Spring Boot 项目中使用它可以指定要扫描的 MyBatis Mapper 接口的包路径，以便 MyBatis 能够找到这些接口并创建对应的代理对象。具体来说，当使用 @MapperScan 注解指定了要扫描的 Mapper 接口所在的包路径后，MyBatis 在启动时会扫描这些包，找到其中的接口，并根据接口中的方法定义和注解来自动生成对应的实现类（代理对象）。这些代理对象会通过动态代理的方式将接口中的方法映射为对数据库的具体操作，从而实现了接口方法与 SQL 操作的绑定。
@SpringBootApplication
@EnableDiscoveryClient
@MapperScan("com.heima.user.mapper")
public class UserApplication {public static void main(String[] args) {SpringApplication.run(UserApplication.class,args);}
}

  • 建立微服务配置文件bootstrap.yml
    bootstrap.yml 是 Spring Cloud 微服务架构中用于进行应用程序初始化的配置文件。与 application.yml 或 application.properties 不同，bootstrap.yml 主要用于以下两个方面：

    1. 用于连接配置服务器：在微服务架构中，通常会使用配置中心（如Spring Cloud Config Server）来集中管理各个微服务的配置信息。bootstrap.yml 中的配置将会在应用程序启动时最先被加载，用于连接配置服务器并获取应用程序所需的配置信息。

    2. 用于加载外部配置：除了连接配置服务器外，bootstrap.yml 中还可以定义一些应用程序启动时所需的基础配置，例如连接数据库、设置日志级别等。这些配置项将在应用程序启动时优先加载，以确保应用程序能够正常初始化。

server:port: 51801
spring:application:name: leadnews-usercloud:nacos:discovery:server-addr: 127.0.0.1:8848config:server-addr: 127.0.0.1:8848file-extension: yml

bootstrap.yml 仅仅加了基本的配置，在nacos中继续配置，这里面的mysql、mybatis-plus的依赖就是2.1说的依赖

在这里插入图片描述
后期取出依赖使用@Value注解取出，例如下面
在这里插入图片描述

2.3 客户端通过post请求访问后端程序(controller)

在微服务的controller层中进行对应配置，让外界能够访问通提供的服务。注意四个注解

前端发送的必须是Post请求的请求体，且必须要是json格式（@RequestBody注解用于从HTTP请求体中获取数据，并将其映射到方法的参数上。通常与Spring框架中的RESTful风格的控制器方法一起使用，用于接收来自客户端的JSON或XML格式的数据。）

@RestController
@RequestMapping("/api/v1/login")
public class UserController {@PostMapping("/login_auth")public ResponseResult login(@RequestBody LoginDto loginDto){String  phone = loginDto.getPhone();String password = loginDto.getPassword();System.out.println(phone  + " , " + password);return ResponseResult.okResult("token");}
}

查看bootstrap中配置文件配置的服务端口：51801
在这里插入图片描述
访问：
在这里插入图片描述

2.4 使用mybatis_plus访问数据库(sercvice、mapper)

  1. 在model部分构建实体类，以及实体类的Dto对象。实体类其实就是表中的接口，可以直接使用mp生成代码，而dto就是data transform object，仅保留实际需要交互的。如用户登入仅需要前端传输 手机号、密码 即可。
  2. 在2.3 部分，前端已经可以访问通controller层了，现在需要访问service层和mapper层。其实可以直接代码生成，这里细致一点。
    mapper：
@Mapper
public interface ApUserMapper extends BaseMapper<ApUser> {}

serviceInterface:

public interface ApUserLoginService extends IService<ApUser> {public ResponseResult login(LoginDto loginDto);
}

serviceImpl:

@Service
@Transactional
@Slf4j //加了之后可以直接使用log对象来输出日志，而无需手动创建和初始化Logger对象。
public class ApUserLoginServiceImpl extends ServiceImpl<ApUserMapper,ApUser> implements ApUserLoginService {@Overridepublic ResponseResult login(LoginDto loginDto) {...}
}
  1. 在service中如何访问数据库？原理是什么？
    简单一句话访问数据库
ApUser dbUser = getOne(Wrappers.<ApUser>lambdaQuery().eq(ApUser::getPhone, dto.getPhone()));

能直接调用getOne的原因：serviceInterface中 extends IService，IService中有getOne 方法，而Interface的实现类Impl那必然也能够直接访问这个子类方法。
下面是IService中的源码
在这里插入图片描述

参数： Wrappers.<ApUser>lambdaQuery().eq(ApUser::getPhone, dto.getPhone()) 其中Wrappers 是一个类

  • Wrappers.：Wrappers是 MyBatis-Plus 提供的用于构建查询条件的工具类，部分表示指定操作的实体类为ApUser。这里使用了泛型的语法，用于在运行时指定实体类的类型。

  • lambdaQuery()：这是 MyBatis-Plus 中的一种链式调用方式，用于创建一个 LambdaQueryWrapper 对象，LambdaQueryWrapper 是用于构建带有 Lambda 表达式的查询条件的工具类。

  • .eq(ApUser::getPhone, dto.getPhone())：这是 LambdaQueryWrapper 的方法之一，表示添加一个等于条件。在这个例子中，它表示查询ApUser表中phone字段等于dto.getPhone()的记录。

3. common模块部分

application.yml

# 全局端口定义server:
# 全局字符集设置
spring:http:encoding:force: truecharset: utf-8enabled: trueaop:proxy-target-class: true
server:tomcat:uri-encoding: utf-8

3.1 springboot自动装配，使用 META-INF/spring.factories

springboot自动配置（简单来说就是自动把第三方组件的bean装载到IOC容器中，不需要开发人员再去写bean相关的一些配置，只要在启动类中加上@SpringbootApplication注解就可以实现自动装配。约定是第三方的starter启动依赖组件里面，必须有一个configuration配置类，在配置类里面声明@Bean代表是要被注册到IOC容器中的bean）

在这里插入图片描述
在这里插入图片描述

  • 当使用 META-INF/spring.factories 来自动加载 Swagger 配置时，我们需要遵循以下步骤：

创建 Swagger 配置类：编写一个配置类，用于配置 Swagger 相关的信息，例如扫描的包路径、API 文档信息、文档页面的访问路径等。这个配置类通常使用 @EnableSwagger2 或 @EnableSwagger3 注解来启用 Swagger。

package com.heima.common.swagger;
@Configuration
@EnableSwagger2
public class SwaggerConfiguration {@Beanpublic Docket buildDocket() {return new Docket(DocumentationType.SWAGGER_2).apiInfo(buildApiInfo()).select()// 要扫描的API(Controller)基础包.apis(RequestHandlerSelectors.basePackage("com.heima")).paths(PathSelectors.any()).build();}private ApiInfo buildApiInfo() {Contact contact = new Contact("黑马程序员","","");return new ApiInfoBuilder().title("头条-平台管理API文档").description("头条后台api").contact(contact).version("1.0.0").build();}
}

将配置类添加到 META-INF/spring.factories 文件中：在 META-INF 目录下创建一个名为 spring.factories 的文件，然后将配置类的全限定名添加到文件中，以实现自动加载和执行 Swagger 相关的配置。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.config.SwaggerConfig

在上面的示例中，com.example.config.SwaggerConfig 是配置类的全限定名，通过将它添加到 spring.factories 文件中，Spring Boot 在启动时会自动加载和执行这个配置类，从而实现对 Swagger 的自动配置和集成。

总的来说，使用 META-INF/spring.factories 来自动加载 Swagger 配置的过程包括创建配置类并将其添加到 spring.factories 文件中，这样在应用程序启动时就会自动加载并执行 Swagger 相关的配置，无需手动初始化和配置，提高了集成的便捷性和效率。

  • 如果不使用 META-INF/spring.factories 来自动加载 Swagger 配置，你可以手动加载 SwaggerConfig 配置类。以下是一般的手动加载步骤：

在主应用程序类上添加 @Import 注解：打开主应用程序类（通常是带有 @SpringBootApplication 注解的类），并在类上方添加@Import(SwaggerConfig.class) 注解，将 SwaggerConfig 手动引入到应用程序中。


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

创建 Swagger 配置类：创建一个配置类，用于配置 Swagger 相关的信息，例如扫描的包路径、API 文档信息、文档页面的访问路径等。这个配置类应该使用 @Configuration 和 @EnableSwagger2 注解来标识。

@Configuration
@EnableSwagger2
public class SwaggerConfig {@Beanpublic Docket api() {return new Docket(DocumentationType.SWAGGER_2).select().apis(RequestHandlerSelectors.basePackage("com.example.controllers")).paths(PathSelectors.any()).build();}
}

启动应用程序：启动应用程序后，Swagger 将会根据手动引入的 SwaggerConfig 类进行配置，并生成 API 文档信息。
通过以上步骤，你可以手动加载 SwaggerConfig 配置类，实现对 Swagger 的手动配置和集成。这种方式能够明确地控制配置类的加载过程，并且适用于一些特定的场景和需求。

3.2 接口工具 swagger、knife4j

Spring已经将Swagger纳入自身的标准，建立了Spring-swagger项目，现在叫Springfox。通过在项目中引入Springfox ，即可非常简单快捷的使用Swagger。

  1. 引入依赖
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId>
</dependency>
<dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId>
</dependency>
  1. knife4j配置
package com.heima.common.swagger;
@Configuration //作用是定义配置类
@EnableSwagger2
@EnableKnife4j
@Import(BeanValidatorPluginsConfiguration.class)
public class Swagger2Configuration {@Bean(value = "defaultApi2")public Docket defaultApi2() {Docket docket=new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())//分组名称.groupName("1.0").select()//这里指定Controller扫描包路径.apis(RequestHandlerSelectors.basePackage("com.heima")).paths(PathSelectors.any()).build();return docket;}private ApiInfo apiInfo() {return new ApiInfoBuilder().title("黑马头条API文档").description("黑马头条API文档").version("1.0").build();}
}
  1. 在工程中进行配置（common模块下）
    文件：resources/META-INF/Spring.factories
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\com.heima.common.exception.ExceptionCatch,\com.heima.common.swagger.SwaggerConfiguration,\com.heima.common.swagger.Swagger2Configuration
  1. 在微服务模块对应controller与Model中的Dto中加上对应的注解

我们在ApUserLoginController中添加Swagger注解，代码如下所示：

@RestController
@RequestMapping("/api/v1/login")
@Api(value = "app端用户登录", tags = "ap_user", description = "app端用户登录API")
public class ApUserLoginController {@Autowiredprivate ApUserService apUserService;@PostMapping("/login_auth")@ApiOperation("用户登录")public ResponseResult login(@RequestBody LoginDto dto){return apUserService.login(dto);}
}

LoginDto

@Data
public class LoginDto {/*** 手机号*/@ApiModelProperty(value="手机号",required = true)private String phone;/*** 密码*/@ApiModelProperty(value="密码",required = true)private String password;
}

启动user微服务，访问地址：http://localhost:51801/swagger-ui.html

3.3 全局异常处理

  • 全局异常处理：@ControllerAdvice 注解可以配合 @ExceptionHandler 注解，用于统一处理应用程序中抛出的异常。通过在@ControllerAdvice类中定义@ExceptionHandler方法，可以捕获特定类型的异常，并进行统一的处理，比如返回特定的错误页面或者 JSON 响应。
@ControllerAdvice  //控制器增强类，就是标明，这个类就是用来统一处理异常的一个类
@Slf4j
public class ExceptionCatch {@ExceptionHandler(Exception.class) //里面加上想要捕获的异常@ResponseBodypublic ResponseResult exception(Exception e){e.printStackTrace();log.error("catch exception:{}",e.getMessage());return ResponseResult.errorResult(AppHttpCodeEnum.SERVER_ERROR);}/*** 处理可控异常  自定义异常* @param e* @return*/@ExceptionHandler(CustomException.class) //想捕获的异常是自定义异常@ResponseBodypublic ResponseResult exception(CustomException e){log.error("catch exception:{}",e);return ResponseResult.errorResult(e.getAppHttpCodeEnum());}
}

当遇到异常被try catch抛出的时候会被自定义类全局异常类捕获，进行我们自定义的操作，就不会返回一个500错误页面，而是自定义的页面

4. 网关部分

4.1 pom文件导入配置类

4.2 在heima-leadnews-gateway下创建heima-leadnews-app-gateway微服务，写好Application启动类，bootstrap.yml 配置文件，在nacos中写yml配置（如下）

spring:cloud:gateway:globalcors:add-to-simple-url-handler-mapping: truecorsConfigurations:'[/**]':allowedHeaders: "*"allowedOrigins: "*"allowedMethods:- GET- POST- DELETE- PUT- OPTIONroutes:# 平台管理- id: useruri: lb://leadnews-userpredicates: - Path=/user/**filters:- StripPrefix= 1
  • id: user：给这个路由规则指定一个唯一的标识符。
  • uri: lb://leadnews-user：将匹配到的请求转发到名为leadnews-user的负载均衡服务，lb://表示使用负载均衡。
  • predicates：定义路由规则的谓词（predicate），这里使用Path=/user/**表示只有请求路径以/user/开头的请求会匹配到这个路由规则。
  • filters：配置过滤器，这里使用StripPrefix=1表示去除请求路径中的第一个路径段，例如将/user/foo转发到目标服务时会变成/foo。
    通过上述配置，当有请求路径以/user/开头时，Spring Cloud Gateway会将该请求转发到leadnews-user服务，并去除请求路径中的第一个路径段。你可以根据实际需求添加更多的路由规则和过滤器来构建复杂的网关功能。
    在这里插入图片描述

客户端向Spring Cloud Gateway发出请求。如果网关处理程序映射确定请求与路由匹配，则会将其发送到网关Web处理程序。此处理程序通过特定于请求的筛选器链来运行请求。过滤器被虚线分隔的原因是过滤器可以在发送代理请求之前和之后运行逻辑。执行所有“预”过滤器逻辑。然后进行代理请求。在发出代理请求后，将运行“post”过滤器逻辑。

4.3 全局过滤器JWT

在Spring Cloud Gateway中，你可以使用两种方式来定义过滤器链：

filters属性：通过在路由配置中使用filters属性，你可以直接在路由配置中指定过滤器集合。这些过滤器仅适用于特定的路由。示例如下：

spring:cloud:gateway:routes:- id: useruri: lb://leadnews-userpredicates:- Path=/user/**filters:- StripPrefix=1# 其他过滤器...

在上述示例中，filters属性定义了一个过滤器集合，其中包含了StripPrefix过滤器。

GlobalFilter接口：通过实现GlobalFilter接口来编写全局过滤器，全局过滤器会应用于所有进入网关的请求。全局过滤器能够对所有路由生效，并且可以在请求和响应阶段进行修改或添加额外的处理逻辑。

@Component
public class CustomGlobalFilter implements GlobalFilter, Ordered {// 实现过滤器逻辑...
}
  • 总结一下两者的区别：
    filters属性用于在路由配置中为特定路由指定过滤器集合，仅对指定路由生效。
    GlobalFilter接口用于定义全局过滤器，对所有路由生效。
    你可以根据具体需求选择使用哪种方式来配置和定义过滤器。如果需要对所有路由应用相同的过滤逻辑，可以使用全局过滤器。如果只需对特定路由应用特定的过滤器链，可以使用filters属性。
    在这里插入图片描述

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/223300.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

爬取极简壁纸

爬取极简壁纸

js反编译的代码需要解密之类的&#xff0c;直接给我干蒙圈了&#xff0c;借助selenium可以直接获取到调式工具中的源码&#xff0c;可以获取渲染后的链接&#xff0c;然后将链接交给下载函数&#xff08;使用异步提高效率&#xff09;即可。 后续学习完js反编译的话&#xff0…
阅读更多...
【斗破年番】萧炎斩杀蝎山，活捉魂殿铁护法，救小医仙身中魔斑毒

【斗破年番】萧炎斩杀蝎山，活捉魂殿铁护法，救小医仙身中魔斑毒

Hello,小伙伴们&#xff0c;我是拾荒君。 《斗破苍穹年番》第72集的国漫已经更新了。这一集中&#xff0c;蝎毕岩靠着秘术的加成暂时压制住了小医仙。在激烈的交战中&#xff0c;小医仙不得不解开自身的厄难毒体&#xff0c;而每解开一次&#xff0c;她就离死亡更近一步。 萧炎…
阅读更多...
Windows11安装后跳过联网登录

Windows11安装后跳过联网登录

Windows11安装后跳过联网登录 实验设备&#xff1a; VMware17Pro虚拟机中使用Windows11镜像安装Windows11操作系统&#xff0c;并且在虚拟机中测试跳过联网登录。 步骤 说明&#xff1a;物理卸载网卡&#xff08;在虚拟机上禁用网卡&#xff09;没用 思路&#xff1a; sh…
阅读更多...
23种经典设计模式：单例模式篇（C++）

23种经典设计模式：单例模式篇（C++）

前言&#xff1a; 博主将从此篇单例模式开始逐一分享23种经典设计模式&#xff0c;并结合C为大家展示实际应用。内容将持续更新&#xff0c;希望大家持续关注与支持。 什么是单例模式&#xff1f; 单例模式是设计模式的一种&#xff08;属于创建型模式 (Creational Pa…
阅读更多...
innovus如何在floorplan view显示所有module

innovus如何在floorplan view显示所有module

我正在「拾陆楼」和朋友们讨论有趣的话题&#xff0c;你⼀起来吧&#xff1f; 拾陆楼知识星球入口 如题&#xff0c;innovus的图形界面在floorplan view下默认只能显示instance数量超过100个的module&#xff0c;如果要显示更小的module&#xff0c;需要在VIEW-Set Perference…
阅读更多...
关于mybatis插入返回主键id和SpringBoot事务注解自调用演示

关于mybatis插入返回主键id和SpringBoot事务注解自调用演示

文章目录 一. 插入返回任意规则主键ID二. SpringBoot自调用事务2.1 场景12.2 场景2 自调用结论总结 一. 插入返回任意规则主键ID 实体对象 TableName("bank") Data public class Entity {TableId("id")Integer id;TableField("money")Integer …
阅读更多...
nodejs+vue+elementui网上家电家用电器数码商城购物网站 多商家

nodejs+vue+elementui网上家电家用电器数码商城购物网站 多商家

基于vue.js的恒捷网上家电商城系统根据实际情况分为前后台两部分&#xff0c;前台部分主要是让用户购物使用的&#xff0c;包括用户的注册登录&#xff0c;查看公告&#xff0c;查看和搜索商品信息&#xff0c;根据分类定位不同类型的商品&#xff0c;将喜欢的商品加入购物车&a…
阅读更多...
新手用什么工具制作电子画册？新分享

新手用什么工具制作电子画册？新分享

随着数字化时代的到来&#xff0c;电子画册已成为企业宣传、展示产品的重要手段。对于新手来说&#xff0c;选择一款合适的工具是关键。今天&#xff0c;为大家推荐一款适合新手制作的电子画册工具&#xff0c;让你轻松制作出精美画册。 工具推荐&#xff1a;FLBOOK在线制作电子…
阅读更多...
【腾讯云云上实验室】用向量数据库——实现高效文本检索功能

【腾讯云云上实验室】用向量数据库——实现高效文本检索功能

文章目录 前言Tencent Cloud VectorDB 简介Tencent Cloud VectorDB 使用实战申请腾讯云向量数据库腾讯云向量数据库使用步骤腾讯云向量数据库实现文本检索 结论和建议 前言 想必各位开发者一定使用过关系型数据库MySQL去存储我们的项目的数据&#xff0c;也有部分人使用过非关…
阅读更多...
RabbitMQ工作模式2 整合springboot 和MQ高级特性

RabbitMQ工作模式2 整合springboot 和MQ高级特性

RabbitMQ工作模式 1.路由模式 创建交换机 , 连接队列 (生产者) public class MyTestExDirect {Testpublic void bbb() throws IOException, TimeoutException {ConnectionFactory connectionFactory new ConnectionFactory();//连接mqconnectionFactory.setUsername("…
阅读更多...
高端影像仪：打破微小产品测量局限

高端影像仪：打破微小产品测量局限

在现代工业生产中&#xff0c;影像仪以CCD数位影像为基石&#xff0c;将计算机屏幕测量技术与空间几何运算的能力融为一体&#xff0c;可以用于测量微小产品的各种尺寸和形状&#xff0c;为生产过程中的质量控制提供重要的参考依据。 影像仪产品内置高精度光学电动双倍镜头&am…
阅读更多...
【Java数据结构 -- 包装类和泛型】

【Java数据结构 -- 包装类和泛型】

包装类和泛型 1. 包装类1.1 基本数据类型和对应的包装类1.2 装箱和拆箱1.3 自动装箱和自动拆箱1.4 自动装箱实际上是调用了valueOf&#xff08;&#xff09;1.5 Integer包装类赋值注意点 2 什么是泛型3 引出泛型4 泛型的使用4.1 语法4.2 类型推导 5 裸类型6 泛型如何编译6.1 擦…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023