JSP 教程 (七)：jsp:plugin 動作標籤 - Applet/JavaBean 瀏覽器外掛產生器

JSP jsp:plugin 動作標籤：已淘汰技術的歷史檔案與現代替代方案

jsp:plugin 是 JSP 1.1 引入的標準動作標籤，用於自動產生 <OBJECT> (IE) 或 <EMBED> (Netscape) 標籤，讓瀏覽器下載並執行 Java Applet 或 JavaBean 元件。隨著瀏覽器廠商停止支援 NPAPI 外掛架構 (Chrome 45+、Firefox 52+、Edge 全版本)、Java 官方淘汰 Applet (JDK 9 標記移除、JDK 11 徹底移除)、現代 Web 技術 (WebAssembly、WebGL、PWA) 取代，此標籤已完全失去實用價值。本文作為歷史技術檔案保存，並提供現代遷移路徑。

歷史背景：Java Applet 盛衰

jsp:plugin 完整語法 (歷史參考)

<jsp:plugin
    type="bean|applet"                    <-- 必填：元件類型
    code="ClassFileName.class"            <-- 必填：主類別檔案名 (含 .class)
    codebase="ClassFileDirectory"         <-- 必填：類別檔目錄或 URL 路徑
    name="instanceName"                   <-- 選填：實例名稱，供同頁多 Applet 通訊
    archive="jar1.jar,jar2.jar"           <-- 選填：JAR 檔列表，預先載入提升效能
    align="bottom|top|middle|left|right"  <-- 選填：對齊方式
    height="displayPixels"                <-- 選填：顯示高度
    width="displayPixels"                 <-- 選填：顯示寬度
    hspace="leftRightPixels"              <-- 選填：水平間距
    vspace="topBottomPixels"              <-- 選填：垂直間距
    jreversion="1.1|1.2|..."              <-- 選填：最低 JRE 版本 (預設 1.1)
    nspluginurl="URLToPlugin"             <-- 選填：Netscape 外掛下載點
    iepluginurl="URLToPlugin"             <-- 選填：IE ActiveX 下載點
>
    <jsp:params>
        <jsp:param name="paramName" value="paramValue" />+
    </jsp:params>
    <jsp:fallback>
        無法載入 Applet 的替代內容 (文字/圖片/連結)
    </jsp:fallback>
</jsp:plugin>

實戰範例 (僅供歷史參考)

<jsp:plugin 
    type="applet" 
    code="Molecule.class" 
    codebase="/html/applets"
    width="400" 
    height="300"
    jreversion="1.6"
    archive="chemistry.jar,vecmath.jar"
    nspluginurl="https://java.sun.com/products/plugin/1.6/jinstall-6u-windows-i586.cab"
    iepluginurl="https://java.sun.com/products/plugin/1.6/jinstall-6u-windows-i586.cab"
>
    <jsp:params>
        <jsp:param name="molecule" value="molecules/benzene.mol" />
        <jsp:param name="background" value="white" />
    </jsp:params>
    <jsp:fallback>
        <p>您的瀏覽器不支援 Java Applet。</p>
        <p><a href="https://java.com/download/">點此下載 Java Runtime</a></p>
        <p>或查看靜態圖片：<img src="benzene.png" alt="苯分子結構"></p>
    </jsp:fallback>
</jsp:plugin>

容器產生的 HTML 輸出範例 (IE vs Netscape)

<!-- IE (ActiveX) -->
<OBJECT 
    classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
    codebase="https://java.sun.com/products/plugin/1.6/jinstall-6u-windows-i586.cab"
    width="400" height="300"
    name="moleculeApplet"
>
    <PARAM name="code" value="Molecule.class" />
    <PARAM name="codebase" value="/html/applets" />
    <PARAM name="archive" value="chemistry.jar,vecmath.jar" />
    <PARAM name="molecule" value="molecules/benzene.mol" />
    <PARAM name="background" value="white" />
    <PARAM name="type" value="application/x-java-applet;version=1.6" />
    <COMMENT>
        <EMBED 
            type="application/x-java-applet;version=1.6"
            pluginspage="https://java.sun.com/products/plugin/1.6/jinstall-6u-windows-i586.cab"
            code="Molecule.class"
            codebase="/html/applets"
            archive="chemistry.jar,vecmath.jar"
            width="400" height="300"
            molecule="molecules/benzene.mol"
            background="white"
        >
        <NOEMBED>
            無法載入 Applet...
        </NOEMBED>
    </COMMENT>
</OBJECT>

JSP 特殊字元跳脫與註解語法 (附錄)

現代替代技術對照表

遷移路徑建議

路徑 A：Java 程式碼編譯為 WebAssembly (保留邏輯)

# 使用 TeaVM (Java bytecode → WASM)
# Maven 配置
<plugin>
    <groupId>org.teavm</groupId>
    <artifactId>teavm-maven-plugin</artifactId>
    <version>0.8.0</version>
    <configuration>
        <targetDirectory>${project.build.directory}/wasm</targetDirectory>
        <mainClass>com.example.AppletMain</mainClass>
    </configuration>
</plugin>

優點：保留 Java 業務邏輯、效能接近原生。缺點：需重寫 UI 層 (無 AWT/Swing)、部分 JDK API 不支援。

路徑 B：重寫為 REST API + 現代前端 (架構現代化)

# 後端：Spring Boot REST Controller
@RestController
@RequestMapping("/api/molecule")
public class MoleculeController {
    @GetMapping("/{id}")
    public MoleculeData getMolecule(@PathVariable String id) {
        return moleculeService.load(id); // 原 Applet 邏輯移至這裡
    }
}

# 前端：React + Three.js 渲染分子結構
function MoleculeViewer({ moleculeId }) {
    const [data, setData] = useState(null);
    useEffect(() => {
        fetch(`/api/molecule/${moleculeId}`).then(r => r.json()).then(setData);
    }, [moleculeId]);
    return ; // Three.js 渲染
}

路徑 C：CheerpJ - 直接在瀏覽器運行未修改 Java Applet (過渡方案)

<!-- HTML 頁面引入 CheerpJ -->
<script src="https://caching.leaningtech.com/cheerpj3.js"></script>
<script>
cheerpjInit().then(() => {
    cheerpjRunJar("/applets/chemistry.jar", "/applets/", "com.example.MoleculeApplet");
});
</script>
<canvas id="cheerpjCanvas" width="400" height="300"></canvas>

優點：零修改運行現有 Applet。缺點：商業授權、效能較原生差、檔案較大。

總結