小菜鸟

java菜鸟号正在起航

0%

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 14k 阅读时长 ≈ 12 分钟

Spring MVC 参数解析详解：按请求格式分类的原理与实践

Spring MVC 的参数解析机制是连接 HTTP 请求与 Controller 方法参数的核心桥梁，不同的请求格式（如表单、JSON、URL 路径参数、文件）对应不同的解析逻辑、注解和参数处理器。从 “格式特点→接收方式→参数处理器→底层原理→实战示例” 五个维度，系统解析 Spring MVC 如何将请求数据绑定到方法参数。

application/x-www-form-urlencoded：传统表单 / URL 编码格式

这是最经典的请求格式，适用于表单提交或URL 查询字符串（如 ?name=张三&age=25），数据以键值对形式传输，且会进行 URL 编码（如空格转为 %20）。

1. 格式特点

  • 数据位置：URL 查询字符串（?key=value）或请求体（表单提交时）；
  • 数据结构：扁平键值对（不支持嵌套对象，如 user.name 需拆分为 user.name=张三）；
  • 编码方式：URL 编码（ASCII 字符外的内容转为 %XX 格式）。

2. 接收方式与参数处理器

根据参数类型（单个参数 / 对象），Spring MVC 会使用不同的参数处理器：

接收场景 注解 / 方式 核心参数处理器 适用场景
单个 / 多个简单参数 @RequestParam RequestParamMapMethodArgumentResolver 接收零散的键值对（如 name、age）
复杂对象参数 无注解（直接用对象接收） ServletModelAttributeMethodProcessor 接收多个键值对，自动封装为 Java 对象（如 User）

3. 底层解析原理

（1）单个参数解析（@RequestParam + RequestParamMapMethodArgumentResolver）
阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 3.3k 阅读时长 ≈ 3 分钟

多平台 SSH 配置：同时管理 GitHub、Gitee、GitLab 等仓库

在开发过程中，我们常常需要同时连接多个代码托管平台（如 GitHub、Gitee、GitLab 等），而每个平台通常需要独立的 SSH 密钥对以确保安全访问。本文将详细介绍如何在同一台设备上配置多个平台的 SSH 密钥，实现无冲突共存和便捷访问。

核心原理

SSH 协议通过密钥对（公钥 + 私钥）验证身份，不同平台的密钥对需要区分存储。通过配置 ~/.ssh/config 文件，可以为不同平台指定对应的密钥，实现 “一平台一密钥” 的隔离管理，避免密钥冲突。

详细配置步骤

1. 生成各平台独立的 SSH 密钥对

使用 ssh-keygen 命令为每个平台生成独立的密钥对，通过 -f 参数指定存储路径和文件名（避免默认文件名 id_rsa 导致覆盖）。

示例（以 GitHub、Gitee、GitLab 为例）：
1
2
3
4
5
6
7
8
# 生成 GitHub 密钥对（邮箱替换为你的 GitHub 绑定邮箱）
ssh-keygen -t ed25519 -C "your_github_email@example.com" -f ~/.ssh/id_rsa_github

# 生成 Gitee 密钥对（邮箱替换为你的 Gitee 绑定邮箱）
ssh-keygen -t ed25519 -C "your_gitee_email@example.com" -f ~/.ssh/id_rsa_gitee

# 生成 GitLab 密钥对（邮箱替换为你的 GitLab 绑定邮箱）
ssh-keygen -t ed25519 -C "your_gitlab_email@example.com" -f ~/.ssh/id_rsa_gitlab
  • 说明：
    • ed25519 是比 rsa 更安全高效的算法，推荐使用（若系统不支持，可替换为 rsa）。
    • 生成过程中会提示设置密码（passphrase），建议设置以增强安全性，回车则为空密码。
    • 执行后，~/.ssh 目录下会生成对应文件（如 id_rsa_github 私钥、id_rsa_github.pub 公钥）。

2. 将私钥添加到 SSH 代理（可选但推荐）

为避免每次访问仓库都输入密钥密码，可通过 ssh-agent 管理私钥：

1
2
3
4
5
6
7
8
9
10
# 启动 SSH 代理
eval "$(ssh-agent -s)"

# 添加各平台私钥
ssh-add ~/.ssh/id_rsa_github
ssh-add ~/.ssh/id_rsa_gitee
ssh-add ~/.ssh/id_rsa_gitlab

# 验证私钥是否添加成功
ssh-add -l  # 列出所有已加载的私钥
  • 注意：
    若重启终端后私钥失效，需重新执行上述命令，或配置终端启动脚本自动加载（如 ~/.bashrc 或 ~/.zshrc 中添加 eval "$(ssh-agent -s)" 和 ssh-add 命令）。

3. 配置 ~/.ssh/config 文件

创建或编辑 ~/.ssh/config 文件，为每个平台指定对应的密钥和访问规则，格式如下：

阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 3.8k 阅读时长 ≈ 3 分钟

Zookeeper 作为服务注册中心：实现与特性解析

Zookeeper 是一个分布式协调服务，常被用作微服务架构的注册中心。与 Eureka 不同，Zookeeper 本身就是一个独立的服务端，无需额外开发注册中心服务，只需在微服务中集成客户端即可实现服务注册与发现。

