大家好，我是TJ！有段时间没给大家推荐好用工具了，主要是最近工作摸鱼太厉害了，所以也没去探索和接触新东西。

前几天，TJ被领导喷了，原因是代码里注释太少，导致写的SDK在生成JavaDoc文档的时候，有价值的说明内容太少，以后维护不方便。于是马上着实去优化这个是，现在是AI时代了，肯定不能死做，第一反应就是去找找看是否有直接可以用的工具。

于是，我找到了这么个IDEA插件：Easy Javadoc

大家有需要的可以直接打开IDEA，在plugins市场里搜索，就能获得。

在安装完插件之后，您只需要记住下面这些快捷键，然后就可以去代码里自动生成了：

下面跟着动图演示，来体验一下该插件快速生成JavaDoc的能力：

可以看到，它的主要功能就是根据函数名称、参数名称等代码层面的信息，通过翻译，自动生成相关的中文注释。所以，虽然有插件的辅助，但开发者还是要有良好的编码习惯，写能让人看得懂的参数定义、方法定义。这样，后续的其他自动化生成工具就都能完美的用上，来提高我们的工作效率了。

由于该插件会用到翻译功能，所以各位用户还要去选择和配置一下你需要使用的翻译API，每个供应商每月都有免费额度，对于个人来说，都足够使用了，下面是主流的一些翻译API，需要的可以自取：

• 百度翻译申请地址：https://api.fanyi.baidu.com/doc/21
• 腾讯翻译申请地址：https://cloud.tencent.com/document/product/551/7372
• 阿里云翻译申请地址：https://www.aliyun.com/product/ai/alimt
• 有道智云翻译申请地址：https://ai.youdao.com/
• 微软翻译申请地址：https://azure.microsoft.com/
• 谷歌翻译（需要翻墙）申请地址：https://cloud.google.com/

好了，今天的分享就到这里，感兴趣的可以根据下面相关链接了解更多内容：

• 插件地址：https://plugins.jetbrains.com/plugin/12977-easy-javadoc
• 开源项目：https://github.com/starcwang/easy_javadoc

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

这两天给我们开发的Chrome插件：Youtube中文配音增加了账户注册和登录功能，其中有一步是邮箱验证，所以这边会在Spring Boot后台给用户的邮箱发个验证信息。如果发邮件，之前的文章教程里就有，这里就不说了，着重说说这两天发现所有用Gmail注册的用户都被退件的问题。

报错现象

先来看看具体报错（如果您也碰到这种情况，那么可以看看后面的内容）：

退信原因：发件人（youtubedubbing@mail.spring4all.com）域名的DNS记录未设置或设置错误导致对方拒收此邮件。
host gmail-smtp-in.l.google.com[142.251.10.26] said: 550-5.7.26 This mail is unauthenticated, which poses a security risk to the sender and Gmail users, and has been blocked. The sender must authenticate with at least one of SPF or DKIM. For this message, DKIM checks did not pass and SPF check for [mail.spring4all.com] did not pass with ip: [54.204.34.130]. The sender should visit https://support.google.com/mail/answer/81126#authentication for instructions on setting up authentication. k191-20020a636fc8000000b00565bcd33890si6279798pgc.848 - gsmtp (in reply to end of DATA command)
解决方案：请通知你的邮箱管理员为邮箱域名设置正确的DNS(SPF、DKIM、DMARC)记录。详细请见 http://service.exmail.qq.com/cgi-bin/help?subtype=1&&no=1000580&&id=20012 。

问题分析

从退信原因中Google给的链接内容非常多，大致内容就是Google针对垃圾邮件滥用邮箱等行为做的防护机制。所以，如果您要支持Gmail的话，就必须符合它所制定的身份配置要求，里面包含了：SPF配置、DKIM配置、ARC配置以及DMARC配置。

