首页手记 Springboot框架入门教程：轻松搭建你的第一个W...

Springboot框架入门教程：轻松搭建你的第一个Web应用

标签：

SpringBoot

概述

本文详细介绍了如何使用Springboot框架搭建第一个Web应用，涵盖了环境配置、项目创建、运行以及基本配置等内容。文章还深入讲解了RESTful API的创建、数据库的连接与操作，以及如何使用Thymeleaf模板引擎和部署应用到Tomcat服务器。通过这些步骤，开发者可以快速掌握Springboot框架的各项功能和使用方法。

Spring Boot框架入门教程：轻松搭建你的第一个Web应用

Spring Boot简介

Spring Boot是什么

Spring Boot是一个基于Spring框架的开源微服务框架，旨在简化新Spring应用的初始搭建以及开发过程。它通过一些约定优于配置的方式，使得开发者可以快速构建独立的、生产级别的基于Spring的应用。Spring Boot不是对Spring框架的替代，而是通过提供一系列默认配置来减少Spring应用的配置繁琐性，使得开发者可以快速创建独立的、生产级别的应用。

Spring Boot的优点

快速启动：Spring Boot通过内嵌的Tomcat服务器，使得开发人员可以快速启动应用，无需额外配置。
约定优于配置：Spring Boot通过约定优于配置的方式，尽量减少配置，使用默认配置即可启动项目。
开发速度快：减少了繁琐的配置，开发者可以专注于业务逻辑的实现，提高开发效率。
支持多种持久层方案：可以很容易地与各种数据库（如MySQL、PostgreSQL、SQLite等）进行交互。
支持多种视图技术：内置了对Thymeleaf、Mustache、Freemarker等视图技术的支持。
自动配置：Spring Boot通过自动配置机制，能够自动配置大多数常见的场景，如数据源、Web服务等。
内嵌Servlet容器：Spring Boot可直接内嵌Tomcat、Jetty或Undertow等Servlet容器。

Spring Boot的核心概念

自动配置：Spring Boot通过@SpringBootApplication注解自动配置需要的资源，如数据源、视图解析器等。
启动器：Spring Boot通过spring-boot-starter系列启动器，快速引入所需的依赖。
Spring Boot配置文件：通过application.properties或application.yml配置文件，对应用进行配置。
健康检查：Spring Boot内置了多项健康检查，可以方便地监控应用状态。
Actuator：Spring Boot Actuator提供了一系列端点以方便查看应用状态和配置，提供了运行时的管理和监控功能。
端点：通过/actuator路径可以查看应用的运行状态和配置，如/health、/metrics等。

环境搭建

Java开发环境配置

安装Java环境：首先需要安装Java环境。访问Oracle官网或OpenJDK官网下载对应的版本。
配置环境变量：
- 设置JAVA_HOME指向Java安装路径。
- 将JAVA_HOME/bin添加到系统PATH环境变量中。
验证安装：可以在命令行中输入java -version来检查是否安装成功。

示例配置环境变量：

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

Spring Boot开发工具介绍

IDEA：IntelliJ IDEA是目前最流行的Java开发工具，支持Java、Kotlin等多种语言，具有强大的代码分析和调试功能。
Eclipse：Eclipse同样是一款非常流行的Java IDE，支持多种插件扩展，适合进行复杂的Java项目开发。
STS：Spring Tool Suite是基于Eclipse的Spring集成开发环境，集成了Spring Boot、Spring框架等插件，专门用于Spring相关应用的开发。
Maven：Maven是一个强大的项目管理和构建工具，可用于项目的构建、依赖管理和文档生成。
Gradle：Gradle是基于Groovy语言的构建工具，它可以通过声明的方式定义项目依赖，具有高度的灵活性和扩展性。

创建第一个Spring Boot项目

安装Maven：下载并安装Maven，避免手动管理各种依赖。访问Maven官网下载最新版本。
创建Maven项目：使用STS或其他IDE创建一个新的Maven项目。
添加Spring Boot启动器：在pom.xml文件中添加Spring Boot依赖。

示例pom.xml文件：

<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>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.1</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

运行第一个Spring Boot应用

创建主类：在src/main/java目录下创建主类，使用@SpringBootApplication注解标记类，该注解集成了@Configuration、@EnableAutoConfiguration、@ComponentScan注解。
编写启动类：
- 添加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);
    }
}

通过以上步骤，一个简单的Spring Boot应用就已经创建成功了。运行mvn spring-boot:run命令启动应用，然后在浏览器中访问http://localhost:8080即可看到应用已经成功运行。

Spring Boot基本配置

application.properties配置文件详解

Spring Boot配置文件通常有两种格式：application.properties和application.yml。这里以application.properties为例，介绍其主要配置项：

配置文件位置：配置文件通常位于src/main/resources目录下。
配置文件名：默认文件名为application.properties，也可以是application.yml。
配置示例：

# 端口号
server.port=8080

# 数据库连接字符串
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root

# 日志级别
logging.level.root=INFO

# 环境变量区分
spring.profiles.active=prod

