Liferay 7.4自定义学号字段实现多方式登录技术咨询

需求背景 #

需要为Liferay 7.4用户档案添加“学号”字段，支持用户通过邮箱+密码或学号+同一密码登录。已重写login.jsp，拟通过以下自定义LoginActionCommand实现：

@Component(
    property = {
        "javax.portlet.name=com_liferay_login_web_portlet_LoginPortlet",
        "mvc.command.name=/login/login"
    },
    service = MVCActionCommand.class
)
public class CustomLoginActionCommand extends BaseMVCActionCommand {

    @Override
    protected void doProcessAction(ActionRequest actionRequest,
            ActionResponse actionResponse) throws Exception {

        ThemeDisplay themeDisplay = (ThemeDisplay)actionRequest.getAttribute(
            WebKeys.THEME_DISPLAY);
        
        HttpServletRequest request = PortalUtil.getOriginalServletRequest(
            PortalUtil.getHttpServletRequest(actionRequest));
        
        HttpServletResponse response = PortalUtil.getHttpServletResponse(
            actionResponse);

        String login = ParamUtil.getString(actionRequest, "login");
        String password = actionRequest.getParameter("password");
        boolean rememberMe = ParamUtil.getBoolean(actionRequest, "rememberMe");
        
        String authType = CompanyConstants.AUTH_TYPE_EA;
        String email = "";
        
       if(isValidEmail(login)){ //if the user trying to login with his email
            email = login ;
        }
        else if(isNumeric(login)){ //check if the user trying to login with his student number
            //fetch User by Student Number (login)
            //e.g. fetchUserByStudentNumber(login)
            //get the Email Adress for the retrieved user object and use it to login
            email = user.getEmailAddress();
        }
        else{
            // Exception
        }
        
        AuthenticatedSessionManagerUtil.login(request, response, email, password, rememberMe, authType);
        
        actionResponse.sendRedirect(themeDisplay.getPathMain());
    }
}

问题解答 #

1. 该实现方式是否可行？ #

整体思路可行，但需要补充关键细节保证稳定运行：

• 完善校验逻辑：isValidEmail和isNumeric的实现要严谨，避免误判带数字的邮箱、非纯数字的学号；
• 错误处理：当学号不存在、密码错误时，要将错误信息返回登录页（比如通过SessionErrors.add(actionRequest, "login.failed")），跳回登录页而非直接重定向首页；
• 兼容安全机制：确保未绕过Liferay内置的用户锁定、验证码、IP限制等校验，AuthenticatedSessionManagerUtil.login会处理部分校验，但要确认登录失败的反馈逻辑正常；
• 空值处理：处理fetchUserByStudentNumber返回null的情况，避免空指针异常。

2. 在Liferay 7.4 U46+中，扩展用户档案是选择为User对象新增字段还是创建自定义字段更优？ #

优先选择自定义字段（Custom Fields），原因如下：

• 低升级风险：无需修改Liferay核心实体，后续版本升级不受影响；
• 开箱即用UI：在控制面板可直接配置字段的显示、编辑权限，无需自行开发前端页面；
• 内置索引支持：Liferay自动处理自定义字段的索引，查询效率有保障；
• 开发成本低：无需使用Service Builder扩展实体，配置即可完成字段添加。

仅当有特殊业务需求（如与核心业务深度绑定、极致性能要求）时，才考虑通过Service Builder扩展User实体。

3. 两种扩展方式下，如何强制学号字段值唯一？ #

自定义字段方式

• 控制面板配置：添加自定义字段时勾选「Unique」选项，Liferay 7.4已支持自定义字段唯一性校验；
• 自定义业务校验：通过ModelListener监听User的添加/更新事件，在beforeCreate或beforeUpdate方法中检查学号是否重复，重复则抛出PortalException终止操作。

扩展User实体方式

• 数据库约束：在service.xml中为新增的studentNumber字段添加unique="true"属性，生成数据库唯一索引；
• 业务层面校验：同样通过ModelListener在用户创建/更新前做唯一性检查，避免重复值。

4. 如何通过学号字段获取对应的User对象？ #

自定义字段方式

方法一：使用DynamicQuery查询

import com.liferay.portal.kernel.dao.orm.DynamicQuery;
import com.liferay.portal.kernel.dao.orm.DynamicQueryFactoryUtil;
import com.liferay.portal.kernel.dao.orm.RestrictionsFactoryUtil;
import com.liferay.portal.kernel.model.User;
import com.liferay.portal.kernel.service.UserLocalServiceUtil;

public User getUserByStudentNumber(long companyId, String studentNumber) {
    DynamicQuery dynamicQuery = DynamicQueryFactoryUtil.forClass(User.class)
        .add(RestrictionsFactoryUtil.eq("expandoAttributes.studentNumber", studentNumber))
        .add(RestrictionsFactoryUtil.eq("companyId", companyId));
    
    List<User> users = UserLocalServiceUtil.dynamicQuery(dynamicQuery);
    return users.isEmpty() ? null : users.get(0);
}

方法二：通过ExpandoValueLocalService查询

import com.liferay.expando.kernel.model.ExpandoColumn;
import com.liferay.expando.kernel.model.ExpandoTable;
import com.liferay.expando.kernel.service.ExpandoColumnLocalServiceUtil;
import com.liferay.expando.kernel.service.ExpandoTableLocalServiceUtil;
import com.liferay.expando.kernel.service.ExpandoValueLocalServiceUtil;
import com.liferay.portal.kernel.model.User;
import com.liferay.portal.kernel.service.UserLocalServiceUtil;

public User getUserByStudentNumber(long companyId, String studentNumber) {
    try {
        ExpandoTable expandoTable = ExpandoTableLocalServiceUtil.getTable(companyId, User.class.getName(), "CUSTOM_FIELDS");
        ExpandoColumn expandoColumn = ExpandoColumnLocalServiceUtil.getColumn(expandoTable.getTableId(), "studentNumber");
        
        List<ExpandoValue> values = ExpandoValueLocalServiceUtil.getValues(expandoColumn.getColumnId(), studentNumber);
        if (!values.isEmpty()) {
            long userId = values.get(0).getClassPK();
            return UserLocalServiceUtil.getUser(userId);
        }
    } catch (Exception e) {
        // 处理异常
    }
    return null;
}

扩展User实体方式

通过Service Builder自动生成的finder方法直接查询：

User user = UserLocalServiceUtil.getUserByStudentNumber(companyId, studentNumber);

内容的提问来源于stack exchange，提问作者Ahmad Tamimi