首页手记 Springboot微服务资料入门教程

Springboot微服务资料入门教程

标签：

SpringBoot 微服务

概述

本文全面介绍了Spring Boot微服务资料，涵盖Spring Boot的基本概念、优势、安装配置以及创建第一个微服务应用的详细步骤。文章详细讲解了微服务的基础功能实现、部署测试、集成协作、监控调优和安全性配置等内容，为开发者提供了从入门到进阶的全方位指导。

Spring Boot简介

什么是Spring Boot

Spring Boot 是一个基于Spring框架的开源框架，它简化了Spring应用的初始配置和开发过程。Spring Boot允许开发者通过较少的配置来快速构建独立的、生产级别的应用。Spring Boot的核心关注点在于减少开发过程中的一些繁重的工作，例如配置Spring、数据库连接、服务器端口设置等。通过提供默认配置和各种自动配置的功能，Spring Boot简化了应用开发流程，使得开发者可以更专注于业务逻辑的实现。

Spring Boot的优势和特点

自动配置：Spring Boot通过自动配置使开发更加简便。例如，它可以根据所使用的数据库自动配置相应的连接参数，省去了手动配置的繁琐步骤。
独立的可执行jar：Spring Boot支持将应用打包为独立的可执行jar文件，包含所有依赖项。这使得部署应用变得简单，只需一个命令即可启动应用。
嵌入式服务器：默认情况下，Spring Boot使用嵌入式的web服务器（如Tomcat、Jetty或Undertow），从而简化了部署流程。
约定优于配置：遵循一套约定，减少对配置文件的依赖，简化了项目的结构和配置。
丰富的starter依赖：通过引入starter依赖，可以快速地将常用的库和框架集成到项目中，极大地方便了开发。
外部化配置：提供了对外部配置的支持，使得应用可以在不同的环境中进行配置，如开发环境、测试环境、生产环境等。
全面的web支持：提供了强大的web支持，包括Spring Web、Thymeleaf、JSP等。
全面的测试支持：内置了对各种测试的支持，如单元测试、集成测试、性能测试等。

Spring Boot的安装和环境配置

环境配置

安装Spring Boot并不需要特殊的环境配置，但在开始之前，请确保你的开发环境中已安装了Java和Maven或Gradle。

安装Java：确保安装了Java 8或更高版本。可以在终端中输入java -version来检查Java版本。
安装Maven：Maven是一个强大的项目管理和构建工具。你可以从Maven官网下载并安装Maven。安装完成后，可以通过命令行运行mvn -v来验证Maven是否安装成功。
安装IntelliJ IDEA或Eclipse：选择一个IDE，例如IntelliJ IDEA或Eclipse，用于开发Spring Boot应用。

创建Spring Boot项目

使用Spring Initializr创建项目：
- 访问https://start.spring.io/。
- 选择项目类型（例如，Maven项目）。
- 选择语言和依赖（例如，Java和Web）。
- 点击“Generate”按钮，下载项目压缩包。
- 解压下载的文件，将其导入到IDE中。
使用IDE创建项目：
- 在IntelliJ IDEA中，选择“File” -> “New” -> “Project”。
- 选择“Spring Initializr”，然后填写相关信息，如项目名、语言、依赖（可以选择Web、JPA等）。
- 点击“Finish”完成项目创建。

确保项目结构中包含pom.xml或build.gradle文件，并确保正确配置了依赖关系。例如，pom.xml文件可能如下所示：

<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.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.5</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

创建第一个Spring Boot微服务应用

使用Spring Initializr快速创建项目

创建一个新的Spring Boot项目可以使用Spring Initializr或者IDE自带的Spring Boot插件。以下是使用Spring Initializr的步骤：

访问https://start.spring.io/。
选择项目类型为Maven项目，语言为Java，依赖项包括Spring Web、Spring Data JPA等。
点击“Generate”下载压缩包。
解压文件并导入到IDE中（如IntelliJ IDEA或Eclipse）。

