在JSF/JSP中集成FCKEditor 2.6

目前,FCKEditor (http://www.fckeditor.net/) 是开源社区一款强大的HTML编辑器,目前最新版本是2.6,支持Java的插件版本是2.4Beta1。

 

对于一般的Java Web应用,我们可以通过直接插入JavaScript代码来构造页面,这种方式操作起来比较简便,也是通用在所有web页面的一种方式。但是,在实际的Java Web应用中,我们除了用到普通的页面编辑功能之外,难免会考虑到页面上传图片、附件等功能。所以,单纯使用JavaScript方式的话,这一大堆的文件上传代码将由你自己来写了,工程量还是比较浩大的。自然而然,我们会想到Jsp Tag,有没有现成的快餐式的页面标签呢?答案是肯定的,就如我上文提到的Java插件就已经实现了这些功能,并集成了Apache Commons-FileUpload,以此来实现文件服务器上传。

 

2.4版的Java插件已经封装得更加简洁,不同于之前的其他版本。标签的使用方式是,

<%@taglib uri="http://java.fckeditor.net" prefix="FCK"%>
<FCK:editor instanceName="EditorDefault" width="755" height="460" basePath="/fckeditor" value="Hello, world">
  <jsp:body>
    <FCK:config SkinPath="skins/office2003/" />
  </jsp:body>
</FCK:editor>

 

在JSF应用中,由于页面都是JSF自定义标签,对于其他标签的内容,JSF不会自动将后台Bean中的值绑定到<FCK:editor/>,那么我们还要做做文章,通过一段JavaScript绑定到body_onload()事件中,以此将JSF标签的内容传递给<FCK:editor/>。

<script type="text/javascript">    
    function renderMessage() {
        YAHOO.util.Dom.get("EditorDefault").value = YAHOO.util.Dom.get("form:content").value;
    }
</script>

<f:view>
  <h:form id="form">
    <h:inputTextarea id="content" value="#{mainMessageEditBean.message.messageContent}" style="display:none"></h:inputTextarea>
  </h:form>
</f:view>

 

保存HTML编辑内容的时候,你只需要通过获得到的HttpServletRequest对象获取页面提交中的Parameter对象,示例代码如下:

    public Map getParamMap() {
        return getFacesContext().getExternalContext().getRequestParameterMap();
    }
    
    public String getParamAsString(String paramName) {
        Object obj = getParamMap().get(paramName);
        if (obj != null) {
            return obj.toString();
        } else {
            return "";
        }
    }

    public String saveMessage() {
        if (message == null) {
            setErrMsg("Message does not exist.");
            return null;            
        }
        String content = getParamAsString("EditorDefault");
        if (content == null || content.length() == 0) {
            setErrMsg("Message must not be empty.");
            return null;                        
        }
    }

 

其他方面,我们需要在自己的web.xml中定义FCKEditor相关的Servlet:

<servlet>
  <servlet-name>Connector</servlet-name>
    <servlet-class>
         net.fckeditor.connector.ConnectorServlet
    </servlet-class>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>Connector</servlet-name>
    <url-pattern>
         /fckeditor/editor/filemanager/connectors/*
    </url-pattern>
</servlet-mapping>

 

这里需要注明的是,/fckeditor这个web根目录下的目录来源于FCKEditor的核心包(Ver 2.6),可以在官方网站上面下载得到。

 

在目录/fckeditor下面有一个重要的文件fckconfig.js,里面可以配置许多FCKEditor在页面上的展示风格,大家可以仔细慢慢研究 :)

 

PS: 考虑到安全问题,建议大家把FCKEditor界面上的Source Code按钮屏蔽掉,防止黑客的恶意脚本的破坏。

 

 

在我的实际应用中,因为要限制上传文件的权限,所以我要用到权限控制。幸好FCKEditor提供了相应的UserAction接口,可以让我自己实现一个类来控制权限。

package com.tail.utils;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;

import net.fckeditor.requestcycle.UserAction;

import com.tail.beans.Principal;
import com.tail.objects.User;

public class UserActionImpl implements UserAction {

    public boolean isEnabledForFileBrowsing(HttpServletRequest req) {        
        return true;
    }

    public boolean isEnabledForFileUpload(HttpServletRequest req) {
        HttpSession session = req.getSession();
        Principal principal = (Principal) session.getAttribute(ConstantUtil.SESSION_PRINCIPAL);
        if (principal != null) {  
            User user = principal.getUser();
            if (user.isUploadable()) {
                return true;
            }
        }
        return false;
    }

}

 

如何加载自定义的UserAction类呢?在classes的根目录下,你需要定义一个fckeditor.properties文件:

connector.userActionImpl=com.tail.utils.UserActionImpl

 

这样你就可以控制文件上传的权限了。

 

我的2.4Beta1版的JAR包在文件上传上还有一些问题,我已经下载了相应Java Source Code做了修改,一切都运行的比较正常!

 

PS: 下载的Java Project是基于Maven的,如果不懂Maven的同学抓紧温习温习吧!

 

 

阅读更多
个人分类: Java Framework
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

关闭
关闭
关闭