开发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建一个文件夹，与上文件指定的路径一致。





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

[b]

[/b]

内容如下：

/**
* @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。