程序员小航

前言 本文记录了 Spring 源码环境的搭建方式，以及踩过的那些坑！​ 当前版本：5.3.2-SNAPSHOT。 环境准备 Git JDK master 分支需要 JDK 11 5.2.x 分支， JDK8 即可 Gradle 6.5.1 IDEA 最新 （2020.2.3） Spring 源码仓库地址：https://github.com/spring-projects/spring-framework 下载源码 clone 源码 git clone https://github.com/spring-projects/spring-framework.git 使用 IDEA 打开 等待 IDEA 加载完成即可。 注： 也可以指定 clone 的分支 git clone -b 5.2.x https://github.com/spring-projects/spring-framework.git 或者先 fork 到自己的仓库，然后再 clone。 这里我是 fork 到我的仓库，然后再 clone 的。 当前 master 分支代表的版本为 ...

前言 有小伙伴反馈说希望可以自定义 Markdown 模版，这样就可以导出自己想要的样式了！这个功能可以有，毕竟大家不可能都生成一模一样的文档。现在来一起看看如何实现自定义模版吧！ 设置模版Settings -> Other Settings -> Doc View -> Markdown Template 打开之后内容如下： 模版这里分两个 Tab 分别是 Spring 、 Dubbo 。 这两个模版内容就稍微有些区别，如果自定义模版，直接修改保存即可。 模版变量 关于模版变量，这里使用的是 velocity 将变量替换为文本，如果有其他方式，或者说是 IDEA 用的那种方式，希望可以告诉我。最好可以提供源码。 总结非常感谢 lvgo 小伙伴的参与。 如果小伙伴们在使用过程中发现一些 bug 或者有好的意见建议，可以在 GitHub 提交 Issues 留言指出来。 Doc View GitHub：https://github.com/liuzhihang/doc-view 最后，记得要 一键三连， 来个 【分享、点赞、在看】！ 推荐文章 Dubbo 生成文 ...

前言 自从 DocView 发布了简陋的第一版之后，就不断地有小伙伴提建议意见等等，希望扩展各种功能。这不，时隔两周，DocView 又发布了新版本，本次的更新主要涉及到支持 Dubbo，以及支持导出单个文档为 Markdown 文件。来一起看看新功能吧！ 支持导出 Markdown 文件DocView 原版本已经支持复制到剪贴板的功能。 而在新版本中增加了 Export 按钮，可以将单个文档导出为 Markdown 文件。 来一张动图，大家看看效果： 导出的 Markdown 文本内容如下： 支持 Dubbo 接口之前的版本是不支持 Dubbo 接口的，而现在的版本可以在 Dubbo 接口里面使用。 当然这里并没有校验接口是否为 Dubbo 接口，只是校验了下是否为接口。所以说即使其他接口也是可以生成的。 这块还是需要完善的! DocView 文档地址在面板左下角的 help 按钮修改了跳转地址为：http://docview.liuzhihang.com/ 只是粗略搭建了一个 DocView 的说明文档网站，小伙伴们可以发现这个网站连 logo 都没有。 其他当 ...

问题最近终端总是弹出这么一句话，咱也不懂怎么解决。 Google baidu 也查不到问题。 小伙伴帮忙看一下。 每次新打开终端都会有这个 Warning 。 Warning: Calling `brew list` to only list formulae is deprecated! Use `brew list --formula` instead. 最后被逼无奈，在 V 站 发帖求助小伙伴， 结果还真找到了答案 解决方式 最后找到问题所在，是因为按照网上的教程安装的 Coreutils ~/.zshrc 里改一下即可。 补充写到这里，很多小伙伴应该已经知道问题所在了，可能有的小伙伴还不知道怎么解决： vim ~/.zshrc 找到使用 brew list 的地方 将 brew list 改为 brew list --formula 如果还不知道怎么弄，那可以用编辑工具打开 .zshrc 文件，然后搜索找到 brew list ，然后替换。

前言 相信大家都遇到一种事务失效场景，那就是 Spring 自调用，就是在 Service 方法内，调用另一个加 @Transactional 注解的方法，发现事务失效，这时候你是怎么解决的呢？ 事情回顾那是一个我忘了天气咋样的下午，突然蹦出一个小红点，嗯~ 挺着急的小红点。 原来是事务失效了！ 莫慌！莫慌！ 最后小伙伴选择了抽走，是我的工具类不香了么？ 当然故事的结果是完美的，问题解决了。 事务在开发中涉及到同时操作多个表的时候，要保证两个操作要么一起成功，要么一起失败，这时候就需要用到事务。 现在一般使用的都是基于 @Transactional 注解的声明式事务。 而事务使用过程中有以下几个注意事项： 事务只能应用到 public 方法上才会有效； 事务需要从外部调用，Spring 自调用会失效； 建议事务注解 @Transactional 一般添加在实现类上。 当然这几句话不是说我的，人家官方文档可是明确说明的！ 这里可是说明了应仅将 @Transactional 注解应用于具有公开可见性的方法。如果对受 protected, private o或 pa ...

