文章目录
- 前言
- 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.Driverurl: jdbc:mysql://localhost:3306/oadbusername: rootpassword: rootmybatis:mapper-location: classpath:mapper/**/*.xml
logging:level:root: infoweb: traceorg.cy.demo: debugpagehelper:reasonable: truehelper-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 应用程序。