通过上述配置，可以对应用的基本信息进行设置，如端口号、数据库连接信息、日志级别等。

配置文件的环境区分

在开发过程中，应用通常需要部署在不同的环境（如开发环境、测试环境、生产环境）中，每个环境的配置可能有所不同。Spring Boot使用spring.profiles.active属性来区分不同的配置文件。

创建环境配置文件：
- 创建application-dev.properties用于开发环境。
- 创建application-test.properties用于测试环境。
- 创建application-prod.properties用于生产环境。

示例application-dev.properties文件：

server.port=8081
spring.datasource.url=jdbc:mysql://localhost:3306/devdb

示例application-prod.properties文件：

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/proddb

在启动应用时，可以通过命令行参数指定当前使用的环境配置文件：

mvn spring-boot:run -Dspring.profiles.active=dev

Spring Boot自动配置机制

Spring Boot的自动配置机制旨在简化新应用的初始搭建，它会根据应用类路径中的jar包依赖情况，自动配置应用所需的组件。自动配置主要通过@EnableAutoConfiguration注解来实现，该注解会读取配置文件中的属性，根据这些属性配置基础的服务。

自动配置原理：
- Spring Boot在启动时，会扫描启动类所在的包及其子包中的所有组件。
- 对于每个组件，Spring Boot会根据其类名、注解等信息，自动配置相应的服务。
- 自动配置过程使用@Conditional注解来根据特定条件控制配置的启用或关闭。
查看自动配置类：Spring Boot提供了/actuator端点，可以通过访问http://localhost:8080/actuator/env查看当前应用的自动配置信息。

示例查看自动配置信息：

http://localhost:8080/actuator/env

创建RESTful API

创建第一个RESTful接口

创建新的Java类：在src/main/java目录下创建一个新的Java类。
添加控制器注解：使用@RestController注解标记接口类。
定义方法：定义处理HTTP请求的方法，如GET、POST等。

示例RESTful接口代码：

package com.example.demo;

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

@RestController
public class HelloController {
    @GetMapping("/")
    public String index() {
        return "Hello World!";
    }
}

返回JSON数据示例

创建新的Java类：创建一个新的Java类，用于返回JSON数据。
定义返回对象：定义一个Java对象，用于封装返回的数据。
使用@RequestMapping注解：标记HTTP请求处理方法，并指定请求的URL。

示例返回JSON数据代码：

package com.example.demo;

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

import java.util.HashMap;
import java.util.Map;

@RestController
public class UserController {
    @GetMapping("/users")
    public Map<String, String> getUsers() {
        Map<String, String> users = new HashMap<>();
        users.put("1", "张三");
        users.put("2", "李四");
        return users;
    }
}

使用Spring Boot的单元测试功能

Spring Boot提供了强大的单元测试功能，通过@SpringBootTest注解，可以轻松地测试Spring Boot应用的控制器。

创建单元测试类：创建一个新的Java类，用于单元测试。
定义测试方法：定义测试方法，使用MockMvc对象模拟HTTP请求。

示例单元测试代码：

package com.example.demo;

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.hamcrest.Matchers.containsString;
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 HelloControllerTest {
    @Autowired
    private MockMvc mockMvc;

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

复杂的RESTful接口示例

package com.example.demo;

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

import java.util.HashMap;
import java.util.Map;

@RestController
public class ComplexController {
    @GetMapping("/users/{id}")
    public Map<String, String> getUser(@PathVariable int id) {
        Map<String, String> user = new HashMap<>();
        user.put("id", String.valueOf(id));
        user.put("name", "张三");
        user.put("email", "zhangsan@example.com");
        return user;
    }

    @PostMapping("/users")
    public Map<String, String> createUser(@RequestBody Map<String, String> user) {
        Map<String, String> savedUser = new HashMap<>(user);
        savedUser.put("id", "101");
        return savedUser;
    }
}

整合Spring Boot与数据库

数据库的连接与配置

添加数据库依赖：在pom.xml文件中添加对应数据库的驱动依赖。
配置数据库连接信息：在application.properties文件中配置数据库连接信息。

示例pom.xml文件：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

示例application.properties文件：

# 数据库连接字符串
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root

使用JPA进行数据操作

添加JPA依赖：在pom.xml文件中添加Spring Data JPA的依赖。
定义实体类：定义表示数据库表的Java类。
定义Repository接口：定义操作数据库表的接口。

示例pom.xml文件：

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

示例实体类User.java：

package com.example.demo;

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

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private int id;
    private String name;
    private String email;

    // 省略getter和setter方法
}

示例Repository接口UserRepository.java：

package com.example.demo;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;

import java.util.List;

public interface UserRepository extends JpaRepository<User, Integer> {
    @Query("SELECT u FROM User u WHERE u.name LIKE :name")
    List<User> findByNameContaining(@Param("name") String name);
}

复杂的JPA操作示例

package com.example.demo;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
public class UserController {
    @Autowired
    private UserRepository userRepository;

