org.gitlab4j.api

Class BoardsApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.BoardsApi

All Implemented Interfaces:

Constants

public class BoardsApi
extends AbstractApi

This class implements the client side API for the GitLab Issue Boards API calls. NOTE: If a user is not a member of a group and the group is private, a GET request on that group will result to a 404 status code.

See Also:

GitLab Issue Boards API Documentaion

Nested Class Summary

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

Constants.ActionType, Constants.ApplicationScope, Constants.ArchiveFormat, Constants.CommitBuildState, Constants.DeploymentStatus, Constants.DeployTokenScope, Constants.Encoding, Constants.EpicOrderBy, Constants.GroupOrderBy, Constants.GroupSearchScope, Constants.ImpersonationState, Constants.IssueOrderBy, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, Constants.MergeRequestOrderBy, Constants.MergeRequestScope, Constants.MergeRequestSearchIn, Constants.MergeRequestState, Constants.MilestoneState, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.ProjectSearchScope, Constants.SearchScope, Constants.SortOrder, Constants.StateEvent, Constants.TagOrderBy, Constants.TargetType, Constants.TodoAction, Constants.TodoState, Constants.TodoType, Constants.TokenType

Field Summary

Fields inherited from class org.gitlab4j.api.AbstractApi

gitLabApi

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

Constructor Summary

Constructors

Constructor and Description
BoardsApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
Board	createBoard(Object projectIdOrPath, String name) Creates a new Issue Board.
BoardList	createBoardList(Object projectIdOrPath, Integer boardId, Integer labelId) Creates a new Issue Board list.
void	deleteBoard(Object projectIdOrPath, Integer boardId) Soft deletes an existing Issue Board.
void	deleteBoardList(Object projectIdOrPath, Integer boardId, Integer listId) Soft deletes an existing Issue Board list.
Board	getBoard(Object projectIdOrPath, Integer boardId) Get a single issue board.
BoardList	getBoardList(Object projectIdOrPath, Integer boardId, Integer listId) Get a single issue board list.
List<BoardList>	getBoardLists(Object projectIdOrPath, Integer boardId) Get a list of the board’s lists.
Pager<BoardList>	getBoardLists(Object projectIdOrPath, Integer boardId, int itemsPerPage) Get a Pager of the board’s lists.
List<BoardList>	getBoardLists(Object projectIdOrPath, Integer boardId, int page, int perPage) Get a list of the board’s lists for the specified project to using the specified page and per page setting.
List<Board>	getBoards(Object projectIdOrPath) Lists Issue Boards in the given project.
Pager<Board>	getBoards(Object projectIdOrPath, int itemsPerPage) Get a Pager of all issue boards for the specified project.
List<Board>	getBoards(Object projectIdOrPath, int page, int perPage) Get all issue boards for the specified project using the specified page and per page setting
Stream<BoardList>	getBoardsListsStream(Object projectIdOrPath, Integer boardId) Get a Stream of the board’s lists.
Stream<Board>	getBoardsStream(Object projectIdOrPath) Get a Stream of all issue boards for the specified project.
Optional<Board>	getOptionalBoard(Object projectIdOrPath, Integer boardId) Get an issue board as an Optional instance.
Optional<BoardList>	getOptionalBoardList(Object projectIdOrPath, Integer boardId, Integer listId) Get a single issue board list as an Optional instance.
BoardList	updateBoard(Object projectIdOrPath, Integer boardId, String name, Integer assigneeId, Integer milestoneId, String labels, Integer weight) Updates an existing Issue Board.
BoardList	updateBoardList(Object projectIdOrPath, Integer boardId, Integer listId, Integer position) Updates an existing Issue Board list.

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getDefaultPerPageParam, getGroupIdOrPath, getLabelIdOrName, getPageQueryParams, getPageQueryParams, getPerPageQueryParam, getProjectIdOrPath, getUserIdOrUsername, getWithAccepts, handle, head, isApiVersion, post, post, post, post, post, put, put, put, putUpload, putUpload, putWithFormData, upload, upload, upload, urlEncode, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

BoardsApi

public BoardsApi(GitLabApi gitLabApi)

Method Detail

getBoards

public List<Board> getBoards(Object projectIdOrPath)
                      throws GitLabApiException

Lists Issue Boards in the given project.

GitLab Endpoint: GET /projects/:id/boards

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

Returns:

a list of project's issue boards

Throws:

GitLabApiException - if any exception occurs

getBoards

public List<Board> getBoards(Object projectIdOrPath,
                             int page,
                             int perPage)
                      throws GitLabApiException

Get all issue boards for the specified project using the specified page and per page setting

GitLab Endpoint: GET /projects/:id/boards

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

page - the page to get

perPage - the number of items per page

Returns:

a list of project's Boards in the specified range

Throws:

GitLabApiException - if any exception occurs

getBoards

public Pager<Board> getBoards(Object projectIdOrPath,
                              int itemsPerPage)
                       throws GitLabApiException

Get a Pager of all issue boards for the specified project.

GitLab Endpoint: GET /projects/:id/boards

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

itemsPerPage - the number of items per page

Returns:

a Pager of project's issue boards

Throws:

GitLabApiException - if any exception occurs

getBoardsStream

public Stream<Board> getBoardsStream(Object projectIdOrPath)
                              throws GitLabApiException

Get a Stream of all issue boards for the specified project.

GitLab Endpoint: GET /projects/:id/boards

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

Returns:

a Stream of project's issue boards

Throws:

GitLabApiException - if any exception occurs

getBoard

public Board getBoard(Object projectIdOrPath,
                      Integer boardId)
               throws GitLabApiException

Get a single issue board.

GitLab Endpoint: GET /projects/:id/boards/:board_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

Returns:

