首页手记 Springboot框架教程：新手入门到实战项目

Springboot框架教程：新手入门到实战项目

标签：

SpringBoot

概述

Spring Boot 框架教程涵盖了从快速搭建项目到开发 RESTful 服务、数据库操作、静态资源处理等内容。文章详细讲解了 Spring Boot 的自动配置原理和性能调优方法，并通过实战案例帮助读者理解如何开发一个完整的图书管理系统。此外，文章还提供了详细的错误解决方案和日志管理配置。

Spring Boot 框架教程：新手入门到实战项目

Spring Boot 简介

Spring Boot 是什么

Spring Boot 是一个基于 Spring 框架的开源项目，旨在简化新 Spring 应用的初始搭建以及开发过程。它通过约定优于配置的方式，帮助开发者快速搭建起独立的、生产级别的应用。Spring Boot 不需要编写大量的 XML 或者 Java 配置来搭建和运行一个 Spring 应用，通过使用注解和默认配置，极大的简化了开发者的编码工作。

Spring Boot 的优势

快速启动：Spring Boot 自动配置了许多常用的库和框架，使得创建新的应用变得非常简单。
独立运行：Spring Boot 可以独立运行，支持将应用打包为可执行的 jar 或者 war 文件，运行时不需要任何其他容器支持。
自动配置：通过约定优于配置的方式，Spring Boot 可以自动配置绝大多数项目配置。例如，可以自动配置应用需要的数据源、HTTP 服务器，以及应用使用的各种库。
无代码生成和 XML 配置：在大多数情况下，不需要编写任何 XML 配置。
全面的生产就绪特性：包括内嵌的 Servlet 容器、热部署、健康检查、性能指标、外部化配置、安全、CORS、健康、活跃、信息端点等。
云配置：支持云计算平台和提供者，比如 Cloud Foundry，亚马逊 Web Services（AWS），以及 Heroku。

Spring Boot 与传统 Spring 的区别

Spring Boot 和传统 Spring 框架的主要区别在于配置方式和打包方式:

配置方式：Spring Boot 使用约定优于配置的原则，提供很多默认配置来减少配置文件的编写。而传统 Spring 依赖大量的 XML 或 Java 配置文件来定义应用的配置。
打包方式：Spring Boot 可以将应用打包成独立的可执行 jar 或者 war 文件，而传统 Spring 应用通常需要部署到一个外部的 Servlet 容器（如 Tomcat，Jetty）中。
开发者体验：Spring Boot 设计为简化开发者的工作流程，使得能够快速启动一个新的应用。而传统 Spring 需要更多的配置步骤和开发经验。

快速搭建 Spring Boot 项目

创建 Spring Boot 项目的方法

创建 Spring Boot 项目有多种方法，可以通过 Spring Initializr（在线工具）、IDEA 插件、Maven 插件等方式来创建。这里我们使用 IDEA 插件来创建一个新的 Spring Boot 项目。

Step 1: 安装 Spring Boot 插件

在 IntelliJ IDEA 中安装 Spring Boot 插件，可以通过以下步骤完成：

打开 IntelliJ IDEA。
选择 File -> Settings -> Plugins。
在搜索框中输入 Spring Boot，搜索插件。
选择 Spring Boot 插件，点击 Install 安装插件。
重启 IntelliJ IDEA。

Step 2: 创建新的 Spring Boot 项目

打开 IntelliJ IDEA，点击 File -> New -> Project。
在弹出的对话框中选择 Spring Initializr，点击 Next。
输入项目的基本信息（项目组名、项目名等）。
选择项目依赖（例如 Web、JPA、Thymeleaf 等）。
点击 Finish 完成项目的创建。

配置项目的基本设置

创建好项目后，可以在 pom.xml 或 build.gradle 文件中配置项目的基本信息，如项目版本、Spring Boot 版本、依赖库等。

<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>
    <packaging>jar</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.3.RELEASE</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-data-jpa</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

使用 IDEA 搭建 Spring Boot 项目

