aHangssBlog

git checkout妙用

Thu, 08 May 2025 00:00:00 GMT

概述

git checkout的作用通常有两个：

切换到指定分支或者commit

从指定分支或commit中恢复文件到当前工作目录

第一个作用大家都很清楚，通过 git checkout <branch>|<commit id> 很轻松能做到。本文重点记录第二个作用，也就是检出文件的作用。

背景

我学习项目的时候通常喜欢在README.md中记录笔记。然后现在我希望将当前项目的版本回退到前一个版本，但是同时我又希望只保留当前版本的 README.md中的新增笔记内容。

如果直接使用 git revert <commit id> 那么会直接恢复到前一个版本，但是随之而来的，我的新增的笔记内容会消失。使用 git reset 也是一样。下方git树图示将展示我希望git树的变化:

解决方案

通过 git checkout 检出文件的功能，可以实现此目的。

新建一个临时分支，这个分支保留了主分支最新的提交。然后在主分支执行回滚操作，回滚到指定的版本。然后通过git checkout 的文件检出功能，将之前的临时分支中最新的文件内容检出到当前分支。就实现了 "版本回退但是保留特定文件最新状态" 的目的。

具体流程如下：

流程

新建一个临时分支，该分支会保存当前分支的所有最新提交

此时，我们的git树会像这样：

此时temp-branch相当于main分支的备份。我们现在可以放心的回滚main分支的提交了。回滚提交到指定的版本：

此时，我们的git树会像这样：

此时README文件中的内容也一同回滚到b的版本了，但是别担心，我们可以使用git checkout 指令来恢复文件。

还记得temp-branch分支吗？他是main分支最新提交的备份，该分支中保存了a提交中的最新内容。因此，我们使用git checkout 来从temp-branch分支中恢复内容：

假如现在我改变了想法，我除了想保留README.md，还想保留之前版本的所有yml文件，那么可以这样写：

完成这一切后，删除这个临时分支（它已经发挥了它的作用）。我们的目的达到了。

开发随记

Sat, 20 Jan 2024 00:00:00 GMT

集合去重

如果是单纯对一个对象整体，或者是其他包装类型的集合进行去重，可以使用HashSet或TreeSet。使用set去重需要注意，HashSet去重是通过对象的equals方法来进行区分的，所以一般需要重写对象的equals方法。但是也可以使用如下无侵入的方式:

HashSet根据某一字段去重

TreeSet

如果是想要根据对象中某个字段来进行去重，可以使用Stream中的toMap方法, 利用map的键不可重复的特性，曲线救国:

Arrays.asList注意事项

使用asList将元素转为list时，要注意，转换后的list没有add和remove方法。因此无法执行add和remove操作。否则会报错。可以通过如下操作解决：

Transactional注意事项

在项目中遇到一个bug。

就是以下代码中，邮件发送的逻辑是异步执行的。但是整个 apply 方法被 @Transactional 注解标记，这个方法中所有的数据库操作都会等到事务执行完毕后才真正提交到数据库。因此就导致当代码执行到邮件发送的逻辑后，邮件发送逻辑中如果需要从数据库获取数据，会无法获取到，因为此时可能异步的任务执行到获取数据那一步的时候，业务代码中的事务并未提交，导致数据没有入库。

业务代码：

producer：

consumer：

解决方案：

在事务提交之后执行邮件发送逻辑

可以考虑使用 TransactionSynchronizationManager.registerSynchronization 实现 afterCommit 方法，让邮件发送的逻辑在事务提交之后执行

也可以手动提交事务。但是如果手动提交事务，那么 @Transactional 注解会失效，就需要手动回滚事务。

BUG排查思路

500异常

打开控制台，查看报错的接口是哪个

观察发送的请求，是否有重复请求？考虑部分接口在重复调用的情况下是否会出现无法预料的异常？

观察payload和response，观察数据结构是否正确

打开后端代码，进行调试，排错

日期转换

Java中的日期转换

Date 转 LocalDateTime

首先将date转为Instant，再指定时区

LocalDateTime 转 Date

