Spring-boot快速上手

本节目标

了解Maven,并配置国内源
使用SpringBoot创建一个项目, 输出HelloWorld

1. 环境准备

自检Idea版本: 社区版: 2021.1 -2022.1.4 专业版: 无要求

如果个人电脑安装的idea不在这个范围, 需要卸载重新安装

Idea 卸载参考:https://blog.csdn.net/qq_19072921/article/details/126408402(一定要删除注册表)

2. Maven

2.1 什么是Maven

https://maven.apache.org/index.html引用来自:https://maven.apache.org/index.html

翻译过来就是:

aven是一个项目管理工具。基于POM(Project Object Model,项目对象模型)的概念，Maven可以通过一小段描述信息来管理项目的构建，报告和文档的项目管理工具软件。

大白话: Maven是一个项目管理工具, 通过pom.xml文件的配置获取jar包，而不用手动去添加jar包

2.2 为什么要学Maven

简单,方便,减少bug

Maven提供的功能非常多, Maven在咱们课程中的体现主要是以下两个方面

项目构建
管理依赖

2.3 创建一个Maven项目

IDEA本身已经集成了Maven, 我们可以直接使用, 无需安装

2.4 Maven 核心功能

接下来, 我们结合项目, 介绍Maven在项目开发中的作用

主要体现在两个方面:

项目构建 2. 管理依赖

2.4.1 项目构建

Maven 提供了标准的,跨平台(Linux, Windows, MacOS等)的自动化项目构建方式

当我们开发了一个项目之后, 代码需要经过编译, 测试, 打包, 发布等流程, 每次代码的修改, 都需要经过这些流程, 如果代码反复调试修改, 这个流程就需要反复进行, 就显得特别麻烦,, 而Maven 给我们提供了一套简单的命令来完成项目的构建.

比如, 点击package, 就可以完成项目的打包操作

打包就是把所有的class文件, 全部放在一起, 打成jar包或者war包

jar包和war包都是一种压缩文件

jar包就是把开发人员已经写好的一些代码进行打包. 打好的jar包就可以引入到其他项目中, 也可以直接使用这些jar包中的类和属性. 另外也可以打成可执行jar包, 这样的包就可以通过java -jar命令来执行

war包可以理解为是一个web项目，里面是项目的所有东西, 通常用于网站.

2.4.2 依赖管理

上面说到, Maven是一个项目管理工具, 通过pom.xml文件的配置获取jar包，而不用手动去添加jar包获取的jar包, 其实就是依赖

pom.xml 就是maven 的配置文件，用以描述项目的各种信息

依赖配置

依赖: 指当前项目运行所需要的jar包.

如果使用Maven, 我们只需要在pom.xml中引入mysql-connector-java的依赖就可以了

复制代码

<dependencies>
 <!--里面放置项目的依赖坐标, 可为多个 -->
</dependencies>

在pom文件标签内, 添加依赖坐标
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.30</version> </dependency>
点击刷新按钮, 引入新加入的依赖jar包

后续有添加新的jar包, 或者修改jar包版本, 都需要通过该方式在项目中添加依赖

刷新完之后, 就可以在项目中看到新加入的jar包

依赖传递

早期我们没有使用maven时, 向项目中添加依赖的jar包，需要把所有的jar包都复制到项目工程下

比如 A 依赖B, B依赖C, 那么 A项目引入B 的同时, 也需要引入C, 如果我们手动管理这个依赖, 这个过程就会比较麻烦, 我们需要知道每个库都依赖哪些库, 以及这些依赖之间的版本是如何关联的

但使用maven的话, 就可以避免管理所需依赖的关系。我们只需要在pom文件中, 定义直接依赖就可以了, 由于maven的依赖具有传递性，所以会自动把所依赖的其他jar包也一起导入

如上图, 项目A 通过Maven 引入 Jar A 时, 会自动引入 Jar B 和Jar C

Jar A 和项目B就是项目A的直接依赖.

Jar B, Jar C是间接依赖

直接依赖：在当前项目中通过依赖配置建立的依赖关系

间接依赖：被依赖的资源如果依赖其他资源，当前项目间接依赖其他资源

依赖排除

