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="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上去就好啦，理清思路是不是简单多了呢，哈哈