Java MethodHandles.empty 怎样构造接受参数但不执行操作的方法句柄
来源:17golang原创
时间:2026-11-18 17:30:39 387浏览 收藏
在做方法句柄适配时,有一种很具体的需求:调用方要求一个完整签名,但某个分支暂时什么都不做。MethodHandles.empty 就是为这个场景准备的工厂方法。先用 MethodType 描述返回类型和参数列表,再把它交给 empty,得到的句柄会保留这个签名、忽略所有参数、不产生操作,并按返回类型给出默认值。
官方参考:https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/invoke/MethodHandles.html
empty(type)不是“没有参数的句柄”,而是“目标类型完整存在、调用参数被忽略”的 no-op 句柄。返回类型是 primitive 时得到零值,引用类型得到null,返回类型是void时不返回值。
先把目标签名写成 MethodType
MethodHandles.empty 接收的不是一串 Class 参数,而是一个 MethodType。因此第一步不是急着创建句柄,而是先把“返回什么、接受哪些参数”写清楚。下面的例子描述一个接收 String 和 int、返回 long 的方法类型。
import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;
public class EmptyHandleDemo {
public static void main(String[] args) throws Throwable {
// 返回 long,参数依次为 String 和 int;参数列表不能使用 void.class。
MethodType signature = MethodType.methodType(
long.class,
String.class,
int.class
);
// empty 保留 signature 的类型,但调用时不会使用两个参数。
MethodHandle noOp = MethodHandles.empty(signature);
// invokeExact 要求调用点的静态签名与句柄类型精确一致。
long result = (long) noOp.invokeExact("ignored", 7);
System.out.println(result); // 结果语义是 long 的默认值 0。
}
}

这里的 String 和 int 仍然属于句柄类型的一部分。它们只是调用时被丢弃,并没有从签名里消失。也正因为签名保持不变,empty 才能作为一个已有接口的占位实现,接到需要固定方法类型的组合器上。
empty 返回什么:零值、null 还是 void
理解这个 API 的关键在返回类型。官方定义把结果分成三类:primitive 返回对应的零值,引用返回 null,void 则没有返回值。参数多少不会改变这个结论,参数只影响句柄的类型。
| 目标返回类型 | 调用结果 | 适合表达的含义 |
|---|---|---|
int、long、double 等 primitive | 对应零值 | 提供类型兼容的空分支 |
String、对象或数组 | null | 表示没有生成引用结果 |
void | 无返回值 | 提供纯 no-op 调用点 |
import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;
final class EmptyDefaults {
static void showDefaults() throws Throwable {
// 同一组输入参数可以分别搭配三种返回类型,观察 empty 的默认语义。
MethodHandle intHandle = MethodHandles.empty(
MethodType.methodType(int.class, String.class)
);
MethodHandle refHandle = MethodHandles.empty(
MethodType.methodType(String.class, String.class)
);
MethodHandle voidHandle = MethodHandles.empty(
MethodType.methodType(void.class, String.class)
);
int intValue = (int) intHandle.invokeExact("ignored");
String refValue = (String) refHandle.invokeExact("ignored");
voidHandle.invokeExact("ignored");
// 这里的判断只展示返回类型语义,不代表业务一定要接受 null。
System.out.println(intValue == 0);
System.out.println(refValue == null);
System.out.println("void handle invoked");
}
}

如果调用方把 null 当成“业务上有值但暂时为空”,就要在组合层额外设计状态含义;empty 只保证 Java 方法句柄层面的默认返回,不会替你补充业务对象,也不会执行参数上的副作用。
把 empty 放进条件组合时,为什么它很合适
官方 API 文档给出的典型用途是给 guardWithTest 提供一个空分支:条件成立时调用目标句柄,条件不成立时什么都不做。关键点是 fallback 仍然要和 target 具有兼容的类型,所以直接使用 empty(target.type()) 比手工拼一个不同签名的常量句柄更稳妥。
import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
final class GuardedNoOp {
static MethodHandle noOpFallback(MethodHandle target) {
// 使用 target.type() 保留完全相同的参数和返回类型,避免组合时类型不匹配。
return MethodHandles.empty(target.type());
}
}
这里没有把谓词、目标句柄或运行结果伪装成已执行的示例;要点只是组合接口的类型关系。实际拼接 guardWithTest 时,还需要让谓词的参数和返回类型满足该组合器的要求。
迁移时别把 empty、zero 和 identity 混在一起
从旧的反射适配代码迁移到 MethodHandle 时,下面三个方法最容易被混用。
| 方法 | 参数形状 | 返回或行为 |
|---|---|---|
empty(MethodType) | 可以有多个参数 | 忽略参数,返回返回类型的默认值 |
zero(Class) | 没有参数 | 返回指定类型的默认值;可视为 empty(methodType(type)) |
identity(Class) | 只有一个参数 | 原样返回这个参数,不是 no-op 空分支 |
dropArguments | 基于已有 target | 丢弃新增的 dummy 参数后继续调用 target |
一个实用判断是:如果需要“同样的签名,但什么都不做”,优先考虑 empty;如果只需要“无参数地拿一个默认值”,看 zero;如果必须保留输入值,就应该看 identity。dropArguments 虽然也会丢弃参数,但它最终仍会调用已有 target,不能把它等同于无副作用的空句柄。
一份适合迁移回归的最小清单
- 先确认
MethodType的返回类型和参数顺序与调用点一致。 - 确认参数列表没有
void.class,返回类型才是void.class时才表达无返回值。 - 调用
invokeExact时,让调用点的静态返回类型和参数类型与句柄完全一致。 - 分别覆盖 primitive、引用和
void返回类型,记录零值、null和无返回值的预期。 - 组合条件分支时使用目标句柄的
type()创建 fallback,避免只匹配返回值却遗漏参数。 - 确认空句柄没有被误当成
identity;它不会读取、修改或回传输入参数。
常见疑问
MethodHandles.empty 会创建一个没有参数的句柄吗?
不会。它按照传入的 MethodType 保留参数列表,只是在调用时忽略这些参数。
返回对象类型时一定是一个空对象吗?
不是。引用返回类型的结果是 null,不会自动创建对象实例。
参数会不会被读取或触发副作用?
不会。empty 的定义是忽略参数并不做操作;如果业务需要校验、记录或转换参数,应使用真正的目标句柄或组合器。
迁移这类适配代码时,可以把结论压缩成一句话:用 MethodType 保留完整签名,用 MethodHandles.empty 提供同型 no-op,再按返回类型处理零值、null 或 void。
-
174 收藏
-
246 收藏
-
353 收藏
-
126 收藏
-
395 收藏
-
296 收藏
-
365 收藏
-
428 收藏
-
文章 · java教程 | 3小时前 | Java教程 · 日期时间 · java LocalDate WeekFields weekBasedYear weekOfWeekBasedYear ISO周401 收藏
-
109 收藏
-
132 收藏
-
397 收藏
-
206 收藏
-
432 收藏
-
470 收藏
-
119 收藏
-
351 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习