首页手记 Spring Boot 入门教程：快速启动你的第一个项目

Spring Boot 入门教程：快速启动你的第一个项目

标签：

SpringBoot

概述

Spring Boot 是一个基于 Spring 框架的开源框架，用于简化新应用的搭建和开发过程。它通过提供默认配置和快速启动功能，让开发者能够更快地构建独立的生产级别应用。Spring Boot 不仅仅是一个框架，更是一个生态系统，帮助开发者解决了一系列常见的配置问题，让开发者可以专注于业务逻辑。

Spring Boot 简介

什么是 Spring Boot

Spring Boot 是一个基于 Spring 框架的开源框架，用于简化新 Spring 应用程序的初始搭建和开发过程。它通过提供默认配置和快速启动功能，让开发者能够更快地构建独立的、生产级别的应用。Spring Boot 不仅仅是一个框架，更是一个生态系统，它帮助开发者解决了一系列常见的配置问题，让开发者可以专注于业务逻辑。

Spring Boot 的主要特点

开箱即用：Spring Boot 提供了大量的自动配置功能，可以自动配置 Spring 应用程序中的常见场景，例如数据源配置、内嵌的服务器配置等。
独立应用：Spring Boot 应用程序通常打包为可执行的 JAR 或 WAR 文件，可以独立运行。
嵌入式容器：Spring Boot 可以使用内置的 Tomcat、Jetty 或 Undertow 服务器来运行应用，无需配置外部服务器。
约定优于配置：通过约定优于配置的方式，开发者无需编写大量的配置代码，只需修改少量配置即可。
命令行界面：提供了丰富的命令行选项，支持应用的打包、运行、监控等操作。
外化配置：支持使用外部的配置文件来覆盖默认的配置，例如使用 application.properties 或 application.yml。

为什么选择 Spring Boot

Spring Boot 是一个理想的入门点，因为它大幅度简化了开发过程，使得开发者可以集中精力编写业务逻辑，而不是花费大量时间进行配置和调试。此外，由于其强大的社区和丰富的插件支持，Spring Boot 成为了现代 Java 开发的首选框架之一。

开发环境搭建

安装 Java 开发环境

在编写 Spring Boot 应用之前，首先需要安装 Java 开发环境。以下是安装步骤：

下载并安装 JDK（Java Development Kit）。推荐使用最新稳定版本，如 Java 11 或 Java 17。
验证安装：在命令行输入 java -version 和 javac -version，检查是否正确安装了 Java。

java -version
javac -version

输出应该显示已安装的 Java 版本信息。

下载并安装 Spring Boot

下载 Spring Boot：访问 Spring Boot 官方网站（https://spring.io/projects/spring-boot），下载最新版本的 Spring Boot。
安装：Spring Boot 是一个轻量级框架，不需要特别的安装步骤，只需要将下载的文件解压到某个目录即可。
验证：安装完成后，可以通过命令行运行 mvn -v 检查是否安装成功。

mvn -v

如果输出了 Maven 版本信息，说明安装成功。

配置开发工具 IDEA 或 Eclipse

Spring Boot 开发工具推荐使用 IntelliJ IDEA 或 Eclipse，下面是配置步骤：

IntelliJ IDEA：
- 安装 IntelliJ IDEA，可以从官网下载最新版本。
- 打开 IntelliJ IDEA，选择 File -> Settings -> Plugins，安装 Spring 插件。
- 创建一个新的 Spring Boot 项目，选择 File -> New -> Project，在项目向导中选择 Spring Initializr，按照提示完成项目创建。
Eclipse：
- 安装 Eclipse，也可以从官网下载最新版本。
- 打开 Eclipse，选择 Help -> Eclipse Marketplace，搜索并安装 Spring Tools 插件。
- 创建一个新的 Spring Boot 项目，选择 File -> New -> Project，在项目向导中选择 Spring，按照提示完成项目创建。

安装完成后，可以通过创建一个简单的 Spring Boot 应用程序来验证配置是否正确。

创建第一个 Spring Boot 项目

使用 Spring Initializr 创建项目

Spring Initializr 是一个在线工具，可以帮助你快速创建 Spring Boot 项目。以下是创建步骤：

访问 Spring Initializr 网站（https://start.spring.io）。
在项目配置界面，选择项目的基本信息，如 Project、Language、Spring Boot 版本等。
在 Dependencies 部分，选择所需的依赖，如 Web、JPA 或 Thymeleaf 等。
点击 Generate 按钮，下载生成的项目压缩包。

项目结构解析

创建项目后，解压下载的压缩包，可以看到以下目录结构：

src
├── main
│   ├── java
│   │   └── com
│   │       └── example
│   │           └── demo
│   │               ├── DemoApplication.java
│   │               └── controller
│   │                   └── HelloController.java
│   └── resources
│       └── application.properties
└── test
    └── java
        └── com
            └── example
                └── demo
                    └── DemoApplicationTests.java

DemoApplication.java：项目的主入口类，包含 main 方法。
HelloController.java：一个简单的控制器类，负责处理 HTTP 请求。
application.properties：项目的配置文件，用于存放项目配置。
DemoApplicationTests.java：一个单元测试类。