项目结构解析

Spring Boot项目的标准目录结构如下：

src
└── main
    ├── java
    │   └── com
    │       └── example
    │           └── demo
    │               ├── DemoApplication.java
    │               └── controller
    │                   └── HelloController.java
    └── resources
        ├── application.properties
        └── static
            └── index.html

src/main/java：包含应用的Java源代码，如主启动类DemoApplication.java和控制器HelloController.java。
src/main/resources：包含应用的资源文件，如配置文件application.properties和静态资源文件。
application.properties：应用的配置文件，用于定义各种属性，如端口号、数据库连接等。
src/main/resources/static：包含静态资源文件，如HTML、CSS、JavaScript等。

主启动类和配置文件介绍

主启动类

主启动类通常是项目的入口点，用来启动Spring Boot应用。主启动类通常包含一个main方法，并使用Spring Boot的注解@SpringBootApplication。例如：

package com.example.demo;

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

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

这个例子中，@SpringBootApplication注解是一个复合注解，包含了@Configuration、@EnableAutoConfiguration和@ComponentScan三个注解。这些注解共同作用，使得应用能够自动配置、扫描组件、开启Spring Boot的功能。

配置文件

配置文件通常位于src/main/resources目录下，名为application.properties或application.yml。这些文件用于定义应用的各种配置属性。例如：

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/demo
spring.datasource.username=root
spring.datasource.password=root

这些配置属性定义了应用运行的端口以及数据库连接的相关信息。

微服务的基础功能实现

RESTful API的创建

创建RESTful控制器

创建一个简单的RESTful控制器，可以使用@RestController注解来标记类。例如：

package com.example.demo.controller;

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

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String getHello() {
        return "Hello, World!";
    }
}

这个例子中，HelloController类被标记为@RestController，这意味着该类中的方法将直接返回一个HTTP响应体，而不是将返回值作为一个模型传递给视图进行渲染。@RequestMapping注解用于定义根URL映射，@GetMapping注解用于定义GET请求处理方法。

测试API

可以通过发送HTTP请求来测试这个API。例如，使用curl命令或Postman工具，访问http://localhost:8080/api/hello，应返回文本"Hello, World!"。

数据库的连接与使用

配置数据库连接

要连接到数据库，首先需要在配置文件中定义数据库连接参数。例如，在application.properties文件中添加以下配置：

spring.datasource.url=jdbc:mysql://localhost:3306/demo
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update

这些配置指定了数据库类型、URL、用户名和密码。spring.jpa.hibernate.ddl-auto=update表示Spring Boot会自动创建或更新数据库表结构。

使用JPA操作数据库

JPA（Java Persistence API）是一个用来管理Java对象持久化的标准和规范。Spring Boot使用Spring Data JPA作为其数据库访问层。

定义一个简单的实体类：

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    private String email;

    // getters and setters
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

定义一个简单的Repository接口：

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
}

定义一个简单的服务类：

package com.example.demo.service;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    public User saveUser(User user) {
        return userRepository.save(user);
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

定义一个简单的控制器来调用服务：

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api")
public class UserController {

    @Autowired
    private UserService userService;

    @PostMapping("/users")
    public User saveUser(@RequestBody User user) {
        return userService.saveUser(user);
    }

    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.getUserById(id);
    }
}

日志的配置和输出

配置日志

日志是调试和监控应用的重要手段。Spring Boot使用logback作为默认的日志框架，但也可以配置为使用log4j或java.util.logging。

在application.properties文件中，可以定义日志的级别和其他配置：

# 日志级别
logging.level.root=WARN
logging.level.com.example=DEBUG

# 日志文件位置
logging.file.name=logs/app.log

输出日志

在应用中使用@Slf4j注解（来自org.slf4j包）来方便地使用日志记录。例如：

