创建Springboot项目资料：新手入门教程

本文详细介绍了如何创建Springboot项目，包括开发环境的搭建、使用Spring Initializr创建项目以及项目的基本结构和配置。文中还提供了从下载项目到运行和部署项目的完整流程，帮助你快速掌握创建Springboot项目资料。

Spring Boot简介

Spring Boot 是一个基于Spring框架的开源微服务框架，旨在简化新Spring应用的初始搭建以及开发过程。Spring Boot通过提供一系列预设的默认配置来帮助开发者快速搭建和部署独立的、生产级别的应用。它消除了开发者在配置Spring应用时的许多复杂性，使得开发者可以专注于编写业务逻辑。

Spring Boot的优点

1. 自动配置：Spring Boot通过一系列预设的默认配置来简化应用的配置工作，减少了开发者需要编写和管理的配置代码量。例如，自动配置一个Web服务器，只需要在application.properties中设置端口号即可。
2. 依赖管理：Spring Boot管理所有的依赖关系，开发者无需手动管理依赖，依赖关系由Spring Boot通过Maven或Gradle自动解析和管理。例如，只需在pom.xml中添加依赖项，Spring Boot会自动处理这些依赖。
3. 开发快速应用：Spring Boot使开发者能够快速创建基于Spring的应用，减少了应用开发周期，提高了开发效率。
4. 生产就绪：Spring Boot应用默认已经配置了各种生产级别的特性，如监控、日志记录等，无需额外配置。例如，Spring Boot提供了内置的Actuator组件，用于监控应用的健康状况。
5. 无需配置XML文件：Spring Boot使得大部分配置都可以通过注解实现，减少了对XML配置文件的依赖。
6. 独立运行的可执行JAR文件：Spring Boot应用可以被打包成独立的可执行JAR文件，包含所有应用需要的依赖，可以直接在任何操作系统上运行。
7. 集成测试：Spring Boot提供了简单的集成测试支持，使开发人员能够快速编写和运行应用的集成测试。例如，使用Spring Boot Test提供的@SpringBootTest注解可以轻松编写集成测试。

准备开发环境

安装JDK

Spring Boot应用需要运行在Java环境上，因此首先需要安装Java开发工具包(JDK)。推荐安装Java Platform，Standard Edition (SE) 8或更高版本。

• 安装JDK：

  • 访问Oracle官网或OpenJDK官网下载JDK安装包。
  • 下载完成后，按照安装向导安装JDK。安装完成后，确保Java环境变量配置正确。
  • 检查安装是否成功：

  java -version

  • 输出类似以下信息，表示安装成功：

  java version "1.8.0_301"
  Java(TM) SE Runtime Environment (build 1.8.0_301-b04)
  Java HotSpot(TM) 64-Bit Server VM (build 25.301-b04, mixed mode)

安装IDE（如IntelliJ IDEA或Eclipse）

• 安装IntelliJ IDEA：

  • 访问官网下载安装包。
  • 下载完成后，按照安装向导安装IntelliJ IDEA。
  • 安装完成后，启动IntelliJ IDEA，并配置JDK。
• 安装Eclipse：
  • 访问Eclipse官网下载安装包。
  • 下载完成后，按照安装向导安装Eclipse。
  • 安装完成后，启动Eclipse，并配置JDK。

安装Maven或Gradle

Maven和Gradle是两种流行的构建工具，用于管理项目的构建、依赖和文档。

• 安装Maven：

  • 访问Maven官网下载安装包。
  • 下载完成后，按照安装向导安装Maven。
  • 配置Maven环境变量，确保Maven可执行文件路径添加到PATH环境变量中。
  • 检查安装是否成功：

  mvn -version

  • 输出类似以下信息，表示安装成功：

  Apache Maven 3.8.5 (15b111594b20059_queries@743cfe0e - 2020-08-17T17:08:38Z) Java version: 1.8.0_301, vendor: Oracle Corporation, runtime: /usr/lib/jvm/java-8-oracle/jre Operating system: Linux 5.10.0-20-amd64, x86-64

