Java - tag - 沐木https://oldletter.cn/tags/java/Java - tag - 沐木Hugo -- gohugo.iozh-cnSat, 11 Jul 2026 00:00:00 +0000信创实战：Java 服务管理脚本（生产级）https://oldletter.cn/posts/xinchuang-03-java-service-script/Thu, 10 Apr 2025 00:00:00 +0000mumuhttps://oldletter.cn/posts/xinchuang-03-java-service-script/

系列：信创国产化适配 | 作者：lin | 日期：2026-05-15

一、背景与问题

1.1 为什么需要专业的 Java 服务管理脚本

在很多项目中，Java 服务的启动方式还停留在：

# ❌ 野蛮启动方式
nohup java -jar app.jar > app.log 2>&1 &
echo $! > app.pid

这种方式存在诸多问题：

问题 影响
进程意外退出后无法自动重启 服务不可用，需人工介入
停止服务直接 kill -9 数据丢失、连接池未关闭
没有 PID 管理 重复启动、僵尸进程
日志输出到 nohup.out 日志无法轮转，磁盘被打满
无法集成 systemd 不符合 Linux 服务管理规范
每次部署手动操作 容易出错，效率低下

1.2 设计目标

我们要实现一个生产级的 Java 服务管理脚本，满足以下要求：

  1. 自动检测 Java：JAVA_HOME → 常见安装路径 → PATH，三级探测
  2. 自动识别 jar：无需硬编码 jar 文件名
  3. 首次部署兼容：自动创建目录结构、移动配置文件
  4. systemd 集成：一键安装/卸载系统服务
  5. 受控停机：发送 SIGTERM 并等待，超时后再由策略决定是否发送 SIGKILL
  6. PID 文件管理：防止重复启动，精确控制进程

二、JVM 堆内存分配公式

在配置 JAVA_OPTS 之前，理解 JVM 内存分配至关重要：

]]>Java Stream 实用技巧：List 与 Map 的花式转换https://oldletter.cn/posts/java-05-stream-utils/Thu, 03 Jun 2021 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-05-stream-utils/前言

Java 8 引入的 Stream API 彻底改变了我们处理集合数据的方式。相比传统的 for 循环，Stream 提供了声明式、链式、可组合的数据处理风格，代码更简洁，意图更清晰。

在日常开发中，我们经常面对这样的场景：从数据库查出一个 List<Map>，需要转成按某个 key 分组的 Map；两个接口返回的列表需要按 id 合并；或者需要对字段做批量转换。这些需求用 Stream 几行代码就能搞定，而传统写法往往要写一堆临时变量和嵌套循环。

本文整理了 7 个实用的 Stream 技巧，每个都附带完整可运行的示例代码，希望能帮助你在实际项目中写出更优雅的集合操作。

一、List 转 Map（key 冲突处理）

基础也常见的操作。假设有一个用户列表，需要按 id 建索引：

import java.util.*;
import java.util.stream.*;

List<Map<String, Object>> users = new ArrayList<>();
users.add(new HashMap<String, Object>() {{ put("id", 1L); put("name", "Alice"); }});
users.add(new HashMap<String, Object>() {{ put("id", 2L); put("name", "Bob"); }});
users.add(new HashMap<String, Object>() {{ put("id", 3L); put("name", "Charlie"); }});

// 基本转换
Map<Long, Map<String, Object>> result = users.stream()
    .collect(Collectors.toMap(
        m -> (Long) m.get("id"),   // key mapper
        m -> m                      // value mapper
    ));

System.out.println(result);
// {1={name=Alice, id=1}, 2={name=Bob, id=2}, 3={name=Charlie, id=3}}

踩坑提示：如果 key 有重复，toMap 会抛 IllegalStateException。解决方案是提供第三个参数，合并函数：

]]>Lombok 进阶指南：从注解原理到 Spring Boot 最佳实践https://oldletter.cn/posts/java-01-lombok/Mon, 20 Mar 2023 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-01-lombok/

📅 2026-05-15 | 🏷️ Java, Lombok, Spring Boot | 📖 阅读约 15 分钟

前言

Lombok 大家都在用，但你真的用对了吗？

很多团队把 Lombok 当成"少写 getter/setter 的工具"，结果在生产环境踩了一堆坑：@Data 导致的 StackOverflowError、序列化失败、MapStruct 不兼容……

这篇文章并非入门教程，重点是进阶实战指南，我会从注解的底层原理讲起，结合 Spring Boot 3.x 工程实践，帮你避开那些"写了半天 debug 两小时"的坑。