IDEA 中提供了丰富的 Spring Boot 插件支持，开发过程中可以方便地进行代码补全、调试、测试等操作。下面以创建一个简单的 RESTful API 为例：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class DemoApplication {

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

    @RestController
    public class GreetingController {

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

上述代码中，@SpringBootApplication 注解是 Spring Boot 的核心注解，包含了三个重要的注解：@Configuration、@EnableAutoConfiguration 和 @ComponentScan。GreetingController 类定义了一个简单的 RESTful API，通过 @GetMapping 映射到 /hello 的 GET 请求。

Spring Boot 的核心配置

配置文件（application.properties/application.yml）详解

Spring Boot 使用 application.properties 或 application.yml 文件来定义各种配置参数。这里以 application.properties 文件为例：

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/demo
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update

# 日志配置
logging.level.root=INFO
logging.file.name=logs/application.log

# 服务器端口
server.port=8080

常用的配置包括数据库连接配置、服务器端口、日志配置等。通过这些配置可以快速定制化 Spring Boot 应用。

属性注入和配置

Spring Boot 环境中，可以使用 @Value 和 @ConfigurationProperties 注解来注入属性。例如，使用 @Value 注解为单个属性注入值：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class ConfigProperties {

    @Value("${spring.datasource.url}")
    private String dbUrl;

    public String getDbUrl() {
        return dbUrl;
    }
}

使用 @ConfigurationProperties 注解可以将一组属性注入到一个对象中：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "spring.datasource")
public class DataSourceProperties {

    private String url;
    private String username;
    private String password;
    private String driverClassName;

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

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

    public String getDriverClassName() {
        return driverClassName;
    }

    public void setDriverClassName(String driverClassName) {
        this.driverClassName = driverClassName;
    }
}

自动配置原理

Spring Boot 使用 @EnableAutoConfiguration 注解来启用自动配置。自动配置是通过 SpringApplication 类中的 addInitializers 方法加载 ConfigurationClassPostProcessor 类来实现的。ConfigurationClassPostProcessor 类会查找带有 @Configuration 和 @EnableAutoConfiguration 注解的类，并在应用启动时自动装配这些类中的 Bean。

下面是一个具体的自动配置类的示例，展示了如何使用 @Configuration 和 @EnableAutoConfiguration 注解：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.EnableAutoConfiguration;

@Configuration
@EnableAutoConfiguration
public class MyAutoConfiguration {

    @Bean
    public MyService myService() {
        return new MyService();
    }
}

Spring Boot 提供了一套默认的自动配置，可以根据项目中的依赖关系自动装配各种组件。例如，如果项目依赖了 spring-boot-starter-web，则会自动装配一个 SpringBootServletInitializer 实现类，该实现类中实现了 SpringApplication 的 run 方法，用于启动 Spring Boot 应用。同时还会自动装配一个 Tomcat 实例，作为应用的 Servlet 容器。

Spring Boot 常用功能介绍

RESTful 服务开发

Spring Boot 提供了强大的 RESTful API 支持，可以通过简单的注解来定义接口和处理请求。以下是一个简单的 RESTful API 示例：

import org.springframework.http.ResponseEntity;
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 UserController {

    @GetMapping("/users")
    public ResponseEntity<List<User>> getUsers() {
        List<User> users = userService.getAllUsers();
        return ResponseEntity.ok(users);
    }
}

上述代码中，使用了 @RestController 注解标记 UserController 类为控制器，同时使用 @GetMapping 注解定义了访问路径 /api/users 的 GET 请求处理方法 getUsers，该方法通过调用 userService 服务来获取用户列表并返回给客户端。

数据库连接与操作

Spring Boot 通过 Spring Data JPA 提供了对数据库的访问支持。以下是一个简单的持久化实体类和对应的 Repository 接口：

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
}

import org.springframework.data.repository.CrudRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface UserRepository extends CrudRepository<User, Long> {
    User findByEmail(String email);
}

在上述代码中，定义了一个 User 实体类，使用了 @Entity 注解将其标记为持久化实体。同时定义了一个 UserRepository 接口，继承了 CrudRepository 接口，该接口提供了基本的 CRUD 操作支持。findByEmail 方法是自定义的方法，用于通过邮箱来查询用户。

静态资源处理

Spring Boot 默认支持静态资源的处理，可以将 webapp 目录下的文件作为静态资源文件，例如 HTML、CSS、JavaScript 等。同时 Spring Boot 还支持 src/main/resources/static 和 src/main/resources/public 目录下的静态资源文件。

以下是一个简单的静态资源文件示例：

在 src/main/resources/static 目录下创建 index.html 文件：

<!DOCTYPE html>
<html>
<head>
    <title>Spring Boot Static Resource Example</title>
</head>
<body>
    <h1>Welcome to Spring Boot!</h1>
</body>
</html>

Spring Boot 会自动解析该文件并将其作为静态资源提供给客户端。

错误处理

Spring Boot 提供了 @ControllerAdvice 和 @ExceptionHandler 注解来处理全局异常。以下是一个简单的全局异常处理器示例：

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 e) {
        return new ResponseEntity<>("An error occurred: " + e.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }

    @ExceptionHandler(ResourceNotFoundException.class)
    public ResponseEntity<String> handleResourceNotFoundException(ResourceNotFoundException e) {
        return new ResponseEntity<>("Resource not found: " + e.getMessage(), HttpStatus.NOT_FOUND);
    }
}

上述代码中，定义了一个全局异常处理器 GlobalExceptionHandler 类，使用了 @ControllerAdvice 注解标记该类为全局异常处理器。同时使用了 @ExceptionHandler 注解定义了两个处理所有异常的方法 handleException 和 handleResourceNotFoundException。

数据库脚本

在“数据库设计”部分，提供了创建数据库表的 SQL 脚本，如下：

CREATE TABLE `book` (
    `id` BIGINT NOT NULL AUTO_INCREMENT,
    `title` VARCHAR(255) NOT NULL,
    `author` VARCHAR(255) NOT NULL,
    `isbn` VARCHAR(255) NOT NULL,
    PRIMARY KEY (`id`)
);

