Liferay7 BPM门户开发之29: 核心kernel.util包下面的通用帮助类ParamUtil、GetterUtil使用

与其闭门造车，不如直接开动原装、进口、免费的法拉利。 -- 作者说

不多说废话，直接上代码。

ParamUtil

ParamUtil、GetterUtil是Liferay最重要的帮助类

ParamUtil用途：获取PortletRequest的参数值，并作类型转换和判空处理（内部机制是通过GetterUtil）
GetterUtil用途：对输入做类型转换、判空处理、赋予默认值（即期望的获取值为空时侯的初始值）

ParamUtil的使用例子1：

public void deleteInterview(
        ActionRequest actionRequest, ActionResponse actionResponse)
    throws Exception {

    long interviewId = ParamUtil.getLong(actionRequest, "interviewId");
    InterviewLocalServiceUtil.deleteInterview(interviewId);

    sendRedirect(actionRequest, actionResponse);
}

ParamUtil的使用例子2：

public void updateQuestion(
        ActionRequest actionRequest, ActionResponse actionResponse)
    throws Exception {

    long questionId = ParamUtil.getLong(actionRequest, "questionId");
    long questionSetId = ParamUtil.getLong(actionRequest, "questionSetId");
    String title = ParamUtil.getString(actionRequest, "title");
    String description = ParamUtil.getString(actionRequest, "description");
    int type = ParamUtil.getInteger(actionRequest, "type");

    ServiceContext serviceContext = ServiceContextFactory.getInstance(
        actionRequest);

    try {
        if (questionId <= 0) {
            QuestionLocalServiceUtil.addQuestion(
                questionSetId, title, description, type, serviceContext);
        }
        else {
            QuestionLocalServiceUtil.updateQuestion(
                questionId, title, description, type, serviceContext);
        }
    }
    catch (Exception e) {
        ...
    }

    sendRedirect(actionRequest, actionResponse);
}

ParamUtil可以通过get来直接获取PortletRequest参数，如：

public static short get(
         PortletRequest portletRequest, String param, short defaultValue) {
 
         return GetterUtil.get(portletRequest.getParameter(param), defaultValue);
     }
 
     public static String get(
         PortletRequest portletRequest, String param, String defaultValue) {
 
         String returnValue =
             GetterUtil.get(portletRequest.getParameter(param), defaultValue);
 
         if (returnValue != null) {
             return returnValue.trim();
         }
 
         return null;
     }

也可以通过类似getInteger、getLong 获取单一值和获取数组的getIntegerValues、getLongValues之类的方法（用于checkbox的提交）实际都是一样的。

区别是getIntegerValues、getLongValues的返回值是通过调用GetterUtil

public static int getInteger(HttpServletRequest request, String param) {
         return GetterUtil.getInteger(request.getParameter(param));
     }
 
     public static int getInteger(
         HttpServletRequest request, String param, int defaultValue) {
 
         return get(request, param, defaultValue);
     }
 
     public static int[] getIntegerValues(
         HttpServletRequest request, String param) {
 
         return getIntegerValues(request, param, new int[0]);
     }
 
     public static int[] getIntegerValues(
         HttpServletRequest request, String param, int[] defaultValue) {
 
         return GetterUtil.getIntegerValues(
             request.getParameterValues(param), defaultValue);
     }

同时，还可以通过print来打印参数输出，方便程序员使用

public static void print(PortletRequest portletRequest) {
         Enumeration<String> enu = portletRequest.getParameterNames();
 
         while (enu.hasMoreElements()) {
             String param = enu.nextElement();
 
             String[] values = portletRequest.getParameterValues(param);
 
             for (int i = 0; i < values.length; i++) {
                 System.out.println(param + "[" + i + "] = " + values[i]);
             }
         }
     }

另外较高版本增加了ServiceContext的参数

static float getFloat(ServiceContext serviceContext, String param, float defaultValue) 

static float[] getFloatValues(ServiceContext serviceContext, String param, float[] defaultValue)

GetterUtil

GetterUtil的代码，就不具体解释了
可以访问：
https://docs.liferay.com/portal/5.1/javadocs/portal-kernel/com/liferay/portal/kernel/util/GetterUtil.java.html

GetterUtil的使用例子：发送request属性到jsp

//java：

package com.liferay.docs.exampleserviceconsumerportlet;

import java.io.IOException;
import javax.portlet.Portlet;
import javax.portlet.PortletException;
import javax.portlet.RenderRequest;
import javax.portlet.RenderResponse;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Reference;
import com.liferay.portal.kernel.portlet.bridges.mvc.MVCPortlet;
import com.liferay.portal.service.UserLocalService;
import com.liferay.bookmarks.service.BookmarksFolderLocalService;

@Component(
        immediate = true,
        property = {
                "com.liferay.portlet.display-category=category.sample",
                "com.liferay.portlet.instanceable=true",
                "javax.portlet.display-name=Example Service Consumer Portlet",
                "javax.portlet.init-param.template-path=/",
                "javax.portlet.init-param.view-template=/view.jsp",
                "javax.portlet.security-role-ref=power-user,user"
        },
        service = Portlet.class
)
public class ExampleServiceConsumerPortlet extends MVCPortlet {
    
    @Override
    public void doView(RenderRequest request, RenderResponse response)
            throws IOException, PortletException {

        int userCount = getUserLocalService().getUsersCount();
        request.setAttribute("USER_COUNT", userCount);

        int bookmarksFolderCount =
                getBookmarksFolderLocalService().getBookmarksFoldersCount();
        request.setAttribute("BOOKMARKS_FOLDER_COUNT", bookmarksFolderCount);

        super.doView(request, response);
    }
    
    public BookmarksFolderLocalService getBookmarksFolderLocalService() {
        return _bookmarksFolderLocalService;
    }

    public UserLocalService getUserLocalService() {
        return _userLocalService;
    }

    @Reference
    public void setBookmarksFolderLocalService(
            BookmarksFolderLocalService bookmarksFolderLocalService) {

        _bookmarksFolderLocalService = bookmarksFolderLocalService;
    }

    @Reference
    public void setUserLocalService(UserLocalService userLocalService) {
        _userLocalService = userLocalService;
    }

    private UserLocalService _userLocalService;
    private BookmarksFolderLocalService _bookmarksFolderLocalService;
}

//jsp：

<%@ taglib uri="http://java.sun.com/portlet_2_0" prefix="portlet" %>
<%@ page import="com.liferay.portal.kernel.util.GetterUtil" %>
<portlet:defineObjects />

<%
int userCount = GetterUtil.getInteger(renderRequest.getAttribute("USER_COUNT"));
int bookmarksFolderCount = GetterUtil.getInteger(renderRequest.getAttribute("BOOKMARKS_FOLDER_COUNT"));
%>

<p>The portal has <%= userCount %> users.</p>
<p>The portal has <%= bookmarksFolderCount %> bookmarks folders.</p>

GetterUtil和ParamUtil的区别是：ParamUtil是解析请求专用类，而GetterUtil是通用的类型转换输出类
使用这两个类ParamUtil、GetterUtil的好处显而易见，如果配合Validator类，像判空、类型转换、验证的大段代码可以大大的省略，非常简洁