package com.example.demo.service;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    private static final Logger log = LoggerFactory.getLogger(UserService.class);

    public User saveUser(User user) {
        log.debug("Saving user: {}", user);
        return user;
    }

    public User getUserById(Long id) {
        log.debug("Fetching user with id: {}", id);
        return null;
    }
}

这样，每次调用saveUser或getUserById方法时，都会记录相应的日志信息。

微服务的部署与测试

使用Maven打包微服务

打包微服务

使用Maven将应用打包为一个jar文件。在命令行中，导航到项目的根目录，然后运行以下命令：

mvn clean package

这将生成一个jar文件，通常位于target目录下。

运行打包后的jar

可以通过Java命令直接运行打包后的jar文件：

java -jar target/demo-0.0.1-SNAPSHOT.jar

或者，可以使用Maven插件直接运行：

mvn spring-boot:run

在本地运行微服务

运行应用后，应确保微服务能够正常运行。可以通过访问应用的端点来验证。例如，访问http://localhost:8080/api/hello。

使用Postman测试微服务接口

Postman是一个强大的API测试工具，可以用来测试微服务接口。以下是使用Postman测试微服务接口的步骤：

打开Postman，创建一个新的请求。
设置请求类型（如GET、POST等）。
输入请求的URL（例如，http://localhost:8080/api/hello）。
发送请求并查看响应结果。

例如，测试/api/users接口：

创建一个POST请求，URL为http://localhost:8080/api/users。
在Body选项卡中，选择raw和JSON类型，输入用户数据，如下所示：

{
    "name": "John Doe",
    "email": "johndoe@example.com"
}

发送请求，查看响应结果。

微服务的集成与协作

服务发现与注册

服务发现与注册是微服务架构中的关键概念。服务发现使服务能够发现和连接到其他服务，而服务注册使服务能够注册到服务注册中心。Spring Cloud提供了Eureka作为服务发现与注册的实现。

添加依赖

在pom.xml中添加Spring Cloud Eureka的相关依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>

配置服务注册中心

在application.properties文件中配置Eureka服务注册中心：

spring.application.name=eureka-server
server.port=8761
eureka.client.register-with-eureka=false
eureka.client.fetch-registry=false
eureka.instance.hostname=localhost

启动服务注册中心

创建一个简单的Eureka服务注册中心，如：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

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

注册服务

在微服务应用中添加Eureka客户端依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

在application.properties文件中配置微服务注册到Eureka服务注册中心：

spring.application.name=demo-service
server.port=8080
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/

负载均衡与故障转移

负载均衡与故障转移可以通过Spring Cloud的Ribbon和Feign库实现。

添加依赖

在微服务应用中添加Spring Cloud Ribbon依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>
</dependency>

配置负载均衡

在application.properties文件中配置负载均衡：

spring.cloud.loadbalancer.ribbon.enabled=true

使用Feign客户端

Feign是一个声明式的Web服务客户端，使编写Web服务客户端更加简单。Spring Cloud对Feign进行了整合，可以很容易地与Eureka结合使用。

添加Spring Cloud Feign依赖：

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

在应用中启用Feign客户端：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

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

定义一个Feign客户端：

package com.example.demo.client;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import com.example.demo.model.User;

@FeignClient(name = "demo-service")
public interface UserClient {

    @GetMapping("/api/users/{id}")
    User getUser(@PathVariable Long id);
}

微服务之间的通信

在微服务架构中，服务之间的通信是通过API接口进行的。Spring Boot提供了多种方式实现服务间的通信，如Ribbon、Feign、RestTemplate等。

使用RestTemplate

RestTemplate是Spring的用于发送HTTP请求的工具类。在微服务之间可以使用RestTemplate发送HTTP请求来调用其他服务的API。

添加依赖：

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

在应用中使用RestTemplate：

package com.example.demo.service;

import com.example.demo.client.UserClient;
import com.example.demo.model.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class UserService {

    @Autowired
    private UserClient userClient;

    public User getUser(Long id) {
        ResponseEntity<User> response = userClient.getUser(id);
        return response.getBody();
    }
}