前言 每次开发完新项目或者新接口功能等，第一件事就是提供接口文档。说到接口文档，当然是用 Markdown 了。各种复制粘贴字段，必填非必填，字段备注，请求返回示例等等。简直是浪费时间哇。所以想到了开发一款插件来解决重复复制文档的问题。下面来看我介绍介绍这款插件。 PS：插件比较简陋，还需要不断迭代。 为什么开发插件每次在对外提供接口时都要写文档，各种麻烦，并且文档耗费了很大一部分时间。也使用了一些文档工具，在线写作工具，最终还是比较喜欢自己手写文档。 使用过的生成工具 Swagger ： 添加依赖，配置类及描述信息，然后在方法及实体上添加注解，启动项目便可以通过访问 xxxx/swagger-ui.html 查看接口文档； API Doc ：添加配置文件及注释，安装 npm 并通过执行命令生成文档； SmartDoc ：添加依赖及注释后执行测试类生成文档； API2DOC ：添加依赖，开启注解，通过注解配置生成文档。 上面四种方法，无疑都需要添加依赖，使用注解等方式，可以说有一定的代码侵入性。 使用过的接口文档工具 ShowDoc ：曾经一段时间很喜欢用这个， Markdo ...

前言 JUC 下面还有一个系列的类，都是 CopyOnWriteXXX ，意思是写时复制，这个究竟是怎么回事？那就以 CopyOnWriteArrayList 为切入点，一起了解写时复制是怎么回事？ 介绍ArrayList 的一个线程安全的变体，其中所有可变操作（add、set 等等）都是通过对底层数组进行一次新的复制来实现的。 像名字一样，每次进行操作的时候，都会进行一次复制，当然会有很大的性能消耗，但是在某些使用场景下，又会提高性能。具体是怎么操作的，那就一步一步阅读源码，然后再做总结归纳。 基本使用public class CopyOnWriteArrayListTest { public static void main(String[] args) { CopyOnWriteArrayList<String> list = new CopyOnWriteArrayList<>(); // 添加元素 list.add("liuzhihang"); ...

前言 JUC 下面的相关源码继续往下阅读，这就看到了非阻塞的无界线程安全队列 —— ConcurrentLinkedQueue，来一起看看吧。 介绍基于链接节点的无界线程安全队列，对元素FIFO（先进先出）进行排序。 队列的头部是队列中最长时间的元素，队列的尾部是队列中最短时间的元素。 在队列的尾部插入新元素，队列检索操作获取队列头部的元素。 当许多线程共享对公共集合的访问 ConcurrentLinkedQueue 是一个合适的选择。 与大多数其他并发集合实现一样，此类不允许使用null元素。 基本使用public class ConcurrentLinkedQueueTest { public static void main(String[] args) { ConcurrentLinkedQueue<String> queue = new ConcurrentLinkedQueue<String>(); // 将指定元素插入此队列的尾部。 queue.add("liuz ...

前言 部署测试，部署预发布，一切测试就绪，上生产。 发布生产 闪退 What？？？ 马上回滚 开始排查 后端一模一样的代码，不是 APP 端的问题吧。可 APP 端没有发版啊。 …… 一番排查 原来是 APP 端打包，测试和预发布包 Header 传的都是 Authorization ，生产传的是 authorization 。就是大小写问题，那赶紧改。 背景首页接口只有登录才可以进入，因为首页要展示获取用户账户的一些信息。这里使用的是统一拦截，从 Header 中获取 token 后，使用 token 获取用户信息。 而现在要改为用户未登录也可以查看首页信息中的宣传文案等等，只不过账户信息不显示。 原流程 整个过程代码在 ThreadLocal底层原理 里面有所介绍。这里省略一部分代码。 @Componentpublic class TokenInterceptor implements HandlerInterceptor { @Override public void afterCompletion(HttpServletRequest arg0, ...

前言 新项目查日志太麻烦，多台机器之间查来查去，还不知道是不是同一个请求的。打印日志时使用 MDC 在日志上添加一个 traceId，那这个 traceId 如何跨系统传递呢？ 背景同样是新项目开发的笔记，因为使用的是分布式架构，涉及到各个系统之间的交互 这时候就会遇到一个很常见的问题： 单个系统是集群部署，日志分布在多台服务器上； 多个系统的日志在多台机器，但是一次请求，查日志更是难上加难。 解决方案 使用 SkyWalking traceid 进行链路追踪； 使用 Elastic APM 的 trace.id 进行链路追踪； 自己生成 traceId 并 put 到 MDC 里面。 MDCMDC（Mapped Diagnostic Context）是一个映射，用于存储运行上下文的特定线程的上下文数据。因此，如果使用log4j进行日志记录，则每个线程都可以拥有自己的MDC，该MDC对整个线程是全局的。属于该线程的任何代码都可以轻松访问线程的MDC中存在的值。 如何使用 MDC 在 log4j2-spring.xml 的日志格式中添加 %X{traceId& ...