Liferay控制面板搜索用户分析

 在Liferay控制面板中，当在用户面板点击搜索用户时：

发送给服务器的请求如下：

我们根据struts-config.xml中的配置，找到和struts-action为/user_admin/view_users匹配的forward:

  
  


   
   
<action path="/users_admin/view_users" forward="portlet.users_admin.view" /> 
  
  

再去tiles-def.xml中找到和forward为portlet.users_admin.view匹配的页面：

  
  


   
   
<definition name="portlet.users_admin.view" extends="portlet.users_admin"> 

   
   
        <put name="portlet_content" value="/portlet/users_admin/view.jsp" /> 

   
   
    </definition> 
  
  

所以，我们找到了页面是/portlet/users_admin/view.jsp:

  
  


   
   
<aui:form action="<%= portletURLString %>" method="get" name="fm"> 

   
   
    <liferay-portlet:renderURLParams varImpl="portletURL" /> 

   
   
    <aui:input name="<%= Constants.CMD %>" type="hidden" /> 

   
   
    <aui:input name="redirect" type="hidden" value="<%= portletURLString %>" /> 

   
   
 

   
   
    <% 

   
   
    long organizationGroupId = 0; 

   
   
    %> 

   
   
 

   
   
    <c:if test="<%= portletName.equals(PortletKeys.USERS_ADMIN) %>"> 

   
   
        <liferay-util:include page="/html/portlet/users_admin/toolbar.jsp"> 

   
   
            <liferay-util:param name="toolbarItem" value="view-all" /> 

   
   
        </liferay-util:include> 

   
   
 

   
   
        .. 
  
  

可以看出来，这个页面是个form，并且首部是toolbar.jsp（里面包含View All/Add/Export All Users),这和我们对照页面看到的不谋而合。

然后，它会对usersListView.equals进行判断，因为我们从浏览器中看到的信息为tree，所以执行下面代码的第15行：

  
  


   
   
.. 

   
   
<c:choose> 

   
   
        <c:when test="<%= usersListView.equals(UserConstants.LIST_VIEW_FLAT_ORGANIZATIONS) %>"> 

   
   
            <%@ include file="/html/portlet/users_admin/view_flat_organizations.jspf" %> 

   
   
        </c:when> 

   
   
        <c:when test="<%= usersListView.equals(UserConstants.LIST_VIEW_FLAT_USERS) %>"> 

   
   
 

   
   
            <% 

   
   
            boolean organizationContextView = false; 

   
   
            %> 

   
   
 

   
   
            <%@ include file="/html/portlet/users_admin/view_flat_users.jspf" %> 

   
   
        </c:when> 

   
   
        <c:otherwise> 

   
   
            <%@ include file="/html/portlet/users_admin/view_tree.jspf" %> 

   
   
        </c:otherwise> 

   
   
    </c:choose> 

   
   
</aui:form> 
  
  

我们跳转到/portlet/users_admin/view_tree.jspf文件：

我们找到了searchBar对应的代码：

  
  


   
   
<span class="aui-search-bar"> 

   
   
                <aui:input inlineField="<%= true %>" label="" name="keywords" size="30" title="search-users-and-organizations" type="text" /> 

   
   
 

   
   
                <aui:button onClick='<%= "javascript:" + renderResponse.getNamespace() + "search();" %>' value="search" /> 

   
   
            </span> 
  
  

然后searchBar下方整个是一个Panel,内包含Organizations和Users：

我们找到对应的代码，如下：

  
  


   
   
<liferay-ui:panel-container extended="<%= false %>" id="usersAdminOrganizationPanelContainer" persistState="<%= true %>"> 

   
   
            <%= organizationInfo %> 

   
   
 

   
   
            <% 

   
   
            int usersCount = 0; 

   
   
 

   
   
            boolean showOrganizations = false; 

   
   
... 

   
   
</liferay-ui:panel-container> 
  
  

然后我们继续进去找search result panel：

对应以下的图：

其代码如下：

  
  


   
   