当前阶段我们需要依赖的库并不多, 但随着项目的越来越复杂, 库之间的依赖关系也会变得越来越复杂. 如上图中, 如果项目A不需要Jar B,也可以通过排除依赖的方式来实现

排除依赖:

指主动断开依赖的资源。（被排除的资源无需指定版本)

复制代码

<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-core</artifactId>
 <version>6.0.6</version>
 <!--排除依赖-->
 <exclusions>
 <exclusion>
 <artifactId>spring-jcl</artifactId>
 <groupId>org.springframework</groupId>
 </exclusion>
 </exclusions>
</dependency>

maven还有一些功能是依赖调解, 可选依赖等

依赖调解:

当项目中的依赖存在依赖冲突时, 例如存在这样的依赖：

A->B->C->X(1.0)

A->D->X(2.0)

Maven会采用最短路径优先的原则去选择依赖，这里2的依赖路径更短，所以会选择X(2.0), 当然我们也可以选择指定某个依赖的版本

当然也可以指定X的版本

1.4.3. Maven Help插件

当项目比较复杂时, 我们就会有Jar包冲突的问题, 这时候就需要去解决依赖冲突. 解决冲突之前, 需要先找到冲突, 我们可以使用Maven Help插件来观察包和包之间的依赖关系

当项目比较复杂时, 我们就会有Jar包冲突的问题, 这时候就需要去解决依赖冲突. 解决冲突之前, 需要先找到冲突, 我们可以使用Maven Help插件来观察包和包之间的依赖关系.

插件就是对程序的一些特定场景, 做出一些特定的功能的扩展

安装插件: File -> Settings ->Plugins -> 搜索'Maven Help' -> 找到对应插件, 点击Install 安装即可, 安装后需要重启下idea, 才能生效

安装之后, 打开pom文件, 可以看到Jar包之间的依赖关系

2.5 Maven 仓库

我们通过短短几行代码, 就把依赖jar包放在了项目里, 具体是如何做的呢?

复制代码

<dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>8.0.30</version>
</dependency>

这个代码, 我们称之为 "坐标", 也就是唯一的

在Maven中, 根据 groupId、artifactId、version 的配置, 来唯一识别一个 jar 包, 缺一不可

当我们在pom文件中配置完依赖之后, 点击刷新, Maven会根据坐标的配置, 去仓库里寻找Jar包, 并把他下载下来, 添加到项目中. 这个Jar包下载的地方就称为仓库.

仓库：⽤于存储资源，管理各种jar包

Maven仓库分为两大类: 本地仓库和远程仓库. 其中远程仓库又分为中央仓库, 私服和其他公共库

2.5.1 本地仓库

本地仓库: 自己计算机上的一个目录(用来存储jar包)

当项目中引入对应依赖jar包后，首先会查找本地仓库中是否有对应的jar包

• 如果有，则在项目直接引用

• 如果没有，则去中央仓库中下载对应的jar包到本地仓库

本地仓库地址可以通过Maven配置查看:

File -> Settings

查看该仓库目录, 可以看到该目录下有很多的jar(最开始是空的, 随着Maven的使用, 该仓库下文件会越来越多)

2.5.2 中央仓库

中央仓库: maven 软件中内置一个远程仓库地址，就是中央仓库，服务于整个互联网. 由 Maven 团队维护，全球唯一

仓库地址：https://repo1.maven.org/maven2/

可以通过 https://mvnrepository.com/这个网站来查询并下载

我们可以把自己写好的Jar包上传到中央仓库(具备一定的要求), 也可以从中央仓库下载Jar包

2.5.3 私有服务器, 也称为私服

私服: 一般由公司团队搭建的私有仓库

私服属于某个公司,或者某个部门, 往往需要一定权限

有了私服之后, Maven依赖下载的顺序又发生了变化

先从本地仓库获取, 本地仓库存在, 则直接返回
如果本地仓库没有, 就从私服请求, 私服存在该资源, 就直接返回
如果私服上不存在该资源，则从中央仓库下载, 中央仓库不存在, 就报错了...
如果中央仓库中存在, 就先缓存在私服上之后，再缓存到本地仓库里, 再为Maven的下载请求提供服务