• 安装Gradle：

  • 访问Gradle官网下载安装包。
  • 下载完成后，按照安装向导安装Gradle。
  • 配置Gradle环境变量，确保Gradle可执行文件路径添加到PATH环境变量中。
  • 检查安装是否成功：

  gradle -v

  • 输出类似以下信息，表示安装成功：

  Gradle 6.8.3 Groovy 2.5.11 Ant 1.10.9 JVM Java HotSpot(TM) 64-Bit Server VM 1.8.0_241-b08 JVM Vendor Oracle Corporation JVM Version 1.8.0_241-b08 OS Linux 4.15.0-155-generic JVM Memory 30 MB

使用Spring Initializr创建项目

访问Spring Initializr官网

Spring Initializr是一个在线工具，帮助开发者快速创建Spring Boot项目。访问Spring Initializr官网，输入项目基本信息。

• 访问Spring Initializr官网：https://start.spring.io/
• 点击Add dependencies按钮，选择需要的依赖，如Spring Web、Spring Data JPA等。
• 完成项目信息填写后，点击Generate按钮下载项目压缩包。

选择项目设置与依赖

• 项目设置：

  • Project: 选择项目类型。
  • Language: 选择Java或Kotlin语言。
  • Spring Boot: 选择Spring Boot版本。
  • Packaging: 选择项目打包方式，如JAR或WAR。
  • Java: 选择Java版本。
• 依赖：
  • 在Dependencies区域，选择需要的依赖，如Spring Web、Spring Data JPA、Thymeleaf等。
  • 每选择一个依赖，Spring Initializr会自动生成相关配置和依赖项。

下载并导入项目

• 下载项目压缩包：

  • 完成项目信息填写后，点击Generate按钮下载项目压缩包。
  • 下载完成后，解压缩文件。
• 导入项目到IDE：
  • 导入到IntelliJ IDEA：
  • 启动IntelliJ IDEA。
  • 选择File -> Open，打开项目文件夹。
  • IntellJ IDEA会自动检测项目类型并导入项目。
  • 导入到Eclipse：
  • 启动Eclipse。
  • 选择File -> Import，选择Existing Maven Projects。
  • 指定项目文件夹，然后点击Finish导入项目。

项目基本结构与配置

项目目录结构介绍

一个典型的Spring Boot项目结构如下：

my-spring-boot-project/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── myapp/
│   │   │               ├── Application.java
│   │   │               └── controller/
│   │   │                   └── HelloController.java
│   │   └── resources/
│   │       ├── application.properties
│   │       ├── static/
│   │       └── templates/
│   └── test/
│       └── java/
│           └── com/
│               └── example/
│                   └── myapp/
│                       └── MyApplicationTests.java
└── README.md

• pom.xml：项目构建描述文件，用于Maven项目管理。例如，pom.xml文件包含项目依赖项和构建配置。
• src/main/java/：存放Java源代码，包括主要的Spring Boot应用类。
• src/main/resources/：存放资源文件，包括application.properties等。
• src/test/java/：存放测试源代码。

快速了解application.properties文件

application.properties文件位于src/main/resources目录下，用于配置Spring Boot应用的属性。常见的配置项包括端口号、数据库连接信息、编码设置等。

• 服务器配置：

  • 配置应用运行的端口号：

  server.port=8080

• 数据源配置：

  • 配置数据库连接信息：

  spring.datasource.url=jdbc:mysql://localhost:3306/mydb
  spring.datasource.username=root
  spring.datasource.password=root
  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

• 日志配置：

  • 配置日志级别：

  logging.level.org.springframework.web=DEBUG
  logging.level.com.example.myapp=INFO

编写第一个Spring Boot应用

创建Controller类

Controller类用于处理HTTP请求，通常包含一些简单的请求处理方法。下面是一个简单的HelloController类示例：

package com.example.myapp.controller;

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

@RestController
public class HelloController {

    @GetMapping("/")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}

