【Liferay Portal指南六】——Configuration Portlet开发

ゝ一纸荒年。 2022-08-11 10:59 193阅读 0赞

注意：

以下内容是基于Liferay 4.2.2版本，对于Liferay 5.1.X有很大的不同

对于这份指南,Configuration Portlet的开发流程采用的也是Struts Portlet的开发流程。

**Step1：配置Portlet**  
添加portlet配置信息到…/ext-web/docroot/WEB-INF/portlet-ext.xml中。  
对于这份指南, 添加下列内容到你的portlet-ext.xml。  
<portlet> <portlet-name>EXT\_3</portlet-name> <display-name>Default Message</display-name> <portlet-class>com.liferay.portlet.StrutsPortlet</portlet-class> <init-param> <name>view-action</name> <value>/ext/defaultmessage/view</value> </init-param> <expiration-cache>0</expiration-cache> <supports> <mime-type>text/html</mime-type> </supports> <resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle> <security-role-ref> <role-name>power-user</role-name> </security-role-ref> </portlet>

**Step2：配置Portlet实例属性**  
添加Liferay具体信息到…/ext-web/docroot/WEB-INF liferay-portlet-ext.xml。  
对于这份指南, 添加下列内容到你的liferay-portlet-ext.xml中即可。  
<portlet> <portlet-name>EXT\_3</portlet-name> <struts-path>ext/defaultmessage</struts-path> <configuration-path>/ext/defaultmessage/config</configuration-path> <use-default-template>false</use-default-template> <restore-current-view>false</restore-current-view> <instanceable>true</instanceable> <private-request-attributes>false</private-request-attributes> <private-session-attributes>false</private-session-attributes> <render-weight>0</render-weight> </portlet>

注意：  
1．<sruts-path> 是value中第一个“/”和最后一个“/”之间的内容。  
2. 这里的<portlet-name>??素的值 EXT\_3必须要和portlet-ext.xml中的<portlet-name>元素的值一致的。

**Step3：定义Portlet名称**  
定向到…/ext-ejb/classes/content/Language-ext.properties添加：

javax.portlet.title.EXT\_3=Default Message  
其中的key值（即javax.portlet.title.EXT\_3），是“javax.portlet.title”+“portlet名字”（即在portlet-ext.xml中添加的portlet的<portlet-name>的值）  
  
**Step4：归类Portlet**  
定向到…/ext-web/docroot/WEB-INF/liferay-display.xml，添加Portlet归类信息如下:  
<category name="category.test"> <portlet id="EXT\_2" /> <portlet id="EXT\_3" /> ... </category>  
以上信息主要是为了在添加应用窗口中显示定义的portlet。如果做了Step3，那么最终在添加应用窗口中显示是第三步所定义的名字。在本例中将显示“Default Message”。添加应用窗口如下图所示，因使用liferay版本不同页面效果会不太一样。

![11.jpg][]  
  
**Step5：定义Struts页面流**  
在配置文件…/ext-web/docroot/WEB-INF/struts-config.xml中定义struts页面流。  
<action path="/ext/defaultmessage/view" type="com.ext.portlet.defaultmessage.action.DefaultMessageViewAction"> <forward name="portlet.ext.defaultmessage.view" path="portlet.ext.defaultmessage.view"/></forward> </action> <action path="/ext/defaultmessage/config" type="com.ext.portlet.defaultmessage.action.DefaultMessageConfigAction"> <forward name="portlet.ext.defaultmessage.config" path="portlet.ext.defaultmessage.config"></forward> </action>

注意：  
这里的path="/ext/defaultmessage/view "值就是portlet-ext.xml中对应的view-action的值。  
<init-param> <name>view-action</name> <value>/ext/defaultmessage/view </value> </init-param>

