Java 插件化開發：編寫與調用 JAR 插件的完整流程

核心思想

Java 插件化本質是面向接口編程 + 動態加載類。將功能封裝為獨立 JAR，主程序通過反射或 ServiceLoader 機制發現並實例化插件。

標準流程

1. 定義插件接口 (API 模塊)

public interface IPlugin {
    String getName();
    void execute(String param);
}

2. 實現插件 (獨立項目)

public class MyPlugin implements IPlugin {
    @Override
    public String getName() { return "MyPlugin"; }
    @Override
    public void execute(String param) { System.out.println("執行: " + param); }
}

打包為 my-plugin.jar，Manifest 包含：Plugin-Class: com.example.MyPlugin

3. 主程序加載插件

方案 A：ServiceLoader (JDK 內建，推薦)

// META-INF/services/com.example.IPlugin 文件內容：com.example.MyPlugin
ServiceLoader loader = ServiceLoader.load(IPlugin.class);
for (IPlugin plugin : loader) {
    plugin.execute("參數");
}

方案 B：自定義類加載器 (熱插拔、隔離依賴)

URLClassLoader cl = new URLClassLoader(new URL[]{new File("plugins/my-plugin.jar").toURI().toURL()});
Class clazz = cl.loadClass("com.example.MyPlugin");
IPlugin plugin = (IPlugin) clazz.getDeclaredConstructor().newInstance();
plugin.execute("參數");

4. 進階：插件管理框架

• PF4J：輕量級，支持依賴管理、生命周期、熱部署
• JPF (Java Plugin Framework)：老牌，功能豐富
• OSGi (Equinox/Felix)：企業級模塊化標準，學習曲線陡峭

最佳實踐建議

1. 接口與實現分離部署，API 包極度精簡
2. 插件間避免直接依賴，通過事件總線通信
3. 沙箱隔離：自定義 ClassLoader 限制權限
4. 版本兼容：接口語義化版本控制

一言以蔽之：寫好接口 → 打包 JAR → 放入插件目錄 → 主程序掃描加載 → 面向接口調用。