/// <summary> /// 根据指定的查询参数查询用户句柄。 /// </summary> /// <param name="query">查询参数。</param> /// <returns>一个列表,列表中包含了所有满足查询条件的用户句柄。</returns> /// <exception cref="ArgumentNullException"/> public IList <UserHandle> QueryUsers(UserQueryParameter query) { if (query == null) { throw new ArgumentNullException(nameof(query)); } if (query.QueryByUsername && query.Username == null) { throw new ArgumentNullException(nameof(query.Username)); } if (query.QueryByOrganization && query.Organization == null) { throw new ArgumentNullException(nameof(query.Organization)); } if (query.QueryByUsername) { // 从用户名开始查找。 // 由于满足条件的实体对象至多一个,做特殊化处理。 UserProfileEntity profile = m_context.QueryUserProfileEntity(query.Username); if (profile == null) { // 未找到符合要求的实体对象。 return(new List <UserHandle>()); } else { // 检查其他条件是否满足。 if (query.QueryByOrganization && string.Compare(query.Organization, profile.Organization, false) != 0) { return(new List <UserHandle>()); } if (query.QueryByUsergroup && profile.UserGroup != (NativeUserGroup)query.UserGroup) { return(new List <UserHandle>()); } // 唯一的用户信息实体对象满足条件。 return(new List <UserHandle>() { UserHandle.FromUserProfileEntity(profile) }); } } else // query.QueryByUsername == false { bool hasQuery = query.QueryByOrganization || query.QueryByUsergroup; if (!hasQuery) { // 没有查询参数。返回空列表。 return(new List <UserHandle>()); } else { IQueryable <UserProfileEntity> profiles = m_context.GetAllUserProfiles(); if (query.QueryByOrganization) { profiles = UserDataContext.QueryUserProfileEntitiesByOrganization(profiles, query.Organization); } if (query.QueryByUsergroup) { profiles = UserDataContext.QueryUserProfileEntitiesByUsergroup(profiles, (NativeUserGroup)query.UserGroup); } List <UserHandle> handles = new List <UserHandle>(); foreach (UserProfileEntity entity in profiles) { handles.Add(UserHandle.FromUserProfileEntity(entity)); } return(handles); } } }