fckeditor2.4在jsp中的配置和使用

1.下載
FCKeditor2.3 (FCKeditot for java)
FCKeditor2.4 (FCKeditor基本檔案)
以下是：
http://www.fckeditor.net/download/default.html

2.建立項目:
建立項目tomcat/webapps/TestFCKeditor.

3.將FCKeditor2.4解壓縮
將FCKeditor2.4解壓縮,將整個目錄FCKeditor複製到項目的根目錄下，並將解壓縮出來的檔案夾fckeditor重新命名為FCKeditor
目錄結構為：tomcat/webapps/TestFCKeditor/FCKeditor
然後將FCKeditor-2.3.zip（java）壓縮包中/web/WEB-INF/lib/目錄下的兩個jar檔案拷到項目的/WEB-INF/ lib/目錄下。把其中的src目錄下的FCKeditor.tld檔案copy到TestFCKedit/WEB-INF/下

4.合并web.xml:
將FCKeditor-2.3.zip壓縮包中/web/WEB-INF/目錄下的web.xml檔案合并到項目的/WEB-INF/目錄下的web.xml檔案中。

5. 修改合并後的web.xml檔案
修改合并後的web.xml檔案，將名為SimpleUploader的Servlet的enabled參數值改為true，
以允許上傳功能，Connector Servlet的baseDir參數值用於設定上傳檔案存放的位置。
在web.xml最後添加標籤定義:

<taglib>
    <taglib-uri>/TestFCKeditor</taglib-uri>
    <taglib-location>/WEB-INF/FCKeditor.tld</taglib-location>
 </taglib>

現在的web.xml檔案沒有<taglib>標籤了，應該直接在jsp檔案中使用：<%@ taglib uri="http://fckeditor.net/tags-fckeditor" prefix="FCK" %>

 

6. 映射:
上面檔案中兩個servlet的映射分別為：/editor/filemanager/browser/default/connectors/jsp/connector
和/editor/filemanager/upload/simpleuploader，需要在兩個映射前面加上/FCKeditor，
即改為/FCKeditor/editor/filemanager/browser/default/connectors/jsp/connector和
/FCKeditor/editor/filemanager/upload/simpleuploader。
這兩個名字根據你放在工程中的FCKeditor檔案夾名稱而定。。

7.修改skin檔案夾
進入skin檔案夾，如果你想使用fckeditor預設的這種奶黃色，
那就把除了default檔案夾外的另兩個檔案夾直接刪除.（建議不刪除，以後要用到其中的一個檔案夾）

8.刪除無用檔案
刪除/FCKeditor/目錄下除fckconfig.js, fckeditor.js, fckstyles.xml, fcktemplates.xml四個檔案以外的所有檔案，保留檔案夾editor
刪除目錄/editor/_source,
刪除/editor/filemanager/browser/default/connectors/下的所有檔案
刪除/editor/filemanager/upload/下的所有檔案
刪除/editor/lang/下的除了fcklanguagemanager.js（我下載的沒有這個檔案）, en.js, zh.js, zh-cn.js四個檔案的所有檔案

9.修改配置：
開啟/FCKeditor/fckconfig.js
修改 FCKConfig.DefaultLanguage = 'zh-cn' ;
把FCKConfig.LinkBrowserURL等的值替換成以下內容：
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.FlashUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=Flash' ;
FCKConfig.ImageUploadURL = FCKConfig.BasePath + 'filemanager/upload/simpleuploader?Type=Image' ;

10.其它
fckconfig.js總設定檔，可用記錄本開啟，修改後將檔案存為utf-8 編碼格式。找到：

FCKConfig.TabSpaces = 0 ; 改為FCKConfig.TabSpaces = 1 ; 即在編輯器域內可以使用Tab鍵。

如果你的編輯器還用在網站前台的話，比如說用於留言本或是日記回複時，那就不得不考慮安全了，
在前台千萬不要使用Default的toolbar，要麼自訂一下功能，要麼就用系統已經定義好的Basic，
也就是基本的toolbar，找到：
FCKConfig.ToolbarSets["Basic"] = [
['Bold','Italic','-','OrderedList','UnorderedList','-',/*'Link',*/'Unlink','-','Style','FontSize','TextColor','BGColor','-',
'Smiley','SpecialChar','Replace','Preview'] ] ;
這是改過的Basic，把映像功能去掉，把添加連結功能去掉，因為映像和連結和flash和映像按鈕添加功能都能讓前台
頁直接存取和上傳檔案， fckeditor還支援編輯域內的滑鼠右鍵功能。

