TeaVM项目：如何将Java类独立编译为JavaScript模块

在Java到JavaScript的转换工具TeaVM中，开发者经常遇到一个常见需求：如何将独立的Java类（不通过main方法调用）编译成可用的JavaScript代码。本文将详细介绍实现这一目标的技术方案。

核心概念

TeaVM提供了JS模块系统，允许开发者将Java类作为独立模块输出到JavaScript环境。这种方式不需要通过main方法作为入口点，而是直接将指定类及其方法暴露给JavaScript调用。

实现步骤

1. 使用@JSBody注解

对于需要暴露给JavaScript的方法，可以使用@JSBody注解进行标记：

import org.teavm.jso.JSBody;

public class Parent {
    @JSBody(params = "number", script = "console.log('Parent doubles ' + number + ' to: ' + (number*2))")
    public static native void showMessage(int number);
}

2. 配置构建工具

在Maven或Gradle配置中，需要明确指定要输出的类和方法：

<plugin>
    <groupId>org.teavm</groupId>
    <artifactId>teavm-maven-plugin</artifactId>
    <version>${teavm.version}</version>
    <executions>
        <execution>
            <goals>
                <goal>compile</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <mainClass>org.teavm.helper.Parent</mainClass>
        <minifying>true</minifying>
    </configuration>
</plugin>

3. 继承关系的处理

对于有继承关系的类，TeaVM会自动保持其继承结构：

class Child extends Parent {
    @JSBody(params = "number", script = "console.log('Child triples ' + number + ' to: ' + (number*3))")
    public static native void showMessage(int number);
}

实际应用场景

这种技术特别适用于以下情况：

1. 将业务逻辑核心类单独编译为JS模块
2. 在现有JavaScript应用中逐步引入Java编写的组件
3. 构建可复用的跨平台库

注意事项

1. 被导出的方法最好使用public修饰符
2. 考虑添加适当的参数校验，因为JavaScript端可能传入任意类型
3. 对于复杂对象，需要使用JS互操作类型

高级技巧

对于更复杂的场景，可以：

1. 使用JSFunctor接口创建JavaScript回调
2. 通过JSExport注解控制导出名称
3. 配置模块系统为CommonJS或ES6模块

通过以上方法，开发者可以灵活地将任意Java类转换为JavaScript模块，无需依赖传统的main方法入口点，实现更细粒度的代码复用和集成。