CREATE TABLE `user` (
    `id` BIGINT NOT NULL AUTO_INCREMENT,
    `name` VARCHAR(255) NOT NULL,
    `email` VARCHAR(255) NOT NULL,
    PRIMARY KEY (`id`)
);

Spring Boot 项目实战

实战案例选择与设计

以一个简单的图书管理系统为例，该系统包含图书的增删改查功能。可以选择使用 Spring Boot 来搭建一个完整的图书管理系统。

需求分析

系统需要实现以下功能：
- 图书的增删改查
- 通过书名、作者等字段搜索图书
- 用户登录和权限管理
系统设计

系统可以分为以下几个模块：
- 前端界面
- 后端接口
- 数据库设计

项目开发流程

环境搭建

按照之前章节中介绍的步骤创建一个新的 Spring Boot 项目。

数据库设计

定义图书表 Book 和用户表 User，并创建对应的实体类和 Repository 接口。

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

@Entity
public class Book {

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

   private String title;
   private String author;
   private String isbn;

   // getters and setters
}

import org.springframework.data.jpa.repository.JpaRepository;

public interface BookRepository extends JpaRepository<Book, Long> {
}

后端接口开发

开发图书的增删改查接口，使用 BookController 类作为控制器。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/books")
public class BookController {

   @Autowired
   private BookRepository bookRepository;

   @GetMapping
   public List<Book> getAllBooks() {
       return bookRepository.findAll();
   }

   @PostMapping
   public Book createBook(@RequestBody Book book) {
       return bookRepository.save(book);
   }

   @PutMapping("/{id}")
   public Book updateBook(@PathVariable Long id, @RequestBody Book book) {
       book.setId(id);
       return bookRepository.save(book);
   }

   @DeleteMapping("/{id}")
   public void deleteBook(@PathVariable Long id) {
       bookRepository.deleteById(id);
   }
}

前端界面设计

可以使用 Thymeleaf 模板引擎来设计前端界面，或者使用其他前端框架如 React、Vue.js 等。下面是一个简单的 Thymeleaf 模板示例：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
   <title>Book Management System</title>
</head>
<body>
   <h1>Books</h1>
   <ul th:each="book : ${books}">
       <li th:text="${book.title}"></li>
   </ul>
</body>
</html>

项目部署与测试

构建项目

使用 Maven 或 Gradle 构建项目，生成一个可执行的 jar 文件。
```
mvn clean package
```
启动项目

在命令行中运行生成的 jar 文件。
```
java -jar target/demo-0.0.1-SNAPSHOT.jar
```
测试接口

使用 Postman 或其他 API 测试工具来测试图书的增删改查接口。

Spring Boot 调优与常见问题解决

性能调优方法

使用多线程

通过 @EnableAsync 注解启用异步支持，可以提高应用的并发处理能力。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableAsync;

@SpringBootApplication
@EnableAsync
public class DemoApplication {

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

启用缓存

使用 @EnableCaching 注解启用缓存支持，可以减少数据库的访问次数。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cache.annotation.EnableCaching;

@SpringBootApplication
@EnableCaching
public class DemoApplication {

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

优化数据库连接

通过 spring.datasource 配置项来优化数据库连接池的配置，例如设置连接池的最大连接数、超时时间等。
```
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.maximum-pool-size=20
spring.datasource.hikari.connection-timeout=30000
```

常见错误及解决方案

找不到主类

确保 @SpringBootApplication 注解标注的类作为程序的入口类，并且该类位于包的根目录下。
Java 执行环境问题

确保 Java 环境变量配置正确，并且运行的 Java 版本与项目中使用的 Java 版本一致。
启动时依赖冲突

检查项目依赖配置，确保没有重复的依赖或冲突的依赖。可以通过 Maven 或 Gradle 的依赖树命令查看依赖关系。
数据库连接失败

检查数据库连接配置，确保数据库服务已经启动，并且连接信息正确。

日志配置与管理

Spring Boot 默认使用 Logback 作为日志实现，可以通过 application.properties 文件来配置日志级别和输出位置。

# 日志配置
logging.level.root=INFO
logging.file.name=logs/application.log

也可以通过 @Log 注解获取日志对象，进行日志的输出：


import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.slf4j.Logger;

@RestController
public class DemoController {

    @Autowired
    private Logger log;

    @GetMapping("/hello")
    public String hello() {
        log.info("Hello request received");
        return "Hello, Spring Boot!";
    }
}
``

以上是 Spring Boot 框架的基础入门到实战项目的详细介绍。希望对读者有所帮助。如果你对 Spring Boot 有更深入的需求，可以参考官方文档或参加慕课网的相关课程进行学习。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

一只名叫tom的猫

手记
篇

粉丝

62

获赞与收藏

330

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30583 343

网络编程入门教程

20个小节 12561 237

Pandas 入门教程

25个小节 18499 337

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空