FCKConfig.ContextMenu = ['Generic',/*'Link',*/'Anchor',/*'Image',*/'Flash','Select','Textarea','Checkbox','Radio','TextField','HiddenField',
/*'ImageButton',*/'Button','BulletedList','NumberedList','TableCell','Table','Form'] ;

這也是改過的把滑鼠右鍵的“連結、映像，FLASH，映像按鈕”功能都去掉。

　　找到： FCKConfig.FontNames = 'Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;
加上幾種我們常用的字型
FCKConfig.FontNames
= '宋體;黑體;隸書;楷體_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;

11.添加檔案
添加檔案 /TestFCKeditor/test.jsp:
<%@ page language="java" import="com.fredck.FCKeditor.*" %>
<%@ taglib uri="/TestFCKeditor" prefix="FCK" %>
<script type="text/javascript" src="/TestFCKeditor/FCKeditor/fckeditor.js"></script>

<%--
三種方法調用FCKeditor
1.FCKeditor自訂標籤 (必須加標頭檔 <%@ taglib uri="/TestFCKeditor" prefix="FCK" %> )
2.script指令碼語言調用 (必須引用 指令檔 <script type="text/javascript" src="/TestFCKeditor/FCKeditor/fckeditor.js"></script> )
3.FCKeditor API 呼叫 (必須加標頭檔 <%@ page language="java" import="com.fredck.FCKeditor.*" %> )
--%>

//標籤調用方式
<%--
<form action="show.jsp" method="post" target="_blank">
<FCK:editor id="content" basePath="/TestFCKeditor/FCKeditor/"
width="700"
height="500"
skinPath="/TestFCKeditor/FCKeditor/editor/skins/silver/"
toolbarSet = "Default"
>
input
</FCK:editor>
<input type="submit" value="Submit">
</form>
--%>

//JS調用方式
<form action="show.jsp" method="post" target="_blank">
<table border="0" width="700"><tr><td>
<textarea id="content" name="content" style="WIDTH: 100%; HEIGHT: 400px">input</textarea>
<script type="text/javascript">
var oFCKeditor = new FCKeditor('content') ;
oFCKeditor.BasePath = "/TestFCKeditor/FCKeditor/" ;
oFCKeditor.Height = 400;
oFCKeditor.ToolbarSet = "Default" ;
oFCKeditor.ReplaceTextarea();
</script>
<input type="submit" value="Submit">
</td></tr></table>
</form>

//FCKeditor API 呼叫
<%--
<form action="show.jsp" method="post" target="_blank">
<%
FCKeditor oFCKeditor ;
oFCKeditor = new FCKeditor( request, "content" ) ;
oFCKeditor.setBasePath( "/TestFCKeditor/FCKeditor/" ) ;
oFCKeditor.setValue( "input" );
out.println( oFCKeditor.create() ) ;
%>
<br>
<input type="submit" value="Submit">
</form>
--%>

添加檔案/TestFCKeditor/show.jsp:
<%
String content = request.getParameter("content");
out.print(content);
%>

 

12.測試
瀏覽http://localhost:8080/TestFCKeditor/test.jsp

最後注意。。不同的版本 變數名稱可能不一樣。請參考你使用的API文檔

配置選項:

