首页 > 代码库 > liferay MVCActionCommand的用法及例子

liferay MVCActionCommand的用法及例子

在liferay7中把portlet中的控制层拆成了3个部分:

1.MVCActionCommand

2.MVCRenderCommand

3.MVCRecourceCommand

至于为什么要拆出来了,之前我们写actionURL,一个JSP中可能有很多actionUrl,都是把它写在mvcPortlet类中,当代码量变大,不便于管理,且结构不是特别清晰。

下面就简单介绍一下MVCActionCommand的用法,附上一个简单的小例子Say Hi to U portlet

1.建一个普通的mvc-portlet,之前以为mvc-action-command是独立存在的,也是傻傻的^^

技术分享

技术分享

这个是通过liferay ide插件自己生成出来的模板,随便解释一下,@Component里面property属性的用法。

1、com.liferay.portlet.display-category:此处是控制的在Portlet管理处,我们添加Portlet时,Portlet是在哪个分类下显示的。如下图所示,我们这里配置的是在category.sample下面,所以我们点击添加时可以在应用程序的示例下面看到。category.sample是国际化的一个key值,如果我们想自己定义分类,可以修改此值即可。

2、com.liferay.portlet.instanceable:此配置意思是是否允许portlet在同一个页面上添加多次,默认值是true,我们有些场景下可能只希望同一个Portlet,在同一个页面只允许添加一次,则将此改为false即可。看上图portlet前面是一个小圆圈的表示只能添加一次,是九个小方块的表示可以添加多次。

3、javax.portlet.display-name:显示名称,也就是我们上面看到的Portle的名称。

4、javax.portlet.init-param.template-path,此值默认为“/”,而且也只能是“/”,在MVCPortlet类里已经限制了,如果不是会报错。

5、javax.portlet.init-param.view-template=/view.jsp,portlet被拖到Liferay页面上后默认执行的是哪个JSP,此路径是相对于META-INF/resource而言,我们可以在此修改相应的JSP路径和名称。

6、javax.portlet.resource-bundle=content.Language语言的国际化支持文件,非必须的。如果要让portlet支持国际化,则需要。可在Resource/content的目录里面建立language_zh_CN.porperties文件,在里面写中文的国际化。此内容后面有博客详细说明。

7、javax.portlet.security-role-ref=power-user,user:将portlet部署后,此portlet默认哪些角色有将此portlet添加到页面的权限。

注意:此处的配置不只是只有这些,以前版本的portlet.xml、liferay-portlet.xml、liferay-display.xml的配置属性都已经挪到了这里,所以如果看到教程说的是对应的配置,在7.0里面都是添加到此处。

更多的配置可以参考源码里面的类:PortletPropertyValidator

(此处的解释参考胡启稳老师的博客)

 

2.然后我的目的是做一个portlet,你输入名字之后,它会向你问好,效果如下:

技术分享

3. 首先,我们要做的是要在view.jsp文件中写一个表单让用户可以让用户输入值,同时在用户点击按钮时触发actionRequest处理传回来的数据。

<%@ include file="/init.jsp" %>

<portlet:actionURL name="greetToU" var="myCommand">
</portlet:actionURL>
<form method="post" action = "${myCommand}">
<p>What‘s your name?</p>
<input type="text" name="name">
<input type="submit" value="http://www.mamicode.com/tell me">
</form>
${greet}

4.重点来了,如何把你写的后台的actionCommand与前台的JSP联系起来,同时又与你的portlet联系起来呢?

先看代码,然后再解释:

package mvc.portlet.portlet;
import com.liferay.portal.kernel.portlet.bridges.mvc.BaseMVCActionCommand;
import com.liferay.portal.kernel.portlet.bridges.mvc.MVCActionCommand;
import com.liferay.portal.kernel.util.ParamUtil;

import javax.portlet.ActionRequest;
import javax.portlet.ActionResponse;
import org.osgi.service.component.annotations.Component;

@Component(
immediate = true,
property = {
        "javax.portlet.name=mvc_Portlet",
        "mvc.command.name=greetToU"
},
service = MVCActionCommand.class
)
public class MyActionCommand extends BaseMVCActionCommand {

    @Override
    protected void doProcessAction(ActionRequest actionRequest, ActionResponse actionResponse) throws Exception {
        String name = ParamUtil.getString(actionRequest, "name");
        actionRequest.setAttribute("greet","Hi " + name+ ", nice to meet u!");
    }
}

注意上面那两个参数,portlet.name把它与portlet联系起来;command.name把它与jsp上的actionUrl联系起来。

然后部署到7.0的portal上去就好啦,理清思路是不是简单多了呢,哈哈

liferay MVCActionCommand的用法及例子