Interface OboUserService
- All Known Implementing Classes:
UserService
@API(status=STABLE)
public interface OboUserService
Service interface exposing OBO-enabled endpoints to manage users.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
followUser
(List<Long> followerIds, Long userId) Make a list of users to start following a specific user.listUsersByEmails
(List<String> emailList) listUsersByEmails
(List<String> emailList, Boolean local, Boolean active) listUsersByIds
(List<Long> uidList) listUsersByIds
(List<Long> uidList, Boolean local, Boolean active) listUsersByUsernames
(List<String> usernameList) listUsersByUsernames
(List<String> usernameList, Boolean active) searchAllUsers
(UserSearchQuery query, Boolean local) searchAllUsers
(UserSearchQuery query, Boolean local, StreamPaginationAttribute pagination) searchUsers
(UserSearchQuery query, Boolean local) searchUsers
(UserSearchQuery query, Boolean local, PaginationAttribute pagination) void
unfollowUser
(List<Long> followerIds, Long userId) Make a list of users to stop following a specific user.
-
Method Details
-
listUsersByIds
List<UserV2> listUsersByIds(@Nonnull List<Long> uidList, @Nullable Boolean local, @Nullable Boolean active) - Parameters:
uidList
- List of user idslocal
- If true then a local DB search will be performed and only local pod users will be returned. If absent or false then a directory search will be performed and users from other pods who are visible to the calling user will also be returned.active
- If not set all user status will be returned, if true all active users will be returned, if false all inactive users will be returned- Returns:
- Users found by user ids
- See Also:
-
listUsersByIds
- Parameters:
uidList
- List of user ids- Returns:
- Users found by user ids
- See Also:
-
listUsersByEmails
List<UserV2> listUsersByEmails(@Nonnull List<String> emailList, @Nullable Boolean local, @Nullable Boolean active) - Parameters:
emailList
- List of emailslocal
- If true then a local DB search will be performed and only local pod users will be returned. If absent or false then a directory search will be performed and users from other pods who are visible to the calling user will also be returned.active
- If not set all user status will be returned, if true all active users will be returned, if false all inactive users will be returned- Returns:
- Users found by emails.
- See Also:
-
listUsersByEmails
- Parameters:
emailList
- List of emails- Returns:
- Users found by emails
- See Also:
-
listUsersByUsernames
- Parameters:
usernameList
- List of usernamesactive
- If not set all user status will be returned, if true all active users will be returned, if false all inactive users will be returned- Returns:
- Users found by usernames
- See Also:
-
listUsersByUsernames
- Parameters:
usernameList
- List of usernames- Returns:
- Users found by usernames
- See Also:
-
searchUsers
- Parameters:
query
- Searching query containing complicated information like title, location, company...local
- If true then a local DB search will be performed and only local pod users will be returned. If absent or false then a directory search will be performed and users from other pods who are visible to the calling user will also be returned.- Returns:
- List of users found by query
- See Also:
-
searchUsers
List<UserV2> searchUsers(@Nonnull UserSearchQuery query, @Nullable Boolean local, @Nonnull PaginationAttribute pagination) - Parameters:
query
- Searching query containing complicated information like title, location, company...local
- If true then a local DB search will be performed and only local pod users will be returned. If absent or false then a directory search will be performed and users from other pods who are visible to the calling user will also be returned.pagination
- The skip and limit for pagination.- Returns:
- List of users found by query
- See Also:
-
searchAllUsers
@API(status=EXPERIMENTAL) Stream<UserV2> searchAllUsers(@Nonnull UserSearchQuery query, @Nullable Boolean local) - Parameters:
query
- Searching query containing complicated information like title, location, company...local
- If true then a local DB search will be performed and only local pod users will be returned. If absent or false then a directory search will be performed and users from other pods who are visible to the calling user will also be returned.- Returns:
- a
Stream
of users found by query - See Also:
-
searchAllUsers
@API(status=EXPERIMENTAL) Stream<UserV2> searchAllUsers(@Nonnull UserSearchQuery query, @Nullable Boolean local, @Nonnull StreamPaginationAttribute pagination) - Parameters:
query
- Searching query containing complicated information like title, location, company...local
- If true then a local DB search will be performed and only local pod users will be returned. If absent or false then a directory search will be performed and users from other pods who are visible to the calling user will also be returned.pagination
- The chunkSize and totalSize for pagination.- Returns:
- a
Stream
of users found by query - See Also:
-
followUser
Make a list of users to start following a specific user.UserService.followUser(List, Long)
- Parameters:
followerIds
- List of ids of the followers.userId
- The id of the user to be followed.- See Also:
-
unfollowUser
Make a list of users to stop following a specific user.UserService.unfollowUser(List, Long)
- Parameters:
followerIds
- List of the ids of the followers.userId
- The id of the user to be unfollowed.- See Also:
-