萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

FCKeditor 在 Java Web 專案中的整合與配置全攻略

版本與下載

  • FCKeditor 2.4.2 核心包:editor/、fckconfig.js、fckeditor.js、fckstyles.xml、fcktemplates.xml
  • Java 整合包 2.3:fckeditor.jar、fckeditor.tld、上傳 Servlet
  • 官網:fckeditor.net(現已更名為 CKEditor 4/5)

專案結構佈署

WebRoot/
├── FCKeditor/                    # 核心資源 (區分大小寫)
│   ├── editor/
│   ├── fckconfig.js
│   ├── fckeditor.js
│   ├── fckstyles.xml
│   └── fcktemplates.xml
├── WEB-INF/
│   ├── lib/
│   │   ├── fckeditor.jar
│   │   └── (上傳相關 jar)
│   ├── fckeditor.tld
│   └── web.xml
└── UserFiles/                    # 上傳儲存根目錄
    ├── Image/
    ├── Flash/
    ├── File/
    └── Media/

關鍵配置修改

1. fckconfig.js 核心設定

// 介面語言
FCKConfig.DefaultLanguage = 'zh-cn';

// 皮膚
FCKConfig.SkinPath = FCKConfig.BasePath + 'skins/silver/';

// 瀏覽伺服器端點 (JSP Connector)
FCKConfig.LinkBrowserURL  = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Connector=connectors/jsp/connector';
FCKConfig.ImageBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector';
FCKConfig.FlashBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector';

// 上傳伺服器端點
FCKConfig.LinkUploadURL  = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=File';
FCKConfig.ImageUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=Image';
FCKConfig.FlashUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=Flash';

2. web.xml 註冊 Servlet

<servlet>
    <servlet-name>Connector</servlet-name>
    <servlet-class>com.fredck.FCKeditor.connector.ConnectorServlet</servlet-class>
    <init-param>
        <param-name>baseDir</param-name>
        <param-value>/UserFiles/</param-value>  <!-- 相對 WebRoot,不可含專案名 -->
    </init-param>
</servlet>

<servlet>
    <servlet-name>SimpleUploader</servlet-name>
    <servlet-class>com.fredck.FCKeditor.uploader.SimpleUploaderServlet</servlet-class>
    <init-param>
        <param-name>baseDir</param-name>
        <param-value>/UserFiles/</param-value>
    </init-param>
    <init-param>
        <param-name>enabled</param-name>
        <param-value>true</param-value>  <!-- 必須啟用 -->
    </init-param>
    <init-param>
        <param-name>debug</param-name>
        <param-value>true</param-value>
    </init-param>
</servlet>

<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" %>
<html><body>
<FCK:editor instanceName="content" basePath="/FCKeditor/"
            toolbarSet="Basic" height="400" />
</body></html>

接收參數

String content = request.getParameter("content");  // 直接獲取 HTML 內容

優化:精簡部署體積

  • 刪除 editor/filemanager/browser/default/connectors/ 下非 JSP 語言目錄
  • 刪除 editor/filemanager/upload/ 非 JSP 上傳腳本
  • editor/lang/ 僅保留 zh-cn.js、en.js、fcklanguagemanager.js
  • editor/skins/ 僅保留使用的皮膚

安全加固 (前台使用必做)

// fckconfig.js
// 1. 移除危險工具列按鈕
FCKConfig.ToolbarSets["Basic"] = [
    ['Bold','Italic','-','OrderedList','UnorderedList','-','Unlink',
     'Style','FontSize','TextColor','BGColor','-','Smiley','SpecialChar','Preview']
];

// 2. 禁用右鍵選單危險項目
FCKConfig.ContextMenu = ['Generic','Anchor','Flash','Select','Textarea',
    'Checkbox','Radio','TextField','HiddenField','Button',
    'BulletedList','NumberedList','TableCell','Table','Form'];

// 3. 增加中文字體
FCKConfig.FontNames = '宋體;黑體;隸書;楷體_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana';

// 4. 啟用 Tab 鍵
FCKConfig.TabSpaces = 1;

重要遷移提醒

FCKeditor 已停止維護,官方繼任者為 CKEditor 4/5。新專案請直接採用 CKEditor:

  • CKEditor 5:模組化、現代化架構、支援協同編輯、React/Vue/Angular 整合包
  • Java 後端:ckeditor5-build-classic + 任意檔案上傳 Controller 即可
  • 遷移指南:官方遷移文檔
copyright © 萬盛學電腦網 all rights reserved