LocalDateTime 先指定时区，转为 Instant, 再通过from转为date

LocalDate to Date

LocalDate 只包含日期信息，没有时间信息。这里我们使用 atStartOfDay() 方法将它设置为当天开始的时间 (00:00:00)，然后按照与 LocalDateTime 相同的方式转换为 Date。同样，这里也使用了系统默认时区。

LocalDateTime序列化问题

LocalDateTime类型数据在序列化为JSON数据时，会被默认转化为时间戳的格式。想要让其以正常格式输出，可以使用 @JsonFormat 注解。

序列化问题

定时任务的持久化异常。因为实体类发生过变动，在序列化时，由于没有手动指定序列化id，而实体类发生变动（字段修改）后，类hash值发生改变，序列化id也发生了变化。所以quartz无法根据之前旧的序列化id找到对应的实体类。

解决方案：为实体类手动定义序列化id

[!NOTE]
建议所有可序列化的类都显式声明serialVersionUID的值，因为默认的serialVersionUID计算对类的详细信息非常敏感，这些详细信息可能因编译器实现而异。因此在反序列化期间可能导致意外的错误(InvalidClassException)。因此为了保证不同java编译器反序列结果一致，可序列化的类强烈建议显示声明serialVersionUID的值，并建议使用private修饰符，因为此声明仅适用于立即声明的类，而不适用于其子类。

数据库字段插入列表数据

数据库中字段是 varchar ，而希望存储一个形如 [1,2323,545] 的列表数据。实体类应该直接为 List ，并用注解 @TableField(typeHandler = JacksonTypeHandler.class) 标记。

然后在@TableName注解上开启autoResultMap属性即可。

计算时间差

QUARTZ

三个重要角色：

job 具体的任务

trigger 触发器，决定了job将在何时触发

scheduler 调度器，是job和trigger的管理者和调度者，可以获取触发器状态，调用触发器，取消触发器。定时任务的一切操作都是使用 scheduler 完成的

其他的看源码即可，源码简洁易懂。

SSE

SSE的核心是 SseEmitter ，用以向客户端发送消息。

当客户端和服务器建立连接之后，服务器会以 text/event-stream 的MIME格式返回一个 SseEmitter 给客户端，之后，客户端和服务器就会一直维持这个连接，直到时间达到 SseEmitter 设定的过期时间。

SSE实践：

客户端通过调用一次服务器的接口来建立SSE的连接。

服务器向客户端推送数据。

中文乱码

SseEmitter 在SpringMVC中默认是ISO编码格式，此时若客户端采用的编码格式是UTF-8，则会导致中文乱码。因此需要重写 SseEmitter 的 extendResponse 方法，手动设置其编码格式。

并发编程

使用 ThreadPoolExecutor 来显式创建线程池。因为这样可以手动指定核心线程数，最大连接数，拒绝策略等。不要使用 Executors 工具类的静态方法例如 newFixedThreadPool 来创建线程池。虽然这样更加方便，但是这样创建出来的线程池不利于维护和拓展。newFixedThreadPool 线程池是一个固定大小的线程池，并且使用的是无界阻塞队列，容易造成内存溢出。以下是 newFixedThreadPool 源码：

应当使用 ThreadPoolExecutor 来显式创建线程池：

线程池使用：

线程池拒绝策略

DiscardOldestPolicy：丢弃最老的任务；

CallerRunsPolicy：同步调用, 遇到新任务会将任务返回给调用者线程，让其执行；

AbortPolicy：丢弃新任务并抛出异常；

DiscardPolicy：丢弃新任务；

异步编排

参考文章👈

使用：

多线程环境中的上下文传递问题

今天线上出了一个问题，同事反映说会议预约时发送的邮件中显示的预约人信息不对，我一看，明明会议是A预约的，邮件中却显示是B。

这个情况让我非常好奇，后来经过思考和排查，大致将问题锁定在并发安全的问题上。

因为预约会议的业务执行过程中，发送邮件是交给线程池来执行的，在处理邮件发送的逻辑中有通过用户上下文获取当前登录用户信息的操作，我初步判断，可能是由于主线程和线程池中执行邮件发送线程之间的上下文没有按预期传递导致的问题。