    @GetMapping("/users/paged")
    public Page<User> getUsersPaged(@RequestParam int page, @RequestParam int size) {
        Pageable pageable = PageRequest.of(page, size, Sort.by("name"));
        return userRepository.findAll(pageable);
    }

    @GetMapping("/users/findByEmail")
    public List<User> getUsersByEmail(@RequestParam String email) {
        return userRepository.findByEmail(email);
    }
}

数据库迁移工具Liquibase介绍

Liquibase是一个开源的数据库变更管理工具，用于管理和跟踪数据库结构的变更。Spring Boot可以通过spring-boot-starter-liquibase启动器，轻松地集成Liquibase。

添加Liquibase依赖：在pom.xml文件中添加Liquibase的依赖。
编写变更记录文件：创建.xml文件，定义数据库变更操作。
配置Liquibase：在application.properties文件中配置Liquibase的相关属性。

示例pom.xml文件：

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

示例db.changelog-master.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.6.xsd">
    <changeSet id="1" author="admin">
        <createTable tableName="user">
            <column name="id" type="int">
                <constraints primaryKey="true"/>
            </column>
            <column name="name" type="varchar(100)"/>
            <column name="email" type="varchar(100)"/>
        </createTable>
    </changeSet>
</databaseChangeLog>

示例application.properties文件：

# Liquibase配置
spring.liquibase.change-log=classpath:db.changelog-master.xml

搭建Web应用

添加静态资源

创建静态资源目录：在src/main/resources/static目录下创建静态资源文件。
访问静态资源：通过URL直接访问静态资源文件。

示例创建静态资源：

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

示例style.css文件：

body {
    background-color: #f0f0f0;
}

示例script.js文件：

console.log("加载了JavaScript文件");

使用Thymeleaf模板引擎

Thymeleaf是一个强大的模板引擎，可用于生成HTML、XML、JavaScript等静态文件。Spring Boot可以通过spring-boot-starter-thymeleaf启动器，轻松地集成Thymeleaf。

添加Thymeleaf依赖：在pom.xml文件中添加Thymeleaf的依赖。
创建模板文件：在src/main/resources/templates目录下创建HTML模板文件。
使用控制器返回模板：通过控制器返回Thymeleaf模板文件。

示例pom.xml文件：

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

示例HTML模板文件index.html：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>首页</title>
    <link rel="stylesheet" th:href="@{/css/style.css}" />
</head>
<body>
    <h1 th:text="'欢迎来到首页'">欢迎来到首页</h1>
</body>
</html>

示例控制器代码：

package com.example.demo;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HomeController {
    @GetMapping("/")
    public String home() {
        return "index";
    }
}

Thymeleaf复杂功能示例

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>首页</title>
    <link rel="stylesheet" th:href="@{/css/style.css}" />
</head>
<body>
    <h1 th:text="'欢迎来到首页'">欢迎来到首页</h1>
    <div th:if="${users.size() > 0}">
        <ul>
            <li th:each="user : ${users}" th:text="${user.name}"></li>
        </ul>
    </div>
</body>
</html>

部署Spring Boot应用到Tomcat服务器

创建可执行Jar包：打包应用为可执行的Jar文件。
启动Tomcat服务器：在Tomcat服务器上部署应用。

示例打包命令：

mvn clean package

示例启动Jar包：

java -jar target/demo-0.0.1-SNAPSHOT.jar

通过以上步骤，一个简单的Spring Boot Web应用就已经搭建完成，并部署到Tomcat服务器上。

通过本教程，你已经掌握了Spring Boot的基础知识，包括搭建开发环境、创建第一个Spring Boot应用、配置文件的使用、创建RESTful API、数据库操作以及Web应用的搭建。希望这些知识可以帮助你在实际项目中快速搭建和开发Spring Boot应用。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕仙森

手记
篇

粉丝

37

获赞与收藏

103

关注作者，订阅最新文章

相关文章推荐

用SpringBoot创建web项目（一）

react入门教程01 - 简介、开发环境搭建、创建第一个React应用

Java开发专属成长路线，新手入门看这个就够了！

SpringBoot | 第一章：第一个SpringBoot应用

SpringBoot | 第一章：第一个SpringBoot应用

阅读免费教程

后端通用面试教程

41个小节 30273 342

网络编程入门教程

20个小节 12461 235

Pandas 入门教程

25个小节 18362 330

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空

Springboot框架入门教程：轻松搭建你的第一个Web应用

Spring Boot是什么

Spring Boot的优点

Spring Boot的核心概念

Java开发环境配置

Spring Boot开发工具介绍

创建第一个Spring Boot项目

运行第一个Spring Boot应用

application.properties配置文件详解

配置文件的环境区分

Spring Boot自动配置机制

创建第一个RESTful接口

返回JSON数据示例

使用Spring Boot的单元测试功能

复杂的RESTful接口示例

数据库的连接与配置

使用JPA进行数据操作

复杂的JPA操作示例

数据库迁移工具Liquibase介绍

添加静态资源

使用Thymeleaf模板引擎

Thymeleaf复杂功能示例

部署Spring Boot应用到Tomcat服务器

相关文章推荐

阅读免费教程