适合读者：有 Lombok 基础使用经验，想深入了解原理和成熟实践的 Java 开发者。

版本说明
本文以 Lombok 1.18.x 的常见行为为基准。Spring Boot 3.x + JDK 17/21 用户请参考第五节的兼容性说明；如果使用更高版本 JDK，记得同步升级 Lombok，否则很容易在编译期踩坑。

一、基础核心注解的"隐藏陷阱"

1.1 @Data：方便但危险

@Data 是 Lombok 更常用的注解，它等价于 @Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor。听起来很美好，但问题恰恰出在这个"全家桶"上。

]]>Maven 国内源配置指南（2026 版）https://oldletter.cn/posts/java-02-maven/Wed, 24 Nov 2021 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-02-maven/

📅 2026-05-15 | 🏷️ Maven, Gradle, 信创, DevOps | 📖 阅读约 12 分钟

前言

“Could not resolve dependencies”，这大概是每个 Java 开发者在国内网络环境下更不想看到的错误。

Maven Central 在国内访问速度慢、不稳定，尤其在企业内网和信创环境下，配置国内镜像源几乎是项目初始化的第一步。但你真的会配吗？镜像优先级怎么算？私服和镜像怎么共存？Gradle 的配置和 Maven 有什么不同？

这篇文章给你一个完整的、可直接复制粘贴的配置方案，覆盖 Maven、Gradle、私服、代理、信创环境，2026 年当前公开版。

一、为什么需要国内镜像

Maven Central（https://repo.maven.apache.org/maven2）物理上在美国，国内访问存在以下问题：

  1. 延迟高：HTTPS 握手 + TCP 往返，单次请求 500ms-2s
  2. 不稳定：国际链路抖动，下载大文件容易中断
  3. 带宽受限：高峰期下载速度可能只有几十 KB/s
  4. 安全合规：信创/政企环境不允许直接访问外网

国内镜像源同步了 Maven Central 的所有包，物理上在国内，访问速度提升 10-100 倍。

Maven 依赖解析机制

Maven 的依赖解析遵循下限路径优先原则。当同一个依赖存在多个版本时，Maven 会在依赖树中选择深度更浅（路径下限）的那个版本。如果深度相同，则按 POM 中声明的顺序选择第一个。

形式化地说，对于依赖树中的节点 D，其解析版本为所有候选版本中深度下限的那个。因此直接声明的依赖优先级高于传递依赖。

二、Maven 配置

2.1 settings.xml 完整配置

将以下内容保存到 ~/.m2/settings.xml（全局配置）或 $MAVEN_HOME/conf/settings.xml（安装级别）：

]]>PDF 模板生成实战：iText 5.x/9.x 方案对比与开源替代https://oldletter.cn/posts/java-03-pdf-template/Thu, 15 Jun 2023 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-03-pdf-template/

📅 2026-05-15 | 🏷️ Java, PDF, iText, OpenPDF, PDFBox | 📖 阅读约 15 分钟

一、背景与问题

在企业级应用中，大量业务文档需要模板化生成：保单、合同、告知书、发票、审批单……这些文档有三个共同特征：

  1. 格式固定 — 排版、字体、Logo 位置都是确定的
  2. 内容动态 — 姓名、金额、日期等字段每次不同
  3. 批量生产 — 高峰期可能一次生成数千份

常见做法是：先用 Word 制作模板 → 用 Java 填充数据 → 输出 PDF。

本文对比两种主流方案，给出完整代码和踩坑记录。

A4 页面尺寸公式

PDF 中常用的 A4 页面尺寸为 210mm × 297mm。在 iText 中使用 point（磅）为单位，换算关系：1 inch = 72 pt = 25.4 mm。

因此 A4 的磅值为：宽 595.28 pt，高 841.89 pt。

]]>常用工具类汇总：SM2/SM4/拼音/文件/HTTP 全覆盖https://oldletter.cn/posts/java-04-utils/Fri, 10 Oct 2025 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-04-utils/

📅 2026-05-15 | 🏷️ Java, 工具类, 国密, Hutool | 📖 阅读约 18 分钟

一、背景

多年项目中积累了不少高频使用的工具代码。它们不算复杂，但每次要用的时候都得翻老项目找，效率很低。这篇文章把它们整理出来，统一收录，方便查阅和复用。

每个工具都包含：使用场景 → 完整代码 → 调用示例。

不要重复造轮子