解决方案

直接传递用户id

在调用发送邮件方法时将主线程中的登录用户信息作为参数进行传递。

使用 transmittable-thread-local 作为存储用户上下文的容器，配合TtlExcutors 或 TtlRunnable 实现上下文在多线程环境中的传递。

使用Spring Security提供的 DelegatingSecurityContextRunnable

或者

SRPING循环依赖

spring通过三级缓存来解决循环依赖问题。

一级缓存： singletonObjects 单例池，存放完全初始化好的bean

二级缓存：earlySingletonObjects 早期bean，存放实例化，但是并未进行依赖注入和初始化的早期bean

三级缓存：singletonFactories 存放bean工厂，用于创建早期引用

假设A和B相互依赖，以下是A和B的创建流程：

创建A实例

检查一级、二级、三级缓存，都没有A

实例化A

将A的 ObjectFactory 放入三级缓存

依赖注入，发现依赖B

创建B实例

检查一级、二级、三级缓存，都没有B

实例化B

将B的 ObjectFactory 放入三级缓存

依赖注入，发现依赖A

解决循环依赖

检查一级缓存，没有A

检查二级缓存，没有A

检查三级缓存，发现有A，获取A的早期引用

将A的早期引用放入二级缓存，并将三级缓存中A的早期引用移除

B完成依赖注入

B初始化完成，放入一级缓存，清除二级、三级缓存中的B

完成 A 的创建：

A 得到了完全初始化的 B

A 完成属性注入和初始化

A 放入一级缓存，清除二、三级缓存中的 A

最终状态：

一级缓存中有完全初始化好的 A 和 B

二级缓存和三级缓存为空

为什么需要三级缓存？

先说结论，三级缓存的作用是为了优化性能。如果没有三级缓存，spring在实例化A的时候，并不知道这个A需不需要使用aop（aop的执行时机是在bean初始化完成之后），那这种情况下，sping是创建A的原始对象放入二级缓存呢？还是创建A的代理对象放入缓存呢？

如果创建原始对象放入缓存，后面发生循环依赖时，B注入的就是A原始对象，但是当A初始化完成后，开始执行aop逻辑时，又需要创建代理对象并放入一级缓存。这就导致了B中注入的是原始对象，其他地方获取A的时候，获取的是代理对象。这有可能会导致aop失效。

如果一开始就为所有的bean创建代理对象并放入二级缓存，会造成资源的浪费。

三级缓存的设计，就是为了延迟创建bean的早期引用，在需要时才决定返回代理对象还是原始对象：

创建Bean A：

实例化A，得到A的原始对象

将A的ObjectFactory放入三级缓存：singletonFactories.put("A", () -> getEarlyBeanReference(A))

开始填充A的属性，发现依赖B

创建Bean B：

实例化B，得到B的原始对象

将B的ObjectFactory放入三级缓存

开始填充B的属性，发现依赖A

检查一、二级缓存没有A

从三级缓存中获取A的工厂，调用getEarlyBeanReference，该方法可以判断A是否需要代理，如果A需要代理，此时就会创建代理对象 （循环依赖的特殊场景，提前创建代理对象）

将得到的A（可能是代理对象）放入二级缓存，并从三级缓存中移除

B完成初始化，放入一级缓存

完成A的创建：

A注入了完整的B

A完成初始化

检查A是否已经被提前代理过（通过标记），如果是，则不再创建新的代理

A放入一级缓存

最终结果：

B中注入的是A的早期引用（可能是代理对象）

其他地方获取A时，也是获取相同的对象

保证了所有引用A的地方获取的都是同一个对象（统一都是代理对象或都是原始对象）

SQL中’ “ `是不一样的

SQL 中单引号、双引号和反引号作用具体如下：

单引号（'）：用于包裹字符串常量。例如：WHERE name = '张三' 双引号（"）：用于标识符（如表名、列名），区分大小写，主要在 Oracle、PostgreSQL 等数据库中使用。例如：SELECT "UserName" FROM "UserTable" 反引号（`）：MySQL 专用，用于标识符（表名、列名），防止与关键字冲突。例如:

