Liferay 6.1开发学习：基于注解的SpringMVC portlet开发

转自： http://www.huqiwen.com/2013/01/10/liferay-6-1-development-study-17-springmvc-portlet/

SpringMVC使用起来是简单易懂，方便快捷。springmvc 在很早之前就开始提供对于JSR168的支持，同样的liferay的这个portal是实现了JSR 168和JSR268规范的，理论只要是提供对JSR 168或JSR268规范支持的MVC框架都可以用来开发Liferay portlet，像Struts1/struts2/SpringMVC等。

对于SpringMVC在portlet中的使用，在Spring的官方文档中已经有说了详细的说明（在spring-framework-reference中的19章。），这里参考官方文档进行配置。

环境准备

Liferay版本：6.1.1 CE版本

Spring版本：3.2.0 GA

Liferay IDE: 1.6.1

开发步骤

一、导入SpringMVC portlet所需要的jar包。

• spring-beans-3.2.0.RELEASE.jar
• spring-context-3.2.0.RELEASE.jar
• spring-core-3.2.0.RELEASE.jar
• spring-expression-3.2.0.RELEASE.jar
• spring-web-3.2.0.RELEASE.jar
• spring-webmvc-3.2.0.RELEASE.jar
• spring-webmvc-portlet-3.2.0.RELEASE.jar

二、新建一个Portlet插件开发的工程，可以使用Liferay IDE中的portlet创建向导建立一个普通的插件工程。

三、修改web.xml，在里面添加如下内容：

<servlet>
    <servlet-name>ViewRendererServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.ViewRendererServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>ViewRendererServlet</servlet-name>
    <url-pattern>/WEB-INF/servlet/view</url-pattern>
</servlet-mapping>

四、portlet.xml中的内容修改，portlet.xml中的主要内容如下，主要为portlet-class的内容，要使用spring的dispatcherPortlet，下面的init-param为非必须的，他配置的内容为当前portlet所对应的mvc配置信息的xml地址，如果不配置，则自动的在web-inf目录下面寻找名称和当前portlet-name一样的xml文件。

<portlet-name>SpringMVC</portlet-name>
<display-name>SpringMVC</display-name>
<portlet-class>org.springframework.web.portlet.DispatcherPortlet</portlet-class>
<init-param>
    <name>contextConfigLocation</name>
    <value>/WEB-INF/SpringMVC-portlet.xml</value>
</init-param>
<expiration-cache>0</expiration-cache>
<supports>
    <mime-type>text/html</mime-type>
    <portlet-mode>view</portlet-mode>
</supports>

五、springmvc的配置XML信息如下：SpringMVC-portlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.2.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd">

    <context:component-scan base-package="com.huqiwen.portlet" />
    <bean id="viewResolver"
        class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass"
            value="org.springframework.web.servlet.view.JstlView" />
        <property name="prefix" value="/WEB-INF/jsp/" />
        <property name="suffix" value=".jsp" />
    </bean>
</beans>

可以看到这里和普通的SpringMVC的配置没有什么区别。

六、编写SpringMVC的controller类，如下：

@Controller
@RequestMapping(value = "VIEW")
public class SpringPortlet {

    @RenderMapping
    public String view(Model model){
        model.addAttribute("username", "huqiwen");
        return "view";
    }

    @RenderMapping(params = "action=edit")
    public String edit(Model model){
        model.addAttribute("edit", "action=edit");
        return "edit";
    }
}

说明：

@RequestMapping中的VIEW，代表当前的是portlet的VIEW模式，如果是EDIT模式，则将这里的VIEW换成edit即可。

@RenderMapping 默认对应的是portlet进入的时候执行的方法。

@RenderMapping(params = "action=edit")   这个请求的是对应于用户在页面中的请求，如JSP中有如下的portlet请求，则会进入到这个方法里面，这里param name可以自定义，不一定叫action，可以叫cmd，op等均可

<portlet:renderURL var="edit">
    <portlet:param name="action" value="edit"/>
</portlet:renderURL>

一个简单的SpringMVC portlt示例下载：点击我