Spring Boot学习指南：从入门到初级应用开发-原创手记-慕课网

概述

Spring Boot学习旨在简化新Spring应用的搭建和开发过程，通过提供默认配置减少繁琐的配置工作。本文全面介绍了Spring Boot的核心概念、开发环境搭建、项目实例以及调试与测试技巧，帮助开发者快速上手并专注于业务逻辑的实现。

Spring Boot简介

Spring Boot 是一个用来简化新Spring应用初始搭建以及开发过程的框架。它通过提供一系列默认配置来减少初始搭建和开发过程中的一些繁琐配置，使得开发人员可以更快地开始编码，专注于解决业务问题。

什么是Spring Boot

Spring Boot 是由 Pivotal Teams 设计的一个基于Apache许可的独立子项目。Spring Boot 旨在简化Spring应用程序的初始搭建以及开发过程，并且提供默认配置来帮助开发者快速构建独立的、生产级别的Spring应用。Spring Boot 具有以下特点：

快速启动： 使用 Spring Boot 可以快速搭建一个独立、运行的Spring 应用。
约定优于配置： 通过提供默认配置来简化应用开发。
无需配置 XML： 几乎不需要配置 XML 或者 Java 注解。
自动配置： 自动配置 Spring 环境和依赖。
内嵌Servlet容器： 默认内嵌Tomcat、Jetty或Undertow，无需手动部署war包。
起步依赖： 通过引入一个或多个起步依赖来自动配置，减少手动配置。
命令行接口： 提供一个强大的命令行接口，方便快速启动应用。

Spring Boot的优势和特点

Spring Boot 的优势和特点主要包括：

快速开发： 使用 Spring Boot 可以快速搭建一个独立、运行的Spring 应用。
简化依赖管理： 通过起步依赖简化了依赖管理，减少了开发过程中配置的各种依赖。
零 XML 配置： 大部分情况下，Spring Boot 可以不需要 XML 配置。
自动配置： Spring Boot 会自动配置大多数场景，减少开发人员的工作量。
内嵌集成： 默认集成嵌入式的Servlet容器，简化部署过程。
全面的生产就绪特性： 包括处理静态资源、错误处理、健康检查、指标收集等功能。
简化嵌入式开发： 可以直接运行应用，无需部署到外部的容器中。

开发环境搭建

开发环境搭建主要包括以下步骤：

安装 JDK

Spring Boot 应用需要 Java 环境。首先安装 JDK。推荐安装 JDK 8 或更高版本。
```
# 安装 JDK
sudo apt-get update
sudo apt-get install openjdk-11-jdk
```
安装 IDE

推荐使用 IntelliJ IDEA 或 Eclipse 开发 Spring Boot 应用。
安装 Maven 或 Gradle

Maven 和 Gradle 是常用的构建工具。Spring Boot 项目默认使用 Maven 或 Gradle 来管理依赖和构建项目。

安装 Spring Boot DevTools

Spring Boot DevTools 提供了一系列便利的功能，如自动重启、热部署等，可以提升开发效率。

<!-- 添加 Spring Boot DevTools 依赖 -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-devtools</artifactId>
   <scope>runtime</scope>
   <optional>true</optional>
</dependency>

搭建环境实例

安装 JDK 示例：

# 安装 JDK
sudo apt-get update
sudo apt-get install openjdk-11-jdk

安装 IDE 示例：

# 安装 IntelliJ IDEA
wget https://download.jetbrains.com/idea/ideaIC-2021.3.3.tar.gz
tar -xzf ideaIC-2021.3.3.tar.gz
cd ideaIC-2021.3.3/bin
./idea.sh

# 安装 Eclipse 示例
wget http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2021-12/R/eclipse-java-2021-12-R-linux-gtk-x86_64.tar.gz
tar -xzf eclipse-java-2021-12-R-linux-gtk-x86_64.tar.gz
cd eclipse
./eclipse

安装 Maven 示例：

# 使用 apt 安装 Maven
sudo apt-get update
sudo apt-get install maven

第一个Spring Boot项目

创建Spring Boot项目

创建第一个 Spring Boot 项目主要有两种方式：

使用 Spring Initializr 在线创建
使用 IDE 直接创建

在线创建示例：

访问 Spring Initializr
选择项目依赖：Web、Thymeleaf、Spring Boot DevTools
生成项目压缩包，解压后导入到 IDE 中