Google官方提供了一个工具：https://toolbox.googleapps.com/apps/checkmx/，可以用来检测你的一些列配置是否符合要求。您只需要输入你的邮箱域名，就可以看到如下的诊断结果：

那么多警告，显然是要慢慢解决才能不被拒收吧。。。不过那么多配置，是不是一下就晕了？

如果你懒得深入看的话，下面DD就讲一下比较快速的解决不被拒收的配置。

解决方案

不要看有那么多警告和配置内容，其实只需要把SPF配置完成，Gmail的发送就不成问题了。配置方法也很简单，就是在域名解析里加一条记录即可。

Gmail官网也给出了介绍：

但第一次也许你会跟我犯一样的错，就是直接用v=spf1 include:_spf.google.com ~all这个value了。。。其实应该要修改成你所用企业邮箱服务商的spf域名。

比如，DD这边用的是腾讯的企业邮箱，所以值要设置成：v=spf1 include:spf.mail.qq.com ~all。直观的讲，你的域名解析里需要有这样一条TXT记录：

SPF汇总

这边汇总一下，国内比较常用的企业邮箱SPF配置，如果您正好碰到类似问题，可以直接选取使用：

• 腾讯企业邮箱：v=spf1 include:spf.mail.qq.com ~all
• 阿里企业邮箱：v=spf1 include:spf.mxhichina.com -all
• 网易企业邮箱：v=spf1 include:spf.163.com -all

今天的分享就到这里，希望对您有所收获！码字不易，欢迎关注、收藏、分享，支持一下。本文可以任意转载，但请注明原文链接 ^_^

大家好，我是TJ

之前给大家推荐过好几款后台模版，都很受欢迎。今天继续再给大家推荐一款非常热门、广受好评的后台模版：tabler

tabler作为一款国外的开源项目，目前已经收获了34.9K Star，含金量非常高。它的主要特点总结如下：

• 响应式布局：支持移动、平板电脑和台式机显示器，无论您使用哪种设备。Tabler在所有主流浏览器中都能很好的展示内容。
• 跨浏览器支持：tabler与最新的Chrome、Firefox+、Safari、Opera、Edge和移动版本的浏览器都能完美兼容
• HTML5和CSS3：采用HTML5和CSS3实现，模版中还包括了一些微妙的CSS3动画，用户体验极佳
• 干净的代码：严格遵循Bootstrap开发标准，容易阅读，也更容易二次开发
• 丰富的演示：模版提供了丰富的掩饰内容，各种组件提供了20多个单独的页面，让您可以自由选择和组合。所有组件的颜色和样式都可能不同，您可以使用Sass轻松进行修改。
• 单页应用版本：tabler还有一个React版本，可以帮助你构建单页版本的应用

下面我们一起欣赏下tabler官方提供的demo：

最后，奉上相关地址，感兴趣的可以前往了解更多：

• 演示地址：https://preview.tabler.io/
• 开源项目：https://github.com/tabler/tabler
• React版本：https://github.com/tabler/tabler-react

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

在Java中，组织字符串是平时最常见的操作，这里总结一下Java自带的四种处理方式。

1. 使用+拼接

案例：

String name = "DD";
String host = "blog.didispace.com";
String result = "hello " + name + ", your blog is " + host;

这种方法很容易上手，甚至可以混合使用非字符串值来一起组织。然而，结果代码编写起来非常不易阅读和维护。最大的缺点是每次我们使用+运算符时都会分配一个新的字符串。所以，JDK中还提供了多种优化策略来减少字符串的创建，比如下面的方案2。在工作中，要尽量避免使用方案1，而是下面的方案。

2. 使用StringBuffer和SpringBuilder

案例：

String name = "DD";
String host = "blog.didispace.com";
String result = new StringBuilder()
    .append("hello ")
    .append(name)
    .append(", your blog is ")
    .append(host)
    .toString();

StringBuffer和StringBuilder是专门用于字符串连接的实现类，它们都提供了用于插入、替换和查找字符串的方法。但它们之间还有一定区别，StringBuffer是线程安全的，而StringBuilder则不是，所以在使用的时候要注意场景。

