开发Portlet第一步：如何基于Crystal开发静态Portlet？

当团队需要基于Crystal开发Porltet时，分为以下三部：

基于Crystal开发静态Portlet
基于将静态Portlet修改为基于测试数据的动态Portlet
将动态Portlet与动态数据服务联调

那么如何基于Crystal开发静态Portlet呢？

分步指南

1、创建项目

准备基于Eclipse的Liferay开发环境，复制静态Portlet开发项目static-development-portlet，具体目录结构如下：

模版项目中包含4个Portlet，便于初始化，具体初始化项目如下：

修改项目名称信息：

/static-development-portlet/pom.xml文件：修改Group Id、Artifact Id和Version信息为项目指定值

/static-development-portlet/src/main/webapp/WEB-INF/liferay-plugin-package.properties文件：如下图修改相应信息为项目指定值

/static-development-portlet/src/main/webapp/WEB-INF/liferay-plugin-package.xml文件：如下图修改相应信息为项目指定值

2、修改（增加、删除）Portlet信息：

/static-development-portlet/src/main/webapp/WEB-INF/portlet.xml文件：

每个<portlet></portlet>标签对应一个portlet定义，模版文件中包含四个Portlet定义，可根据实际需要修改或增删。

portlet-name信息必须英文、全局唯一，根据项目指定，一般结构为【项目代码】-【porlet代码】，多单词间用横杠“-”隔开。

display-name用于管理过程中区分哪个Portlet，titile用于显示Portlet边框上的标题文字，取简洁明了的文字。

portletSetupShowBorders是默认是否显示边框，fase为不显示。

以下示例代码中，除portlet-name和中文内容外，可不改。

<portlet>

        <portlet-name>static-user-list</portlet-name>

        <display-name>用户列表（静态）</display-name>

        <portlet-class>com.gsoft.crystal.portlet.CrystalDispatcherPortlet</portlet-class>

        <expiration-cache>0</expiration-cache>

        <supports>

            <mime-type>text/html</mime-type>

            <portlet-mode>view</portlet-mode>

        </supports>

        <resource-bundle>content.Language</resource-bundle>

        <portlet-info>

            <title>用户管理（静态）</title>

            <short-title>用户管理（静态）</short-title>

            <keywords>用户管理（静态）</keywords>

        </portlet-info>

        <portlet-preferences>

            <preference>

                <name>portletSetupShowBorders</name>

                <value>false</value>

            </preference>

        </portlet-preferences>

        <security-role-ref>

            <role-name>administrator</role-name>

        </security-role-ref>

    </portlet>

/static-development-portlet/src/main/webapp/WEB-INF/liferay-portlet.xml文件：

每个<portlet></portlet>标签对应一个portlet定义，模版文件中包含四个Portlet定义，可根据实际需要修改或增删。

portlet-name必须与portlet.xml文件中的portlet-name一一对应。

其余为加载图标、CSS、JS文件的路径，确保与具体的文件路径保持一致。

<portlet>

<portlet-name>static-user-list</portlet-name>

<icon>/images/user-list.png</icon>

<header-portlet-css>/css/bootstrap-multiselect.css</header-portlet-css>

<header-portlet-css>/css/user-list.css</header-portlet-css>

<footer-portlet-javascript>/js/jquery-2.1.1.js</footer-portlet-javascript>

<footer-portlet-javascript>/js/bootstrap.min.js</footer-portlet-javascript>

<footer-portlet-javascript>/js/bootstrap-multiselect.js</footer-portlet-javascript>

<footer-portlet-javascript>/js/user-list.js</footer-portlet-javascript>

</portlet>

/static-development-portlet/src/main/webapp/WEB-INF/liferay-display.xml文件：

如下图，将定义的portlet添加到static-dev分类中。

在/static-development-portlet/src/main/webapp/WEB-INF/spring目录下修改或增删****-portlet.xml文件

其中****对应portlet-name属性的值（去除横杠，如portlet-name为test-list，则文件名为testlist-portlet.xml）。

修改对应的包路径（必须为com.gsoft.portlet，的子包，否则可能会出现未知问题）。

修改jsp文件所在目录。

/static-development-portlet/src/main/webapp/WEB-INF/jsp目录下为每个portlet建一个文件夹，与上文件指定的路径一致。

com.gsoft.portlet.demo.application包下创建portlet类，类名不限：

内容如下：

/**

 * @author shencq

 *

 */

@Controller

public class ApplicationManagementPortlet extends AbstractCrystalPortlet {

    @RequestMapping

    public String view(Model model, RenderRequest request) {

        return "view";

    }

    @RequestMapping(params = "action=add")

    public String view4add(Model model, @RequestParam String rediract) {

        model.addAttribute("rediract", rediract);

        return "add";

    }

    @RequestMapping(params = "action=save")

    public String save(Model model, @RequestParam String rediract){

        model.addAttribute("rediract", rediract);

        return "pop_up_success";

    }

}