Spring - 6 ( 9000 字 Spring 入门级教程 )

2024-05-03 08:20
文章标签 java 教程 spring 9000 入门级

本文主要是介绍Spring - 6 ( 9000 字 Spring 入门级教程 )，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

一： SpringBoot 配置文件

1.1 配置文件作用

配置文件通常是一个文本文件，其中包含了程序或系统的各种设置、选项和参数。比如C:\Users, C:\Windows 文件夹, 以及各种 .config, .xml 文件

配置文件主要是为了解决硬编码（代码写死）带来的问题, 把可能会发生改变的信息, 放在⼀个集中的地方, 当我们启动某个程序时, 应用程序从配置文件中读取数据, 并加载运行，它们允许开发人员将应用程序的配置信息从源代码中分离出来，从而提高代码的可维护性和灵活性。

1.2 SpringBoot 配置文件

SpringBoot 支持配置文件, 同时也并定义了配置文件的格式，很多项目或者框架的配置信息就放在配置文件中, 比如:

  • 项目的启动端口
  • 数据库的连接信息(包含用户名和密码的设置)
  • 第三方系统的调用密钥等信息
  • ⽤于发现和定位问题的普通日志和异常日志等.

1.3 配置文件快速入手

SpringBoot 内置了 Tomcat 服务器, 默认端口号是 8080, 但是用户电脑上 8080 端口号有可能就被其他应用程序占用了,此时我们就需要通过配置文件修改项目的启动端口号

SpringBoot 在创建项目时, 就已经帮我们创建了配置文件：
在这里插入图片描述

  1. 修改 application.properties 文件
server.port=9090
  1. 重新运行程序, 观察日志

在这里插入图片描述

显示 Tomcat 启动端口号为 9090

  1. 访问程序: http://127.0.0.1:9090/login.html

在这里插入图片描述

此时: http://127.0.0.1:808/login.html 就不能再访问了

1.4 配置文件的格式

Spring Boot 配置文件有以下三种格式：

  • application.properties
  • application.yml（yaml 的简写，用法和 yaml 一模一样）
  • application.yaml

如图所示：

在这里插入图片描述

当应用程序启动时, Spring Boot 会自动从 classpath 路径找到并加载 application.properties 和 application.yaml 或者 application.yml ⽂件，我们可以通过 spring.config.name 指定文件路径和名称

注意：

  1. 理论上讲 .properties 和 .yml 可以并存在于⼀个项目中，当 .properties 和 .yml 并存时，两个配置都会加载. 如果配置文件内容有冲突, 以 .properties 为主

  2. 虽然理论上来讲 .properties 可以和 .yml 共存，但实际的业务当中，我们通常会采取⼀种统⼀的配置文件格式，这样可以更好的维护(降低故障率).

二： properties 配置文件说明

properties 配置文件是最早期的配置文件格式，也是创建 SpringBoot 项目默认的配置文件

2.1 properties 基本语法

properties 是以键值的形式配置的，key 和 value 之间是以"="连接的，如：

# 配置项⽬端⼝号
server.port=8080#配置数据库连接信息
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/testdb?characterEncoding=utf8&
spring.datasource.username=root
spring.datasource.password=root

注意：配置文件中使用 “#” 来添加注释信息。

2.2 读取配置文件

在项目中，如果想要主动的读取配置文件中的内容，可以使用 @Value 注解。@Value 注解使用 " ${} " 的格式读取

  1. properties 配置如下:
mykey.key1 = bite
  1. 读取程序代码：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.RestController;@RestController
