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

2024-01-02 22:39:22

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版本,如果不是,打开电脑的环境变量,进行修改
      在这里插入图片描述

文章来源:https://blog.csdn.net/weixin_45873353/article/details/135344789
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。