首页手记 Springboot框架入门教程：快速搭建第一个Web应用

Springboot框架入门教程：快速搭建第一个Web应用

标签：

SpringBoot

概述

Spring Boot框架简化了基于Spring的应用程序开发，通过提供默认配置和自动配置功能，使得开发者可以快速搭建独立的生产级别应用。例如，以下是一个简单的Spring Boot启动类示例：

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

该框架支持嵌入式Servlet容器，并内置了监控功能，帮助开发者更好地了解应用的运行状态。此外，Spring Boot还支持无代码生成和灵活的依赖管理，极大地提升了开发效率。

Spring Boot简介

Spring Boot是什么

Spring Boot是Spring框架的一个模块，它简化了基于Spring的应用程序的开发，让开发者可以快速地开发出独立的、生产级别的应用。例如，以下是一个简单的Spring Boot启动类示例：

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

Spring Boot通过提供默认配置，使得开发者不需要编写大量的配置代码，只需要少量的配置即可快速搭建应用。

Spring Boot的优势

简化配置：Spring Boot通过提供默认配置，极大地简化了应用的配置过程。开发者只需要关注核心业务逻辑，而不需要关心底层的配置细节。
自动配置：Spring Boot能够根据开发者引入的依赖自动配置应用程序。这大大降低了配置的复杂性，使得开发者可以快速搭建应用。
独立运行：Spring Boot应用程序可以打包成独立的可执行文件，支持将应用部署到任何平台。
全面的监控：Spring Boot内置了监控功能，可以帮助开发者更好地了解应用的运行状态。
嵌入式容器：Spring Boot支持嵌入式Servlet容器（如Tomcat、Jetty等），使得应用程序可以更简单地启动和运行。
无代码生成：Spring Boot不需要生成任何元数据，如XML配置文件等。
扩展性强：开发者可以根据需要选择不同的组件或库，以满足特定的需求。

Spring Boot与传统Spring的区别

配置简化：Spring Boot通过提供默认配置，简化了应用的配置过程。传统Spring需要开发者手动配置大量XML或Java配置文件。
快速启动：Spring Boot可以帮助开发者快速搭建应用，而传统的Spring项目需要更多的配置和调试时间。
无XML配置：Spring Boot鼓励使用注解和属性配置，避免了传统Spring的XML配置。
依赖管理：Spring Boot提供了大量的自动配置，而传统Spring项目则需要开发者手动管理依赖。

环境搭建

安装Java开发环境

下载并安装Java JDK：访问Oracle官方网站或OpenJDK官方网站下载安装最新的Java JDK。
设置环境变量：确保Java的安装路径已添加到系统的环境变量中。例如，在Windows系统中，可以在“系统变量”中设置JAVA_HOME和PATH，如下所示：
```
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_261
PATH=%JAVA_HOME%\bin;%PATH%
```
验证安装：通过命令行输入java -version来验证Java是否安装成功。

下载并配置Spring Boot

下载Spring Boot：访问Spring Boot的官方网站，下载最新版本的Spring Boot。
IDE选择：推荐使用IntelliJ IDEA或Spring Tool Suite（STS）作为开发环境。
配置IDE：在IntelliJ IDEA或STS中，选择Spring Boot的相关插件，并配置相关环境。例如，在STS中创建新的Spring Boot项目，可以按照以下步骤操作：
- 打开STS。
- 选择File > New > Spring Starter Project。
- 输入项目名称，选择项目位置。
- 在Spring Boot Dependencies中选择Spring Web依赖。

创建第一个Spring Boot项目

在STS或IntelliJ IDEA中创建新的Spring Boot项目，选择Spring Web作为启动依赖，完成项目的初始化。以下是创建过程中的关键步骤：

创建项目：
- 打开STS或IntelliJ IDEA。
- 选择File > New > Spring Starter Project。
- 输入项目名称，选择项目位置。
- 在Spring Boot Dependencies中选择Spring Web依赖。
项目结构：
- src/main/java：存放Java源代码。
- src/main/resources：存放配置文件和资源文件。
- src/test/java：存放测试代码。

启动类：

在src/main/java目录下创建一个启动类，例如Application.java：

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

Spring Boot核心概念

Starter依赖

Spring Boot通过引入starter依赖，简化了项目配置。starter依赖是一个集合，包含了一系列常用的库和配置，以便快速搭建应用程序。例如，spring-boot-starter-web依赖包含了构建Web应用所需的所有依赖。

引入starter依赖：

在pom.xml或build.gradle文件中添加相应的starter依赖。

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

自动配置：
- starter依赖会自动配置相关组件，例如，spring-boot-starter-web会自动配置嵌入式的Tomcat服务器、Spring MVC、Thymeleaf模板引擎等。

配置文件详解

Spring Boot使用application.properties或application.yml作为默认的配置文件。以下是常用配置项：

基础配置：
- server.port：设置服务器端口。
- server.servlet.context-path：设置应用上下文路径。
- spring.application.name：设置应用名称。
```
server.port=8080
server.servlet.context-path=/app
spring.application.name=my-app
```
数据库配置：
- spring.datasource.url：设置数据源URL。
- spring.datasource.username：设置数据库用户名。
- spring.datasource.password：设置数据库密码。
```
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=password
```
日志配置：
- logging.level.root：设置根日志级别。
- logging.file：设置日志文件路径。
```
logging.level.root=INFO
logging.file=./logs/app.log
```

自动配置机制

Spring Boot的自动配置机制允许开发者通过简单的配置来启动应用。自动配置机制会根据引入的依赖和配置文件中的设置，自动配置相关组件。

