Liferay7.0开发学习(四):MVC Portlet开发详解

2016年06月07日 Liferay, Liferay7 评论 5 条 阅读 11,905 views 次

本文介绍的是Liferay 7.0开发中的MVC portlet的更详细的介绍,一个基本的MVC Portlet插件的创建与部署请参考下面这一篇博客:

Liferay7.0开发学习(二):创建并部署一个Portlet

此篇博客的内容是基于上面的代码进行的。

我们开发此Portlet时,主要有两部分组成,

1、后台的控制类MvcPortletTestmvcportlet,相当于action,用来处理前端页面的跳转与参数接收。

2、前端相应的JSP代码,用来做前端的界面展示。

为啥称为MVCPortlet?

这是因为我们写的控制类继承自MVCPortlet,MVCPortlet继承自LiferayPortlet。LiferayPortlet继承自GenericPortlet,其中的GenericPortlet为Portlet规范里面定义的接口,Liferay是基于此做一些方便开发的扩展,所以我们称他为MVC Portlet。

在Liferay Portlet开发中我们也可以使用Struts2,SpringMVC等进行开发,我们一般说MVC Portlet时,指的就是我们采用控制类继承自MVCPortlet的方法。

MVCPortlet控制类配置属性详解

我们在此类的最上方看到有如下的注解。

MVC Portlet

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

portlet分类

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

跳转控制

页面上的Portlet的执行顺序是这样的。

首页进入MVCPortlet控制类的doview方法-->然后进入相应的JSP文件。

如果我们的控制类里面没有doview方法,则是执行父类的doview方法,想在JSP展现的时候从数据库或者是其他地方加载数据,我们一般将内容放在doview方法里面。

在页面中提交表单,或者跳转到其他页面,都需要使用portlet的标签。控制跳转的主要有三个标签。

<portlet:renderURL>

<portlet:actionURL>

<portlet:resourceURL>

下面逐个介绍:

<portlet:renderURL>

一般是使用下面的标签。

注意:在进行下面的之前,不要忘了在init.jsp里面引入相关的标签。

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>

<%@ taglib uri="http://java.sun.com/portlet_2_0" prefix="portlet" %>

<%@ taglib uri="http://liferay.com/tld/aui" prefix="aui" %>
<%@ taglib uri="http://liferay.com/tld/portlet" prefix="liferay-portlet" %>
<%@ taglib uri="http://liferay.com/tld/theme" prefix="liferay-theme" %>
<%@ taglib uri="http://liferay.com/tld/ui" prefix="liferay-ui" %>

<liferay-theme:defineObjects />

<portlet:defineObjects/>

1、进入doview方法。

 

<portlet:renderURL var="toViewURL"></portlet:renderURL>

其中的var是定义一个变量,也就是URL地址了,可以在JSP的其他地方使用。如form的action里面。

执行此标签会进入后台控制类的doView方法里面。

2、跳转到其他页面。

下面代码的逻辑是先进入doview方法,然后跳转到other.jsp的页面。

<portlet:renderURL var="toViewURL">

<portlet:param name="mvcPath" value="/other.jsp"/>

</portlet:renderURL>

注意:mvcPath是固定的参数,也可以换为jspPage,但是推荐使用mvcPath,jspPage已经是废弃参数,虽然目前版本还支持,但不确定在哪个版本中可能就取消了。

<portlet:actionURL>

renderURL的标签是进入到doview方法,actionURL可以让我们进入到指定的后台方法里面。

1、进入指定方法

比如现在我们提交了一个表单,想保存到数据库中,我们调用addBook方法。

<portlet:actionURL var="addURL" name="addBook"></portlet:actionURL >

在后台的方法我们有几种写法:

方法一:

 public void addBook(ActionRequest request,ActionResponse response){

      }

方法二:

 @ProcessAction(name="addBook")
 public void actionTest(ActionRequest request,ActionResponse response){
 
 }

区别在于方法一直接是写的对应的名称,方法二是使用的注解,看自己喜好,无所谓好坏。

2、进入指定的页面。

上面的方法执行后,还会跳转到当前页面,如果想跳转到指定的页面,需要添加mvcPath。

如下:

<portlet:actionURL var="addURL" name="addBook">

<portlet:param name="mvcPath" value="/other.jsp"/>

</portlet:actionURL >

<portlet:resourceURL>

这个是用来做ajax,或者是文件下载等的,可以参考之前的博客。

Liferay 6.1开发学习(十):在Liferay中使用Ajax

liferay中的文件下载

Liferay中怎么使用AJAX?

表单数据提交

比如我们在JSP中有如下的代码:

<portlet:actionURL var="addURL" name="addBook">
 <portlet:param name="jspPage" value="/other.jsp"/>
</portlet:actionURL >
<form action="${addURL}" method="post">
 <input type="text" name="name">
 <input type="submit">
</form>

在后台使用如下代码获取:

String name = ParamUtil.getString(request, "name");

但是我们会发现获取不值?!

这是因为在liferay 6.2开始,默认必须要加上namespace。如下图即可。

<input type="text" name="<portlet:namespace/>name">

或者:我们修改配置为不需要命名空间。

在property里面添加,加了此配置后,在JSP中加不加namespace,后台都可以获取到值。

com.liferay.portlet.requires-namespaced-parameters=false

portlet namespace

或者:使用AUI标签。AUI标签会自动的添加namesapce。

<aui:form action="${addURL}" method="post">
 <aui:input label="name" name="name"/>
 <aui:button type="submit" value="save"/>
</aui:form>

 将值传到JSP

如果在后台需要将值传到前台,使用request.setAttribute。

request.setAttribute("name", name);

在JSP页面中,可以使用java代码

String name = (String)request.getAttribute("name");

或者EL表达式

${name}

 

MVCPortlet开发的常用的基础知识就这些了。

用户头像

5 条留言  访客:5 条  博主:0 条

  1. 如何去掉 Liferay7页面下方的 由……提供技术支持 Liferay

  2. 写的很多,后续希望快点出

  3. 在gradle里面添加依赖后发布的portlet发布后无法运行,请问如何添加第三方依赖包

给我留言

您必须 登录 才能发表留言!

Copyright © IT人生录 保留所有权利.   主题设计 知更鸟 滇ICP备16001547号

用户登录

分享到: