首页手记 SpringBoot入门：从零开始搭建第一个Sprin...

SpringBoot入门：从零开始搭建第一个SpringBoot应用

标签：

SpringBoot

概述

Spring Boot入门介绍了Spring Boot框架的核心概念和快速搭建应用的过程，包括环境配置、项目创建和运行，帮助开发者快速上手。文章详细解释了Spring Boot的自动配置原理、Starter依赖管理和配置文件的使用方法，提供了丰富的实战案例和部署建议。

SpringBoot简介

Spring Boot 是一个用于简化新 Spring 应用创建过程的框架。它基于 Spring 框架，让开发者能够快速地搭建独立运行的、生产级别的应用。Spring Boot 可以看作是对 Spring 项目的简化和自动配置，提供了大量开箱即用的功能，大大减少了开发过程中配置代码的数量，使得开发者可以专注于业务逻辑的实现。

什么是SpringBoot

Spring Boot 是由 Pivotal 团队提供的，用于简化 Spring 应用的配置过程的框架。它基于 Spring 框架，通过预设的一系列配置，使得开发者可以在最短的时间内完成应用的搭建，从而提高开发效率。Spring Boot 提供了一种声明式的配置方式，使得配置变得更加直观和简单。

SpringBoot的优势

快速搭建应用：Spring Boot 提供了大量的默认配置选项，使得开发者可以非常快速地搭建一个简单的应用。
自动化配置：Spring Boot 自动配置了很多常用的框架和库，如数据库连接、日志等，开发者只需通过注解或配置文件进行轻量级配置即可。
嵌入式服务器：Spring Boot 可以直接运行在 Web 服务器上，比如 Tomcat、Jetty 或者 Undertow，开发者无需配置复杂的服务器环境。
内外部配置分离：Spring Boot 提供了多种配置方式，包括外部配置文件（如 application.properties 或 application.yml）和环境变量等，使得内外部配置可以灵活分离。
集成第三方库：Spring Boot 提供了多种 Starter 依赖，使得集成第三方库变得更加简单，开发者只需添加对应的依赖即可。
无码配置：Spring Boot 的一大特点是无需编写大量配置代码，大部分配置都可以通过注解或者配置文件完成。
优秀的单元测试支持：Spring Boot 提供了丰富的单元测试支持，内置了 JUnit、Mockito 等测试框架，方便开发者进行单元测试。
生产就绪特性：Spring Boot 内置了许多生产环境的特性，如性能监控、错误处理、日志管理等，使得应用可以直接部署到生产环境。
命令行工具：Spring Boot 提供了一系列命令行工具，比如 spring-boot:run，可以方便地启动应用。
支持云服务：Spring Boot 内置了对多种云服务的支持，比如 Amazon Web Services (AWS)、Microsoft Azure 等，使得部署到云服务变得更加简单。

SpringBoot的适用场景

微服务：Spring Boot 微服务架构支持轻量级、独立的服务开发，易于部署和扩展。
快速原型开发：Spring Boot 提供了丰富的库和配置，使得快速搭建原型变得更加简单。
企业级应用开发：Spring Boot 提供了企业级应用开发所需的特性，如安全性、监控、日志管理等。
遗留系统现代化：Spring Boot 可以作为现代化遗留系统的一步，将原有的应用迁移到 Spring Boot 框架上。
测试驱动开发：Spring Boot 提供了丰富的测试支持，使得测试驱动开发变得更加简单。
跨平台开发：Spring Boot 支持多种操作系统和编程语言，可以构建跨平台的应用。
简化配置：Spring Boot 的自动化配置特性使得配置变得简单，可以减少配置代码的数量。
开发效率提升：Spring Boot 的快速启动特性使得开发效率得到提升。
生产就绪：Spring Boot 内置了许多生产环境所需的功能，使得应用可以直接部署到生产环境。
易于维护：Spring Boot 的轻量级配置和内置的日志管理使得应用更加易于维护。

环境搭建

开发环境配置

为了开始开发 Spring Boot 应用，首先需要配置好开发环境。这包括安装 Java 开发工具包（JDK）、集成开发环境（IDE）、构建工具（Maven 或 Gradle）以及版本控制系统（如 Git）。

安装Java环境

下载安装 JDK：访问 Oracle 官方网站下载适合您操作系统的 JDK 版本。
设置环境变量：安装完成后，需要设置环境变量以确保 Java 可以被系统识别。
- 操作系统变量设置示例：
```
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
```
验证安装：通过运行命令 java -version 验证安装是否成功。
```
java -version
```

创建第一个SpringBoot项目

使用 Spring Initializr 创建项目：Spring Initializr 是一个在线的项目生成工具，可以快速地生成一个 Spring Boot 项目。
- 访问 Spring Initializr。
- 选择项目类型：语言（Java）、打包方式（Jar 或 War）、依赖（例如 Web、Thymeleaf、JPA）。
- 输入项目基本信息：Group（如 com.example）、Artifact（如 demo）、依赖版本（如 2.7.0）。
- 点击“Generate”按钮生成项目文件。
下载并解压项目：下载生成的压缩包并解压到本地开发环境中。
导入项目到 IDE：使用 Eclipse 或 IntelliJ IDEA 等 IDE 打开解压后的项目文件夹。
构建和运行项目：
- 使用 Maven 或 Gradle 的命令构建项目。
```
mvn clean package
```
- 运行项目：
```
mvn spring-boot:run
```

项目结构解析

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

src/main/java：存放 Java 源代码，包括 Spring Boot 应用的主类。
src/main/resources：存放资源文件，如配置文件 application.properties 或 application.yml。
pom.xml（或 build.gradle）：项目构建描述文件，Maven 或 Gradle 使用。
src/main/resources/static：存放静态资源文件，如 HTML、CSS、JavaScript。
src/main/resources/templates：存放 Thymeleaf 模板文件。
src/main/resources/META-INF/resources：存放静态资源文件，如 HTML、CSS、JavaScript（在使用嵌入式 Web 服务器时）。
src/test/java：存放测试代码。
src/test/resources：存放测试相关的资源文件。

第一个SpringBoot应用

创建简单的SpringBoot应用

创建一个简单的 Spring Boot 应用，包含一个简单的控制器，用于响应 HTTP GET 请求。

创建主类：在 src/main/java 目录下创建主类，该类需要继承自 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);
   }
}

创建控制器：在 src/main/java 目录下创建一个控制器类，并定义一个简单的 RESTful API。

package com.example.demo;

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

@RestController
public class HelloController {

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

运行和测试应用

运行应用：使用 Maven 或 Gradle 的命令运行应用。
```
mvn spring-boot:run
```
测试应用：打开浏览器或使用命令行工具（如 curl），访问 http://localhost:8080/hello。
```
curl http://localhost:8080/hello
```
预期输出：
```
Hello, World!
```

解读启动日志

启动日志会提供大量的信息，包括应用的启动过程、配置的自动注入等。

启动日志解析：

开始启动应用：

2023-01-01 12:00:00,000 INFO  [main] o.s.b.SpringApplication - Starting application...

读取配置文件：

2023-01-01 12:00:01,000 INFO  [main] o.s.b.c.c.ConfigFileApplicationListener - Loaded configuration from 'file:/path/to/application.properties'

启动应用成功：

2023-01-01 12:00:02,000 INFO  [main] o.s.b.SpringApplication - Started application in 3.418 seconds (JVM running for 4.299)

启动成功后应用运行在端口 8080：

2023-01-01 12:00:02,000 INFO  [main] o.s.b.web.embedded.tomcat.TomcatStarter - Tomcat started on port(s): 8080 (http)

SpringBoot核心概念

自动配置原理

Spring Boot 的自动配置功能允许开发者通过注解或配置文件来自动配置 Spring 应用。自动配置的核心是 @SpringBootApplication 注解，该注解继承了 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 三个注解。

@Configuration：标记类为配置类，可以提供 Bean 的定义。
@EnableAutoConfiguration：允许 Spring Boot 自动配置应用。
@ComponentScan：扫描指定包下的组件。

Starter依赖管理

Starter 是 Spring Boot 提供的一系列依赖管理器，用于简化依赖的管理过程。每个 Starter 依赖通常包含了多个库的依赖，使得引入特定功能变得更加简单。

例如，要引入 Spring Web 的依赖，只需要添加一个 spring-boot-starter-web 依赖即可。

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

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

Spring Boot 提供了两种类型的配置文件：application.properties 和 application.yml。

application.properties：使用属性文件的方式配置应用。

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

application.yml：使用 YAML 格式配置应用。

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

实战：添加功能

添加Controller

扩展应用中的控制器，例如添加一个 RESTful API 用于返回当前时间。

package com.example.demo;

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

import java.time.LocalDateTime;

@RestController
public class TimeController {

    @GetMapping("/time")
    public String currentTime() {
        return LocalDateTime.now().toString();
    }
}

使用SpringBoot的内置功能（如：RestTemplate, JPA）

使用 RestTemplate 发送 HTTP 请求：

package com.example.demo;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

@RestController
public class RestController {

   @Autowired
   private RestTemplate restTemplate;

   @GetMapping("/api")
   public String callApi() {
       ResponseEntity<String> response = restTemplate.getForEntity("http://example.com/api/data", String.class);
       return response.getBody();
   }
}

使用 JPA 进行数据库操作：

package com.example.demo;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;

@Service
public class UserService {

   @PersistenceContext
   private EntityManager entityManager;

   public void createUser(User user) {
       entityManager.persist(user);
   }
}

集成第三方服务（如：数据库、邮件服务）

集成数据库（如 MySQL）：

添加依赖：

<dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>8.0.25</version>
</dependency>
<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

配置数据库连接：

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

实现一个简单的 DAO：

package com.example.demo;

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

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

集成邮件服务（如 SendGrid）：

添加依赖：

<dependency>
 <groupId>com.sendgrid</groupId>
 <artifactId>sendgrid-java</artifactId>
 <version>4.7.1</version>
</dependency>

配置邮件服务：

spring.mail.host=smtp.sendgrid.net
spring.mail.port=587
spring.mail.username=apikey
spring.mail.password=your_api_key
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.connectiontimeout=5000
spring.mail.properties.mail.smtp.timeout=5000
spring.mail.properties.mail.smtp.socketFactory.port=587
spring.mail.properties.mail.smtp.socketFactory.fallback=false
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory

发送邮件：

package com.example.demo;

import com.sendgrid.Method;
import com.sendgrid.Request;
import com.sendgrid.SendGrid;
import com.sendgrid.helpers.mail.Mail;
import com.sendgrid.helpers.mail.objects.Content;
import com.sendgrid.helpers.mail.objects.Email;

public class EmailService {

 private final SendGrid sendGrid;

 @Autowired
 public EmailService(SendGrid sendGrid) {
     this.sendGrid = sendGrid;
 }

 public void sendEmail(String to, String subject, String content) throws Exception {
     Email from = new Email("from@example.com");
     Email toEmail = new Email(to);
     Content contentObj = new Content("text/plain", content);
     Mail mail = new Mail(from, subject, toEmail, contentObj);
     Request request = new Request();
     request.setMethod(Method.POST);
     request.setEndpoint("mail/send");
     request.setBody(mail.build());
     sendGrid.api(request);
 }
}

总结与后续学习方向

SpringBoot应用部署

使用 Docker 部署：

创建 Dockerfile：

FROM openjdk:11-jre-slim
ADD target/myapp.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

构建并运行 Docker 镜像：

docker build -t myapp .
docker run -p 8080:8080 myapp

使用云服务部署：
- 利用 AWS、Azure 或 Google Cloud 的服务（如 AWS Elastic Beanstalk、Azure App Service）进行部署。

常见问题解决

内存溢出问题（Out of Memory）：
- 调整 JVM 的内存设置：
```
java -Xms512m -Xmx1024m -jar myapp.jar
```

线程泄露问题：

设置线程池的大小：

spring.profiles.active=prod
spring.datasource.maximum-pool-size=10

启动时间过长：

使用 Spring Boot 的 actuator 依赖来监控应用启动时间。

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

配置参数冲突：

调整配置文件中的相关参数。

spring:
datasource:
 url: jdbc:mysql://localhost:3306/db
 username: root
 password: root

SpringBoot入门：从零开始搭建第一个SpringBoot应用

SpringBoot简介

什么是SpringBoot

SpringBoot的优势

SpringBoot的适用场景

环境搭建

开发环境配置

安装Java环境

创建第一个SpringBoot项目

项目结构解析

第一个SpringBoot应用

创建简单的SpringBoot应用

运行和测试应用

解读启动日志

SpringBoot核心概念

自动配置原理

Starter依赖管理

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

实战：添加功能

添加Controller

使用SpringBoot的内置功能（如：RestTemplate, JPA）

集成第三方服务（如：数据库、邮件服务）

总结与后续学习方向

SpringBoot应用部署

常见问题解决

推荐学习资源

阅读免费教程

热搜

最近搜索清空

SpringBoot入门：从零开始搭建第一个SpringBoot应用

SpringBoot简介

什么是SpringBoot

SpringBoot的优势

SpringBoot的适用场景

环境搭建

开发环境配置

安装Java环境

创建第一个SpringBoot项目

项目结构解析

第一个SpringBoot应用

创建简单的SpringBoot应用

运行和测试应用

解读启动日志

SpringBoot核心概念

自动配置原理

Starter依赖管理

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

实战：添加功能

添加Controller

使用SpringBoot的内置功能（如：RestTemplate, JPA）

集成第三方服务（如：数据库、邮件服务）

总结与后续学习方向

SpringBoot应用部署

常见问题解决

推荐学习资源

阅读免费教程