AutoDetectLanguage=true/false 自動檢測語言
BaseHref="" 相對連結的基地址
ContentLangDirection="ltr/rtl" 預設文字方向
ContextMenu=字串數組,右鍵菜單的內容
CustomConfigurationsPath="" 自訂設定檔路徑和名稱
Debug=true/false 是否開啟調試功能,這樣,當調用FCKDebug.Output()時,會在調試窗中輸出內容
DefaultLanguage="" 預設語言
EditorAreaCss="" 編輯區的樣式表檔案
EnableSourceXHTML=true/false 為TRUE時,當由可視化介面切換到字碼頁時,把HTML處理成XHTML
EnableXHTML=true/false 是否允許使用XHTML取代HTML
FillEmptyBlocks=true/false 使用這個功能,可以將空的區塊層級元素用空格來替代
FontColors="" 設定顯示顏色拾取器時文字顏色列表
FontFormats="" 設定顯示在文字格式列表中的命名
FontNames="" 字型列表中的字型名
FontSizes="" 字型大小中的字型大小列表
ForcePasteAsPlainText=true/false 強制粘貼為純文字
ForceSimpleAmpersand=true/false 是否不把&符號轉換為XML實體
FormatIndentator="" 當在源碼格式下縮排代碼使用的字元
FormatOutput=true/false 當輸出內容時是否自動格式化代碼
FormatSource=true/false 在切換到程式碼檢視時是否自動格式化代碼
FullPage=true/false 是否允許編輯整個HTML檔案,還是僅允許編輯BODY間的內容
GeckoUseSPAN=true/false 是否允許SPAN標記代替B,I,U標記
IeSpellDownloadUrl=""下載拼字檢查器的網址
ImageBrowser=true/false 是否允許瀏覽伺服器功能
ImageBrowserURL="" 瀏覽伺服器時啟動並執行URL
ImageBrowserWindowHeight="" 映像瀏覽器視窗高度
ImageBrowserWindowWidth="" 映像瀏覽器視窗寬度
LinkBrowser=true/false 是否允許在插入連結時瀏覽伺服器
LinkBrowserURL="" 插入連結時瀏覽伺服器的URL
LinkBrowserWindowHeight=""連結目標瀏覽器視窗高度
LinkBrowserWindowWidth=""連結目標瀏覽器視窗寬度
Plugins=object 註冊外掛程式
PluginsPath="" 外掛程式檔案夾
ShowBorders=true/false 合并邊框
SkinPath="" 皮膚檔案夾位置
SmileyColumns=12 圖符窗列數
SmileyImages=字元數組 圖符窗中圖片檔案名稱數組
SmileyPath="" 圖符檔案夾路徑
SmileyWindowHeight 圖符視窗高度
SmileyWindowWidth 圖符視窗寬度
SpellChecker="ieSpell/Spellerpages" 設定拼字檢查器
StartupFocus=true/false 開啟時FOCUS到編輯器
StylesXmlPath="" 設定定義CSS樣式列表的XML檔案的位置
TabSpaces=4 TAB鍵產生的空白字元數
ToolBarCanCollapse=true/false 是否允許展開/摺疊工具列
ToolbarSets=object 允許使用TOOLBAR集合
ToolbarStartExpanded=true/false 開啟是TOOLBAR是否展開
UseBROnCarriageReturn=true/false 當斷行符號時是產生BR標記還是P或者DIV標記

解決上傳亂碼:
在SimpleUploaderServlet.java和ConnectorServlet.java兩個檔案裡找到
DiskFileUpload upload = new DiskFileUpload();
分別在其後加入 upload.setHeaderEncoding("utf-8");
這樣解決了檔案上傳的中文亂碼問題.
但是在控制台顯示的中文內容還是亂碼,但是沒關係,我們沒必要去看控制台下的中文

----------------------------------------------------------------another
FCKeditor2.4.2 Java版使用說明
以及基本配置請參考：http://hi.baidu.com/wain19/blog/item/c33fb0fab74f24dfb48f312d.html

我的開發環境是ubuntu7.04, 系統預設編碼是utf-8,
期間，本人遇到了下面這些問題：

問題一：XML request error: Internel Server Error(500)

出現錯誤的地方是在：點插入圖片，點Browse按鈕的時候：
XML request error: Internel Server Error(500)

找資料：http://lamono.javaeye.com/blog/49135
拷貝xalan.jar和serialize.jar到/WEB-INF/lib，問題解決。

