1、简介 MyBatis 是一个流行的开源持久性框架，提供了 JDBC 和 Hibernate 的替代方案。
本文将带你了解 MyBatis 的一个扩展，名为 MyBatis-Plus，它具有许多方便的功能，可以大大地提高我们的开发效率。
2、MyBatis-Plus 整合 2.1、Maven 依赖 首先，在 pom.xml 中添加以下 Maven 依赖。
<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-spring-boot3-starter</artifactId> <version>3.5.7</version> </dependency> 最新版本的 Maven 依赖可在 此处 找到。由于这是基于 Spring Boot 3 的 Maven 依赖，我们还需要在 pom.xml 中添加 spring-boot-starter 依赖。
如果使用的是 Spring Boot 2，则需要添加以下依赖：
<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.7</version> </dependency> 接着，在 pom.xml 中添加 H2 内存数据库依赖，用于验证 MyBatis-Plus 的特性和功能。
<dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> <version>2.3.230</version> </dependency> 同样，H2 的最新版本可以在 这里 找到。除了 H2 外，我们还可以使用 MySQL 等其他关系型数据库。
2.2、Client 依赖添加完毕后，创建 Client 实体，其中包含一些属性，如 id、firstName、lastName 和 email：
OpenAI 最近 推出了 一项名为 “结构化输出”（Structured Outputs）的强大功能，可确保 AI 生成的响应严格遵守预定义的 JSON Schema。这一功能大大提高了 AI 生成的内容在实际应用中的可靠性和可用性。
Spring AI(1.0.0-SNAPSHOT) 已 完全集成 了对 OpenAI 的结构化输出的支持，以一种无缝的 Spring 原生方式为 Java 开发人员带来了这一功能。
下图显示了新的结构化输出功能如何扩展 OpenAI Chat API：
注：Spring AI 已经提供了 功能强大、与模型无关的结构化输出 工具，可用于包括 OpenAI 在内的各种 AI 模型。OpenAI 结构化输出功能提供了一个额外的、一致的、但针对特定模型的解决方案，目前仅适用于 gpt-4o、gpt-4o-mini 和更高版本的模型。
OpenAI 结构化输出功能可确保 AI 模型生成的响应符合所提供的 JSON Schema。这解决了 AI 驱动的应用程序中的几个常见难题：
类型安全：不再担心缺少必填 KEY 或枚举值无效； 明确拒绝：基于安全性的模型拒绝变得可以通过编程检测到； 简化的提示：实现一致的格式化，而无需使用过于具体的 Prompt（提示）。 Spring AI 允许开发人员以最少的配置利用这一功能。接下来看看如何在 Spring 应用中使用它。
编程式配置 你可以使用 OpenAiChatOptions Builder 以编程式设置响应格式，如下所示：
String jsonSchema = """ { "type": "object", "properties": { "steps": { "type": "array", "items": { "type": "object", "properties": { "explanation": { "type": "string" }, "output": { "type": "string" } }, "required": ["explanation", "output"], "additionalProperties": false } }, "final_answer": { "type": "string" } }, "required": ["steps", "final_answer"], "additionalProperties": false } """; Prompt prompt = new Prompt("how can I solve 8x + 7 = -23", OpenAiChatOptions.
1、简介 Enum（枚举）提供了一种在 Java 编程语言中定义一组命名常量的强大方法。这些常量可用于表示相关值的固定集合，例如 HTTP 状态码。总所周知，互联网上的所有 Web 服务器都会响应 HTTP 状态码作为标准响应码。
本文将带你了解如何创建一个包含所有 HTTP 状态码的 Java 枚举。
2、了解 HTTP 状态码 HTTP 状态码在 Wweb 通信中起着至关重要的作用，它能告知客户端其请求的结果。这些代码分为五类，每一类在 HTTP 协议中都有特定的功能。
3、HTTP 状态码使用枚举的好处 在 Java 中枚举 HTTP 状态码有几个优点，包括：
类型安全：使用 Enum 枚举可确保类型安全，使代码更具可读性和可维护性 分组常量：Enum 枚举将相关常量组合在一起，以清晰和结构化的方式处理固定值集合 避免硬编码：将 HTTP 状态码定义为枚举，有助于防止硬编码字符串或整数造成的错误 增强清晰度和可维护性：这种方法通过增强清晰度、减少错误和提高代码的可维护性，促进软件开发的最佳实践 4、基本做法 为了在 Java 应用中有效管理 HTTP 状态码，我们可以定义一个枚举来封装所有标准 HTTP 状态码及其描述。
这种方法可以让我们充分利用枚举类型安全和代码清晰的优势。
定义 HttpStatus 枚举：
public enum HttpStatus { CONTINUE(100, "Continue"), SWITCHING_PROTOCOLS(101, "Switching Protocols"), OK(200, "OK"), CREATED(201, "Created"), ACCEPTED(202, "Accepted"), MULTIPLE_CHOICES(300, "Multiple Choices"), MOVED_PERMANENTLY(301, "Moved Permanently"), FOUND(302, "Found"), BAD_REQUEST(400, "Bad Request"), UNAUTHORIZED(401, "Unauthorized"), FORBIDDEN(403, "Forbidden"), NOT_FOUND(404, "Not Found"), INTERNAL_SERVER_ERROR(500, "Internal Server Error"), NOT_IMPLEMENTED(501, "Not Implemented"), BAD_GATEWAY(502, "Bad Gateway"), UNKNOWN(-1, "Unknown Status"); private final int code; private final String description; HttpStatus(int code, String description) { this.
1、概览 在配置应用的安全设置时，用户的详细信息可能未包括 Spring Security 预期的 ROLE_ 前缀。这种情况下会导致 “Forbidden” 授权错误，无法访问受保护端点。
本文将带你了解如何配置 Spring Security，以允许使用不带 ROLE_ 前缀的角色。
2、Spring Security 默认行为 首先来看看 Spring Security 角色检查机制的默认行为。
添加一个 InMemoryUserDetailsManager，其中包含一个具有 ADMIN 角色的用户：
@Configuration public class UserDetailsConfig { @Bean public InMemoryUserDetailsManager userDetailsService() { UserDetails admin = User.withUsername("admin") .password(encoder().encode("password")) .authorities(singletonList(new SimpleGrantedAuthority("ADMIN"))) .build(); return new InMemoryUserDetailsManager(admin); } @Bean public PasswordEncoder encoder() { return new BCryptPasswordEncoder(); } } 如上，创建 UserDetailsConfig 配置类，该类配置了一个 InMemoryUserDetailsManager Bean。在工厂方法内部，使用 PasswordEncoder 来处理用户详细信息的密码。
接着，添加要调用的端点：
@RestController public class TestSecuredController { @GetMapping("/test-resource") public ResponseEntity<String> testAdmin() { return ResponseEntity.
1、简介 Java 中的转换（“Cast”）是一个基本概念，它允许将一种数据类型转换为另一种数据类型。它是在程序中有效操作对象和变量的关键过程。在现实世界中，“Cast” 类似于将一种单位的度量值转换为另一种单位的度量值，例如将英寸转换为厘米。
在 Java 的多态（Polymorphism）中，当超类引用子类的对象时，经常会使用到转换。例如，我们需要访问子类的特定方法或属性，就需要依靠转换来实现。这一点非常重要，因为 Java 是一种强类型语言，变量具有特定的数据类型。
本文将带你了解 Java Class.cast() 方法和 Cast（强转）操作符两个选项用法和差别，以及每个选项的最佳实践。
2、定义用例 以一个视频游戏角色的层次结构为例。
创建一个包含了超类 Character（角色）和子类 Warrior（战士）、Commander（指挥官）的示例。
该用例涉及创建 Warrior 和 Commander 的实例。这些实例存储在 Character 对象类型的集合中。之后，它们会被检索并转换回各自的特定类型。这种转换允许调用特定子类的方法。
3、定义 Model 类 首先，定义第一个继承自 Character 的子类，即实现了 obeyCommand() 方法的 Warrior：
public class Warrior extends Character { public void obeyCommand(String command) { logger.info("Warrior {} obeys a command {}", this.getName(), command); } } 然后，创建 Character 的第二个子类，即 Commander。这个子类实现了一个 issueCommand() 方法，可以向战士们发布命令：
public class Commander extends Character { public void issueCommand(String command) { log.
1、简介 本文将带你了解调整 JDBC 连接池大小的最佳策略。
2、什么是 JDBC 连接池，为什么要使用它？ JDBC 连接池是一种用于有效管理数据库连接的机制。创建数据库连接需要几个耗时的步骤，如
打开数据库连接 验证用户身份 创建用于通信的 TCP Sokcet 套接字 通过套接字收发数据 关闭连接和 TCP Sokcet 套接字 为每个用户请求重复这些步骤的效率可能会很低，尤其是对于有许多用户的应用。JDBC 连接池通过提前创建一个可重复使用的连接池来解决这个问题。当应用程序启动时，它会在池中创建并维护数据库连接。池连接管理器负责管理这些连接并处理其生命周期。
当客户端请求连接时，连接池管理器会从连接池中提供一个连接，而不是创建一个新的连接。一旦客户端完成操作，连接就会返回池中重复使用，而不是关闭。这种连接的重复使用节省了时间和资源，大大提高了应用程序的性能。
3、为什么 JDBC 连接池的大小对应用来说很重要？ 确定 JDBC 连接池的最佳大小对于平衡性能和资源利用率至关重要。较小的连接池可能会加快连接访问速度，但如果没有足够的连接来满足所有请求，则可能导致延迟。相反，较大的连接池可确保有更多连接可用，减少在队列中花费的时间，但可能会降低连接表的访问速度。
“连接表” 通常指的是管理和跟踪数据库连接的内部数据结构。它记录了当前连接的状态（如空闲、使用中等）以及相关的元数据，以便有效地分配和管理连接。这个“表”并不是数据库中的实际表，而是连接池实现中的一个逻辑概念。
下表总结了在确定连接池大小时需要考虑的利弊：
连接池大小 优点 缺点 较小的连接池 更快地访问连接表 可能需要更多连接来满足请求。请求在队列中停留的时间可能会更长 较大的连接池 有更多连接来满足请求。请求在队列中花费的时间减少（或没有） 降低访问连接表的速度 4、确定 JDBC 连接池大小时应考虑的要点 在确定池大小时，需要考虑几个因素。首先，应该评估平均事务响应时间和花费在数据库查询上的时间。负载测试可以帮助确定这些时间，建议在计算连接池大小时再增加 25% 的容量，以应对意外负载。其次，连接池应能根据实际需要进行增减。我们可以使用日志或 JMX 监视来监控系统，从而动态调整池的大小。
此外，还应考虑每次页面加载执行多少次查询以及每次查询的持续时间。为了获得最佳性能，我们可以从少量连接开始，然后逐渐增加。每个节点 8 到 16 个连接的池通常是最佳的。我们还可以根据监控统计数据调整空闲超时（Idle Timeout）和池大小调整数量（Pool Resize Quantity）值。
5、JDBC 连接池的基本控制设置 这些基本设置可控制池的大小：
连接池属性 说明 初始和最少连接数 池创建时的大小及其允许的最小连接数量 池最大连接数 连接池可维护的最大连接数量 池大小调整数量 空闲超时时要移除的连接数。闲置时间超过超时的连接将被移除，一旦连接池达到初始和最小连接池大小，就会停止移除。 最大空闲连接数 池中允许的最大闲置连接数。如果闲置连接数超过此限制，多余的连接将被关闭，从而释放资源 最小空闲连接数 在连接池中保留的空闲连接的最小数量 最大等待时间 应用等待连接可用的最长时间 验证查询 用于验证连接的 SQL 查询，然后再将其交给应用 6、调整 JDBC 连接池大小的最佳实践 以下是调整 JDBC 连接池以确保与数据库实例之间健康连接的一些最佳实践。
1、简介 本文将带你了解如何在 Spring Boot 应用中使用 ProblemDetail 响应错误信息，无论我们处理的是 REST API 还是 Reactive Stream（响应式流），它都提供了一种向客户端传达错误的标准化方式。
2、为什么要关注 ProblemDetail？ 使用 ProblemDetail 来标准化错误响应对任何 API 都至关重要。
它可以帮助客户理解和处理错误，提高 API 的可用性和可调试性。这将带来更好的开发体验和更强大的应用。
采用它还有助于提供更翔实的错误信息，这对维护我们的服务和排除故障至关重要。
3、传统的错误处理方式 在 ProblemDetail 之前，我们经常在 Spring Boot 中实现自定义 ExceptionHandler 和 ResponseEntity 来处理错误。我们会创建自定义的错误响应结构。这导致了不同 API 之间的不一致性。
这种方式不仅需要大量的模板代码。而且，缺乏表示错误的标准化方式，因此客户端很难统一解析和理解错误信息。
4、ProblemDetail 规范 ProblemDetail 规范是 RFC 7807 标准的一部分。它为错误响应定义了一致的结构，包括诸如类型（type）、标题（title）、状态（status）、详情（detail）和实例（instance）等字段。这种标准化提供了一个通用的错误信息格式，有助于 API 开发人员和使用者。
实现 ProblemDetail 可确保我们的错误响应具有可预测性并易于理解。这反过来提高了我们的 API 和其客户端之间的整体沟通效果。
5、在 Spring Boot 中实现 ProblemDetail 在 Spring Boot 中有多种方法可以实现 ProblemDetail。
5.1、通过配置属性启用 ProblemDetail 我们可以添加一个配置属性来启用它。对于 RESTful 服务，在 application.properties 中添加以下属性：
spring.mvc.problemdetails.enabled=true 此属性可使 ProblemDetail 自动用于基于 MVC（servlet 栈）的应用中的错误处理。
1、概览 Java 21 在 java.lang.Character 类中引入了一组新方法，为 Emoji 表情符号提供更好的支持。通过这些方法，我们可以轻松检查某个字符是否是 Emoji 表情符号，并检查 Emoji 表情符号的属性和特征。
本文将带你了解这些新添加的方法，以及与 Java 21 中 Emoji 表情符号处理相关的关键概念。
2、Character API 的更新 Java 21 在 java.lang.Character 类中引入了六个与 Emoji 表情符号处理相关的新方法。所有新方法都是静态的，以代表字符 Unicode 码点的 int 作为参数，并返回 boolean 值。
Unicode 码点是分配给 Unicode 标准中每个字符的唯一数值。它代表不同平台和语言中的特定字符。例如，码点 U+0041 代表字母 A，十六进制形式为 0x0041。
现在，让我们来仔细看看这些与 Emoji 表情符号相关的新方法。
2.1、isEmoji() isEmoji(int codePoint) 方法是新 emoji 方法中最基本的方法。它接收代表字符 Unicode 码点的 int 值，并返回一个 boolean 值，表示该字符是否为 Emoji。
用法如下；
String messageWithEmoji = "Hello Java 21! 😄"; String messageWithoutEmoji = "Hello Java!
1、概览 本文将带你了解 Spring Boot @MockBeans 注解的用法。
2、示例项目 以一个简单的票据验证器（Ticket Validator）示例为例：
public class TicketValidator { private CustomerRepository customerRepository; private TicketRepository ticketRepository; public boolean validate(Long customerId, String code) { customerRepository.findById(customerId) .orElseThrow(() -> new RuntimeException("Customer not found")); ticketRepository.findByCode(code) .orElseThrow(() -> new RuntimeException("Ticket with given code not found")); return true; } } 如上，我们定义了 validate() 方法，用于检查数据库中是否存在给定数据。它依赖 CustomerRepository 和 TicketRepository。
现在，来看看如何使用 Spring 的 @MockBean 和 @MockBeans 注解创建测试和模拟依赖。
3、@MockBean 注解 Spring 框架提供了 @MockBean 注解，用于模拟依赖以进行测试。该注解允许我们定义特定 Bean 的模拟版本。新创建的模拟 Bean 将被添加到 Spring ApplicationContext 中。因此，如果已经存在相同类型的 Bean，它将被替换为模拟版本。
Spring Boot 中的 application.yaml / application.properties 配置文件用于定义应用运行时需要的配置属性。
Spring Boot 提供了强大的配置属性绑定功能，可以把配置文件中的属性绑定到 Java Bean，并且会根据 Java Bean 的字段类型对配置属性进行必要的转换。
绑定属性到 Bean 通过一个简单的示例来看看如何把配置文件中的配置属性绑定到 Bean，并且自动转换其类型。
本文使用的 Spring Boot 版本是 3.3.1。
创建 Spring Boot 项目 创建任意 Spring Boot 应用。
定义配置属性 在 src/main/resources 目录下创建 application.yaml 配置文件，并在其中定义如下自定义的配置属性：
app: # 数值 port: 8080 # 字符串 title: "Spring Boot 属性绑定测试" # Duration duration: 15s # DataSize data-size: 10MB # 集合 file-types: ["png", "jpeg"] 如上，在配置文件中定义了几个不同类型的配置属性。在本例中，这些配置属性的名称没有任何意义，随意取的。
定义配置 Bean 在 cn.springdoc.demo.prop 包下定义与配置文件中属性相对应的 Bean。
package cn.