3. 使用String::format and String::formatted

案例：

String name = "DD";
String host = "blog.didispace.com";
String template = "hello %s, your blog is %s";
String result = format.formatter(name, host);

String类本身也提供了一些格式化方法，比如：

• static String format(String format, Object... args)
• static String format(Locale locale, String format, Object... args)
• String formatted(Object... args) (Java 15+)

这些方法是以模版的方式来实现字符串的拼接，可以有效地节省字符串创建的数量。

4. 使用java.text.MessageFormat

案例：

String name = "DD";
String host = "blog.didispace.com";
String result = MessageFormat.format("hello {0}, your blog is {1}", name, host);

MessageFormat类型与上面String本身自带的format有点类似，但语法风格上有很大的差别。MessageFormat的参数风格有点像slf4j，而String自带的format风格更像C语言中的print。

除了这些JDK自带的方案之外，还有很多开发者自己封装的处理方法，后面再总结一些优秀的封装，感兴趣的记得关注下程序猿DD或者收藏我的博客。

大家好，我是TJ

之前陆陆续续给大家推荐过很多后台管理模版了，但是模版这东西永远不嫌多，所以，今天再添一枚：vue-pure-admin

vue-pure-admin采用了当下最为流线的技术栈，其中主要包括：

• Vue3
• Vite
• Element-Plus
• TypeScript
• Pinia
• Tailwindcss

很多热门模版一般功能都特别强大，这也导致了内容非常多，但实际很多时候我们就只要一个主体内容就可以。所以，这里值得注意的是，vue-pure-admin还提供了一个精简版本，更适合直接引入到项目作为开发初始版本。

vue-pure-admin提供的精简版打包后全局引入（包含Element-Plus的情况下）才2.3MB的大小，再利用brotli压缩之后，甚至低于350kb，可谓是极致精简了！

该模版还贴心的提供了教程视频，简直是保姆级模版了，实属难得：

• 开发教程：https://www.bilibili.com/video/BV1kg411v7QT
• UI设计：https://www.bilibili.com/video/BV17g411T7rq

接下来一起欣赏下vue-pure-admin的效果吧：

这里就简单预览一下，其实还有更多有意思的组件展示，留给大家自己去探索吧！最后，奉上相关地址，喜欢的直接冲吧！

• 体验地址：https://yiming_chang.gitee.io/vue-pure-admin
• 开源地址：https://github.com/pure-admin/vue-pure-admin

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

大家好，我是TJ

对于个人建站来说，WordPress相信很多读者都知道了。但WordPress很多时候我们还是用来建立自主发布内容的站点为主，适用于个人博客、企业主站等。虽然有的主题可以把WordPress变为论坛，但效果并不是很好。

所以，今天给大家推荐一个开源的论坛项目：vanilla，有建站需求的小伙伴可以关注一下！

主要特性

• 重构了传统的论坛以迎合大众的需求。
• 灵活的主题机制
• 支持单点登录和嵌入式集成
• 强大的社区管理功能
• 插件机制，可以进一步扩展功能

下面通过图片来直观认识一下它：

论坛主页：

富文本编辑器：

Dashboard：

使用案例

vanilla的官网就是用vanilla构建的，所以感兴趣的用户可以直接通过访问官网来体验它的强大的功能：

看界面元素确实很符合现代论坛的用户需求吧。

最后，奉上相关地址，感兴趣的小伙伴可以冲了：

• 官网网站：https://open.vanillaforums.com/
• 开源地址：https://github.com/vanilla/vanilla

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

大家好，我是TJ君

作为一名开发者，有很多场景需要用到内网穿透，比如：我们在接入一些大平台做第三方应用时，在本地开发微信公众号工具的时候需要让微信平台能否访问到本地提供的接口。除此之外，还有很多其他场景，也会用到，比如：把放在家里的NAS或服务器暴露到公网上，这样在外面的时候也可以随时随地的访问。