FCKeditor-java沒有很好的解決中文問題。需要我們修改它的原始碼後重新編譯打包。打包過程如下：
1。 建立一個web工程名字為FCKeditor-java-2.3，然後把FCKeditor-2.3-java.zip解壓縮後的代碼拷貝到工程目錄下。
2。如果是用的Eclipse,使用快速鍵Ctrl+Shift+R
在SimpleUploaderServlet.java和ConnectorServlet.java兩個檔案裡找到
DiskFileUpload upload = new DiskFileUpload();
分別在其後加入 upload.setHeaderEncoding("utf-8");
現在如果直接運行ant任務，會報下面的錯誤：
taskdef class org.apache.catalina.ant.DeployTask cannot be found

3。 把tomcat安裝目錄下/server/lib中的catalina-ant.jar拷貝到/WEB-INF/lib目錄 下。
4。 開啟build.xml
找到
<property name="catalina.home"
修改成你自己的tomcat安裝目錄
<property name="catalina.home"         value="/home/uniquejava/tool/tomcat5028/"/>
找到
<taskdef name="deploy"
修改成如下內容
     <taskdef name="deploy" classname="org.apache.catalina.ant.DeployTask">
        <classpath refid="compile.classpath">
        </classpath>
    </taskdef>
    <taskdef name="list" classname="org.apache.catalina.ant.ListTask">
        <classpath refid="compile.classpath">
        </classpath>
    </taskdef>
    <taskdef name="reload" classname="org.apache.catalina.ant.ReloadTask">
        <classpath refid="compile.classpath">
        </classpath>
    </taskdef>
    <taskdef name="undeploy" classname="org.apache.catalina.ant.UndeployTask">
        <classpath refid="compile.classpath">
        </classpath>
    </taskdef>

運行ant任務dist, 就可以產生新的FCKeditor-2.3.jar包

問題三： 上傳時建立的中文目錄全部亂碼。 雖然上傳到伺服器上的檔案名稱正常，但在JSP頁面點下載連結時檔案名稱亂碼導致不能正常下載。

尋找資料：TOMCAT 連結參數有中文時，亂碼解決方案
http://hi.baidu.com/jadestone/blog/item/7564deefc9192d36acafd5be.html
修改tomcat-home/conf/server.xml
方法一:
在兩處地方加上URIEncoding="utf-8"：
    <Connector port="8080"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000"
               disableUploadTimeout="true" URIEncoding="utf-8" />
              
    <Connector port="8009"
               enableLookups="false" redirectPort="8443" debug="0"
               protocol="AJP/1.3" URIEncoding="utf-8" />
              
方法二:
使用useBodyEncodingForURI="true". 這個方法適合你的TOMCAT執行個體下需要跑多個不同Encoding的程式時。（有點懷疑？！）
<... maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
       enableLookups="false" redirectPort="8443" acceptCount="100"
      connectionTimeout="20000" disableUploadTimeout="true" useBodyEncodingForURI="true" />

     enableLookups="false" redirectPort="8443" protocol="AJP/1.3" useBodyEncodingForURI="true" /

我只試了方法一，問題解決！

這樣, FCKeditor終於可以正常使用了。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。
=================================================================
以下為個人原創 http://blog.csdn.net/nickshen3/[我是轉自這裡]
怎麼將FCKeditor2.4使用在自己的web中。
1. 在webapps建立test檔案夾。webapps/test
2. 將下載的FCKeditor2.3的Java包FCKeditor-2.3.zip解壓縮，並將web檔案夾下的兩個檔案夾_samples，WEB-INF拷貝到剛才建立的webapps/test下。再將src檔案夾下的FCKeditor.tld拷貝到WEB-INF下。
3. 在webapps/test/下建立檔案夾FCKeditor 。
4. 將剛才下載的 FCKeditor_2.4.3.zip 解壓縮，然後將fckeditor檔案夾下的 editor（檔案夾）,fckconfig.js,fckeditor.js,fckstyles.xml,fcktemplates.xml。四個檔案拷貝到剛才建立的檔案夾FCKeditor下。
5.修改test/_samples/jsp/sample02.jsp檔案，將原來的
       <FCK:editor id="EditorDefault" basePath="/FCKeditor/"
改為<FCK:editor id="EditorDefault" basePath="/test/FCKeditor/"。以後使用的時候只需將test換成項目的名稱即可。
6.開啟tomcat。測試Http://localhost:8080/test/_samples/jsp/sample02.jsp。
ok。