org.gitlab4j.api

Class TodosApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.TodosApi

All Implemented Interfaces:

Constants

public class TodosApi
extends AbstractApi

This class implements the client side API for the GitLab Todos API.

Nested Class Summary

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

Constants.ActionType, Constants.ApplicationScope, Constants.ArchiveFormat, Constants.CommitBuildState, 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
TodosApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
List<Todo>	getDoneTodos() Get a List of done todos for the current user.
Pager<Todo>	getDoneTodos(int itemsPerPage) Get a Pager of done todos for the current user.
Stream<Todo>	getDoneTodosStream() Get a Stream of done todos for the current user.
List<Todo>	getPendingTodos() Get a List of pending todos for the current user.
Pager<Todo>	getPendingTodos(int itemsPerPage) Get a Pager of pending todos for the current user.
Stream<Todo>	getPendingTodosStream() Get a Stream of pending todos for the current user.
List<Todo>	getTodos(Constants.TodoAction action, Integer authorId, Integer projectId, Integer groupId, Constants.TodoState state, Constants.TodoType type) Get a List of all todos that match the provided filter params.
Pager<Todo>	getTodos(Constants.TodoAction action, Integer authorId, Integer projectId, Integer groupId, Constants.TodoState state, Constants.TodoType type, int itemsPerPage) Returns a Pager of todos that match the provided filter params.
Stream<Todo>	getTodosStream(Constants.TodoAction action, Integer authorId, Integer projectId, Integer groupId, Constants.TodoState state, Constants.TodoType type) Get a List of all todos that match the provided filter params.
void	markAllAsDone() Marks all pending todos for the current user as done.
Todo	markAsDone(Integer todoId) Marks a single pending todo given by its ID for the current user as done.

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getDefaultPerPageParam, getGroupIdOrPath, getPageQueryParams, getPageQueryParams, getPerPageQueryParam, getProjectIdOrPath, getUserIdOrUsername, getWithAccepts, handle, head, isApiVersion, post, post, post, post, post, 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

TodosApi

public TodosApi(GitLabApi gitLabApi)

Method Detail

getPendingTodos

public List<Todo> getPendingTodos()
                           throws GitLabApiException

Get a List of pending todos for the current user.

GitLab Endpoint: GET /todos

Returns:

a List of pending Todos for the current user

Throws:

GitLabApiException - if any exception occurs

getPendingTodos

public Pager<Todo> getPendingTodos(int itemsPerPage)
                            throws GitLabApiException

Get a Pager of pending todos for the current user.

GitLab Endpoint: GET /todos

Parameters:

itemsPerPage - the number of todo that will be fetched per page

Returns:

a Pager containing the pending Todos for the current user

Throws:

GitLabApiException - if any exception occurs

getPendingTodosStream

public Stream<Todo> getPendingTodosStream()
                                   throws GitLabApiException

Get a Stream of pending todos for the current user.

GitLab Endpoint: GET /todos

Returns:

a Stream containing the pending Todos for the user

Throws:

GitLabApiException - if any exception occurs

getDoneTodos

public List<Todo> getDoneTodos()
                        throws GitLabApiException

Get a List of done todos for the current user.

GitLab Endpoint: GET /todos

Returns:

a List of done Todos for the current user

Throws:

GitLabApiException - if any exception occurs

getDoneTodos

public Pager<Todo> getDoneTodos(int itemsPerPage)
                         throws GitLabApiException

Get a Pager of done todos for the current user.

GitLab Endpoint: GET /todos

Parameters:

itemsPerPage - the number of todo that will be fetched per page

Returns:

a Pager containing the done Todos for the current user

Throws:

GitLabApiException - if any exception occurs

getDoneTodosStream

public Stream<Todo> getDoneTodosStream()
                                throws GitLabApiException

Get a Stream of done todos for the current user.

GitLab Endpoint: GET /todos

Returns:

a Stream containing the done Todos for the current user

Throws:

GitLabApiException - if any exception occurs

getTodos

public List<Todo> getTodos(Constants.TodoAction action,
                           Integer authorId,
                           Integer projectId,
                           Integer groupId,
                           Constants.TodoState state,
                           Constants.TodoType type)
                    throws GitLabApiException

Get a List of all todos that match the provided filter params.

GitLab Endpoint: GET /todos

Parameters:

action - the action to be filtered. Can be assigned, mentioned, build_failed, marked, approval_required, unmergeable or directly_addressed.

authorId - the ID of an author

projectId - the ID of a project

groupId - the ID of a group

state - the state of the todo. Can be either pending or done

type - the type of a todo. Can be either Issue or MergeRequest

Returns:

Stream of Todo instances

Throws:

GitLabApiException - if any exception occurs

getTodosStream

public Stream<Todo> getTodosStream(Constants.TodoAction action,
                                   Integer authorId,
                                   Integer projectId,
                                   Integer groupId,
                                   Constants.TodoState state,
                                   Constants.TodoType type)
                            throws GitLabApiException

Get a List of all todos that match the provided filter params.

GitLab Endpoint: GET /todos

Parameters:

action - the action to be filtered. Can be assigned, mentioned, build_failed, marked, approval_required, unmergeable or directly_addressed.

authorId - the ID of an author

projectId - the ID of a project

groupId - the ID of a group

state - the state of the todo. Can be either pending or done

type - the type of a todo. Can be either Issue or MergeRequest

Returns:

Stream of Todo instances

Throws:

GitLabApiException - if any exception occurs

getTodos

public Pager<Todo> getTodos(Constants.TodoAction action,
                            Integer authorId,
                            Integer projectId,
                            Integer groupId,
                            Constants.TodoState state,
                            Constants.TodoType type,
                            int itemsPerPage)
                     throws GitLabApiException

Returns a Pager of todos that match the provided filter params. When no filter params are provided, will returns all pending todos for the current user.

GitLab Endpoint: GET /todos

Parameters:

action - the action to be filtered. Can be assigned, mentioned, build_failed, marked, approval_required, unmergeable or directly_addressed.

authorId - the ID of an author

projectId - the ID of a project

groupId - the ID of a group

state - the state of the todo. Can be either pending or done

type - the type of a todo. Can be either Issue or MergeRequest

itemsPerPage - the number of todo that will be fetched per page

Returns:

a list of pages in todo for the specified range

Throws:

GitLabApiException - if any exception occurs

markAsDone

public Todo markAsDone(Integer todoId)
                throws GitLabApiException

Marks a single pending todo given by its ID for the current user as done. The todo marked as done is returned in the response.

GitLab Endpoint: POST /todos/:id/mark_as_done

Parameters:

todoId - the ID of a todo

Returns:

todo instance with info on the created page

Throws:

GitLabApiException - if any exception occurs

markAllAsDone

public void markAllAsDone()
                   throws GitLabApiException

Marks all pending todos for the current user as done.

GitLab Endpoint: POST /todos/mark_as_done

Throws:

GitLabApiException - if any exception occurs