SELECT user FROM `order` 总结：字符串用单引号标识符用双引号（标准 SQL/Oracle/PostgreSQL）或反引号（MySQL）

NGINX PROXY_PASS斜杠问题

nginx配置中，proxy_pass和root后面的url末尾是否带有斜杠（/）会影响URL的处理方式：

proxy_pass 斜杠区别

proxy_pass后的url加与不加斜杠的区别在于是否保留location中匹配的路径部分：

不带斜杠：会将location的匹配路径部分也传递给后端

带斜杠：会去除location匹配的路径

location 斜杠区别

location匹配路径末尾是否带斜杠的区别在于对目录的处理方式：

不带斜杠：严格匹配，必须完全符合路径

带斜杠：表示目录匹配，会匹配该目录下的所有内容

最佳实践：如果要匹配目录，建议在location中使用斜杠结尾，这样可以避免一些意外的404错误。如果要严格匹配某个路径，则不要使用斜杠结尾。

动态渲染表格

有些场景下我们需要动态渲染表格，也就是列是不固定的。这中情况有些复杂，一下记录两种解决方案：

后端返回数据结构形如

前端渲染

后端返回数据结构形如

这种是以一行数据为一个单位。

Sortable库

SortableJS

JavaScript library for reorderable drag-and-drop lists

Holder静态内部类技巧

读取文件内容，只读一次，然后缓存下来供全局使用

这种做法有很多好处：

简洁优雅

天然线程安全，因为Jvm会保证类加载的过程是线程安全的

在Spring、Mybatis等著名开发框架中经常能看到这种开发技巧。

Vue组件拖拽实现笔记

问题背景

实现表格行拖拽排序时，遇到了"拖动后只改变序号但不改变实际内容"以及"第一次拖动后无法继续拖动"的问题。

核心知识点

Vue 的渲染机制

虚拟 DOM: Vue 使用虚拟 DOM 来高效更新实际 DOM，比较新旧虚拟 DOM 树的差异。

key 属性作用: 在组件或元素上使用 key 属性可以帮助 Vue 跟踪每个节点的身份，正确复用和重新排序元素。

组件重新渲染：当 key 值改变时，Vue 会销毁并重新创建整个组件，而不是尝试更新它。

v-if/v-else/v-else-if 控制的组件会销毁和重建

v-for 列表渲染时，key 的选择影响性能和状态复用

props 变化不会销毁组件，只会触发更新

setup 只在组件创建时执行一次

响应式数据变更只会触发局部 DOM 更新

异步组件加载时，挂载和卸载流程与普通组件一致，Suspense 可控制加载占位和错误处理。

nextTick 方法

定义: Vue 提供的全局 API，用于在 DOM 更新循环完成后执行延迟回调。

原理: Vue 更新 DOM 是异步的，修改数据后 DOM 不会立即更新，nextTick 允许等待 DOM 更新完成后再执行操作。

用法:

Sortable.js 的使用

创建与销毁: 拖拽功能实现时需要管理 Sortable 实例的生命周期

sortable实例是与dom元素相绑定的。当用户拖动元素后，js修改了数组中数据的顺序，此时为了让table重新渲染，需要为table设置一个key。当key发生改变，table就会被强制渲染。此时sortable原来绑定的dom元素丢失，会导致下一次无法进行拖拽。因此需要重新创建sortable实例。

组件挂载完成执行 initSortable 方法，第一次执行的时候直接创建新的 Sortable 实例。开始监听 drag-handler 的拖动。当发生拖动的时候 tableKey++ , Table销毁后重新渲染，触发 nextTick 回调，再次执行 initSortable 方法. 第二次执行的时候，会销毁之前的 Sortable 实例（因为这个实例所绑定的dom元素已经销毁，需要重新绑定），重新创建 Sortable 实例并且绑定新的dom元素

事件处理: 使用 onEnd 回调处理拖拽结束事件

BigDecimal处理小数点