这里的path="/ext/defaultmessage/config "值就是liferay-portlet-ext.xml中对应的标签<configuration-path>的值。  
<portlet-name>EXT\_3</portlet-name> <struts-path>ext/defaultmessage</struts-path> <configuration-path>/ext/defaultmessage/config</configuration-path> ……

**Step6：定义tiles页面布局**  
在配置文件…/ext-web/docroot/WEB-INF/tiles-defs.xml中定义页面布局。  
<definition name="portlet.ext.defaultmessage.view" extends="portlet"> <put name="portlet\_content" value="/portlet/ext/defaultmessage/view.jsp" /> </definition> <definition name="portlet.ext.defaultmessage.config" extends="portlet.portlet\_configuration.edit\_configuration"> <put name="portlet\_configuration\_content" value="/portlet/ext/defaultmessage/config.jsp" /> </definition>

这理portlet.ext.defaultmessage.view 继承 portlet。这意味着portlet.ext.defaultmessage.view将会使用 portlet.jsp 作为它的模板。portlet.portlet\_configuration.edit\_configuration道理相同。

注意：  
这里的name="portlet.ext.defaultmessage.view"值就是struts-config.xml中对应的forward="portlet.ext.defaultmessage.view"的值。  
这里的name="portlet.ext.defaultmessage.config"值就是struts-config.xml中对应的forward="portlet.ext.defaultmessage.config "的值。

**Step7：创建目录defaultmessage**  
创建一个叫defaultmessage的目录，你的目录结构应该像这样: …/ext-web/docroot/html/portlet/ext/defaultmessage。

**Step8：创建init.jsp**  
在defaultmessage中创建init.jsp你的目录结构应该像这样：…/ext-web/docroot/html/portlet/ext/ defaultmessage /init.jsp。输入下列内容到init.jsp中：  
<%@ include file="/html/common/init.jsp" %>  
  
看看我们在这行中包含了什么？  
<%@ include file="/html/common/init.jsp" %>

实际对应目录是：…/portal/portal-web/docroot/html/common/init.jsp。这将会让我们使用Liferay 标签库

**Step9：创建view.jsp**  
在defaultmessage中创建view.jsp文件。在本例中，可以直接复制如下代码。  
<%@ include file="/html/portlet/ext/library/init.jsp"%> <br />The default message is:<br /> <% String defaultMessage = (String) request.getAttribute("default\_message"); %> <table width="100%" border="0" align="center" cellpadding="0" cellspacing="0"> <tr align="center"> <td><%=defaultMessage %></td> </tr> </table> <%@ include file="/html/portlet/ext/defaultmessage/init.jsp" %>

这将会让我们使用在上一步这定义的init.jsp

**Step10：创建config.jsp**  
在defaultmessage中创建config.jsp文件。在本例中，可以直接复制如下代码。  
<%@ include file="/html/portlet/ext/library/init.jsp"%> <br /> Setup the default message: <br /> <form action="<liferay-portlet:actionURL portletConfiguration="true" />" method="post" name="<portlet:namespace />fm"> Content: <input name="<portlet:namespace />default\_message" size="20" type="text" value=""> <br /> <input type="button" value="Submit" onClick="submitForm(document.<portlet:namespace />fm);"> </form> <%@ include file="/html/portlet/ext/defaultmessage/init.jsp" %>

这将会让我们使用在上一步这定义的init.jsp

**Step11：创建Action类**  
创建 action 类来处理信息，DefaultMessageViewAction.java。  
package com.ext.portlet.defaultmessage.action; import javax.portlet.PortletConfig; import javax.portlet.PortletPreferences; import javax.portlet.RenderRequest; import javax.portlet.RenderResponse; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionForward; import org.apache.struts.action.ActionMapping; import com.liferay.portal.kernel.util.StringPool; import com.liferay.portal.struts.PortletAction; import com.liferay.util.Validator; public class DefaultMessageViewAction extends PortletAction \{ public ActionForward render(ActionMapping mapping, ActionForm form, PortletConfig config, RenderRequest request, RenderResponse response) throws Exception \{ PortletPreferences prefs = request.getPreferences(); String defaultMessage = prefs.getValue("default\_message", StringPool.BLANK); if (Validator.isNull(defaultMessage)) \{ return mapping.findForward("/portal/portlet\_not\_setup"); \} request.setAttribute("default\_message", defaultMessage); return mapping.findForward("portlet.ext.defaultmessage.view"); \} \}