说到内网传统，TJ君第一个想到的是国内最早的一款知名软件：花生壳。但是今天不是要推荐它，而是要推荐一个更牛的开源项目：frp！该项目目前已经收获了69.9 K Star，在GitHub上获得了极大的认可！

下载安装

frp目前已经提供了大部分操作系统的支持版本，通过这个链接：https://github.com/fatedier/frp/releases， 就可以下载到适合你使用的安装。

以Windows的包为例，解压后可以获得这些内容：

frps是服务端程序，frpc是客户端程序。ini文件就是对应的配置文件。

暴露内网服务

内网穿透的玩法有很多，这里列举一个比较常见的例子。

比如：我要暴露一个只有自己能访问到服务器。那么可以这样配置：

配置 frps.ini，并启动服务端 frps

[common]
bind_port = 7000

在需要暴露到外网的机器上部署 frpc，配置如下：

[common]
server_addr = x.x.x.x 
server_port = 7000

[secret_ssh]
type = stcp
# 只有 sk 一致的用户才能访问到此服务
sk = abcdefg
local_ip = 127.0.0.1
local_port = 22

在想要访问内网服务的机器上也部署 frpc，配置如下：

[common]
server_addr = x.x.x.x
server_port = 7000

[secret_ssh_visitor]
type = stcp
# stcp 的访问者
role = visitor
# 要访问的 stcp 代理的名字
server_name = secret_ssh
sk = abcdefg
# 绑定本地端口用于访问 SSH 服务
bind_addr = 127.0.0.1
bind_port = 6000

把frpc也都启动起来之后，通过 SSH 就可以访问内网机器了

ssh -oPort=6000 test@127.0.0.1

其他支持

除了上面的玩法之外，frp还有很多玩法，比如：

• 自定义域名访问内网的 Web 服务
• 转发 DNS 查询请求
• 转发 Unix 域套接字
• 对外提供简单的文件访问服务
• 为本地 HTTP 服务启用 HTTPS
• 点对点内网穿透

篇幅有限，具体如何配置这里就不多说了，有需要的读者可以直接查看官方文档，均有详细的服务端客户端配置案例。

最后，奉上相关链接：

开源地址：https://github.com/fatedier/frp/
文档地址：https://gofrp.org/docs/

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

最近因为要在系统里植入一个流程图的灵活绘制功能。如果说自己写一个，那必将是个庞大的工程，所以就在GitHub上调研了一番。最后发现了今天要给大家推荐的这个开源框架：LogicFlow

LogicFlow是一款流程图编辑框架，它提供了必要的流程图交互和编辑功能，同时还支持节点自定义和插件拓展。LogicFlow可以用于各种逻辑编排场景，例如流程图、ER图和BPMN流程。它在工作审批配置、机器人逻辑编排和无代码平台流程配置等方面都有广泛应用。

快速入门

LogicFlow的使用非常简单，只需要两步：

1. 引入依赖

<!--LogicFlow core包css-->
<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@logicflow/core/dist/style/index.css"
/>
<!--LogicFlow extension包css-->
<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@logicflow/extension/lib/style/index.css"
/>
<!--LogicFlow core包js-->
<script src="https://cdn.jsdelivr.net/npm/@logicflow/core/dist/logic-flow.js"></script>
<!--LogicFlow的插件支持单个引入，这里以菜单插件为例-->
<script src="https://cdn.jsdelivr.net/npm/@logicflow/extension/lib/Menu.js"></script>

也可以使用npm引入，只需要：

npm install @logicflow/core
npm install @logicflow/extension

2. 可以编写一个简单的案例

import LogicFlow from "@logicflow/core";
import "@logicflow/core/dist/style/index.css";

const lf = new LogicFlow({
  container: document.querySelector("#container")
});