在动手写工具类之前，先看看成熟库是否已经提供了：

  • Hutool 5.8.44（2026-03-11）：国人开发的 Java 工具库，覆盖字符串、日期、加密、HTTP、JSON 等 90% 的工具需求，API 简洁
  • Apache Commons：commons-lang3、commons-io、commons-collections 等，稳定可靠
  • Guava：Google 的 Java 工具库，集合、缓存、并发工具强大

本文在每个工具节的末尾都会给出"成熟库替代方案"，优先使用成熟库，只在特定需求时手写。

二、字符串工具

2.1 中文姓名转拼音生成邮箱账号

场景： 新员工入职系统自动生成企业邮箱，规则是"名.姓@company.com"，需要支持复姓（如诸葛孔明 → kongming.zhuge@company.com）。

import cn.hutool.extra.pinyin.PinyinUtil;

import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;

/**
 * 中文姓名转拼音邮箱账号工具
 *
 * 支持：
 * - 单姓：张三 → san.zhang
 * - 复姓：诸葛孔明 → kongming.zhuge
 * - 单名：张伟 → wei.zhang
 */
public class PinyinEmailUtil {

    /**
     * 中国常见复姓集合（可根据需要扩充）
     */
    private static final Set<String> COMPOUND_SURNAMES = new HashSet<>(Arrays.asList(
            "欧阳", "太史", "端木", "上官", "司马", "东方", "独孤", "南宫",
            "万俟", "闻人", "夏侯", "诸葛", "尉迟", "公羊", "赫连", "澹台",
            "皇甫", "宗政", "濮阳", "公冶", "太叔", "申屠", "公孙", "慕容",
            "仲孙", "钟离", "长孙", "宇文", "司徒", "鲜于", "司空", "闾丘",
            "子车", "亓官", "司寇", "巫马", "公西", "颛孙", "壤驷", "公良",
            "漆雕", "乐正", "宰父", "谷梁", "拓跋", "夹谷", "轩辕", "令狐",
            "段干", "百里", "呼延", "东郭", "南门", "羊舌", "微生", "公户",
            "公玉", "公仪", "梁丘", "公仲", "公上", "公门", "公山", "公坚",
            "左丘", "公伯", "西门", "公祖", "第五", "公乘", "贯丘", "公皙",
            "南荣", "东里", "东宫", "仲长", "子书", "子桑", "即墨", "达奚",
            "褚师"
    ));

    /**
     * 将中文姓名转换为拼音邮箱账号
     *
     * @param chineseName 中文姓名（如 "诸葛孔明"）
     * @param domain      邮箱域名（如 "company.com"）
     * @return 邮箱账号（如 "kongming.zhuge@company.com"）
     */
    public static String toEmail(String chineseName, String domain) {
        if (chineseName == null || chineseName.length() < 2) {
            throw new IllegalArgumentException("姓名至少需要2个字符");
        }

        String surname;
        String givenName;

        // 判断是否为复姓（取前两个字匹配）
        String firstTwo = chineseName.substring(0, 2);
        if (COMPOUND_SURNAMES.contains(firstTwo)) {
            surname = firstTwo;
            givenName = chineseName.substring(2);
        } else {
            surname = chineseName.substring(0, 1);
            givenName = chineseName.substring(1);
        }

        // 转拼音（去掉声调，转小写）
        String surnamePinyin = PinyinUtil.getPinyin(surname, "");
        String givenNamePinyin = PinyinUtil.getPinyin(givenName, "");

        return givenNamePinyin + "." + surnamePinyin + "@" + domain;
    }

    /**
     * 仅生成邮箱前缀（不含域名）
     */
    public static String toEmailPrefix(String chineseName) {
        String prefix = toEmail(chineseName, "").replace("@", "");
        // 去除末尾可能多余的点号
        if (prefix.endsWith(".")) {
            prefix = prefix.substring(0, prefix.length() - 1);
        }
        return prefix;
    }
}

使用示例：

]]>问卷考试系统设计（二）：题目 DSL 设计——用 JSON 描述一切题型https://oldletter.cn/posts/qnr-02-dsl-design/Sun, 05 Apr 2026 00:00:00 +0000mumuhttps://oldletter.cn/posts/qnr-02-dsl-design/上一篇：问卷考试系统设计（一）：架构选型与数据模型

上一篇聊了整体架构和数据模型，这篇讲整个系统核心的部分：怎么用一套统一的 JSON 结构，把单选、多选、量表、矩阵、排序、填空……所有题型都描述清楚。然后让引擎把这些 JSON 跑起来，条件跳题、题目分组、随机排序，这些才是让问卷从"能编辑"变成"能填写"的关键。

为什么用 JSON 而不是多张表

传统建模的麻烦

直观的做法，每种题型一张表：