IDE 创建示例：

打开 IntelliJ IDEA，选择 "File" -> "New" -> "Project"
选择 "Spring Initializr"，点击 "Next"
输入项目基本信息，如 Group、Artifact 等，选择 "Maven" 作为构建工具
选择所需依赖，如 Web、Thymeleaf、Spring Boot DevTools，点击 "Next"
输入项目位置，点击 "Finish"

项目结构介绍

Spring Boot 项目的典型结构如下：

myapp
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.example
│   │   │       └── myapp
│   │   │           ├── Application.java
│   │   │           └── controller
│   │   │               └── HelloController.java
│   │   └── resources
│   │       ├── application.properties
│   │       └── static
│   │           └── index.html
│   └── test
│       └── java
│           └── com.example
│               └── myapp
│                   └── MyApplicationTests.java
└── pom.xml

Application.java：主启动类
HelloController.java：控制器类
application.properties：应用配置文件
index.html：静态资源文件
MyApplicationTests.java：单元测试类

启动第一个Spring Boot应用程序

启动 Spring Boot 应用程序主要有两种方式：

IDE 中运行主启动类：

在 IntelliJ IDEA 中，右键 Application.java，选择 "Run"。

package com.example.myapp;

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);
   }
}

命令行运行：

使用 Maven 或 Gradle 在命令行启动应用。
```
# 使用 Maven
mvn spring-boot:run

# 使用 Gradle
gradle bootRun
```

Spring Boot核心概念

自动配置

Spring Boot 通过约定优于配置的方式自动配置了许多常见场景。例如，启动一个内嵌的Servlet容器，自动配置数据源和数据库连接。

自动生成数据源配置示例：

spring:
  application:
   name: myapp
   datasource:
      url: jdbc:mysql://localhost:3306/mydb
      username: root
      password: root

依赖管理和启动器

Spring Boot 使用 Maven 或 Gradle 来管理依赖，并引入了 "启动器" 概念。启动器包含了实现某个功能所需的依赖，如 spring-boot-starter-web 包含 Web 应用所需的依赖。

引入 Web 启动器示例：

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

配置文件详解

Spring Boot 支持多种配置文件，常用的有 application.properties 和 application.yml。这些配置文件可以用来覆盖默认配置或定义自己的配置。

application.properties 示例：

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

application.yml 示例：

server:
  port: 8080
spring:
  datasource:
   url: jdbc:mysql://localhost:3306/mydb
   username: root
   password: root

Spring Boot常用功能

路由和控制器

路由和控制器是处理 HTTP 请求的入口。可以使用 @Controller 或 @RestController 注解来定义控制器类，并使用 @RequestMapping 或 @GetMapping 等注解来映射 URL 和处理方法。

Controller 示例：

package com.example.myapp.controller;

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

@RestController
public class HelloController {

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

数据访问与存储

Spring Boot 支持多种数据库，如 MySQL、PostgreSQL 等。可以使用 spring-boot-starter-data-jpa 来实现 JPA 操作数据库。

JPA 示例：

package com.example.myapp.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;
    private String password;

    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;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", email='" + email + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}

package com.example.myapp.repository;

import com.example.myapp.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

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

错误处理

Spring Boot 提供了内置的错误处理机制，可以自定义全局错误处理器来处理应用中的异常。

全局错误处理器示例：

