首页手记 Spring Boot项目开发入门教程

Spring Boot项目开发入门教程

标签：

Java SpringBoot

概述

Spring Boot项目开发简化了新Spring应用的初始搭建及开发过程，通过自动配置和快速启动功能，开发者可以专注于业务逻辑实现。本文详细介绍Spring Boot的配置、环境搭建、项目创建、REST API开发、数据库集成、静态资源管理以及部署调试等关键步骤。

Spring Boot 简介

什么是 Spring Boot

Spring Boot 是一个基于 Spring 框架的简化开发的项目，旨在简化新 Spring 应用的初始搭建以及开发过程。Spring Boot 通过约定优于配置的原则，帮助开发者快速搭建起独立运行的 Spring 应用。

Spring Boot 主要目标是为开发人员提供干净的初始代码，快速集成各种功能模块，从而减少初始配置和样板代码。它提供了一系列默认配置和快速启动功能，使得开发人员可以专注于业务逻辑的实现，而不需要过多关注配置细节。

Spring Boot 的优势

简化配置：Spring Boot 提供了大量的约定优于配置的功能，自动配置了许多常用的中间件和组件，减少了配置文件的编写。
快速启动：Spring Boot 自动装配功能可以快速启动应用，无需手动配置各种 Bean。
独立运行：Spring Boot 应用可以独立运行，无需部署在传统的 Servlet 容器中，可以直接打包为可执行的 JAR 文件。
模块支持：Spring Boot 提供了丰富的 Starter 模块，涵盖了 Web、数据访问、安全、测试等领域。
嵌入式服务器：Spring Boot 可以嵌入 Servlet 容器（如 Tomcat、Jetty），使得应用可以作为一个独立的程序运行。
热部署：Spring Boot 支持热部署，代码修改后可以立即生效，大大加快了开发速度。
全面的监控工具：Spring Boot 提供了 Actuator 模块，方便开发者监控应用的运行状态。
单元测试支持：Spring Boot 提供了方便的单元测试支持，可以轻松运行单元测试，包括集成测试。
微服务支持：Spring Boot 是微服务架构的理想选择，支持各种微服务框架，如 Spring Cloud。

Spring Boot 的核心概念

Spring Boot 的核心概念主要包括以下几个方面：

自动配置：Spring Boot 根据约定自动配置了应用所需的大多数配置，使得开发人员只需要关注应用的业务逻辑。
Starter 依赖管理：Spring Boot 通过 Starter 依赖管理简化了依赖配置，只需要在 pom.xml 或 build.gradle 文件中添加 Starter 依赖即可引入所需的库。
内置 Web 服务器：Spring Boot 内置了 Tomcat、Jetty、Undertow 等 Web 服务器，使得应用可以作为一个独立的程序运行。
命令行界面：Spring Boot 提供了一个命令行界面，可以启动应用、执行任务、管理应用的生命周期。
Actuator 监控：Spring Boot 的 Actuator 模块提供了丰富的监控功能，帮助开发者更好地了解应用的运行状态。
外部化配置：Spring Boot 支持外部化配置，可以将配置文件放在外部存储中，方便不同环境的配置管理。
健康检查：Spring Boot 的 Actuator 模块提供了健康检查功能，可以监控应用的健康状态。

开发环境搭建

安装 Java 开发环境

Spring Boot 项目需要 Java 开发环境，包括 Java Development Kit (JDK) 和 Java Runtime Environment (JRE)。

安装 JDK

访问 Oracle 官方网站，下载并安装最新版本的 JDK。
安装完成后配置环境变量，确保 JDK 的 bin 目录路径添加到了 PATH 环境变量中。
验证安装是否成功。打开命令行工具，输入 java -version 和 javac -version，检查是否能正确显示 JDK 版本信息。

java -version
javac -version

安装 JRE

JRE 是运行 Java 应用所需的最小集，如果你只是运行 Java 应用，安装 JRE 即可，但开发 Java 应用需要 JDK。

配置环境变量（示例）