在java中处理小数点，通常来说有3中方法：

Math

通过 Math.round() 四舍五入，截取小数

String.format

用于展示而非计算

BigDecimal

使用GraalVM打包原生应用

Sat, 28 Jun 2025 00:00:00 GMT

GraalVM 是一个由 Oracle 开发的 多语言运行时（runtime），它最大的亮点是：

💥 让 Java 和其他语言（像 JS、Python、Ruby、LLVM 等）都能高效运行、互操作，甚至打包成原生可执行文件（.exe/.out）！

简化来说，它是一种更「万能」的 Java 运行环境，但远不止于 Java。

graalvm可以将java项目打包为二进制文件，类似于 go build 那种。这是通过 native-iamge 工具实现的。

下面介绍具体操作方法：

准备环境

需要准备两点：

windows下需要准备c++构建工具

下载graalvm

C++构建工具

下载 vs installer

选择单个组件：

C++ 生成工具

MSVC 生成工具

Windows 11 SDK

下载graalvm

Download GraalVM

下载完graalvm后，实际上它自带一个jdk。此时我们将环境变量中的JAVA_HOME修改为graalvm的安装目录。

然后再配置一个GRAALVM_HOME, 值也是graalvm的安装目录。

然后在path里将graalvm安装目录下的bin目录配置进去，注意要放在其他jdk配置之前，防止jdk版本被覆盖。

SpringBoot项目配置

添加 native-maven-plugin 插件

项目打包

直接通过idea的maven工具，选择plugins中的 native:compile 命令执行

如果执行失败，可以先复制idea生成的maven命令，然后在 x64 Native Tools Command Prompt for VS 2022 Preview 命令行工具中执行此命令。这个命令行工具在安装指定组件的vs后，就会有。

成功打包exe文件。

logstash应用

Tue, 27 May 2025 00:00:00 GMT

ELK配置

先把elk跑起来，具体的docker compose文件和logstash的配置文件内容如下：

logstash.conf

Java应用配置

配置完elk后，我们开始配置springboot应用，在resources目录下创建logback-spring.xml文件：

同时需要在pom.xml中添加logstash依赖：

这样配置后，应用程序的日志会同时输出到控制台和发送到LogStash。LogStash会将日志转发到Elasticsearch，然后可以在Kibana中查看和分析这些日志。

Kibana数据分析

我们在 Management → Index Management 中可以看到自动创建的索引

在 Analytics → Discover 中可以查看并分析日志内容

在 Analytics → Dashboards 中可以构建图表数据视图，直观的展示数据

nginx正向代理

Thu, 08 May 2025 00:00:00 GMT

Nginx正向代理

nginx正向代理需要借助一个模块：ngx_http_proxy_connect_module

该模块的源码地址

我们需要先下载这个源码，然后通过编译的方式将其安装到nginx里。nginx安装方式有很多，比如通过apt直接安装，或者使用docker等。本文使用的nginx安装方式是源码编译安装。

步骤

1. 下载ngx_http_proxy_connect_module模块

直接clone其github仓库即可。

2. 下载nginx （v1.24.0）

安装nginx前，你可能需要一些前置的准备：

安装gcc

安装pcre （正则库）

openssl

3. 打补丁

这里我使用nginx1.24.0，需要的补丁是 proxy_connect_rewrite_102101.patch。如果你使用其他nginx版本，可以在ngx_http_proxy_connect_module模块的github仓库查看对应的补丁。只需要将上述 'proxy_connect_rewrite_102101.patch' 替换为对应版本的补丁即可。

4. 编译nginx源码，安装nginx

通过编译安装的nginx主目录位置在： /usr/local/nginx 下

5. 编辑配置文件，启用正向代理

6. 配置代理

在win上配置代理，填入云主机的ip地址和端口即可。

已经安装了nginx？

上面是从头开始安装nginx的例子。如果你的云主机上已经存在了nginx，但是不想重装，可以通过平滑升级方式实现。

步骤

1. 查看当前nginx配置项

记住configure arguments: 后面的内容，我们需要保留这些配置项，这样才不会影响你原来的nginx