自动配置原理：
- Spring Boot会根据引入的依赖，扫描并加载相关的配置类。
- 配置类中会包含一些默认的配置逻辑，例如，启动嵌入式Tomcat服务器。
- 例如，启动一个基于spring-boot-starter-web的Web应用时，Spring Boot会自动配置Tomcat服务器。
覆盖默认配置：
- 如果需要覆盖默认配置，可以在配置文件中设置相应的属性值。
```
server.port=8080
```

开发第一个Web应用

创建控制器

控制器是Spring MVC中的一个重要组件，用于处理HTTP请求。使用@Controller注解标记控制器类，使用@RequestMapping注解标记控制器方法。

创建控制器类：

在src/main/java目录下创建一个控制器类，例如HelloController.java。

package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class HelloController {
   @RequestMapping("/")
   @ResponseBody
   public String hello() {
       return "Hello, Spring Boot!";
   }
}

控制器方法：
- 使用@RequestMapping注解标记控制器方法，定义请求的URL路径。
- 使用@ResponseBody注解将方法返回的内容直接作为响应体返回。

创建视图和模板

Spring Boot支持多种模板引擎，例如Thymeleaf、FreeMarker等。这里以Thymeleaf为例，介绍如何创建视图和模板。

添加Thymeleaf依赖：

在pom.xml或build.gradle文件中添加Thymeleaf依赖。

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

创建模板文件：

在src/main/resources/templates目录下创建一个模板文件，例如hello.html。

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
   <title>Hello</title>
</head>
<body>
   <h1 th:text="'Hello, World!'">Hello, World!</h1>
</body>
</html>

控制器方法返回视图：

修改控制器方法，使其返回视图名称。

@Controller
public class HelloController {
   @RequestMapping("/")
   public String hello() {
       return "hello";
   }
}

配置静态资源

Spring Boot支持默认的静态资源路径，例如/static、/public、/resources。开发者可以直接将静态资源文件放在这些目录下，Spring Boot会自动提供访问。

创建静态资源文件夹：
- 在src/main/resources目录下创建static文件夹，用于存放静态资源文件。
添加静态资源文件：
- 在static文件夹下创建一个CSS文件，例如style.css。
```
body {
   background-color: lightblue;
}
```

引用静态资源文件：

在Thymeleaf模板文件中引用静态资源文件。

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
   <title>Hello</title>
   <link rel="stylesheet" href="style.css" th:href="@{style.css}" />
</head>
<body>
   <h1 th:text="'Hello, World!'">Hello, World!</h1>
</body>
</html>

运行与部署

打包Spring Boot应用

Spring Boot应用可以通过Maven或Gradle工具进行打包。打包后的应用是一个独立的可执行jar文件，可以直接运行。

Maven打包：
- 在项目根目录下运行mvn clean package命令，生成一个独立的可执行jar文件。
```
mvn clean package
```
- 打包后的jar文件位于target目录下。
Gradle打包：
- 在项目根目录下运行gradle build命令，生成一个独立的可执行jar文件。
```
gradle build
```
- 打包后的jar文件位于build/libs目录下。

在本地运行应用

运行打包后的jar文件：
- 使用java -jar命令运行打包后的jar文件。
```
java -jar target/my-app.jar
```
启动内置的Web服务器：
- 打包后的jar文件包含了嵌入式的Web服务器（如Tomcat）。
- 启动后，可以访问http://localhost:8080查看应用。

部署到服务器

上传jar文件：
- 将打包后的jar文件上传到服务器。
配置服务器环境：
- 确保服务器上已经安装了Java环境。
- 设置服务器的端口和应用路径。
启动应用：
- 使用java -jar命令启动上传的jar文件。
```
java -jar /path/to/my-app.jar
```

常见问题解答

常见错误及解决方法

找不到类路径错误：
- 确保类路径设置正确，检查pom.xml或build.gradle文件中的依赖是否正确引入。
- 例如，确保以下依赖正确引入：
```
<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
 <version>2.6.4</version>
</dependency>
```
端口冲突错误：
- 检查是否有其他应用已经占用了指定的端口。
- 修改配置文件中的端口设置。
依赖版本冲突：
- 检查pom.xml或build.gradle文件中的依赖版本是否冲突。
- 使用mvn dependency:tree或gradle dependencies命令查看依赖树，解决版本冲突问题。

Spring Boot配置优化

使用外部配置文件：
- 将敏感信息（如数据库密码）放入外部配置文件中，避免硬编码。
- 使用spring.config.location属性指定外部配置文件的位置。
配置属性覆盖：
- 使用-D参数或环境变量覆盖配置文件中的属性值。
- 例如，java -jar app.jar -Dspring.datasource.username=root。
配置文件分割：
- 将配置文件分割为多个文件，例如application.yml和application-dev.yml。
- 使用spring.profiles.active属性指定激活的配置文件。

具体示例：

在application.properties中配置数据库连接：

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

在命令行中覆盖数据库用户名：

java -jar app.jar -Dspring.datasource.username=root

简单的日志和监控

日志配置：
- 使用配置文件中的logging.level属性设置日志级别。
- 例如，logging.level.root=INFO。
监控工具：
- 使用Spring Boot Actuator监控应用的状态。
- 启用Actuator，添加spring-boot-starter-actuator依赖。
访问监控端点：
- 启动应用后，访问http://localhost:8080/actuator查看监控信息。

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

通过以上步骤，你可以快速搭建并运行一个简单的Spring Boot Web应用。Spring Boot简化了开发流程，使得开发者可以专注于编写核心业务逻辑，而不需要花费过多的时间在配置上。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕姐8265434

手记
篇

粉丝

222

获赞与收藏

1065

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30787 345

网络编程入门教程

20个小节 12720 239

Pandas 入门教程

25个小节 18599 341

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空