lf.render({
  nodes: [
    {
      id: "node_id_1",
      type: "rect",
      x: 100,
      y: 100,
      text: {
        x: 100,
        y: 100,
        value: "节点1"
      },
      properties: {}
    },
    {
      id: "node_id_2",
      type: "circle",
      x: 200,
      y: 300,
      text: {
        x: 200,
        y: 300,
        value: "节点2"
      },
      properties: {}
    }
  ],
  edges: [
    {
      id: "edge_id",
      type: "polyline",
      sourceNodeId: "node_id_1",
      targetNodeId: "node_id_2",
      text: {
        x: 139,
        y: 200,
        value: "连线"
      },
      startPoint: {
        x: 110,
        y: 140
      },
      endPoint: {
        x: 200,
        y: 250
      },
      pointsList: [
        {
          x: 100,
          y: 140
        },
        {
          x: 100,
          y: 200
        },
        {
          x: 200,
          y: 200
        },
        {
          x: 200,
          y: 250
        }
      ],
      properties: {}
    }
  ]
});

这里不得不提一下，LogicFlow提供了一个工具，可以帮助大家所见即所得的绘图，效果如下：

工具地址：https://codesandbox.io/s/logicflow-example-1-zy3o85?file=/step1/index.js:0-1170

最后，奉上最关键的几个传送门：

• 开源项目：https://github.com/didi/LogicFlow
• 案例地址：https://site.logic-flow.cn/examples/#/gallery

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

一个好企业，应该有完善的个人成长体系。每一个员工在为公司付出的时候，个人也能不断的成长。相信这是每个打工人希望遇到的，但要做好这一切并不容易。

如果您正在搭建公司的成长培训体系，那么今天的推荐也许可以助你一臂之力！

今天要推荐的开源项目名为：PlayEdu

这是一款适用于搭建内部培训平台的开源系统，旨在为企业/机构打造自己品牌的内部培训平台。

PlayEdu 基于 Java + MySQL 开发，采用前后端分离模式，前台采用 React18 为核心框架，后台采用 SpringBoot3 为核心框架。

功能体验

该开源项目提供了体验版DEMO，感兴趣的小伙伴可以直接通过下面的链接体验一下该项目的功能：

• 学员端入口：https://demo.playedu.xyz，账号：1@playedu.xyz 密码；123123
• 管理端入口：https://admin.playedu.xyz，账号：admin@playedu.xyz 密码：123123

您也可以直接通过下面的截图了解一二：

相关链接

如果该项目对您有用，可以直接通过下面的了解更多！

• 开源地址：https://github.com/PlayEdu/PlayEdu

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！

今天给大家推荐一个桌面工具：GitHub Desktop

看名字就知道，这是一个GitHub的客户端程序，但这个是新版的客户端，相信很多小伙伴还没有用过。该版本的GitHub Desktop要比之前的更加强大，因为该版本的目标是：无论您是Git新手还是经验丰富的用户，GitHub Desktop都可以简化您的开发工作流程！

通过使用GitHub Desktop可以让你：

1. 更轻松的与协作者一起提交代码

使用客户端程序，可以快速的添加协作者到您的commit中。这个小功能可以帮助你在提交代码的时候，给那些帮助过你的协作者们表达感谢。同时，在Commit历史页面上，大家也可以看到这些协作者的信息：

2. 更方便地检出PR分支和查看CI状态

通过客户端程序，用户可以看到所有的PR，并且可以方便地检出分支到本地。同时，还能当PR通过的时候，还能查看CI状态。

3. 高亮查看文件差异

新版GitHub桌面支持在查看各种不同语言的差异时突出显示语法。

是不是跃跃欲试了呢？那就通过下面的链接快来试试吧：

• 官方网站：https://desktop.github.com/
• 开源地址：https://github.com/desktop/desktop

欢迎扫描下方二维码，关注公众号：TJ君，订阅每日推荐，获取更多好用效率工具！