2. 配置新的配置项

进入新下载的nginx源码目录，通过configure配置新的配置项，这个配置项会覆盖掉原来的配置。因此把原来的配置加上，再添加你想要的其他模块。

3. 复制二进制文件

将 objs 目录下，编译好的nginx二进制文件复制到nginx的安装目录下的/sbin里。

4. 升级nginx

回到源码的目录，执行make upgrade指令

如果在执行make upgrade指令时报错： make: *** [Makefile:22：upgrade] 错误 1 尝试先kill掉原来的nginx进程，然后使用绝对路径来启动新的nginx：

之后再执行 make upgrade 应该不会有问题了。

5. 配置nginx.conf

安装完ngx_http_proxy_connect_module模块后，剩下的就是配置nginx.conf了，和上面一样，不再赘述。

frp内网穿透

Thu, 08 May 2025 00:00:00 GMT

在本文中，你将学习如何使用frp实现内网穿透，主要包含以下内容：

下载和安装frp

配置frp客户端和服务端

通过systemd管理frp服务

实现web服务的内网穿透

前提条件：

✨ 在开始之前，请确保你已经：

拥有一个域名

拥有一台具有公网IP的云服务器

本文介绍如何通过frp在自己的云服务器上搭建内网穿透服务，提供对外暴露的web服务。

内网穿透可以将本机的服务通过云服务器拥有的公有ip暴露到公网上供他人访问，应用场景有很多，比如做微信小程序开发时需要调试接口，或者向别人演示自己还未正式上线的小demo等。

在阅读本文内容之前，需要有一些前置准备：

你拥有一个域名

你拥有一台具有公网ip地址的云主机

frp

frp 是一款高性能的反向代理应用，专注于内网穿透。它支持多种协议，包括 TCP、UDP、HTTP、HTTPS 等，并且具备 P2P 通信功能。使用 frp，您可以安全、便捷地将内网服务暴露到公网，通过拥有公网 IP 的节点进行中转。

下载

如果你是win系统，可以通过frp的github releases点击下载文件。

如果你是linux系统，你可以通过wget下载:

这里以win为例，下载完压缩包解压之后，你会看到如下的目录结构：

这里介绍一下，这个frpc.toml是客户端的配置文件，客户端指的是你需要进行内网穿透的机器。c就是client的意思。frpc.exe就是客户端的frp程序的启动文件。

frps.toml就是源服务器的配置文件，源服务器指的就是你的云服务器（拥有公网ip的）。同理，这个s就是source的意思。

那其实我们现在用的win机器，只需要保留frpc.toml和frpc.exe就行了，剩下的frps.toml和frps.exe可以删除掉。因为云服务器使用linux系统这个exe他也用不了，所以我们在云服务器上还需要从giithub上下载这个frp的文件。

同样的，在云服务器上下载了文件后，也可以删除掉frpc.toml和frpc，只需要保留frps.toml和frps即可。

接下来介绍具体操作步骤：

对于客户端（win机器）

通过github releases下载文件

保留文件中的frpc.toml和frpc.exe即可

配置frpc.toml

启动frpc服务

对于云主机（linux机器）

通过sh命令获取frp文件

保留文件中的frps.toml和frps即可

配置frps.toml

启动frps服务

如果你不想每次都进入frp安装目录下通过 xxx/frps -c xxx/frps.toml 来启动的话，可以通过systemd来添加frp服务，通过systemctl统一管理。具体步骤如下：

在/lib/systemd/system/下创建 frps.service文件, 内容如下：

通过systemd管理frps

对外提供web服务

在云主机上配置frps.toml

在win机器（客户端）上配置frpc.toml

记得把自己的域名解析到云主机上！

启动服务

或者通过systemd

win机器同理，通过powershell或者cmd执行exe程序并通过 -c 指定应用的配置文件。

至此，内网穿透已经实现，你可以愉快的向别人分享你的demo啦！😊

结尾附上frp的官方文档，本文还有些不完善的地方或者没有提到的功能，可以参考frp官方文档。