萬盛學電腦網

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

JSP 環境整合 FCKeditor 完整配置指南

FCKeditor 簡介

FCKeditor(現已更名為 CKEditor 4/5)是開源線上富文本編輯器,支援 ASP.NET、ASP、ColdFusion、PHP、Java 等後端,相容 IE 5+、Firefox、Chrome、Safari 等主流瀏覽器。

安裝步驟(以 FCKeditor 2.x 為例)

1. 下載兩個套件

  • 主程式:FCKeditor_2.x.zip(核心 JS/CSS/圖片)
  • JSP 整合包:FCKeditor-2.x.zip(Servlet、連接器、上傳處理、taglib)

2. 部署主程式

解壓 FCKeditor_2.x.zip
複製 FCKeditor/ 目錄至 Web 應用根目錄(同級於 WEB-INF)

3. 部署 JSP 整合包

解壓 FCKeditor-2.x.zip
# 3.1 複製 Servlet 定義至 web.xml
# 來源:FCKeditor-2.x/web/WEB-INF/web.xml
# 目標:專案 WEB-INF/web.xml
# 修正 url-pattern 以符合實際部署路徑:
# 原:/editor/filemanager/browser/default/connectors/jsp/connector
# 改:/FCKeditor/editor/filemanager/browser/default/connectors/jsp/connector
# 原:/editor/filemanager/upload/simpleuploader
# 改:/FCKeditor/editor/filemanager/upload/simpleuploader

# 3.2 複製 lib 目錄下所有 jar 至專案 WEB-INF/lib/
# 包含:commons-fileupload, commons-io, xalan, xerces 等

4. JSP 頁面引入編輯器

<%@ taglib uri="https://java.fckeditor.net" prefix="FCK" %>
<html><head><title>FCKeditor Demo</title></head><body>
<FCK:editor 
  instanceName="content"
  basePath="/FCKeditor/"
  toolbar="Default"
  width="100%"
  height="400"
  value="<p>預設內容</p>"
  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"
/>
</body></html>

5. 測試與精簡(瘦身)

啟動 Tomcat 測試編輯器載入、圖片上傳、瀏覽伺服器功能。成功後執行瘦身:

  1. 刪除所有以 _ 開頭的資料夾(語言包、皮膚備份等)。
  2. 根目錄僅保留:fckconfig.js, fckeditor.js, fckstyles.xml, fcktemplates.xml。
  3. 清空 editor/filemanager/upload/ 目錄。
  4. editor/skins/ 僅保留 default/。
  5. editor/lang/ 僅保留 en.js, zh-cn.js, zh.js, fcklanguagemanager.js。

常見問題與解決

問題原因與解決
上傳圖片報 content-handler 錯誤Struts/Spring/Hibernate 專案中 xalan.jar 版本衝突。刪除 WEB-INF/lib/xalan*.jar,由 JDK 內建 XML 解析器處理。
前台使用安全性前台不應開放完整工具列。修改 fckconfig.js 約第 78 行 FCKConfig.ToolbarSets["Default"],移除 Image, Flash, Table 等上傳按鈕。
路徑 404檢查 basePath、Connector URL 是否與實際部署路徑一致(含 Context Path)。

遷移建議:升級至 CKEditor 4/5

  • FCKeditor 已停止維護(2010 年釋出最後版本),存在 XSS、相容性風險。
  • CKEditor 4:API 相容性較好,支援現代瀏覽器,模組化載入。
  • CKEditor 5:全新架構、框架整合(React/Vue/Angular)、協同編輯、GPU 加速渲染。
  • Java 後端整合:CKEditor 4 仍可用舊 Connector;CKEditor 5 需自行實作上傳/瀏覽 API(REST + 圖片 Base64 或雲存儲)。
copyright © 萬盛學電腦網 all rights reserved