<liferay-ui:panel collapsible="<%= true %>" extended="<%= true %>" id="usersAdminUsersPanel" persistState="<%= true %>" title='<%= usersPanelTitle %>'> 

   
   
 

   
   
                            <% 

   
   
                            boolean organizationContextView = true; 

   
   
                            %> 

   
   
 

   
   
                            <%@ include file="/html/portlet/users_admin/view_flat_users.jspf" %> 

   
   
                        </liferay-ui:panel> 
  
  

所以，万里长征终于走完第一步，显示所有用户信息的页面在/portlet/usrs_admin/view_flat_users.jspf中：

  
  


   
   
<liferay-ui:search-container 

   
   
    rowChecker="<%= new RowChecker(renderResponse) %>" 

   
   
    searchContainer="<%= new UserSearch(renderRequest, portletURL) %>" 

   
   
> 

   
   
    <aui:input name="deleteUserIds" type="hidden" /> 

   
   
    <aui:input disabled="<%= true %>" name="usersRedi 

   
   
... 

   
   
 

   
   
 

   
   
<liferay-ui:search-container-results> 

   
   
        <c:choose> 

   
   
            <c:when test="<%= PropsValues.USERS_INDEXER_ENABLED && PropsValues.USERS_SEARCH_WITH_INDEX %>"> 

   
   
                <%@ include file="/html/portlet/users_admin/user_search_results_index.jspf" %> 

   
   
            </c:when> 

   
   
            <c:otherwise> 

   
   
                <%@ include file="/html/portlet/users_admin/user_search_results_database.jspf" %> 

   
   
            </c:otherwise> 

   
   
        </c:choose> 

   
   
    </liferay-ui:search-container-results> 

   
   
 

   
   
... 

   
   
<liferay-ui:search-container-row 

   
   
        className="com.liferay.portal.model.User" 

   
   
        escapedModel="<%= true %>" 

   
   
        keyProperty="userId" 

   
   
        modelVar="user2" 

   
   
    > 

   
   
        <liferay-portlet:renderURL varImpl="rowURL"> 

   
   
            <portlet:param name="struts_action" value="/users_admin/edit_user" /> 

   
   
            <portlet:param name="redirect" value="<%= searchContainer.getIteratorURL().toString() %>" /> 

   
   
            <portlet:param name="p_u_i_d" value="<%= String.valueOf(user2.getUserId()) %>" /> 

   
   
        </liferay-portlet:renderURL> 

   
   
 

   
   
        <% 

   
   
        if (!UserPermissionUtil.contains(permissionChecker, user2.getUserId(), ActionKeys.UPDATE)) { 

   
   
            rowURL = null; 

   
   
        } 

   
   
        %> 

   
   
 

   
   
        <%@ include file="/html/portlet/users_admin/user/search_columns.jspf" %> 

   
   
 

   
   
        <liferay-ui:search-container-column-jsp 

   
   
            align="right" 

   
   
            path="/html/portlet/users_admin/user_action.jsp" 

   
   
        /> 

   
   
    </liferay-ui:search-container-row> 

   
   
 

   
   
.. 
  
  

显示不是问题，关键数据从哪里来，我们从12-17行可以看出它有一个判断：

PropsValues.USERS_INDEXER_ENABLED && PropsValues.USERS_SEARCH_WITH_INDEX 来决定它从索引还是从数据库找记录：

这2个值最终是配置在portal.properties文件中的：

  
  


   
   
# 

   
   
    # Set this to false to disable the user indexer. 

   
   
    # 

   
   
    users.indexer.enabled=true 

   
   
 

   
   
    # Set this to true to search users from the index. Set this to false to 

   
   
    # search users from the database. Note that setting this to false will 

   
   
    # disable the ability to search users based on Expando attributes. This 

   
   
    # setting is not used unless the property "users.indexer.enabled" is set 

   
   
    # to true. 

   
   
    # 

   
   
    users.search.with.index=true 
  
  

所以，我们只要在portal-ext.properties中吧这2个值设置为false,就可以让搜索的结果从数据库中来而不是索引中来。

大功告成。