a Board instance for the specified board ID

Throws:

GitLabApiException - if any exception occurs

getOptionalBoard

public Optional<Board> getOptionalBoard(Object projectIdOrPath,
                                        Integer boardId)

Get an issue board as an Optional instance.

GitLab Endpoint: GET /projects/:id/boards/:board_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

Returns:

the Board instance for the specified board ID as an Optional instance

createBoard

public Board createBoard(Object projectIdOrPath,
                         String name)
                  throws GitLabApiException

Creates a new Issue Board.

NOTE: This is only available in GitLab EE

GitLab Endpoint: POST /projects/:id/boards

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

name - the name for the new board

Returns:

the created Board instance

Throws:

GitLabApiException - if any exception occurs

updateBoard

public BoardList updateBoard(Object projectIdOrPath,
                             Integer boardId,
                             String name,
                             Integer assigneeId,
                             Integer milestoneId,
                             String labels,
                             Integer weight)
                      throws GitLabApiException

Updates an existing Issue Board.

NOTE: This is only available in GitLab EE

GitLab Endpoint: PUT /projects/:id/boards/:board_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance, required

boardId - the ID of the board, required

name - the new name of the board, optional (can be null)

assigneeId - the assignee the board should be scoped to, optional (can be null)

milestoneId - the milestone the board should be scoped to, optional (can be null)

labels - a comma-separated list of label names which the board should be scoped to, optional (can be null)

weight - the weight range from 0 to 9, to which the board should be scoped to, optional (can be null)

Returns:

the updated Board instance

Throws:

GitLabApiException - if any exception occurs

deleteBoard

public void deleteBoard(Object projectIdOrPath,
                        Integer boardId)
                 throws GitLabApiException

Soft deletes an existing Issue Board.

NOTE: This is only available in GitLab EE

GitLab Endpoint: DELETE /projects/:id/boards/:board_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

Throws:

GitLabApiException - if any exception occurs

getBoardLists

public List<BoardList> getBoardLists(Object projectIdOrPath,
                                     Integer boardId)
                              throws GitLabApiException

Get a list of the board’s lists. Does not include open and closed lists.

GitLab Endpoint: GET /projects/:id/boards/:board_id/lists

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

Returns:

a list of the issue board's lists

Throws:

GitLabApiException - if any exception occurs

getBoardLists

public List<BoardList> getBoardLists(Object projectIdOrPath,
                                     Integer boardId,
                                     int page,
                                     int perPage)
                              throws GitLabApiException

Get a list of the board’s lists for the specified project to using the specified page and per page setting. Does not include open and closed lists.

GitLab Endpoint: GET /projects/:id/boards/:board_id/lists

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

page - the page to get

perPage - the number of Boards per page

Returns:

a list of the issue board's lists in the specified range

Throws:

GitLabApiException - if any exception occurs

getBoardLists

public Pager<BoardList> getBoardLists(Object projectIdOrPath,
                                      Integer boardId,
                                      int itemsPerPage)
                               throws GitLabApiException

Get a Pager of the board’s lists. Does not include open and closed lists.

GitLab Endpoint: GET /projects/:id/boards/:board_id/lists

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

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

Returns:

a Pager of the issue board's lists

Throws:

GitLabApiException - if any exception occurs

getBoardsListsStream

public Stream<BoardList> getBoardsListsStream(Object projectIdOrPath,
                                              Integer boardId)
                                       throws GitLabApiException

Get a Stream of the board’s lists. Does not include open and closed lists.

GitLab Endpoint: GET /projects/:id/boards/:board_id/lists

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

Returns:

a Stream of the issue board's lists

Throws:

GitLabApiException - if any exception occurs

getBoardList

public BoardList getBoardList(Object projectIdOrPath,
                              Integer boardId,
                              Integer listId)
                       throws GitLabApiException

Get a single issue board list.

GitLab Endpoint: GET /projects/:id/boards/:board_id/lists/:list_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

listId - the ID of the board lists to get

Returns:

a BoardList instance for the specified board ID and list ID

Throws:

GitLabApiException - if any exception occurs

getOptionalBoardList

public Optional<BoardList> getOptionalBoardList(Object projectIdOrPath,
                                                Integer boardId,
                                                Integer listId)

Get a single issue board list as an Optional instance.

GitLab Endpoint: GET /projects/:id/boards/:board_id/lists/:list_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

listId - the ID of the board lists to get

Returns:

a BoardList instance for the specified board ID and list ID as an Optional instance

createBoardList

public BoardList createBoardList(Object projectIdOrPath,
                                 Integer boardId,
                                 Integer labelId)
                          throws GitLabApiException

Creates a new Issue Board list.

GitLab Endpoint: POST /projects/:id/boards/:board_id/lists

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

labelId - the ID of the label

Returns:

the created BoardList instance

Throws:

GitLabApiException - if any exception occurs

updateBoardList

public BoardList updateBoardList(Object projectIdOrPath,
                                 Integer boardId,
                                 Integer listId,
                                 Integer position)
                          throws GitLabApiException

Updates an existing Issue Board list. This call is used to change list position.

GitLab Endpoint: PUT /projects/:id/boards/:board_id/lists/:list_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

listId - the ID of the list

position - the new position for the list

Returns:

the updated BoardList instance

Throws:

GitLabApiException - if any exception occurs

deleteBoardList

public void deleteBoardList(Object projectIdOrPath,
                            Integer boardId,
                            Integer listId)
                     throws GitLabApiException

Soft deletes an existing Issue Board list. Only for admins and project owners.

GitLab Endpoint: DELETE /projects/:id/boards/:board_id/lists/:list_id

Parameters:

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance

boardId - the ID of the board

listId - the ID of the list

Throws:

GitLabApiException - if any exception occurs