如果你写过框架级代码，一定体会过这种绝望——为了搞清楚一个 List<Map<String, User>> 里到底藏了什么类型，你在 Type、ParameterizedType、TypeVariable 的迷宫里绕了两个小时，最后写出一堆自己第二天都看不懂的反射代码。

一枚「蛋」的诞生

EggG 是一个 Java 类型元数据分析与构建工具，同时也是流式反射调用框架。它的名字带着几分趣味——"Egg" 译为「蛋」，寓意「孵化」出类型信息中隐藏的一切细节。

这个项目由 Solon 框架作者 noear 发起，目前已在 Solon、Snack4 等知名框架中作为核心基础设施使用。它用大约 3600 行精炼代码，把 Java 泛型反射这件事做到了优雅而完整。

它能做什么？

1. 一行代码看透泛型

不再需要手动拆解 ParameterizedType。EggG 替你完成从类型声明到实际泛型参数的全链路分析：

Eggg eggg = new Eggg();

TypeEggg typeEggg = eggg.getTypeEggg(new HashMap<Integer, UserModel>() {}.getClass());

if (typeEggg.isMap() && typeEggg.isParameterizedType()) {
    Type keyType   = typeEggg.getActualTypeArguments()[0];   // Integer
    Type valueType = typeEggg.getActualTypeArguments()[1];   // UserModel
}

这是最基础的能力——但已经足够替代你项目中大量手写的泛型解析工具类。

2. 泛型嵌套传导，一键追到底

真实业务中，泛型往往层层嵌套。A<X, Y> → B<M, N> extends A<List<M>, Map<String, N>> → C extends B<String, Integer>——面对这样的继承链，手工追踪简直是噩梦。

EggG 可以自动把泛型变量沿着继承体系一路传导到底：

ClassEggg classEggg = eggg.getTypeEggg(C.class).getClassEggg();

// 字段 x（来自祖父类 A）→ 实际类型是 List<String>
assert classEggg.getFieldEgggByName("x").getType() == List.class;
assert classEggg.getFieldEgggByName("x").getTypeEggg().getActualTypeArguments()[0] == String.class;

// 字段 y → 实际类型是 Map<String, Integer>
assert classEggg.getFieldEgggByName("y").getType() == Map.class;
assert classEggg.getFieldEgggByName("y").getTypeEggg().getActualTypeArguments()[1] == Integer.class;

无论继承层级有多深，泛型参数的传导都由框架自动完成。你只需要关心「我想要什么」，而不是「它从哪里来」。

3. 流式反射——告别丑陋的反射代码

Java 原生反射的 API 设计堪称反人类。EggG 从 1.1.0 版本起提供了流畅的链式反射调用，让反射代码变得像普通调用一样自然：

Eggg eggg = new Eggg();

// 从类开始：创建实例 → 调用方法 → 获取结果
String result = eggg.reflect(String.class)
        .create("Hello World")
        .call("substring", 6)
        .get();   // "World"

// 从实例开始：直接调用
String result2 = eggg.reflect("Hello World")
        .call("substring", 6)
        .get();

// 字段读写 + 链式操作
Person person = eggg.reflect(Person.class)
        .create()
        .setField("name", "Tom")
        .setField("age", 25)
        .call("hello")
        .get();

// 通过 getter/setter 访问属性
Person p = eggg.reflect(Person.class).create()
        .setProperty("name", "Alice")  // 走 setName
        .setProperty("age", 30)        // 走 setAge
        .get();

// 调用静态方法
String s = eggg.reflect(Person.class)
        .call("staticHello")
        .get();

基本类型和包装类型之间的自动互通也已经处理好——Integer 自动匹配 int 参数，你再也不用担心 NoSuchMethodException 的困扰。

4. 注解提炼与别名——框架作者的利器

EggG 提供了 DigestHandler（提炼器）和 AliasHandler（别名器）两个扩展点。框架作者可以在类型分析过程中，同步完成注解的提取和别名的映射，一步到位地构建出自己需要的元数据模型。

以 JSON 序列化框架为例：

private static final Eggg eggg = new Eggg()
        .withCreatorClass(ONodeCreator.class)           // 指定构造器注解
        .withDigestHandler(EgggUtil::doDigestHandle)    // 注解提炼
        .withAliasHandler(EgggUtil::doAliasHandle);     // 别名映射

在一次类型分析过程中，字段、方法、参数上的注解信息被同步提炼为 ONodeAttrHolder，别名也被自动映射。这比「先反射拿类型、再反射拿注解、最后手动拼装」的传统方式高效得多。

设计亮点

零依赖

整个项目没有任何第三方依赖（连测试用的 JUnit5 都是 test scope）。这意味着你可以把它用在任何 Java 项目中，不会引入任何传递依赖冲突。发布到 Maven Central，开箱即用：

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>eggg</artifactId>
    <version>1.1.0</version>
</dependency>

全版本兼容

从 JDK 8 到 JDK 25，EggG 全部支持。无论你的项目是坚守 Java 8 的老牌企业应用，还是追着最新 LTS 版本跑的新锐项目，都可以放心使用。

智能缓存

内部使用 ConcurrentHashMap + SoftReference 实现了类型元数据的两级缓存。相同类型不会重复分析，内存紧张时又可以自动释放，在性能和资源之间取得了良好的平衡。

全局单例设计

Eggg 实例被设计为应用级全局单例使用。一次配置、处处可用，非常契合框架级组件的使用场景。

谁应该关注 EggG？

• 框架/中间件开发者 —— 如果你正在写序列化框架、依赖注入容器、ORM 框架或者任何需要深度分析 Java 类型元数据的工具，EggG 可以帮你省下数千行样板代码。
• SDK/工具库作者 —— 需要灵活的反射调用能力，又不想暴露复杂的反射 API 给使用者。
• 追求优雅的工程师 —— 即使不是框架作者，当你的业务代码需要处理复杂泛型场景时，EggG 也能让代码变得清晰可维护。

在知名项目中的实战

EggG 已经在多个开源项目中作为核心依赖稳定运行：

• Solon —— Java 轻量级应用框架，使用 EggG 完成依赖注入过程中的类型分析与元数据提取。
• Snack4 —— 高性能 JSON 框架，使用 EggG 进行序列化/反序列化时的泛型推断与注解解析。

经过这些项目的实战打磨，EggG 在边界情况处理、性能表现和 API 稳定性上都已经达到了生产级水准。

写在最后

Java 的泛型在编译后被擦除，这早已是老生常谈。但「类型擦除」不等于「信息消失」——泛型的声明信息仍然保留在 class 文件中，等待着被有心人发掘。

EggG 就是那个帮你把丢失的泛型信息找回来的工具。它不大，但很精；它不喧哗，但足够有用。

如果你厌倦了在 Type 和 ParameterizedType 之间反复横跳，厌倦了手写那些脆弱的反射工具类——不妨试试这枚「蛋」。