参考:https://blog.csdn.net/u012551585/article/details/62261352?locationNum=7&fps=1
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%>',
- {"<portlet:namespace />action":"role",
- "<portlet:namespace />plid":plidPageId,
- "<portlet:namespace />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<Event> 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[ ]*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 zonebase@163.com
- */
- @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 zonebase@163.com
- */
- @Component(
- immediate = true,
- property = {"type=" + TemplateContextContributor.TYPE_THEME},
- service = TemplateContextContributor.class
- )
- public class TestContextContributorTemplateContextContributor
- implements TemplateContextContributor {
- @Override
- public void prepare(
- Map<String, Object> contextObjects, HttpServletRequest request) {
- contextObjects.put("customObject", "Hello World.");
- }
- }
文末彩蛋:Liferay7.0官方实例库https://github.com/liferay/liferay-blade-samples/tree/master/maven