# 设置 JAVA_HOME
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
# 设置 JRE_HOME
export JRE_HOME=/usr/lib/jvm/java-11-openjdk-amd64/jre
# 添加 JDK 的 bin 目录到 PATH
export PATH=$JAVA_HOME/bin:$PATH

安装 IDE（如 IntelliJ IDEA 或 Eclipse）

开发 Spring Boot 项目常用的 IDE 包括 IntelliJ IDEA 和 Eclipse。这里以 IntelliJ IDEA 为例：

访问 IntelliJ IDEA 官方网站，下载并安装最新版本的 IntelliJ IDEA。
打开 IntelliJ IDEA，选择“File” -> “New” -> “Project”。
选择“Spring Initializr”，点击“Next”。
填写项目名称、语言（Java）、Spring Boot 版本，选择项目存放的目录。
选择项目类型为“Maven”或“Gradle”。
点击“Finish”完成项目创建。

下载和配置 Spring Boot Starter

Spring Boot Starter 是 Spring Boot 提供的一系列依赖管理模块，帮助开发者快速集成各种常用的功能。

访问 Spring Initializr 网站，选择项目类型为“Maven”或“Gradle”，并选择相应的 Java 版本和 Spring Boot 版本。
选择项目基本信息，如项目名称、语言、包名。
选择要集成的功能模块，如 Web、JPA、Security 等。
点击“Generate”按钮生成项目文件。
下载并解压生成的源码包。
在 IDE 中导入项目，如果是 Maven 或 Gradle 项目，IDE 会自动识别并导入依赖。

创建第一个 Spring Boot 项目

使用 Spring Initializr 创建项目

访问 Spring Initializr 网站，选择项目类型为“Maven”或“Gradle”，并选择相应的 Java 版本和 Spring Boot 版本。
选择项目基本信息，如项目名称、语言、包名。
选择要集成的功能模块，如 Web、JPA、Security 等。
点击“Generate”按钮生成项目文件。
下载并解压生成的源码包。
在 IDE 中导入项目，如果是 Maven 或 Gradle 项目，IDE 会自动识别并导入依赖。

导入项目到 IDE

以 IntelliJ IDEA 为例：

打开 IntelliJ IDEA，选择“File” -> “Open”。
选择解压后的项目目录，点击“OK”。
IntelliJ IDEA 会自动检测到 Maven 或 Gradle 项目，并提示导入。
点击“Import Project”按钮，等待 IDE 读取项目信息。
确认项目设置，特别是 Java SDK 和项目依赖，确保配置正确。
点击“Finish”完成项目导入。

运行第一个 Spring Boot 应用

在 IDE 中打开 src/main/java 目录下的主类，通常命名为 Application.java，该类需要包含一个 SpringApplication.run 方法。

package com.example.demo;

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

运行主类，可以使用 IDE 的运行按钮，或者在命令行工具中执行 mvn spring-boot:run 或 gradle bootRun 命令。

mvn spring-boot:run

或

gradle bootRun

打开浏览器，输入 http://localhost:8080，查看应用是否正常启动。

配置文件的外部化

配置文件可以通过命令行参数或环境变量来外部化。以下是一些示例：

环境变量：

export SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/mydb

命令行参数：

java -jar myapp.jar --server.port=8081

配置文件位置：

# ./config/application.properties
server.port=8082

Spring Boot 常用配置

应用配置文件介绍

Spring Boot 支持多种配置文件格式，包括：

application.properties：基于键值对的配置文件。
application.yml：基于 YAML 格式的配置文件。

配置文件通常位于 src/main/resources 目录下。Spring Boot 会自动检测这些配置文件，并根据其中的内容自动配置应用。

配置文件属性详解

配置文件中的属性可以根据应用的需求进行修改。常用的配置属性包括：

端口号配置：

server.port=8081

应用名称配置：

spring.application.name=myapp

数据源配置：

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

日志配置：

logging.level.root=INFO
logging.file=./logs/application.log

外部化配置

Spring Boot 支持多种方式来外部化配置，包括：