package com.example.myapp.config;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception ex) {
        return new ResponseEntity<>("An error occurred: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

实战案例：开发一个简易的博客系统

需求分析

一个简易的博客系统需求如下：

用户管理： 可以注册、登录和注销用户
文章管理： 用户可以发布、编辑和删除文章
评论管理： 用户可以对文章发表评论
显示文章列表： 展示所有文章列表
文章详情： 查看文章详情和评论

项目规划

数据库设计： 设计用户表、文章表、评论表
前端页面： 设计注册、登录、发布文章、查看文章等页面
后端接口： 实现用户注册、登录、发布文章、查看文章等功能
前端与后端集成： 实现前后端交互，展示数据

功能实现

数据库设计：

CREATE TABLE users (
   id SERIAL PRIMARY KEY,
   username VARCHAR(255) NOT NULL UNIQUE,
   email VARCHAR(255) NOT NULL UNIQUE,
   password VARCHAR(255) NOT NULL
);

CREATE TABLE posts (
   id SERIAL PRIMARY KEY,
   title VARCHAR(255) NOT NULL,
   content TEXT NOT NULL,
   user_id INT NOT NULL,
   created_at TIMESTAMP DEFAULT NOW(),
   FOREIGN KEY (user_id) REFERENCES users(id)
);

CREATE TABLE comments (
   id SERIAL PRIMARY KEY,
   post_id INT NOT NULL,
   user_id INT NOT NULL,
   content TEXT NOT NULL,
   created_at TIMESTAMP DEFAULT NOW(),
   FOREIGN KEY (post_id) REFERENCES posts(id),
   FOREIGN KEY (user_id) REFERENCES users(id)
);

后端接口实现：

package com.example.myapp.controller;

import com.example.myapp.model.User;
import com.example.myapp.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import javax.servlet.http.HttpServletResponse;
import java.util.Optional;

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

   @Autowired
   private UserRepository userRepository;

   @PostMapping("/register")
   public User register(@RequestBody User user) {
       return userRepository.save(user);
   }

   @PostMapping("/login")
   public User login(@RequestBody User user) {
       Optional<User> optionalUser = userRepository.findByUsername(user.getUsername());
       return optionalUser.orElse(null);
   }

   @GetMapping("/logout")
   public void logout(HttpServletResponse response) {
       response.setStatus(HttpServletResponse.SC_OK);
   }
}

package com.example.myapp.controller;

import com.example.myapp.model.Post;
import com.example.myapp.repository.PostRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/posts")
public class PostController {

   @Autowired
   private PostRepository postRepository;

   @PostMapping("/create")
   public Post create(@RequestBody Post post) {
       return postRepository.save(post);
   }

   @GetMapping("/list")
   public List<Post> list() {
       return postRepository.findAll();
   }
}

前端页面实现：

<!DOCTYPE html>
<html lang="en">
<head>
   <meta charset="UTF-8">
   <title>Blog - Register</title>
</head>
<body>
<h1>Register</h1>
<form action="/users/register" method="post">
   <input type="text" name="username" placeholder="Username">
   <input type="email" name="email" placeholder="Email">
   <input type="password" name="password" placeholder="Password">
   <button type="submit">Register</button>
</form>
</body>
</html>

<!DOCTYPE html>
<html lang="en">
<head>
   <meta charset="UTF-8">
   <title>Blog - Posts</title>
</head>
<body>
<h1>Posts</h1>
<ul>
   <li th:each="post : ${posts}">
       <h2 th:text="${post.title}"></h2>
       <p th:text="${post.content}"></p>
   </li>
</ul>
</body>
</html>

Spring Boot调试与测试

单元测试与集成测试

Spring Boot 支持使用 JUnit 和 MockMvc 等工具进行单元测试和集成测试。

单元测试示例：

package com.example.myapp.config;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest
public class ApplicationTests {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void shouldReturnDefaultMessage() throws Exception {
        mockMvc.perform(get("/"))
            .andExpect(status().isOk())
            .andExpect(content().string("Hello, World!"));
    }
}

集成测试示例：

package com.example.myapp.repository;

import com.example.myapp.model.User;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;

import java.util.Optional;

import static org.junit.jupiter.api.Assertions.assertEquals;

@DataJpaTest
public class UserRepositoryTest {

    @Autowired
    private UserRepository userRepository;

    @Test
    public void shouldFindUserByUsername() {
        User user = new User();
        user.setUsername("test");
        user.setPassword("password");
        user.setEmail("test@example.com");
        userRepository.save(user);

        Optional<User> foundUser = userRepository.findByUsername("test");
        assertEquals("test", foundUser.get().getUsername());
    }
}

日志配置与调试技巧

Spring Boot 使用 Logback 和 Log4j2 作为默认的日志框架。可以通过 application.properties 或 application.yml 配置日志。

日志配置示例：

logging:
  level:
    root: INFO
    com.example: DEBUG

调试技巧：

使用 spring-boot-devtools： 提供自动重启和热部署功能。
使用断点调试： 在 IDE 中设置断点，单步调试代码。
使用日志： 通过配置日志级别来查看详细的日志信息。
使用 actuator： Spring Boot Actuator 提供了一系列生产就绪特性，如健康检查、指标收集等。

通过以上步骤，你可以更好地理解和使用 Spring Boot 来开发应用。