当前位置:首页 > 文章列表 > 文章 > java教程 > Java MethodHandles.empty 怎样构造接受参数但不执行操作的方法句柄

Java MethodHandles.empty 怎样构造接受参数但不执行操作的方法句柄

来源:17golang原创 2026-11-18 17:30:39 0浏览 收藏

在做方法句柄适配时,有一种很具体的需求:调用方要求一个完整签名,但某个分支暂时什么都不做。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删除
Go debug/gosym.Table.SymByAddr 怎样按地址寻找符号对象Go debug/gosym.Table.SymByAddr 怎样按地址寻找符号对象
上一篇
Go debug/gosym.Table.SymByAddr 怎样按地址寻找符号对象
Go go/types.Named.NumMethods 怎样统计命名类型显式关联的方法
下一篇
Go go/types.Named.NumMethods 怎样统计命名类型显式关联的方法
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1258次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1200次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1047次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码