环境变量：

export SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/mydb

命令行参数：

java -jar myapp.jar --server.port=8081

配置文件位置：

# ./config/application.properties
server.port=8082

外部化配置的优先级

Spring Boot 允许配置文件有多个来源，优先级最高的是 Spring Profile 配置文件，其次是本地配置文件，最后是外部配置文件。

常见功能开发示例

创建简单的 REST API

Spring Boot 提供了 @RestController 和 @RequestMapping 注解，使得开发 REST API 非常简单。

创建 Controller

package com.example.demo;

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

@RestController
public class DemoController {

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

测试 REST API

可以使用 Postman 或其他工具测试 REST API。例如，使用 Postman 发送 GET 请求到 http://localhost:8080/hello，返回结果为 "Hello, World!"。

数据库集成：使用 Spring Data JPA 操作数据库

Spring Boot 提供了 Spring Data JPA 模块，简化了对数据库的操作。

添加依赖

在 pom.xml 或 build.gradle 文件中添加 Spring Data JPA 依赖。

<!-- pom.xml -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

// build.gradle
implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

创建实体类

package com.example.demo.entity;

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;

    // 构造函数、getter 和 setter 方法
}

创建 Repository 接口

package com.example.demo.repository;

import com.example.demo.entity.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.controller;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
public class UserController {

    @Autowired
    private UserRepository userRepository;

    @GetMapping("/users")
    public List<User> getUsers() {
        return userRepository.findAll();
    }
}

启动应用后，访问 http://localhost:8080/users，可以看到数据库中所有用户的列表。

静态资源管理

Spring Boot 提供了自动配置功能，可以方便地管理静态资源，如 CSS、JavaScript 和图片文件。

放置静态资源

将静态资源文件放在 src/main/resources/static 目录下，Spring Boot 会自动将其映射到 / 路径下。

src/main/resources/static/
│
├── css/
│   └── style.css
├── js/
│   └── script.js
└── images/
    └── logo.png

访问静态资源

可以通过 URL 直接访问这些静态资源，如 http://localhost:8080/css/style.css。

项目部署与调试

打包 Spring Boot 应用

Spring Boot 应用可以作为一个独立的程序运行，可以将其打包为可执行的 JAR 文件。

使用 Maven 打包

mvn clean package

或

mvn spring-boot:repackage

使用 Gradle 打包

./gradlew build

或

./gradlew bootJar

部署到 Tomcat 或直接运行 Jar 包

部署到 Tomcat

将打包好的 JAR 文件放在 Tomcat 的 webapps 目录下，启动 Tomcat。

java -jar myapp.jar --server.port=8080

直接运行 JAR 包

运行打包好的 JAR 文件，可以通过命令行工具执行以下命令：

java -jar target/myapp.jar

配置外部化配置

如果需要使用外部化配置，可以将配置文件放在外部存储中，并通过命令行参数传递配置文件路径。

java -jar target/myapp.jar --spring.config.location=classpath:/external-config.properties

常见问题及解决方法

端口号冲突

如果应用启动时报端口号冲突错误，可以修改 application.properties 文件中 server.port 的值。

server.port=8081

数据库连接失败

如果数据库连接失败，检查 application.properties 文件中的数据库配置属性是否正确。

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

启动时间过长

如果应用启动时间过长，可能是应用加载了过多的依赖或配置文件。可以通过优化配置文件，减少不必要的依赖来提高启动速度。

内存溢出

如果应用运行时报内存溢出错误，可以通过增加 JVM 内存来解决。

java -jar -Xmx512m target/myapp.jar

通过以上步骤，你可以完成 Spring Boot 项目的开发环境搭建、配置、开发、部署和调试。希望本文对你有所帮助。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕森卡

手记
篇

粉丝

120

获赞与收藏

528

关注作者，订阅最新文章

阅读免费教程

Java并发工具

23个小节 19278 315

Java 并发原理入门教程

26个小节 39003 568

Java 入门教程

50个小节 342046 3165

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空