public class PropertiesController {@Value("${mykey.key1}")private String key1;@RequestMapping("/key")public String key() {return "读取到值:" + key1;}

@Value(“${mykey.key1}”)注解的作用是告诉 Spring 框架在运行时去获取名为 mykey.key1 的属性值，并将其注入到 key1 变量中。

最终执行效果：
在这里插入图片描述

2.3 properties 缺点分析

properties 配置是以 key-value 的形式配置的，如下图所示：

在这里插入图片描述

从上述配置 key 看出，properties 配置文件中会有很多的冗余的信息，比如这些：

在这里插入图片描述

想要解决这个问题，就要使用 yml 配置文件的格式化了.

三：yml 配置文件说明

3.1 yml 基本语法

yml 是树形结构的配置文件，它的基础语法是"key: value"，key 和 value 之间使用英文冒号加空格的方式组成，空格不可省略

在这里插入图片描述

因为第⼀项的配置为正确的，所以 key 也是高亮显示的

3.2 使用 yml 连接数据库

spring:datasource:url: jdbc:mysql://127.0.0.0:3306/dbname?characterEncoding=utf8&useSSL=falseusername: rootpassword: root

yml 和 properties 连接数据库的配置对比：

  1. properties

在这里插入图片描述

  1. yml

在这里插入图片描述

四：yml 进阶使用

4.1 yml 配置不同数据类型及 null

# 字符串
string.value: Hello# 布尔值，true或false
boolean.value: true
boolean.value1: false# 整数
int.value: 10# 浮点数
float.value: 3.14159# Null，~代表null
null.value: ~#  空字符串直接后⾯什么都不加就可以了, 但这种⽅式不直观, 更多的表⽰是使⽤引号括起来
empty.value: ''

4.2 yml 配置读取

yml 读取配置的方式和 properties 相同，使用 @Value 注解即可，实现代码如下：

  1. yml 配置:
string:hello: bite
  1. 读取程序代码：
@RestController
public class ReadYml {@Value("${string.hello}")private String hello;@RequestMapping("/ymlKey")public String key(){return "读取到值:"+hello;}
}

访问: http://127.0.0.1:8080/ymlKey

在这里插入图片描述

4.3 value 值加单双引号问题

字符串默认不用加上单引号或者双引号，如果加英文的单双引号可以表示特殊的含义。

举个例子：

  1. yml 配置
string:str1: Hello \n Spring Boot.str2: 'Hello \n Spring Boot.'str3: "Hello \n Spring Boot."
  1. 读取程序代码
@RestController
public class ReadYml {@Value("${string.str1}")private String str1;@Value("${string.str2}")private String str2;@Value("${string.str3}")private String str3;@RequestMapping("/yml")public String readYml(){System.out.println(str1);System.out.println(str2);System.out.println(str3);return "yml";}
}

以上程序的执行结果如下图所示：

在这里插入图片描述

从上述结果可以看出：

  • 字符串默认不用加上单引号或者双引号。
  • 单引号会转义特殊字符，使其失去特殊功能, 始终是⼀个普通的字符串.
  • 双引号不会转义字符串里面的特殊字符, 特殊字符会表示本身的含义.

注意：此处的转义理解起来会有些拗口, \n 本意表示的是换行

  • 使用单引号会转义, 就是说, \n 不再表示换行了, 二是表示⼀个普通的字符串
  • 使用双引号不会转义, 表示 \n 表示的是它本身的含义, 就是换行

4.4 配置对象

我们还可以在 yml 中配置对象

  1. yml 配置
student:id: 1name: Javaage: 18

或者是使用行内写法（与上面写法的作用是一样的）：

student: {id: 1,name: Java,age: 18}

这个时候就不能用 @Value 来读取配置中的对象了，此时要使用另⼀个注解 @ConfigurationProperties 来读取

  1. 读取程序代码
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;@ConfigurationProperties(prefix = "student")
@Component
@Data
public class Student {private int id;private String name;private int age;
}

prefix = “student” 意味着这个注解将会查找 “student” 的配置项，并将它们映射到被注解的类的属性上。

配置文件中的属性是 student.id、student.name 和 student.age。使用了 @ConfigurationProperties(prefix = “student”) 注解之后，Spring Boot 会根据名字自动将这些属性值注入到 Student 类的对应属性 id、name 和 age 中。

  1. 访问 http://127.0.0.1:8080/readStudent

在这里插入图片描述

4.5 配置集合

配置文件也可以配置 list 集合，如下所示：

  1. yml 配置
dbtypes:name:- mysql- sqlserver- db2

集合的读取和对象⼀样，也是使用 @ConfigurationProperties 来读取的