Zookeeper 注册中心的核心优势

  • 强一致性：基于 ZAB 协议（类 Paxos 算法），保证服务注册信息在集群中的一致性；
  • 临时节点特性：服务实例以临时节点注册，服务下线或崩溃时自动删除，无需手动清理；
  • 分布式协调能力：支持节点监听（Watch）机制，服务消费者可实时感知服务实例变化；
  • 成熟稳定：广泛应用于分布式系统，如 Kafka、Hadoop 等，可靠性经过验证。

集成 Zookeeper 注册中心的步骤

1. 引入依赖

在 Spring Boot 项目中添加 Zookeeper 服务发现依赖：

阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 3.8k 阅读时长 ≈ 3 分钟

JVM 参数全解析：从基础配置到高级调优

JVM 参数是控制 JVM 运行行为的核心手段，合理配置参数能显著提升应用性能、避免内存溢出等问题。JVM 参数分为标准参数、非标准参数（-X 开头）和非标准化参数（-XX 开头），本文将系统梳理常用参数的分类、作用及配置方式，帮助开发者根据场景选择合适的参数。

JVM 参数类型

标准参数（稳定，跨版本兼容）

以 - 开头，如 java -version、java -classpath 等，本文不重点展开。

非标准参数（-X 开头，半稳定）

由 JVM 实现定义，可能随版本变化，常用参数如下：

参数 作用描述
-Xmixed 混合模式执行（解释器 + JIT 编译，默认启用）
-Xint 仅使用解释器执行（禁用 JIT，适合调试）
-Xbootclasspath 设置引导类加载路径（如指定自定义核心类库）
-Xms<size> 初始堆内存（等价于 -XX:InitialHeapSize，如 -Xms2g）
-Xmx<size> 最大堆内存（等价于 -XX:MaxHeapSize，如 -Xmx4g）
-Xss<size> 线程栈大小（等价于 -XX:ThreadStackSize，如 -Xss1m）
-Xloggc:<file> 将 GC 日志写入文件（带时间戳，如 -Xloggc:gc.log）

非标准化参数（-XX 开头，不稳定，最常用）

用于精细控制 JVM 内部行为，分为两类：

  • Boolean 类型：-XX:+<option>（启用）、-XX:-<option>（禁用），如 -XX:+PrintGCDetails。
  • KV 类型：-XX:<option>=<value>，如 -XX:NewRatio=2。

常用 JVM 参数详解

参数查看与调试

参数 作用描述
-XX:+PrintCommandLineFlags 程序启动前打印手动或自动设置的 -XX 参数
-XX:+PrintFlagsInitial 打印所有 -XX 参数的默认初始值
-XX:+PrintFlagsFinal 打印运行时生效的 -XX 参数值（最终值）
-XX:+PrintVMOptions 仅打印用户设置的 JVM 参数

堆内存配置（核心）

堆内存是 JVM 管理的核心区域，参数直接影响 GC 效率和内存利用率：

阅读全文 »

发表于 更新于 分类于 阅读次数： Valine：
本文字数： 5.8k 阅读时长 ≈ 5 分钟

Maven 自定义插件开发全指南：从实现到应用

Maven 插件是扩展 Maven 功能的核心方式，通过自定义插件，你可以将团队特有的构建逻辑、检查规则或部署流程集成到 Maven 生命周期中。本文将详细介绍如何开发、打包和使用自定义 Maven 插件。

自定义插件的核心概念

  • Mojo：Maven 插件的最小执行单元（类似 “目标”），每个插件包含一个或多个 Mojo，每个 Mojo 对应一个具体功能（如代码检查、自定义打包）。
  • 插件打包类型：自定义插件必须使用 <packaging>maven-plugin</packaging> 声明。
  • 注解驱动：通过 @Mojo 注解定义 Mojo 元信息，@Parameter 注解声明可配置参数。

开发自定义插件的步骤

1. 创建插件项目

新建一个 Maven 项目，修改 pom.xml 如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.zhanghe.study</groupId>
    <artifactId>test-maven-plugin</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>maven-plugin</packaging> <!-- 插件必须使用此打包类型 -->

    <name>Test Maven Plugin</name>
    <description>A custom Maven plugin example</description>

    <dependencies>
        <!-- 插件核心依赖 -->
        <dependency>
            <groupId>org.apache.maven</groupId>
            <artifactId>maven-plugin-api</artifactId>
            <version>3.8.6</version> <!-- 推荐使用较新版本 -->
        </dependency>
        <!-- 注解处理器（简化 Mojo 配置） -->
        <dependency>
            <groupId>org.apache.maven.plugin-tools</groupId>
            <artifactId>maven-plugin-annotations</artifactId>
            <version>3.6.4</version>
            <scope>provided</scope> <!-- 编译时依赖 -->
        </dependency>
    </dependencies>
</project>

2. 实现 Mojo 类

每个 Mojo 类需继承 AbstractMojo 并实现 execute() 方法，通过注解定义元信息和参数。

示例：创建一个打印版本信息的 Mojo：

阅读全文 »