开发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";
    }
}

  

其中,return "****",对应上文指定jsp目录下的jsp文件名,标识跳转到****.jsp文件。

默认执行:

 

创建静态资源文件和JSP文件:

其中,JSP文件中,除静态代码外,如需请求服务跳转页面或执行js代码,可如下所示:

3、发布portlet

创建Liferay Portal服务器

将portlet项目动到服务器下部署

启动服务即可使用portlet,修改jsp、静态文件等一般会自动更新,如不能自动更新,可手动重新部署portlet。

原文地址:https://www.cnblogs.com/luoruiyuan/p/5788675.html