微服务的监控与调优

应用监控与性能调优

应用监控

Spring Boot Actuator提供了丰富的监控功能，可以方便地监控应用的运行状态。例如：

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

在application.properties文件中启用Actuator端点：

management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always

性能调优

性能调优可以通过配置应用级别的参数来实现，例如线程池大小、连接池大小等。例如：

server.tomcat.max-threads=200
spring.datasource.hikaricp.maximum-pool-size=20

异常处理与日志管理

异常处理

Spring Boot提供了全局异常处理机制。可以创建一个全局异常处理器来处理未捕获的异常。

package com.example.demo;

import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RequestMapping;
import java.util.Map;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<Map<String, Object>> handleException(Exception ex) {
        Map<String, Object> response = Map.of("status", "failure", "message", ex.getMessage());
        return new ResponseEntity<>(response, HttpStatus.INTERNAL_SERVER_ERROR);
    }

    @RequestMapping("/error")
    public String showErrorPage() {
        return "error";
    }
}

日志管理

在application.properties文件中进一步配置日志管理：

# 配置日志级别
logging.level.org.springframework.web=INFO
logging.level.com.example=DEBUG

# 配置日志文件的滚动策略
logging.file.name=logs/app.log
logging.file.max-size=10MB
logging.file.max-history=10

微服务的安全性配置

基本认证

Spring Boot提供了内置的认证机制，如基本认证和JWT认证。

添加依赖：

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

在应用中配置基本认证：

package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.provisioning.InMemoryUserDetailsManager;
import org.springframework.security.web.SecurityFilterChain;

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeRequests(authorizeRequests ->
                authorizeRequests
                    .antMatchers("/api/hello").permitAll()
                    .antMatchers("/api/users").authenticated()
            )
            .formLogin()
            .and()
            .httpBasic()
            .and()
            .csrf().disable();
        return http.build();
    }

    @Bean
    public UserDetailsService userDetailsService() {
        var user = User.withDefaultPasswordEncoder()
            .username("user")
            .password("password")
            .roles("USER")
            .build();
        return new InMemoryUserDetailsManager(user);
    }
}

OAuth2认证

OAuth2是一种流行的认证框架，Spring Boot可以通过Spring Security OAuth2实现OAuth2认证。

添加依赖：

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

在application.properties文件中配置OAuth2客户端：

spring.security.oauth2.client.registration.github.client-id=your-client-id
spring.security.oauth2.client.registration.github.client-secret=your-client-secret
spring.security.oauth2.client.registration.github.scope=read:user
spring.security.oauth2.client.provider.github.token-uri=https://github.com/login/oauth/access_token
spring.security.oauth2.client.provider.github.user-info-uri=https://api.github.com/user

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕运维8079593

手记
篇

粉丝

18

获赞与收藏

62

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30787 345

网络编程入门教程

20个小节 12720 239

Pandas 入门教程

25个小节 18599 341

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空

Springboot微服务资料入门教程

什么是Spring Boot

Spring Boot的优势和特点

Spring Boot的安装和环境配置

环境配置

创建Spring Boot项目

使用Spring Initializr快速创建项目

项目结构解析

主启动类和配置文件介绍

主启动类

配置文件

RESTful API的创建

创建RESTful控制器

测试API

数据库的连接与使用

配置数据库连接

使用JPA操作数据库

日志的配置和输出

配置日志

输出日志

使用Maven打包微服务

打包微服务

运行打包后的jar

在本地运行微服务

使用Postman测试微服务接口

服务发现与注册

添加依赖

配置服务注册中心

启动服务注册中心

注册服务

负载均衡与故障转移

添加依赖

配置负载均衡

使用Feign客户端

微服务之间的通信

使用RestTemplate

应用监控与性能调优

应用监控

性能调优

异常处理与日志管理

异常处理

日志管理

微服务的安全性配置

基本认证

OAuth2认证

阅读免费教程