私服是很多人在使用的, 所以只需要第一个使用者下载一次就可以了

2.6 Maven 设置国内源

因为中央仓库在国外, 所以下载起来会比较慢, 所以咱们选择借助国内一些公开的远程仓库来下载资源接下来介绍, 如何设置国内源

2.6.1 配置当前项目setting

File -> Settings

查看配置文件的地址, 如上图所示, Maven配置文件地址为: D:\Maven\.m2\settings.xml

不同电脑设置的Maven路径不同

settings respository可以修改设置为其他路径, 两个路径不要有中文

配置国内源

Maven 仓库默认在国外https://mvnrepository.com/国内使用时会比较慢，我们可以更换为阿里云的仓库

打开settings.xml, 在 mirrors 节点上，添加内容如下

复制代码

<mirror>
 <id>aliyunmaven</id>
 <mirrorOf>central</mirrorOf>
 <name>阿里云公共仓库</name>
 <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
 </mirror>

如果上述地址不存在settings文件, 则直接复制粘贴过去即可

2.6.2 设置新项目的setting

上述配置的内容, 只对当前项目生效, 为了让后续新建的项目也生效, 需要重新设置一下新项目的 Settings

3. 第一个SpringBoot程序

3.1 Spring Boot介绍

在学习SpringBoot之前, 我们先来认识一下Spring

我们看下Spring官方 https://spring.io/的介绍

可以看到, Spring让Java程序更加快速, 简单和安全. Spring对于速度、简单性和生产力的关注使其成为世界上最流行的Java框架

Spring官方提供了很多开源的项目, 覆盖范围从Web开发到大数据, Spring发展到了今天, 已经形成了自己的生态圈. 我们在开发时, 也倾向于使用Spring官方提供的技术, 来解决对应的问题.

这些项目都是基于Spring Framework来进行开发的, 但是Spring Framework存在配置多, 入门难的问题, Spring 也意识了这个问题, 为了简化开发者的使用, 从而创造性的推出了SpringBoot.

接下来我们看下什么是Spring Boot.

Spring Boot 的诞生是为了简化 Spring 程序开发的

Spring Boot 翻译一下就是 Spring 脚手架，什么是脚手架呢？如下图所示

盖房子的这个架子就是脚手架，脚手架的作用是砌筑砖墙，浇筑混凝土、方便墙面抹灰，装饰和粉刷的，简单来说，就是使用脚手架可以更快速的盖房子

而 Spring Boot 就是 Spring 框架的脚手架，它是为了快速开发 Spring 框架而诞生的.

3.2 Spring Boot 项目创建

3.2.1 使用 Idea 创建

因为我们用的 Idea 社区版（其他版本也同样适用）

创建SpringBoot

File -> New ->Project

注意事项

第一次打开 Spring Boot 项目需要加载很久，因为当前 Spring Boot 框架并没有在自己的本地仓库.

为了加速 Spring Boot 项目的下载，在打开项目之前，请先确认自己的 Maven 已经配置为国内源

3.3 项目代码和目录介绍

观察pom文件

复制代码

?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
https://maven.apache.org/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <parent>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-parent</artifactId>
 <version>3.2.0</version>
 <relativePath/> <!-- lookup parent from repository -->
 </parent>
 <groupId>com.example</groupId>
 <artifactId>demo</artifactId>
 <version>0.0.1-SNAPSHOT</version>
 <name>demo</name>
 <description>Demo project for Spring Boot</description>
 <properties>
 <java.version>17</java.version>
 </properties>
 <dependencies>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
 </dependency>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-test</artifactId>
 <scope>test</scope>
 </dependency>
 </dependencies>
 <build>
 <plugins>
 <plugin>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-mavenplugin</artifactId>
 </plugin>
 </plugins>
 </build>
</project>

pom具体信息, 不需要过度关注, 我们主要看标签里面的内容

pom文件中, 引入了两个依赖

• spring-boot-starter-web：包含了web应用开发所需要的常见依赖

• spring-boot-starter-test：包含了单元测试所需要的常见依赖

父工程

但是我们发现, 这个依赖没有指定具体的版本号, 但我们的jar包也正常引入到项目中了.并且查看的话, 是有版本号的.

我们来看看本地仓库的的jar包是否下载下来了呢

也下载下来了.

为什么没有指定 , 程序也可以正常运行呢?

因为每一个SpringBoot工程，都有一个父工程. 依赖的版本号，在父工程中统一管理.

父工程指定版本号后, 就会自动引入和所指定版本对应的依赖, 创建的SpringBoot项目, 会继承 SpringBoot父工程

目录介绍

Spring Boot 项目有两个主要的目录

• src/main/java: Java 源代码

• src/main/resources: 为静态资源或配置文件

• src/test/java:测试代码源代码

• target: 编译后的文件路径

• pom.xml: maven 配置文件

3.4 运行项目

点击启动类的 main 方法就可以运行 Spring Boot 项目了，启动成功如下图所示

3.5 输出 Hello world

我们的Java EE课程, 更多是围绕着如何使用Java来进行web开发

咱们前面的课程中, 讲的是Java基础, 是没办法直接和浏览器进行互动的. 所以接下来我们要用 Spring Boot 来实现和浏览器及用户的交互

在创建的项目包路径下创建 UserController 文件，实现代码如下：

3.6 Web服务器

浏览器和服务器两端进行数据交互, 使用的就是HTTP协议

前面我们已经学习了 HTTP 协议, 知道了 HTTP 协议就是 HTTP 客户端和 HTTP 服务器之间的交互数据的格式.

Web 服务器就是对HTTP协议进行封装, 程序员不需要直接对协议进行操作(自己写代码去解析http协议规则)，让Web开发更加便捷, 所以Web服务器也被称为WWW服务器, HTTP服务器, 主要功能是提供网上信息浏览服务

常见的Web服务器有: Apache,Nginx, IIS, Tomcat, Jboss等

SpringBoot 内置了Tomcat服务器, 无需配置即可直接运行

Tocmat默认端口号是8080,所以我们程序访问时的端口号也是8080

3.7 请求响应流程分析

浏览器输入URL之后, 发起请求, 就和服务器之间建立了连接

浏览器：

输入网址：http://127.0.0.1:8080/cmr

◦ 通过IP地址127.0.0.1定位到网络上的一台计算机, 127.0.0.1就是本机

◦ 通过端口号8080找到计算机上对应的进程 , 也就是在本地计算机中找到正在运行的8080端口的程序

◦ /user/sayhi是请求资源位置

▪ 资源：对计算机而言资源就是数据

• web资源：通过网络可以访问到的资源（通常是指存放在服务器上的数据）

3.8 访问出错怎么办

3.8.1 404(客户端)

404 表示用户访问的资源不存在. 大概率是 URL 的路径写的不正确.

错误实例2: 注解写错

复制代码

@Controller
public class UserController {
 @RequestMapping("/sayHi")
 public String sayHi(){
 return "hello,Spring";
 }
}

3.8.2 500

服务器出现内部错误. 一般是服务器的代码执行过程中遇到了一些特殊情况(服务器异常崩溃)会产生这个状态码.

错误实例:

复制代码

@RestController
public class UserController {
 @RequestMapping("/sayHi")
 public String sayHi(){
 int res = 10/0;
 return "hello,Spring";
 }
}

3.8.3 无法访问此网站

一般是 Tomcat 启动失败了

这种情况一般是服务未成功启动, 也就是tomcat未启动,或者IP/端口写错

3.8.4 小结

最开始学习Spring的时候, 会遇到很多问题, 更多是环境相关的问题

我们不仅要学习 Spring 代码的基本写法, 更重要的是学习排查错误的思路

4. 总结

Spring Boot 是为了快速开发 Spring 而诞生的, Spring Boot 具备:

• Spring Boot 提供了启动添加依赖的功能, 可以快速集成框架.

• 内置web服务器，无需配置 Tomcat 等 Web服务器，直接运行和部署程序

• 可以完全抛弃繁琐的 XML，使用注解和配置的方式进行开发.

Spring Boot 可使用 Idea 或网页创建，它的设计思想是约定大于配置，类上标注 @SpringBootApplication 就可以启动 Spring Boot 项目