org.gitlab4j.api

Class UserApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.UserApi

All Implemented Interfaces:

Constants

public class UserApi
extends AbstractApi

This class provides an entry point to all the GitLab API users calls.

Nested Class Summary

Nested classes/interfaces inherited from interface org.gitlab4j.api.Constants

Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.SortOrder

Field Summary

Fields inherited from interface org.gitlab4j.api.Constants

NEXT_PAGE_HEADER, PAGE_HEADER, PAGE_PARAM, PER_PAGE, PER_PAGE_PARAM, PREV_PAGE_HEADER, TOTAL_HEADER, TOTAL_PAGES_HEADER

Method Summary

Modifier and Type	Method and Description
User	createUser(User user, String password, Integer projectsLimit) Creates a new user.
void	deleteUser(Integer userId) Deletes a user.
void	deleteUser(User user) Deletes a user.
List<User>	findUsers(String emailOrUsername) Search users by Email or username GET /users?search=:email_or_username
Pager<User>	findUsers(String emailOrUsername, int itemsPerPage) Search users by Email or username and return a Pager GET /users?search=:email_or_username
List<User>	findUsers(String emailOrUsername, int page, int perPage) Search users by Email or username in the specified page range.
User	getUser(int userId) Get a single user.
List<User>	getUsers() Get a list of users.
Pager<User>	getUsers(int itemsPerPage) Get a Pager of users.
List<User>	getUsers(int page, int perPage) Get a list of users using the specified page and per page settings.
User	modifyUser(User user, String password, Integer projectsLimit) Modifies an existing user.

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getPageQueryParams, handle, isApiVersion, post, post, post, put, put, urlEncode, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getUsers

public List<User> getUsers()
                    throws GitLabApiException

Get a list of users. Only returns the first page GET /users

Returns:

a list of Users, this list will only contain the first 20 users in the system.

Throws:

GitLabApiException - if any exception occurs

getUsers

public List<User> getUsers(int page,
                           int perPage)
                    throws GitLabApiException

Get a list of users using the specified page and per page settings. GET /users

Parameters:

page - the page to get

perPage - the number of users per page

Returns:

the list of Users in the specified range

Throws:

GitLabApiException - if any exception occurs

getUsers

public Pager<User> getUsers(int itemsPerPage)
                     throws GitLabApiException

Get a Pager of users. GET /users

Parameters:

itemsPerPage - the number of Project instances that will be fetched per page

Returns:

a Pager of User

Throws:

GitLabApiException - if any exception occurs

getUser

public User getUser(int userId)
             throws GitLabApiException

Get a single user. GET /users/:id

Parameters:

userId - the ID of the user to get

Returns:

the User instance for the specified user ID

Throws:

GitLabApiException - if any exception occurs

findUsers

public List<User> findUsers(String emailOrUsername)
                     throws GitLabApiException

Search users by Email or username GET /users?search=:email_or_username

Parameters:

emailOrUsername - the email or username to search for

Returns:

the User List with the email or username like emailOrUsername

Throws:

GitLabApiException - if any exception occurs

findUsers

public List<User> findUsers(String emailOrUsername,
                            int page,
                            int perPage)
                     throws GitLabApiException

Search users by Email or username in the specified page range. GET /users?search=:email_or_username

Parameters:

emailOrUsername - the email or username to search for

page - the page to get

perPage - the number of users per page

Returns:

the User List with the email or username like emailOrUsername in the specified page range

Throws:

GitLabApiException - if any exception occurs

findUsers

public Pager<User> findUsers(String emailOrUsername,
                             int itemsPerPage)
                      throws GitLabApiException

Search users by Email or username and return a Pager GET /users?search=:email_or_username

Parameters:

emailOrUsername - the email or username to search for

itemsPerPage - the number of Project instances that will be fetched per page

Returns:

the User Pager with the email or username like emailOrUsername

Throws:

GitLabApiException - if any exception occurs

createUser

public User createUser(User user,
                       String password,
                       Integer projectsLimit)
                throws GitLabApiException

Creates a new user. Note only administrators can create new users. POST /users email (required) - Email password (required) - Password username (required) - Username name (required) - Name skype (optional) - Skype ID linkedin (optional) - Linkedin twitter (optional) - Twitter account website_url (optional) - Website url projects_limit (optional) - Number of projects user can create extern_uid (optional) - External UID provider (optional) - External provider name bio (optional) - User's bio admin (optional) - User is admin - true or false (default) can_create_group (optional) - User can create groups - true or false

Parameters:

user - the User instance with the user info to create

password - the password for the new user

projectsLimit - the maximum number of project

Returns:

created User instance

Throws:

GitLabApiException - if any exception occurs

modifyUser

public User modifyUser(User user,
                       String password,
                       Integer projectsLimit)
                throws GitLabApiException

Modifies an existing user. Only administrators can change attributes of a user. PUT /users/:id email (required) - Email password (required) - Password username (required) - Username name (required) - Name skype (optional) - Skype ID linkedin (optional) - Linkedin twitter (optional) - Twitter account website_url (optional) - Website url projects_limit (optional) - Number of projects user can create extern_uid (optional) - External UID provider (optional) - External provider name bio (optional) - User's bio admin (optional) - User is admin - true or false (default) can_create_group (optional) - User can create groups - true or false

Parameters:

user - the User instance with the user info to modify

password - the new password for the user

projectsLimit - the maximum number of project

Returns:

the modified User instance

Throws:

GitLabApiException - if any exception occurs

deleteUser

public void deleteUser(Integer userId)
                throws GitLabApiException

Deletes a user. Available only for administrators. DELETE /users/:id

Parameters:

userId - the user ID to delete

Throws:

GitLabApiException - if any exception occurs

deleteUser

public void deleteUser(User user)
                throws GitLabApiException

Deletes a user. Available only for administrators. DELETE /users/:id

Parameters:

user - the User instance to delete

Throws:

GitLabApiException - if any exception occurs