关于Liferay中用户接受用户协议的研究 推荐

Liferay中用户接受用户协议的代码在PortalRequestProcessor类中，具体代码是：

// Authenticated users should agree to Terms of Use
if ((user != null) && !user.isAgreedToTermsOfUse()) {
boolean termsOfUseRequired = false;
try {
termsOfUseRequired = PrefsPropsUtil.getBoolean(
user.getCompanyId(), PropsKeys.TERMS_OF_USE_REQUIRED);
}
catch (SystemException se) {
termsOfUseRequired = PropsValues.TERMS_OF_USE_REQUIRED;
}
if (termsOfUseRequired) {
return _PATH_PORTAL_TERMS_OF_USE;
}
}

这里可以看出，是否跳转到/portal/terms_of_use页面是由布尔变量termsOfUseRequired来决定的，只有这个布尔变量为true时候才会发生跳转。具体逻辑是：
(1)如果用户不为null，也就是非第一次登陆Liferay,并且用户的agreedToTermOfUse为false， 也就是第一次登陆时候。
那么就先初始化这个布尔变量为false ,然后读取portal.properties中的TERMS_OF_USE_REQUIRED变量，这个变量的初始值为true.'

#
# Set this to true if all users are required to agree to the terms of use.
#
terms.of.use.required=true
#

那么跳转到/portal/terms_of_use又如何呢？
我们发现，定义了一个struts的action_mapping(在struts-config.xml)：

<action path="/portal/terms_of_use" forward="portal.terms_of_use" />

在Tiles框架(tiles-defs.xml)中定义了这个forward key实际指向的页面：

<definition name="portal.terms_of_use" extends="portal">
<put name="title" value="terms-of-use" />
<put name="content" value="/portal/terms_of_use.jsp" />
</definition>

所以最终的页面是/portal/terms_of_use.jsp

在这个页面中，我们可以看到对应的 "I Agree"和"I Disagree" 2个按钮的页面代码为：

<c:if test="<%= !user.isAgreedToTermsOfUse() %>">
<aui:button-row>
<aui:button type="submit" value="i-agree" />
<%
String taglibOnClick = "alert('" + UnicodeLanguageUtil.get(pageContext, "you-must-agree-with-the-terms-of-use-to-continue") + "');";
%>
<aui:button onClick="<%= taglibOnClick %>" type="cancel" value="i-disagree" />
</aui:button-row>
</c:if>

我们可以看到，当用户点击"I Disagree"时候，它会跳到一个alert对话框，然后阻止你进一步操作直到你点了agree按钮。当用户点击"I Agree"时候，它会做一个表单提交，提交的url如下：

<aui:form action='<%= themeDisplay.getPathMain() + "/portal/update_terms_of_use" %>' name="fm">
<aui:input name="doAsUserId" type="hidden" value="<%= themeDisplay.getDoAsUserId() %>" />
<aui:input name="<%= WebKeys.REFERER %>" type="hidden" value="<%= referer %>" />

提交到了/portal/update_terms_of_use,结合struts-config.xml，我们这个请求对应一个Struts的Action而不是一个页面：

<action path="/portal/update_terms_of_use" type="com.liferay.portal.action.UpdateTermsOfUseAction" />

我们跟进到这个类：

public class UpdateTermsOfUseAction extends Action {
@Override
public ActionForward execute(
ActionMapping mapping, ActionForm form, HttpServletRequest request,
HttpServletResponse response)
throws Exception {
long userId = PortalUtil.getUserId(request);
UserServiceUtil.updateAgreedToTermsOfUse(userId, true);
return mapping.findForward(ActionConstants.COMMON_REFERER);
}
}

可以发现，它会让userServiceUtil来对当前用户更新下agreedToTermsOfUse状态位：
一直跟进会发现它最终调用的是UserLocalServiceImpl的updateAgreedToTermOfUse()方法：

public User updateAgreedToTermsOfUse(
long userId, boolean agreedToTermsOfUse)
throws PortalException, SystemException {
User user = userPersistence.findByPrimaryKey(userId);
user.setAgreedToTermsOfUse(agreedToTermsOfUse);
userPersistence.update(user, false);
return user;
}

它会去设置User_表的字段：

见User_表的DDL:




用户第一次注册然后登陆时选择接受"I Agree"用户term之后，它会显示改变这个字段的值：



从上面可以看出，我这里注册了一个用户，名字叫kevin qian,那么在初次接受term之后，会自动吧数据库表中agreedToTermsOfUse这个字段的位设置为1，因此下次就会跳过用户条款页面了。

总结：
综上所述我们有以下事实：
(1)当用户信息刚插入到Users_表中时候，agreedToTermsOfUse为false, 这也是用户的初始状态。
(2)如果用户在accept 用户条款页面中点了"Agree",那么数据库中agreedToTermsOfUse这个字段就会变成1了
(3)如果用户刚注册好他自己的账户(初始状态)，这时候user不为null,并且agreedToTermsOfUse为false，这时候，Liferay的struts action会吧用户带到用户条款页面，也就是/portal/terms_of_use.jsp页面
(4)如果用户曾经在这个用户条款页面选择过 “ I Agree”，那么后果就是它对应的数据库记录中的agreedToTermsOfUse字段为true了，那么它再不可能到用户条款页面了，
(5)如果一用户不是新用户，那么他却在登录后跳转到用户条款页面，那么唯一的解释就是，这个用户不是在这个数据库中创建的，这个用户的这个字段agreedToTermsOfUse没有被更新。