• @RestController：表示该类是一个RESTful风格的控制器。
• @GetMapping("/")：映射HTTP GET请求到根路径/。
• hello()：处理HTTP GET请求的方法，返回字符串Hello, Spring Boot!。

测试运行项目

• 在IDE中运行：

  • 在IDE中找到Application.java类，该类通常位于src/main/java目录下。
  • 右键点击Application.java类，选择Run运行应用。
  • 应用启动后，默认会打印启动日志信息，并在指定端口启动HTTP服务器。
  • 打开浏览器，访问http://localhost:8080/，可以看到返回的Hello, Spring Boot!字符串。

• 在命令行中运行：

  • 打开命令行工具，使用Maven或Gradle命令启动项目。
  • 使用Maven运行项目：

  mvn spring-boot:run

  • 使用Gradle运行项目：

  ./gradlew bootRun

输出日志示例

以下是应用启动时的输出日志示例：

2023-08-15 14:30:00 [main] INFO org.springframework.boot.web.embedded.tomcat.TomcatWebServer - Tomcat started on port(s): 8080 (http)
2023-08-15 14:30:00 [main] INFO com.example.myapp.Application - Started Application in 2.564 seconds (JVM running for 3.073)

打包与部署

打包项目为可执行的JAR文件

• 使用Maven打包：

  • 在命令行中，切换到项目根目录，执行以下命令：

  mvn clean package

  • 打包完成后，会生成一个target目录，包含一个可执行的JAR文件，如my-spring-boot-project-0.0.1-SNAPSHOT.jar。

  • 打包命令输出示例：

  [INFO] Reactor Summary:
  [INFO]
  [INFO] my-spring-boot-project  0.0.1-SNAPSHOT SUCCESS
  [INFO] └─my-spring-boot-module   0.0.1-SNAPSHOT SUCCESS
  [INFO]
  [INFO] BUILD SUCCESS
  [INFO] ------------------------------------------------------------------------
  [INFO] Total time:  2.549 s
  [INFO] Finished at: 2023-08-15T14:30:00Z
  [INFO] Final Memory: 17M/314M
  [INFO] ------------------------------------------------------------------------

• 使用Gradle打包：

  • 在命令行中，切换到项目根目录，执行以下命令：

  ./gradlew build

  • 打包完成后，会生成一个build目录，包含一个可执行的JAR文件，如my-spring-boot-project-0.0.1-SNAPSHOT.jar。

  • 打包命令输出示例：

  BUILD SUCCESSFUL in 2s
  4 actionable tasks: 4 up-to-date

部署项目到服务器

• 在服务器上部署：

  • 将打包好的JAR文件上传到服务器的指定目录。
  • 在命令行中，切换到JAR文件所在的目录，执行以下命令启动应用：

  java -jar my-spring-boot-project-0.0.1-SNAPSHOT.jar

  • 应用启动后，默认会打印启动日志信息，并在指定端口启动HTTP服务器。
  • 打开浏览器，访问服务器IP地址和指定端口，如http://<server-ip>:8080/，可以看到返回的Hello, Spring Boot!字符串。

• 使用容器化技术部署：

  • 使用Docker容器化技术部署Spring Boot应用。
  • 在项目根目录下，创建一个Dockerfile文件，内容如下：

  FROM openjdk:8-jdk-alpine
  COPY target/my-spring-boot-project-0.0.1-SNAPSHOT.jar my-spring-boot-project.jar
  EXPOSE 8080
  ENTRYPOINT ["java","-jar","my-spring-boot-project.jar"]

  • 构建Docker镜像：

  docker build -t my-spring-boot-project:0.0.1 .

  • 运行Docker容器：

  docker run -p 8080:8080 -d my-spring-boot-project:0.0.1

  • 访问服务器IP地址和指定端口，如http://<server-ip>:8080/，可以看到返回的Hello, Spring Boot!字符串。

通过以上步骤，你已经成功创建了一个简单的Spring Boot应用，并将其打包和部署到服务器上。接下来，你可以继续学习更多关于Spring Boot的高级特性和最佳实践，进一步提高开发效率和应用质量。