登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  java教程

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。
    }
}
MethodType 由返回类型和参数列表组成后交给 MethodHandles.empty 的静态关系图
图1:MethodType、MethodHandles.empty 与 MethodHandle 的结构说明图,不是截图或运行证据。

这里的 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");
    }
}
MethodHandles.empty 忽略参数并按返回类型给出零值 null 或 void 的静态关系图
图2:empty 的参数忽略与默认返回值关系说明图,不是截图或运行证据。

如果调用方把 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,不能把它等同于无副作用的空句柄。

一份适合迁移回归的最小清单

  1. 先确认 MethodType 的返回类型和参数顺序与调用点一致。
  2. 确认参数列表没有 void.class,返回类型才是 void.class 时才表达无返回值。
  3. 调用 invokeExact 时,让调用点的静态返回类型和参数类型与句柄完全一致。
  4. 分别覆盖 primitive、引用和 void 返回类型,记录零值、null 和无返回值的预期。
  5. 组合条件分支时使用目标句柄的 type() 创建 fallback,避免只匹配返回值却遗漏参数。
  6. 确认空句柄没有被误当成 identity;它不会读取、修改或回传输入参数。

常见疑问

MethodHandles.empty 会创建一个没有参数的句柄吗?

不会。它按照传入的 MethodType 保留参数列表,只是在调用时忽略这些参数。

返回对象类型时一定是一个空对象吗?

不是。引用返回类型的结果是 null,不会自动创建对象实例。

参数会不会被读取或触发副作用?

不会。empty 的定义是忽略参数并不做操作;如果业务需要校验、记录或转换参数,应使用真正的目标句柄或组合器。

迁移这类适配代码时,可以把结论压缩成一句话:用 MethodType 保留完整签名,用 MethodHandles.empty 提供同型 no-op,再按返回类型处理零值、null 或 void。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>