liferay7.0开发的二三坑

     liferay7.0的官方文档并不稳定，一直在更新完善，比如Liferay7.0 通过JPM安装Blade Cli 时[ZipFile.open] error in opening zip file 这篇，现在官网已经更新，没有这个问题了，希望新版本早日稳定，以下是我开发时遇到的一些问题：

问题一：Portlet页面中使用AJAX请求Portlet控制类中serveResource时，resourceRequest得到的AJAX请求参数为NULL ？

问题二：Liferay不同页面拥有不同theme时，切换页面时，上一个页面的theme会Cache下来

问题三：Liferay自定义字段操作

问题四：Liferay自定义JSON服务接口

问题五：在Liferay API基础上自定义 数据库查询

问题六：Liferay用户具有哪些状态，比如停用、激活等

问题七：Liferay添加用户时，用户screenname不允许为全数字

问题八： Liferay自定义登录

问题九：Liferay自定义ERROR404页面

问题十：Blade安装问题，官网提供的blade依赖的Java Package Manager 地址无法访问（截止2017.4.20日)

问题十一：Liferay 自动登录

问题十二：MVCPortlet中得到所在页面的请求参数

问题十三：Liferay7.0中任务调度定时任务

问题十四：Liferay7.0中上下文提供者

问题一：Portlet页面中使用AJAX请求Portlet控制类中serveResource时，resourceRequest得到的AJAX请求参数为NULL ？

       这个问题主要是LIferay默认情况下要求为参数加上namespace才行，这个有点坑，表单那块如果使用aui是没有这个问题的，如果使用原生表单项的话，也会遇到相同的问题，后台接收不到传的参数；所以只需为我们的请求项加上namespace就行了：

  $.post('<%=resourceURL%>',
	{"action":"role",
	 "plid":plidPageId,
         "roleId":roleId
	},
	function(data){
	                      });

问题二：Liferay不同页面拥有不同theme时，切换页面时，上一个页面的theme会Cache下来

         这个问题主要它的缓存机制有关，liferay提供了相关的Cache禁用配置，在portal-ext.properties添加以下配置：

#禁止缓存	
theme.css.fast.load=false
theme.css.fast.load.check.request.parameter=true
theme.images.fast.load=false
theme.images.fast.load.check.request.parameter=true

javascript.fast.load=false
javascript.log.enabled=false

layout.template.cache.enabled=false

browser.launcher.url=

combo.check.timestamp=true

freemarker.engine.cache.storage=soft:1
freemarker.engine.resource.modification.check.interval=0

minifier.enabled=false

openoffice.cache.enabled=false

velocity.engine.resource.modification.check.interval=0

com.liferay.portal.servlet.filters.cache.CacheFilter=false
com.liferay.portal.servlet.filters.etag.ETagFilter=false
com.liferay.portal.servlet.filters.header.HeaderFilter=false

     

         portal-ext.properties配置相关的属性值，在https://docs.liferay.com/ce/portal/7.0-latest/propertiesdoc/portal.properties.html可以查看全部的配置信息

问题三：Liferay自定义字段操作

         某些情况下，Liferay自定义的数据库字段并不能满足要求，Liferay允许在已有字段的基础上添加自定义字段，Liferay后台提供了添加自定义字段的界面操作（控制面板>配置>自定义字段），自定义字段的数据存储结构和wordpress自定义的存储字段一样，并没有在修改原有表，而是都存储在expando开头的数据表中，https://docs.liferay.com/portal/7.0/javadocs/portal-kernel/com/liferay/expando/kernel/service/package-frame.html提供了相关的API，下面是一个取自定义值得例子：