  1. 读取程序代码
@Component
@ConfigurationProperties("dbtypes")
@Data
public class ListConfig {private List<String> name;
}

4.6 配置 Map

配置文件也可以配置 map，如下所示：

  1. yml 配置
maptypes:map:k1: kk1k2: kk2k3: kk3

或者是使用行内写法

maptypes: {map: {k1: kk1,k2: kk2, k3: kk3}}

Map 的读取和对象⼀样，也是使用 @ConfigurationProperties 来读取的

  1. 读取程序代码
@Component
@ConfigurationProperties("maptypes")
@Data
public class MapConfig {private HashMap<String,String> map;
}

4.7 yml 优缺点

优点:

  1. 可读性高，写法简单, 易于理解
  2. 支持更多的数据类型, 可以简单表达对象, 数组, List，Map 等数据形态.
  3. 支持更多的编程语言, 不止是 Java 中可以使用, 在 Golang, Python, Ruby, JavaScript 中也可以使用

缺点:

  1. 不适合写复杂的配置文件
  2. 对格式有较强的要求(⼀个空格可能会引起⼀场血案)

举个例子：

  1. properties 格式如下
keycloak.realm = demo
keycloak.resource = fm-cache-cloud
keycloak.credentials.secret = d4589683-Oce7-4982-bcd3
keycloak.security[0].authRoles[0]= user
keycloak.security[0].collections[0].name = ssologinurl
keycloak.security[0].collections[0].patterns[0] = /login/*
  1. yml 文件格式：
keycloak:realm: demoresource: fm-cache-cloudcredentials:secret: d4589683-Oce7-4982-bcd3security:- authRoles:- usercollections:- name: ssologinurlpatterns:- /login/*

五： 综合性练习

下面我们来做一个验证码案例

在这里插入图片描述

验证码的实现方式很多, 网上也有比较多的插件或者工具包可以使用, 咱们选择使用 Google 的开源项目 Kaptcha 来实现.

5.1 Kaptcha 插件介绍

Kaptcha 是 Google 的⼀个⾼度可配置的实用验证码生成工具，网上有很多人甚至公司基于 Google 的 kaptcha 进行了⼆次开发. 我们直接选择⼀个适配 SpringBoot 的开源项目

  • 项目链接：https://github.com/oopsguy/kaptcha-spring-boot

由于作者的文档写的不是很全, 下⾯简单介绍下插件的使用

5.2 原理

验证码可以客户端生成, 也可以服务器生成.，对于普通的字符验证码, 后端通常分两部分.

  1. 生成验证码内容, 根据验证码内容和干扰项等, 生成图片, 返回给客户端
  2. 把验证码内容存储起来, 校验时取出来进行对比.

kaptcha 插件选择把验证码存储在 Session 里

5.3 引入依赖

<dependency><groupId>com.oopsguy.kaptcha</groupId><artifactId>kaptcha-spring-boot-starter</artifactId><version>1.0.0-beta-2</version>
</dependency>

5.4 生成验证码

该插件提供了两种方式生成验证码：

  1. 通过代码来生成
  2. 通过配置文件来生成验证码

我们采用配置文件的形式来生成验证码

Kaptcha 详细配置：

配置项配置说明默认值
kaptcha.border图片边框，合法值：yes , noyes
kaptcha.border.color边框颜色，合法值： r,g,b 或者 white,black,blue.black
kaptcha.image.width图片宽200
kaptcha.image.height图片高50
kaptcha.producer.impl图片实现类com.google.code.kaptcha.impl.DefaultKaptcha
kaptcha.textproducer.impl文本实现类com.google.code.kaptcha.text.impl.DefaultTextCreator
kaptcha.textproducer.char.string文本集合，验证码值从此集合中获取abcde2345678gfynmnpwx
kaptcha.textproducer.char.length验证码长度5
kaptcha.textproducer.font.names字体Arial, Courier
kaptcha.textproducer.font.size字体大小40px
kaptcha.textproducer.font.color字体颜色，合法值： r,g,b 或者 white,black,blue.black
kaptcha.textproducer.char.space文字间隔2
kaptcha.noise.impl干扰实现类com.google.code.kaptcha.impl.DefaultNoise
kaptcha.noise.color干扰颜色，合法值： r,g,b 或者 white,black,blue.black
kaptcha.obscurificator.impl图片样式 水纹，鱼眼，阴影水纹
kaptcha.background.impl背景实现类com.google.code.kaptcha.impl.DefaultBackground
kaptcha.background.clear.from背景颜色渐变，开始颜色light grey
kaptcha.background.clear.to背景颜色渐变，结束颜色white
kaptcha.word.impl文字渲染器com.google.code.kaptcha.text.impl.DefaultWordRenderer
kaptcha.session.keysession keyKAPTCHA_SESSION_KEY
kaptcha.session.datesession dateKAPTCHA_SESSION_DATE

我们可以使用 kaptcha.items 配置多个验证码生成器，kaptcha.items 是⼀个 Map, key 为验证码生成器名称, value 为验证码生成器的配置

kaptcha:items:# home captchahome:path: /homeaptchasession:key: HOME_KAPTCHA_KEYdate: HOME_KAPTCHA_SESSION_DATE# admin captchaadmin:path: /admin/captchasession:key: ADMIN_KAPTCHA_SESSION_KEYdate: ADMIN_KAPTCHA_SESSION_DATE

配置说明：

在这里插入图片描述

配置后, 可以直接访问 http://XXXX:port/home/captcha 即可生成验证码

5.5 需求

界面如下图所示：

  1. 页面生成验证码
  2. 输入验证码, 点击提交, 验证用户输入验证码是否正确, 正确则进行页面跳转

在这里插入图片描述

5.6 准备工作

创建项目, 引入 Spring MVC 的依赖包, 把前端页面放在项目中

在这里插入图片描述

5.7 约定前后端交互接口

需求分析：后端需要提供两个服务：

  • 生成验证码, 并返回验证码
  • 校验验证码是否正确: 校验验证码是否正确.

接口定义：

  1. 生成验证码

请求:

GET /admin/captcha

响应: 图片内容

在这里插入图片描述

浏览器给服务器发送⼀个 GET /admin/captcha 这样的请求, 服务器就会返回⼀个图片, 浏览器会将图片显示在页面上

  1. 校验验证码是否正确

请求: /admin/check

POST /admin/check
captcha=xn8d

captcha：用户输入的验证码

响应:根据用户输⼊的验证码, 校验验证码是否正确. true: 验证成功. false: 验证失败.

true

5.8 实现服务器端代码

  1. 引⼊依赖
<dependency><groupId>com.oopsguy.kaptcha</groupId><artifactId>kaptcha-spring-boot-starter</artifactId><version>1.0.0-beta-2</version>
</dependency>
  1. 通过配置创建验证码生成器
kaptcha:border:enabled: trueimage:height: 50width: 160text-producer:character:length: 4font:color: blueitems:home:path: /admin/captchasession:key: KAPTCHA_SESSION_KEYdate: KAPTCHA_SESSION_DATE
  1. 启动项目, 访问 http://127.0.0.1:8080/admin/captcha , 显示验证码

在这里插入图片描述

  1. 验证码校验
import com.google.code.kaptcha.Constants;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpSession;
import java.util.Date;@RestController
public class KaptchaController {private final static long VALID_MILLIS_TIME = 60 * 1000;@RequestMapping("/check")public boolean checkHomeCaptcha(String captcha, HttpSession session) {if (!StringUtils.hasLength(captcha)) {return false;}String savedCaptcha = (String) session.getAttribute(Constants.KAPTCHA_SESSION_KEY);Date sessionDate = (Date) session.getAttribute(Constants.KAPTCHA_SESSION_DATE);if (captcha.equalsIgnoreCase(savedCaptcha)) {if (sessionDate == null || System.currentTimeMillis() - sessionDate.getTime() < VALID_MILLIS_TIME) {return true;}return false;}return false;}
}

5.9 调整前端页面代码

  1. 修改 index.html，补充 ajax 代码, 点击提交按钮, 发送请求去服务端进行校验
$("#checkCaptcha").click(function () {$.ajax({url: "/check",type: "post",data: { captcha: $("#inputCaptcha").val() },success: function (result) {if (result) {location.href = "success.html";} else {alert("验证码错误");$("#inputCaptcha").val("");}}});
});

5.10 运行测试

  1. 通过 http://127.0.0.1:8080/index.html 访问服务

在这里插入图片描述

  1. 输入验证码, 验证成功

在这里插入图片描述

这篇关于Spring - 6 ( 9000 字 Spring 入门级教程 )的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/956278。

相关文章

Java中ArrayList和LinkedList有什么区别举例详解

Java中ArrayList和LinkedList有什么区别举例详解

《Java中ArrayList和LinkedList有什么区别举例详解》：本文主要介绍Java中ArrayList和LinkedList区别的相关资料,包括数据结构特性、核心操作性能、内存与GC影... 目录一、底层数据结构二、核心操作性能对比三、内存与 GC 影响四、扩容机制五、线程安全与并发方案六、工程
阅读更多...
JavaScript中的reduce方法执行过程、使用场景及进阶用法

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》：本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程
阅读更多...
如何使用Java实现请求deepseek

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2
阅读更多...
Java调用DeepSeek API的最佳实践及详细代码示例

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》：本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.
阅读更多...
Spring AI集成DeepSeek的详细步骤

Spring AI集成DeepSeek的详细步骤

《SpringAI集成DeepSeek的详细步骤》DeepSeek作为一款卓越的国产AI模型,越来越多的公司考虑在自己的应用中集成,对于Java应用来说,我们可以借助SpringAI集成DeepSe... 目录DeepSeek 介绍Spring AI 是什么？1、环境准备2、构建项目2.1、pom依赖2.2
阅读更多...
Spring Cloud LoadBalancer 负载均衡详解

Spring Cloud LoadBalancer 负载均衡详解

《SpringCloudLoadBalancer负载均衡详解》本文介绍了如何在SpringCloud中使用SpringCloudLoadBalancer实现客户端负载均衡,并详细讲解了轮询策略和... 目录1. 在 idea 上运行多个服务2. 问题引入3. 负载均衡4. Spring Cloud Load
阅读更多...
Springboot中分析SQL性能的两种方式详解

Springboot中分析SQL性能的两种方式详解

《Springboot中分析SQL性能的两种方式详解》文章介绍了SQL性能分析的两种方式：MyBatis-Plus性能分析插件和p6spy框架,MyBatis-Plus插件配置简单,适用于开发和测试环... 目录SQL性能分析的两种方式:功能介绍实现方式:实现步骤:SQL性能分析的两种方式:功能介绍记录
阅读更多...
在 Spring Boot 中使用 @Autowired和 @Bean注解的示例详解

在 Spring Boot 中使用 @Autowired和 @Bean注解的示例详解

《在SpringBoot中使用@Autowired和@Bean注解的示例详解》本文通过一个示例演示了如何在SpringBoot中使用@Autowired和@Bean注解进行依赖注入和Bean... 目录在 Spring Boot 中使用 @Autowired 和 @Bean 注解示例背景1. 定义 Stud
阅读更多...
如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别详解

如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别详解

《如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别详解》：本文主要介绍如何通过海康威视设备网络SDK进行Java二次开发摄像头车牌识别的相关资料,描述了如何使用海康威视设备网络SD... 目录前言开发流程问题和解决方案dll库加载不到的问题老旧版本sdk不兼容的问题关键实现流程总结前言作为
阅读更多...
Ubuntu固定虚拟机ip地址的方法教程

Ubuntu固定虚拟机ip地址的方法教程

《Ubuntu固定虚拟机ip地址的方法教程》本文详细介绍了如何在Ubuntu虚拟机中固定IP地址,包括检查和编辑`/etc/apt/sources.list`文件、更新网络配置文件以及使用Networ... 1、由于虚拟机网络是桥接，所以ip地址会不停地变化，接下来我们就讲述ip如何固定 2、如果apt安
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2