以下是 HelloController.java 的示例代码：

package com.example.demo.controller;

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

以下是 application.properties 的示例内容：

# application.properties
server.port=8080

运行你的第一个 Spring Boot 应用程序

在 IDE 中打开项目，运行 DemoApplication.java 中的 main 方法。

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

运行后，控制台会输出启动信息。打开浏览器，访问 http://localhost:8080，可以看到默认的欢迎页面。

Spring Boot 核心概念

自动配置

Spring Boot 的一个核心特性是自动配置。通过自动配置，Spring Boot 可以根据类路径中的依赖自动配置合适的默认设置。例如，如果你添加了 spring-boot-starter-web 依赖，Spring Boot 会自动配置嵌入式 Tomcat 服务器和基本的 Spring MVC 设置。

自定义自动配置可以通过在 application.properties 或 application.yml 文件中修改配置来实现。

# application.properties
server.port=8081

起始类与配置类

起始类（通常带有 @SpringBootApplication 注解）是用来启动 Spring Boot 应用程序的入口点。@SpringBootApplication 实际上是 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 的组合。

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

配置类通常使用 @Configuration 注解，用于定义 Spring 的 Bean 源。

package com.example.demo;

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

@Configuration
public class AppConfig {
    @Bean
    public String exampleBean() {
        return "Hello, Spring Boot!";
    }
}

外部化配置

Spring Boot 允许将配置信息外部化，这样可以在不同环境中（如开发、测试、生产）使用不同的配置。外部化配置可以通过 application.properties 或 application.yml 文件实现。

# application.properties
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root

常用注解与组件

@Controller、@Service、@Repository、@Component

这些注解用于定义 Spring 的组件。@Component 是基础注解，可以用于定义任何 Spring 组件。@Controller 用于定义控制器，@Service 用于定义服务，@Repository 用于定义数据访问层。

package com.example.demo;

import org.springframework.stereotype.Component;
import org.springframework.stereotype.Repository;
import org.springframework.stereotype.Service;

@Service
public class MyService {
    public String sayHello() {
        return "Hello from MyService";
    }
}

@Repository
public class MyRepository {
    public String getData() {
        return "Data from MyRepository";
    }
}

@Controller
public class MyController {
    @Autowired
    private MyService myService;

    public String hello() {
        return myService.sayHello();
    }
}

@Autowired、@Qualifier、@Value

@Autowired 用于自动装配依赖，@Qualifier 用于指定具体的一个 Bean，@Value 用于注入属性值。

package com.example.demo;

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

@Component
public class MyComponent {
    @Autowired
    private MyService myService;

    @Autowired
    @Qualifier("myQualifier")
    private MyQualifierBean qualifierBean;

    @Value("${app.name}")
    private String appName;

    public void print() {
        System.out.println("Service says: " + myService.sayHello());
        System.out.println("Qualifier Bean says: " + qualifierBean.getMessage());
        System.out.println("App Name: " + appName);
    }
}

@RestController 和 @RequestMapping

@RestController 是 @Controller 和 @ResponseBody 的组合，用于定义控制器处理 REST 请求。@RequestMapping 用于映射 HTTP 方法和 URL。

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

小结与进阶指南

本教程回顾

本教程介绍了 Spring Boot 的基本概念和常用功能，包括环境搭建、项目创建、核心概念和常用注解。通过本教程，读者可以快速上手 Spring Boot，并构建简单的 Web 应用程序。

Spring Boot 入门教程：快速启动你的第一个项目

Spring Boot 简介

什么是 Spring Boot

Spring Boot 的主要特点

为什么选择 Spring Boot

开发环境搭建

安装 Java 开发环境

下载并安装 Spring Boot

配置开发工具 IDEA 或 Eclipse

创建第一个 Spring Boot 项目

使用 Spring Initializr 创建项目

项目结构解析

运行你的第一个 Spring Boot 应用程序

Spring Boot 核心概念

自动配置

起始类与配置类

外部化配置

常用注解与组件

@Controller、@Service、@Repository、@Component

@Autowired、@Qualifier、@Value

@RestController 和 @RequestMapping

小结与进阶指南

本教程回顾

推荐资源和进阶学习方向

阅读免费教程

热搜

最近搜索清空

Spring Boot 入门教程：快速启动你的第一个项目

Spring Boot 简介

什么是 Spring Boot

Spring Boot 的主要特点

为什么选择 Spring Boot

开发环境搭建

安装 Java 开发环境

下载并安装 Spring Boot

配置开发工具 IDEA 或 Eclipse

创建第一个 Spring Boot 项目

使用 Spring Initializr 创建项目

项目结构解析

运行你的第一个 Spring Boot 应用程序

Spring Boot 核心概念

自动配置

起始类与配置类

外部化配置

常用注解与组件

@Controller、@Service、@Repository、@Component

@Autowired、@Qualifier、@Value

@RestController 和 @RequestMapping

小结与进阶指南

本教程回顾

推荐资源和进阶学习方向

阅读免费教程