long companyId=PortalUtil.getCompanyId(renderRequest);
		try {
			long testUserId=UserLocalServiceUtil.getUserByScreenName(companyId, "test").getPrimaryKey();
			System.out.println(testUserId);
			String testvalue=ExpandoValueLocalServiceUtil.getData(companyId, User.class.getName(),
					"CUSTOM_FIELDS", "customword",
					testUserId, "test");
			System.out.println(testvalue);
			renderRequest.setAttribute("customword", testvalue);
		} catch (PortalException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

问题四：Liferay自定义JSON服务接口

        Liferay提供了两种工具新建Service模块，Eclipse 和Blade 方式创建，需要注意的就是创建以后远程的调用路径问题，可以参考官网给出的实例：

       

    另外，Liferay支持修改官网提供的接口，通过http://localhost:8080/api/jsons查看Liferay提供的原有接口，可参照官网https://dev.liferay.com/develop/tutorials/-/knowledge_base/7-0/customizing-liferay-services-service-wrappers覆盖原有借口，但要注意此模块只能覆盖原接口，不能新建接口，新建接口还需要使用上述方法。

问题五：在Liferay API基础上自定义 数据库查询

             Liferay API提供了大量的操作，但某些情况下它提供的不是太灵活，需要我们自定义，API提供了这方面的支持，例如：

        DynamicQuery guestbookQuery = DynamicQueryFactoryUtil.forClass(Guestbook.class)
            .add(RestrictionsFactoryUtil.eq("name", guestbookName))
            .setProjection(ProjectionFactoryUtil.property("guestbookId"));

        Order order = OrderFactoryUtil.desc("modifiedDate");

        DynamicQuery entryQuery = DynamicQueryFactoryUtil.forClass(Entry.class)
            .add(RestrictionsFactoryUtil.eq("name", entryName))
            .add(PropertyFactoryUtil.forName("guestbookId").in(guestbookQuery))
            .addOrder(order);

        List entries = EventLocalServiceUtil.dynamicQuery(entryQuery);

问题六：Liferay用户具有哪些状态，比如停用、激活等

           

        public static final int STATUS_ANY = -1;
	public static final int STATUS_APPROVED = 0;
	public static final int STATUS_DENIED = 4;
	public static final int STATUS_DRAFT = 2;
	public static final int STATUS_DRAFT_FROM_APPROVED = 9;
	public static final int STATUS_EXPIRED = 3;
	public static final int STATUS_INACTIVE = 5;
	public static final int STATUS_INCOMPLETE = 6;
	public static final int STATUS_PENDING = 1;
	public static final int STATUS_SCHEDULED = 7;

          可以去 http://note.youdao.com/noteshare?id=0018de9bef6459ea3aab2c6f8f07d4ec查看用户所用状态。

问题七：Liferay添加用户时，用户screenname不允许为全数字

         当我们自定义注册时，会发现liferay默认情况下screenname字段不允许为全数字：

                                //添加用户
				try {						
					User u=UserLocalServiceUtil.addUserWithWorkflow(currentuserId, companyId, false, password, password,
							false, screenname, email, 0L,
							phone, new Locale("zh_CN"), username, username,
							username, 0L, 0L, "男".equals(sex)?true:false, 
							month, day, year, message,
							null, null, roles, null, 
							false, ServiceContextFactory.getInstance(resourceRequest));
					UserLocalServiceUtil.updateStatus(u.getUserId(), WorkflowConstants.STATUS_INACTIVE,ServiceContextFactory.getInstance(resourceRequest));
				} catch (PortalException e) {
					
					e.printStackTrace();
				}

        查看数据库可知该字段为varchar，应该支持全数字，查看配置文件，果然是可配置项：

   users.screen.name.allow.numeric=true

问题八： Liferay自定义登录

          Liferay默认提供了三种登录方式：

        public static final String AUTH_TYPE_EA = "emailAddress";

	public static final String AUTH_TYPE_ID = "userId";

	public static final String AUTH_TYPE_SN = "screenName";

       

        自定义登录代码示例http://download.csdn.net/detail/u012551585/9825444

        自定义好登录页面后怎样替换默认的登录页面呢，需要在添加配置项：

#登录页面
auth.login.url=/zh_CN/web/guest/customlogin

问题九：Liferay自定义ERROR404页面

       Liferay在报错或者找不到路径时，全部跳转到原有的error页面 bundles/tomcat-8.0.32/webapps/ROOT/errors/code.jsp。项目中需要自定404页面：

      首先，在bundles/tomcat-8.0.32/webapps/ROOT/errors/ 文件夹中创建自定义的404.jsp页面（如果想在该页面中显示一些系统信息，可以参照code.jsp的写法）；然后在配置文件中配置该404页面：

layout.show.http.status=true
layout.friendly.url.page.not.found=/errors/404.jsp

问题十：Blade安装问题，官网提供的blade依赖的Java Package Manager 地址无法访问（截止2017.4.20日），这个估计官网后续会更新，下面给出一个解决方案：

         Linux下直接运行下面命令：

curl -sL https://github.com/jpm4j/jpm4j.installers/raw/master/dist/biz.aQute.jpm.run.jar > tmp.jar && \
JPM_BIN_DIR=`java -jar tmp.jar -g init | grep -e "Bin[ \t]*dir" | awk '{print $3}'` && \
rm -f tmp.jar && \
${JPM_BIN_DIR}/jpm install -f https://releases.liferay.com/tools/blade-cli/latest/blade.jar && \
echo "blade installed successfully into ${JPM_BIN_DIR}/blade"

        Windows下：

      https://github.com/jpm4j/jpm4j.installers/blob/master/dist/jpm-setup.exe

问题十一：Liferay 自动登录

         某些访问写略下，我们可能会要求liferay自动登录，官方教程：https://dev.liferay.com/zh/develop/tutorials/-/knowledge_base/7-0/auto-login

         首先，在任意一个module project中新建一个class继承AutoLogin，最主要的就是实现它的login方法的返回值，要求是一个String数组，数组的第一个值为你要登录的用户ID，第二个值为密码，第三个值为密码是否加密("true"或"false")，代码示例如下：

package com.zonebase.liferaylogin.portlet;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.osgi.service.component.annotations.Component;

import com.liferay.portal.kernel.model.User;
import com.liferay.portal.kernel.security.auto.login.AutoLogin;
import com.liferay.portal.kernel.security.auto.login.AutoLoginException;
import com.liferay.portal.kernel.service.UserLocalServiceUtil;

@Component(immediate = true)
public class CustomAutoLogin implements AutoLogin{
        //该方法可以不管返回null
	@Override
	public String[] handleException(HttpServletRequest request, HttpServletResponse response, Exception e)
			throws AutoLoginException {
		// TODO Auto-generated method stub
		return null;
	}
        //主要是该方法的返回值
	@Override
	public String[] login(HttpServletRequest request, HttpServletResponse response) throws AutoLoginException {
		         //默认登录之后跳转到主页面，也可以通过该属性进行设置
                        request.setAttribute("AutoLogin.AUTO_LOGIN_REDIRECT", "/show1");
		
			String userId=request.getParameter("userId");
			if(userId!=null&&userId!=""){
				User user=UserLocalServiceUtil.fetchUser(Long.parseLong(userId));
				return new String[] { userId,user.getPassword(),String.valueOf(user.getPasswordEncrypted())};
			}
			return null;
	}
}

            接下来，重要的是在配置文件中配置该自动登录的地址：

auto.login.hooks=com.zonebase.liferaylogin.portlet.CustomAutoLogin

问题十二：MVCPortlet中得到所在页面的请求参数

        某些情况下，在portlet中可能要得到该请求页面的请求参数，只需获得HttpServletRequest，代码如下：

public class HomepagePortlet extends MVCPortlet {
	@Override
	public void doView(RenderRequest renderRequest, RenderResponse renderResponse)
			throws IOException, PortletException {
		HttpServletRequest request = PortalUtil.getOriginalServletRequest(PortalUtil.getHttpServletRequest(renderRequest));	
		HttpServletResponse response=PortalUtil.getHttpServletResponse(renderResponse);
                String test=request.getParameter("test");
                .....
                .....
        }
}

问题十三：Liferay7.0中任务调度定时任务

package test.scheduler.portlet;
import org.osgi.service.component.annotations.Activate;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Deactivate;
import org.osgi.service.component.annotations.Modified;
import org.osgi.service.component.annotations.Reference;

import com.liferay.portal.kernel.messaging.BaseSchedulerEntryMessageListener;
import com.liferay.portal.kernel.messaging.DestinationNames;
import com.liferay.portal.kernel.messaging.Message;
import com.liferay.portal.kernel.module.framework.ModuleServiceLifecycle;
import com.liferay.portal.kernel.scheduler.SchedulerEngineHelper;
import com.liferay.portal.kernel.scheduler.TimeUnit;
import com.liferay.portal.kernel.scheduler.TriggerFactory;
import com.liferay.portal.kernel.scheduler.TriggerFactoryUtil;
/**
 * 任务调度DEMO
 * @author [email protected]
 */
@Component(immediate = true, service = TestSchedulerEntryMessageListener.class)
public class TestSchedulerEntryMessageListener extends BaseSchedulerEntryMessageListener {
	@Reference(target = ModuleServiceLifecycle.PORTAL_INITIALIZED, unbind = "-")
	private volatile ModuleServiceLifecycle _moduleServiceLifecycle;
	@Reference(unbind = "-")
	private volatile SchedulerEngineHelper _schedulerEngineHelper;
	@Reference(unbind = "-")
	private volatile TriggerFactory _triggerFactory;
	@Activate
	@Modified
	protected void activate() {
		//触发器 定义
		schedulerEntryImpl.setTrigger(
			TriggerFactoryUtil.createTrigger(
				getEventListenerClass(), getEventListenerClass(), 60,
				TimeUnit.MINUTE));
		_schedulerEngineHelper.register(
			this, schedulerEntryImpl, DestinationNames.SCHEDULER_DISPATCH);
	}

	@Deactivate
	protected void deactivate() {
		_schedulerEngineHelper.unregister(this);
	}
	@Override
	protected void doReceive(Message message) throws Exception {
		//任务
		System.out.println("轮训执行。。。。。。。。。。。。");
	}

}

问题十四:上下文提供者

       某些情况下，我们需要自定义一些像themeDisplay 的上下文对象来储存信息，相关的文档请看https://dev.liferay.com/develop/tutorials/-/knowledge_base/7-0/context-contributors

   示例如下：

package com.zonebase.testcontext.context.contributor;

import com.liferay.portal.kernel.template.TemplateContextContributor;

import java.util.Map;

import javax.servlet.http.HttpServletRequest;

import org.osgi.service.component.annotations.Component;

/**
 * 上下文提供者DEMO
 * @author [email protected]
 */
@Component(
	immediate = true,
	property = {"type=" + TemplateContextContributor.TYPE_THEME},
	service = TemplateContextContributor.class
)
public class TestContextContributorTemplateContextContributor
	implements TemplateContextContributor {

	@Override
	public void prepare(
		Map contextObjects, HttpServletRequest request) {
		contextObjects.put("customObject", "Hello World.");
	}

}

文末彩蛋：Liferay7.0官方实例库https://github.com/liferay/liferay-blade-samples/tree/master/maven