CREATE TABLE question_single_choice (
    id BIGINT PRIMARY KEY, stem TEXT,
    option_a TEXT, option_b TEXT, option_c TEXT, option_d TEXT,
    correct_answer VARCHAR(10)
);
CREATE TABLE question_likert (
    id BIGINT PRIMARY KEY, stem TEXT,
    scale_type VARCHAR(20), is_reverse BOOLEAN
);
-- 10 种题型 10 张表……

问题很明显：

]]>API 鉴权实战（一）：AK/SK、API Key、RBAC 与统一认证授权架构设计https://oldletter.cn/posts/api-auth-01-aksk-rbac/Tue, 10 Sep 2024 00:00:00 +0000mumuhttps://oldletter.cn/posts/api-auth-01-aksk-rbac/

作者：林 | 系列：API 鉴权实战 | 适合读者：Java 后端/架构师

本文代码使用 Lombok 简化 POJO，所有 getter/setter/builder 均由 Lombok 自动生成。

<!-- pom.xml -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>provided</scope>
</dependency>

一、背景：为什么要做 API 鉴权

对外暴露 API 时，两个核心问题绕不开：

  1. 调用方是谁？（认证，Authentication）
  2. 他能做什么？（授权，Authorization）

简单的内部系统可能用一个 API Key 就够了。但当系统开始支持多租户、第三方接入、AI 开放平台、文件上传、额度控制时，单一的鉴权方式撑不住。你需要一套完整的体系：从密钥管理到权限判断，从缓存设计到上下文传递。

本文从更基础的 API Key 讲起，逐步构建到 PDP 策略决策点，把认证授权的全链路打通。

二、五种鉴权方式详解

2.1 API Key

原理： 给每个调用方分配一个唯一的密钥字符串，请求时放在 Header 里，服务端查库校验。

适用场景： 内部服务间调用、快速原型、低安全要求的公开 API。

不适用场景： 对外开放的 API，API Key 是静态的，明文传输，一旦被截获攻击者就能冒充调用方。

]]>Java 为什么不能直接解析 Lambda？从一个 ORM 查询说起https://oldletter.cn/posts/java-lambda-parse-01-why/Wed, 10 Jun 2026 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-lambda-parse-01-why/

📅 2026-06-10 | 🏷️ Java, Lambda, JVM | 📖 阅读约 15 分钟

问题起源

做 Java ORM 的时候，更让人羡慕的就是 C# 的 LINQ：

// C# — 直接写 Lambda，框架自动转 SQL
var users = await context.Users
    .Where(u => u.Age > 18 && u.Name == "Tom")
    .OrderBy(u => u.Id)
    .ToListAsync();

我们也想在 Java 里这么写：

// 理想中的 Java ORM 写法
query.where(u -> u.getAge() > 18 && u.getName().equals("Tom"));

但试了一下就发现，Java 运行时核心拿不到 Lambda 里面的结构。u -> u.getAge() > 18 这个表达式，运行时只能执行它（传一个 User 进去，返回 true/false），但拿不到"age > 18"这个结构信息。

]]>编译期方案：用 SerializedLambda 和注解处理器提取属性名https://oldletter.cn/posts/java-lambda-parse-02-compile-time/Wed, 10 Jun 2026 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-lambda-parse-02-compile-time/

📅 2026-06-10 | 🏷️ MyBatis Plus, QueryDSL, SerializedLambda, APT | 📖 阅读约 25 分钟

前言

上一篇说了 Java 的 Lambda 编译后丢失了 AST 信息，不能类似 C# 一样直接解析。但框架开发者们没有放弃，而是找到了其他办法。

这一篇讲两种编译期方案：它们不解析 Lambda 本身，而是利用 Java 的其他机制来提取属性信息。

  • 方案 1: SerializedLambda — MyBatis Plus 用的方式，从方法引用中提取 getter 方法名
  • 方案 2: Annotation Processor — QueryDSL 用的方式，编译期扫描实体字段，生成元模型类

方案 1: SerializedLambda（MyBatis Plus 路线）

发现过程

这个方案的关键发现是：当一个 Lambda 表达式实现了 Serializable 接口时，Java 编译器会额外生成一个 writeReplace() 方法。

这个方法返回一个 SerializedLambda 对象，里面包含了：

  • implClass — 实现方法所在的类名
  • implMethodName — 实现方法的方法名
  • implMethodSignature — 方法签名
  • capturedArgCount — 捕获的外部变量数量

对于 User::getAge 这种方法引用，implMethodName 就是 "getAge"，这就是我们要的属性信息。

]]>