jOOR 项目技术文档

1. 安装指南

jOOR 是一个简单的 Java 反射工具包，提供了对 java.lang.reflect 包的封装。它没有任何外部依赖，可以直接在项目中使用。

1.1 Maven 依赖

根据你使用的 Java 版本，选择合适的依赖项添加到你的 pom.xml 文件中：

• Java 9+

<dependency>
  <groupId>org.jooq</groupId>
  <artifactId>joor</artifactId>
  <version>0.9.15</version>
</dependency>

• Java 8+

<dependency>
  <groupId>org.jooq</groupId>
  <artifactId>joor-java-8</artifactId>
  <version>0.9.15</version>
</dependency>

• Java 6+

<dependency>
  <groupId>org.jooq</groupId>
  <artifactId>joor-java-6</artifactId>
  <version>0.9.15</version>
</dependency>

1.2 安装方式

1. 将上述依赖项添加到你的 Maven 项目中。
2. 使用 Maven 构建工具重新构建项目，jOOR 将会自动下载并添加到你的项目中。

2. 项目的使用说明

jOOR 提供了简单易用的 API，用于简化 Java 反射操作。以下是一些基本的使用示例。

2.1 基本反射操作

import static org.joor.Reflect.*;

String world = onClass("java.lang.String") // 类似于 Class.forName()
                .create("Hello World")     // 调用最匹配的构造函数
                .call("substring", 6)      // 调用最匹配的 substring() 方法
                .call("toString")          // 调用 toString() 方法
                .get();                    // 获取包装的对象，这里是一个 String

2.2 代理抽象

jOOR 还提供了对 java.lang.reflect.Proxy API 的简单封装：

public interface StringProxy {
  String substring(int beginIndex);
}

String substring = onClass("java.lang.String")
                    .create("Hello World")
                    .as(StringProxy.class) // 为包装的对象创建代理
                    .substring(6);         // 调用代理方法

2.3 运行时编译 Java 代码

jOOR 支持运行时编译 Java 代码，前提是你的项目中包含 java.compiler 模块：

Supplier<String> supplier = Reflect.compile(
    "com.example.HelloWorld",
    "package com.example;\n" +
    "class HelloWorld implements java.util.function.Supplier<String> {\n" +
    "    public String get() {\n" +
    "        return \"Hello World!\";\n" +
    "    }\n" +
    "}\n").create().get();

// 输出 "Hello World!"
System.out.println(supplier.get());

3. 项目 API 使用文档

3.1 Reflect 类

Reflect 类是 jOOR 的核心类，提供了静态方法来执行反射操作。

• on(Object object)：包装一个对象，允许对其进行反射操作。
• onClass(String className)：通过类名加载类，并返回一个 Reflect 对象。
• create(Object... args)：调用最匹配的构造函数创建对象。
• call(String methodName, Object... args)：调用指定方法。
• get()：获取包装的对象。

3.2 Reflect 对象

Reflect 对象是 jOOR 的核心对象，提供了对包装对象的反射操作。

• as(Class<T> proxyType)：为包装的对象创建代理。
• field(String fieldName)：获取指定字段的值。
• set(String fieldName, Object value)：设置指定字段的值。

4. 项目安装方式

jOOR 的安装非常简单，只需将相应的 Maven 依赖添加到你的项目中即可。根据你使用的 Java 版本，选择合适的依赖项，并将其添加到 pom.xml 文件中。然后使用 Maven 重新构建项目，jOOR 将会自动下载并添加到你的项目中。

通过以上步骤，你就可以在你的 Java 项目中使用 jOOR 进行反射操作了。