DefaultMessageConfigAction.java

package com.ext.portlet.defaultmessage.action; import javax.portlet.ActionRequest; import javax.portlet.ActionResponse; import javax.portlet.PortletConfig; import javax.portlet.PortletPreferences; import javax.portlet.RenderRequest; import javax.portlet.RenderResponse; import org.apache.struts.action.ActionForm; import org.apache.struts.action.ActionForward; import org.apache.struts.action.ActionMapping; import com.liferay.portal.kernel.util.StringPool; import com.liferay.portal.struts.PortletAction; import com.liferay.portlet.PortletPreferencesFactory; import com.liferay.util.ParamUtil; import com.liferay.util.servlet.SessionMessages; public class DefaultMessageConfigAction extends PortletAction \{ public void processAction(ActionMapping mapping, ActionForm form, PortletConfig config, ActionRequest request, ActionResponse response) throws Exception \{ String defaultMessage = ParamUtil.getString(request, "default\_message"); if (defaultMessage != null) \{ String portletResource = ParamUtil.getString(request, "portletResource"); PortletPreferences prefs = PortletPreferencesFactory.getPortletSetup(request, portletResource, true, true); prefs.setValue("default\_message", defaultMessage); prefs.store(); SessionMessages.add(request, config.getPortletName() + ".doConfigure"); \} \} public ActionForward render(ActionMapping mapping, ActionForm form, PortletConfig config, RenderRequest request, RenderResponse response) throws Exception \{ String portletResource = ParamUtil.getString(request, "portletResource"); PortletPreferences prefs = PortletPreferencesFactory.getPortletSetup(request, portletResource, true, true); String defaultMessage = prefs.getValue("default\_message", StringPool.BLANK); request.setAttribute("default\_message", defaultMessage); return mapping.findForward("portlet.ext.defaultmessage.config"); \} \}

**Step12：测试框架部署**  
利用命令Ant deploy。部署文件到Tomcat服务器，需要重新启动服务器。检验文件是否部署到tomcat。  
定向到… /tomcat/webapps/ROOT/WEB-INF 打开portlet-ext.xml，liferay-portlet-ext.xml，struts-config-ext.xml和tiles-defs-ext.xml检查文件是否部署正确。  
定向到… /tomcat/webapps/ROOT/html/portlet/ext/defaultmessage打开view.jsp和config.jsp，检查文件是否部署正确。  
启动服务器，访问[http://localhost:8080][http_localhost_8080]。  
登录系统，用户名：[test@liferay.com][test_liferay.com]。密码：test。  
调出添加应用页面，找到添加的portlet。本例中，找到Default Message。

![22633700575315156250.jpg][]

因为还没有配置信息，所以初始状态显示的是页面“/portal/portlet\_not\_setup”中的内容。点击【Configuration】按钮，跳转到配置页面。

![33.jpg][]

输入信息，提交之后，返回正常页面。如果显示如下内容，那么配置就成功了。

![44.jpg][]

[11.jpg]: /images/20220810/093799e66c4c4613bb8de975ced4a83e.png
[http_localhost_8080]: http://localhost:8080
[test_liferay.com]: mailto:test@liferay.com
[22633700575315156250.jpg]: /images/20220810/9d0ddf0913514038b072058155ab63a9.png
[33.jpg]: /images/20220810/fee556803d87459fa69231bf9d05c1ec.png
[44.jpg]: /images/20220810/fd32e10501254b53a452aae7f18879c8.png