【SpringBoot3】1.SpringBoot入门的第一个完整小项目（新手保姆版+教会打包）

1 SpringBoot简单介绍

1.1 SpringBoot是什么

SpringBoot的底层是Spring，SpringBoot 是Spring框架的一部分，旨在简化 Spring 应用程序的开发和部署。使用 Spring Boot 可以更轻松地创建独立运行的、生产级别的 Spring 应用程序，同时仍然可以充分利用Spring的强大功能。

1.2 主要优点

• 简化配置： Spring Boot 使用约定大于配置的原则，通过默认配置减少了大量的样板代码。它提供了一组合理的默认值，减少了开发者需要手动配置的工作。不需要写xml文件！

• 内嵌服务器： Spring Boot 内置了 Tomcat、Jetty 或 Undertow 等常见的服务器，使得应用程序可以作为独立的 JAR 文件运行，无需外部的 Web 服务器。

• 自动配置： Spring Boot 根据项目中使用的依赖库和类路径上的 JAR 包，自动配置应用程序。这使得开发者可以更轻松地集成第三方库，减少了手动配置的繁琐过程。

• 开发工具： Spring Boot 提供了一组开发工具，如自动重启、热部署等，加速了开发过程。

• 微服务支持： Spring Boot 为微服务架构提供了良好的支持。它可以轻松集成 Spring Cloud，使得构建分布式系统更加简便。

• Spring 生态系统： Spring Boot 是 Spring 生态系统的一部分，可以轻松集成 Spring 框架的各种功能，如 Spring Data、Spring Security 等。

• 生产准备： Spring Boot 提供了一系列生产级别的特性，如健康检查、性能监控、外部化配置等，帮助开发者构建可靠的生产应用。

1.3 术语

1.3.1 starter（场景启动器）

在 Spring Boot 中，Starter（启动器）是一种方便的方式，通过提供预配置的依赖项来简化项目的构建。启动器是一组依赖项的集合，它们通常一起使用，以支持特定类型的应用程序。Spring Boot 的启动器旨在帮助开发者轻松地引入常用的库和框架，以便更容易地配置和搭建应用程序。
Spring Boot Starter 的命名约定为 spring-boot-starter-{name}，其中 {name} 描述了这个启动器的用途。

• 常见的场景启动器

名称	用途
spring-boot-starter-web	用于构建基于 Spring MVC 的 Web 应用程序
spring-boot-starter-data-jpa	集成了 Spring Data JPA，用于数据访问
spring-boot-starter-security	集成了 Spring Security，用于安全性处理
spring-boot-starter-amqp	集成了 RabbitMQ，用于消息队列
spring-boot-starter-data-redis	集成了 Spring Data Redis，用于与 Redis 数据库交互

1.4 官方文档

1. documentation —— 官方详细文档
2. how to start —— 快速开始

2 环境说明

本博客提供的小案例使用了

• java 17
• springboot 3

3 实现代码

本博客提供的小案例的任务是，在浏览器上点击localhost:8080/hello，在页面上会显示：hello, spring boot 3!

3.1 新建工程与模块

将主项目下的src文件夹删除（没有用）

新建模块

• 选择Maven工程
• 填写包名 GroupId

3.2 加入依赖

• module01的pom.xml文件本来长这样
  
• 首先加入<parent></parent>标签，所有springboot项目都必须继承自 spring-boot-starter-parent

 <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>3.0.5</version>
  </parent>

• 然后加入web开发的必要的场景启动器

<dependencies>
    <!--        web开发的场景启动器 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

• 完成后，pom.xml长这样

3.3 主程序文件

springboot需要一个开始运行的主程序，在src -> main -> java下新建包com.example.springboot，新建MainApplication.java

• 注意：
  • 需要加上@SpringBootApplication注解，说明这是一个SpringBoot程序
  • 加上main程序

package com.example.springboot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @Author: yrf
 * @description:
 */
@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

3.4 业务代码

由于要实现的业务很简单，可以直接只写一个controller来接收浏览器的请求
在包com.example.springboot下，新建controller.HelloController.java

• 注意：
  • @Controller说明是控制层
  • @ResponseBody说明
    • 不写 @ResponseBody： 如果不使用@ResponseBody注解，Spring框架会默认将方法返回值解释为一个视图名称，并尝试根据这个视图名称寻找匹配的视图模板。这通常用于渲染HTML视图。
    • 写 @ResponseBody： 如果你在方法上使用@ResponseBody注解，Spring将不会解释方法的返回值为一个视图名称，而是将返回值直接作为响应体的内容返回给客户端。这通常用于返回非HTML数据，如JSON或XML。
  • @GetMapping说明接收的浏览器请求路径

package com.example.springboot.controller;

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

/**
 * @Author: yrf
 * @description:
 */
@ResponseBody
@Controller
public class HelloController {
    @GetMapping("/hello")
    public String hello(){
        return "hello, spring boot 3!";
    }
}

3.5 运行测试

直接运行MainApplication.java中的main方法
浏览器访问http://localhost:8080/hello，得到

3.6 部署打包

除了如3.5中在编译器内运行，还可以将程序打包为jar包直接在命令行运行，这样的好处是可以：

• 独立运行：SpringBoot可以将应用程序的所有依赖（包括嵌入式服务器）打包到一个可执行的 JAR 文件中。这使得应用程序可以独立运行，无需外部的 Web 服务器或其他容器。

• 容易部署：打包为 JAR 文件的 SpringBoot 应用程序非常容易部署。只需将 JAR 文件复制到目标服务器上，然后通过命令行或脚本启动即可。这简化了部署过程，无需手动配置大量的服务器设置。

• jar包的运维十分方便，可以在jar包同一文件夹下新建application.properties文件，来改变数据库连接、服务器端口号、日志级别等属性
  

  # 数据库连接配置
  spring.datasource.url=jdbc:mysql://localhost:3306/mydatabase
  spring.datasource.username=myuser
  spring.datasource.password=mypassword
  # 服务器端口配置
  server.port=8080
  # 日志级别配置
  logging.level.root=INFO
  # 应用程序名称配置
  spring.application.name=myapp
  

打包方式如下：

• 在pom.xml文件中加入打包的插件

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

• 打开“Maven”标签，同时选中改模块的LifeCycle中的clean和package，点击运行
  
• 在项目文件夹的target文件夹中可以看到生成的目标jar包
  

3.7 命令行运行

• 右键，可以直接在资源管理器中打开该路径
  
• 在地址栏中输入cmd，打开命令行
  
• 在命令行中输入java -jar {jar包名称}.jar，可以直接运行该SpringBoot项目

java -jar module01-1.0-SNAPSHOT.jar

• 注意：如果有报错，可能是因为：
  • 端口号冲突：有其他的web程序在运行，如3.5中的程序没有停止
  • 没有主清单属性：在打包jar包前，没有加入打包的插件spring-boot-maven-plugin，参考3.6节加入插件即可
  • 运行错误：可能是java版本不符合，如环境变量对应的java是1.8版本的，可以在命令行中输入```java -version``，来验证是不是要求的17版本，如果不是，打开电脑的环境变量，进行修改