文章目录
- 前言
- 1.环境准备
- 2.创建SpringBoot项目
- 3.配置Maven
- 3.1 pom.xml文件
- 3.2 添加其他依赖
- 4. 编写代码
- 4.1 启动类
- 4.2 控制器
- 4.3 配置文件
- 5.运行项目
- 6.打包与部署
- 6.1 打包
- 6.2 运行JAR文件
- 7.总结
前言
Spring Boot 是一个用于快速构建 Spring 应用程序的框架，它简化了 Spring 应用的初始搭建和开发过程。Maven 是一个强大的项目管理和构建工具，可以帮助我们管理依赖、构建项目。本文将详细介绍如何使用 Maven 搭建一个 Spring Boot 项目。
1.环境准备
在开始之前，确保你的开发环境已经安装了以下工具：
-
JDK：Spring Boot 3.x 需要 JDK 17 或更高版本。建议安装 JDK 21。
-
Maven：用于项目依赖管理和构建。
-
IDE：推荐使用 IntelliJ IDEA 或 Eclipse。
2.创建SpringBoot项目
项目架构
demo/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/cy/demo/
│ │ │ ├── App.java # Spring Boot 启动类
│ │ │ ├── controller/ # 控制器层
│ │ │ ├── service/ # 服务层
│ │ │ ├── mapper/ # MyBatis Mapper 接口
│ │ │ └── entity/ # 实体类
│ │ └── resources/
│ │ ├── static/ # 静态资源
│ │ ├── templates/ # 模板文件
│ │ ├── application.yml # 配置文件
│ │ └── mapper/ # MyBatis Mapper XML 文件
│ └── test/ # 测试代码
├── pom.xml # Maven 配置文件
└── target/ # 编译输出目录
3.配置Maven
3.1 pom.xml文件
<?xml version="1.0" encoding="UTF-8"?>
<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>org.cy</groupId>
<artifactId>oa-server</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<!-- 引入springboot的父项目,统一版本管理，避免版本冲突-->
<parent>
<!-- groupid:表示依赖属于Spring Boot官方组织-->
<groupId>org.springframework.boot</groupId>
<!-- Spring Booot父项目模版-->
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.1</version>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.3</version>
</dependency>
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>4.3.0</version>
</dependency>
<!-- 分页依赖-->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>2.1.0</version>
</dependency>
</dependencies>
</project>
3.2 添加其他依赖
- 分页插件
<!-- 分页依赖-->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>2.1.0</version>
</dependency>
- JWT支持
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>4.3.0</version>
</dependency>
4. 编写代码
4.1 启动类
App.java 是Spring Boot启动类
package org.cy.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class App {
public static void main(String[] args) {
SpringApplication.run(App.class,args);
}
}
4.2 控制器
创建一个简单控制器 MyController.java:
package org.cy.demo.api;
import org.cy.demo.common.vo.R;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* @author YunR
* @date
*/
@RestController
public class MyController {
@GetMapping("/t") //返回地址
public R<?> test(){
return R.OK("这是测试数据");
}
}
4.3 配置文件
在application.yml中配置数据库连接MyBatis：
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/oadb
username: root
password: root
mybatis:
mapper-location: classpath:mapper/**/*.xml
logging:
level:
root: info
web: trace
org.cy.demo: debug
pagehelper:
reasonable: true
helper-dialect: mysql
server:
port: 9999
# 自定义配置
oa:
token:
expire-time:99999999999 # 令牌过期时间
anonurls: # 无需登录直接可以访问的资源路径，可以使用ant格式
- /security/login # 表示放行登录接口地址
- /t
5.运行项目
- 在 IDE 中右键点击 App.java，选择 Run。
- 打开浏览器，访问 http://localhost:9999/t，你会看到返回的字符串"这是测试数据“”。
6.打包与部署
6.1 打包
在项目根目录下运行以下命令，将项目打包为 JAR 文件：
mvn clean package
打包后的 JAR 文件会生成在 target 目录下
6.2 运行JAR文件
java -jar target/demo-0.0.1-SNAPSHOT.jar
7.总结
通过本文，你已经学会了如何使用 Maven 搭建一个 Spring Boot 项目，并编写了一个简单的 Web 应用。Spring Boot 的强大功能可以帮助你快速构建现代化的 Java 应用程序。
