萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 整合 FCKeditor 富文本編輯器:安裝配置、瘦身與安全加固

FCKeditor (現更名為 CKEditor) 是經典的開源 Web 富文本編輯器,支援 Java/.NET/PHP 等後端。本文記錄 JSP 環境下的完整整合流程:從下載、部署、web.xml 配置、標籤庫使用,到生產環境瘦身優化與前台安全配置。

一、下載與目錄結構

官網下載兩個套件:

  • 主程式:FCKeditor_2.x.zip → 解壓後的 FCKeditor/ 目錄
  • JSP 整合包:FCKeditor-2.x.zip → 含 WEB-INF/lib (JAR)、WEB-INF/web.xml (Servlet 定義)、_samples/ (範例)

二、部署步驟

  1. 將 FCKeditor/ 整個目錄複製到 Web 應用根目錄
  2. 從整合包 WEB-INF/lib 複製所有 JAR 到專案 WEB-INF/lib
  3. 從整合包 WEB-INF/web.xml 複製 Servlet 定義到專案 web.xml,修改 url-pattern 前綴:

原始 mapping (整合包預設)

<servlet-mapping>
  <servlet-name>Connector</servlet-name>
  <url-pattern>/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>SimpleUploader</servlet-name>
  <url-pattern>/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>

修改後 (對應 FCKeditor 實際部署路徑)

<servlet-mapping>
  <servlet-name>Connector</servlet-name>
  <url-pattern>/FCKeditor/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
</servlet-mapping>
<servlet-mapping>
  <servlet-name>SimpleUploader</servlet-name>
  <url-pattern>/FCKeditor/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>

三、JSP 頁面引用標籤庫

<%@ taglib uri="https://java.fckeditor.net" prefix="FCK" %>
...
<FCK:editor id="content" basePath="/FCKeditor/"
  imageBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector"
  linkBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Connector=connectors/jsp/connector"
  flashBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector"
  imageUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Image"
  linkUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=File"
  flashUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Flash"
>預設內容 </FCK:editor>

四、生產環境瘦身優化 (刪除無用檔案)

  1. 刪除所有以下劃線開頭的資料夾:_samples, _test, _source 等
  2. FCKeditor 根目錄僅保留:fckconfig.js, fckeditor.js, fckstyles.xml, fcktemplates.xml
  3. editor/filemanager/upload/ 目錄清空 (上傳處理由 Servlet 處理)
  4. editor/skins/ 僅保留 default/ (不需換膚時)
  5. editor/lang/ 僅保留 en.js, fcklanguagemanager.js, zh-cn.js, zh.js (中英雙語)

瘦身後體積可減少 70% 以上,加快部署與載入速度。

五、Struts/Spring/Hibernate 環境常見衝突

上傳圖片報錯:The output format must have a '{https://xml.apache.org/xalan}content-handler' property!

解決:刪除 WEB-INF/lib/xalan*.jar,避免與 JDK 內建 XML 解析器衝突。

六、前台安全加固 (普通用戶使用編輯器時)

  • 禁用預設工具列:在 fckconfig.js 定義精簡工具列陣列,移除「圖片」、「Flash」、「表單」、「來源碼」等高風險按鈕
  • 上傳功能後端驗證:Servlet 端檢查檔案類型、大小、副檔名、內容掃描
  • 輸出端 XSS 過濾:儲存前/顯示時使用 AntiSamy、OWASP Java HTML Sanitizer 清理惡意腳本
  • CSRF 保護:上傳/儲存請求加入防偽 Token
FCKeditor 已停止維護,新專案強烈建議直接使用 CKEditor 4/5,架構更現代、安全性更高、支援模組化建構與 npm 整合。
copyright © 萬盛學電腦網 all rights reserved