org.gitlab4j.api

Class NotesApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.NotesApi

All Implemented Interfaces:

Constants

public class NotesApi
extends AbstractApi

Nested Class Summary

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

Constants.ActionType, Constants.ApplicationScope, Constants.ArchiveFormat, Constants.AutoDevopsDeployStrategy, Constants.BuildGitStrategy, Constants.CommitBuildState, Constants.ContributorOrderBy, Constants.DeploymentOrderBy, Constants.DeploymentStatus, Constants.DeployTokenScope, Constants.Encoding, Constants.EpicOrderBy, Constants.EventScope, 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.PackageOrderBy, Constants.PackageStatus, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectAccessTokenScope, Constants.ProjectOrderBy, Constants.ProjectSearchScope, Constants.SearchScope, Constants.SortOrder, Constants.SquashOption, 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
NotesApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
Note	createIssueNote(java.lang.Object projectIdOrPath, java.lang.Long issueIid, java.lang.String body) Create a issues's note.
Note	createIssueNote(java.lang.Object projectIdOrPath, java.lang.Long issueIid, java.lang.String body, java.util.Date createdAt) Create a issues's note.
Note	createIssueNote(java.lang.Object projectIdOrPath, java.lang.Long issueIid, java.lang.String body, java.util.Date createdAt, java.lang.Boolean internal) Create a issues's note.
Note	createMergeRequestNote(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, java.lang.String body) Create a merge request's note.
void	deleteIssueNote(java.lang.Object projectIdOrPath, java.lang.Long issueIid, java.lang.Long noteId) Delete the specified issues's note.
void	deleteMergeRequestNote(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, java.lang.Long noteId) Delete the specified merge request's note.
Note	getIssueNote(java.lang.Object projectIdOrPath, java.lang.Long issueIid, java.lang.Long noteId) Get the specified issues's note.
java.util.List<Note>	getIssueNotes(java.lang.Object projectIdOrPath, java.lang.Long issueIid) Get a list of the issues's notes.
Pager<Note>	getIssueNotes(java.lang.Object projectIdOrPath, java.lang.Long issueIid, int itemsPerPage) Get a Pager of issues's notes.
java.util.List<Note>	getIssueNotes(java.lang.Object projectIdOrPath, java.lang.Long issueIid, int page, int perPage) Get a list of the issue's notes using the specified page and per page settings.
java.util.stream.Stream<Note>	getIssueNotesStream(java.lang.Object projectIdOrPath, java.lang.Long issueIid) Get a Stream of the issues's notes.
Note	getMergeRequestNote(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, java.lang.Long noteId) Get the specified merge request's note.
java.util.List<Note>	getMergeRequestNotes(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid) Gets a list of all notes for a single merge request
java.util.List<Note>	getMergeRequestNotes(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, Constants.SortOrder sortOrder, Note.OrderBy orderBy) Gets a list of all notes for a single merge request.
Pager<Note>	getMergeRequestNotes(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, Constants.SortOrder sortOrder, Note.OrderBy orderBy, int itemsPerPage) Get a Pager of all notes for a single merge request
java.util.List<Note>	getMergeRequestNotes(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, Constants.SortOrder sortOrder, Note.OrderBy orderBy, int page, int perPage) Gets a list of all notes for a single merge request using the specified page and per page settings.
Pager<Note>	getMergeRequestNotes(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, int itemsPerPage) Get a Pager of all notes for a single merge request
java.util.List<Note>	getMergeRequestNotes(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, int page, int perPage) Gets a list of all notes for a single merge request using the specified page and per page settings.
java.util.stream.Stream<Note>	getMergeRequestNotesStream(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid) Gets a Stream of all notes for a single merge request
java.util.stream.Stream<Note>	getMergeRequestNotesStream(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, Constants.SortOrder sortOrder, Note.OrderBy orderBy) Gets a Stream of all notes for a single merge request.
java.util.List<Note>	getNotes(java.lang.Object projectIdOrPath, java.lang.Long issueIid) Deprecated. As of release 4.7.0, replaced by getIssueNotes(Object, Long)
Pager<Note>	getNotes(java.lang.Object projectIdOrPath, java.lang.Long issueIid, int itemsPerPage) Deprecated. As of release 4.7.0, replaced by getIssueNotes(Object, Long, int)
java.util.List<Note>	getNotes(java.lang.Object projectIdOrPath, java.lang.Long issueIid, int page, int perPage) Deprecated. As of release 4.7.0, replaced by getIssueNotes(Object, Long, int, int)
Note	updateIssueNote(java.lang.Object projectIdOrPath, java.lang.Long issueIid, java.lang.Long noteId, java.lang.String body) Update the specified issues's note.
Note	updateMergeRequestNote(java.lang.Object projectIdOrPath, java.lang.Long mergeRequestIid, java.lang.Long noteId, java.lang.String body) Update the specified merge request's note.

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, patch, patch, post, post, post, post, post, put, put, put, putUpload, putUpload, putWithFormData, upload, 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

NotesApi

public NotesApi(GitLabApi gitLabApi)

Method Detail

getNotes

@Deprecated
public java.util.List<Note> getNotes(java.lang.Object projectIdOrPath,
                                                 java.lang.Long issueIid)
                                          throws GitLabApiException

Deprecated. As of release 4.7.0, replaced by getIssueNotes(Object, Long)

Get a list of the issues's notes.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue ID to get the notes for

Returns:

a list of the issues's notes

Throws:

GitLabApiException - if any exception occurs

getNotes

@Deprecated
public java.util.List<Note> getNotes(java.lang.Object projectIdOrPath,
                                                 java.lang.Long issueIid,
                                                 int page,
                                                 int perPage)
                                          throws GitLabApiException

Deprecated. As of release 4.7.0, replaced by getIssueNotes(Object, Long, int, int)

Get a list of the issue's notes using the specified page and per page settings.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue IID to get the notes for

page - the page to get

perPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getNotes

@Deprecated
public Pager<Note> getNotes(java.lang.Object projectIdOrPath,
                                        java.lang.Long issueIid,
                                        int itemsPerPage)
                                 throws GitLabApiException

Deprecated. As of release 4.7.0, replaced by getIssueNotes(Object, Long, int)

Get a Pager of issues's notes.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue IID to get the notes for

itemsPerPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getIssueNotes

public java.util.List<Note> getIssueNotes(java.lang.Object projectIdOrPath,
                                          java.lang.Long issueIid)
                                   throws GitLabApiException

Get a list of the issues's notes.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue ID to get the notes for

Returns:

a list of the issues's notes

Throws:

GitLabApiException - if any exception occurs

getIssueNotes

public java.util.List<Note> getIssueNotes(java.lang.Object projectIdOrPath,
                                          java.lang.Long issueIid,
                                          int page,
                                          int perPage)
                                   throws GitLabApiException

Get a list of the issue's notes using the specified page and per page settings.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue IID to get the notes for

page - the page to get

perPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getIssueNotes

public Pager<Note> getIssueNotes(java.lang.Object projectIdOrPath,
                                 java.lang.Long issueIid,
                                 int itemsPerPage)
                          throws GitLabApiException

Get a Pager of issues's notes.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue IID to get the notes for

itemsPerPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getIssueNotesStream

public java.util.stream.Stream<Note> getIssueNotesStream(java.lang.Object projectIdOrPath,
                                                         java.lang.Long issueIid)
                                                  throws GitLabApiException

Get a Stream of the issues's notes.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes

Parameters:

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

issueIid - the issue ID to get the notes for

Returns:

a Stream of the issues's notes

Throws:

GitLabApiException - if any exception occurs

getIssueNote

public Note getIssueNote(java.lang.Object projectIdOrPath,
                         java.lang.Long issueIid,
                         java.lang.Long noteId)
                  throws GitLabApiException

Get the specified issues's note.

GitLab Endpoint: GET /projects/:id/issues/:issue_iid/notes/:note_id

Parameters:

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

issueIid - the issue IID to get the notes for

noteId - the ID of the Note to get

Returns:

a Note instance for the specified IDs

Throws:

GitLabApiException - if any exception occurs

createIssueNote

public Note createIssueNote(java.lang.Object projectIdOrPath,
                            java.lang.Long issueIid,
                            java.lang.String body)
                     throws GitLabApiException

Create a issues's note.

GitLab Endpoint: POST /projects/:id/issues/:issue_iid/notes/:note_id

Parameters:

projectIdOrPath - the project in the form of an Long(ID), String(path), or Project instance @param projectIdOrPath the project ID to create the issues for

issueIid - the issue IID to create the notes for

body - the content of note

Returns:

the created Note instance

Throws:

GitLabApiException - if any exception occurs

createIssueNote

public Note createIssueNote(java.lang.Object projectIdOrPath,
                            java.lang.Long issueIid,
                            java.lang.String body,
                            java.util.Date createdAt)
                     throws GitLabApiException

Create a issues's note.

GitLab Endpoint: POST /projects/:id/issues/:issue_iid/notes/:note_id

Parameters:

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

issueIid - the issue IID to create the notes for

body - the content of note

createdAt - the created time of note

Returns:

the created Note instance

Throws:

GitLabApiException - if any exception occurs

createIssueNote

public Note createIssueNote(java.lang.Object projectIdOrPath,
                            java.lang.Long issueIid,
                            java.lang.String body,
                            java.util.Date createdAt,
                            java.lang.Boolean internal)
                     throws GitLabApiException

Create a issues's note.

GitLab Endpoint: POST /projects/:id/issues/:issue_iid/notes/:note_id

Parameters:

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

issueIid - the issue IID to create the notes for

body - the content of note

createdAt - the created time of note

internal - whether the note shall be marked 'internal'

Returns:

the created Note instance

Throws:

GitLabApiException - if any exception occurs

updateIssueNote

public Note updateIssueNote(java.lang.Object projectIdOrPath,
                            java.lang.Long issueIid,
                            java.lang.Long noteId,
                            java.lang.String body)
                     throws GitLabApiException

Update the specified issues's note.

GitLab Endpoint: PUT /projects/:id/issues/:issue_iid/notes/:note_id

Parameters:

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

issueIid - the issue IID to update the notes for

noteId - the ID of the node to update

body - the update content for the Note

Returns:

the modified Note instance

Throws:

GitLabApiException - if any exception occurs

deleteIssueNote

public void deleteIssueNote(java.lang.Object projectIdOrPath,
                            java.lang.Long issueIid,
                            java.lang.Long noteId)
                     throws GitLabApiException

Delete the specified issues's note.

GitLab Endpoint: DELETE /projects/:id/issues/:issue_iid/notes/:note_id

Parameters:

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

issueIid - the issue IID to delete the notes for

noteId - the ID of the node to delete

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotes

public java.util.List<Note> getMergeRequestNotes(java.lang.Object projectIdOrPath,
                                                 java.lang.Long mergeRequestIid)
                                          throws GitLabApiException

Gets a list of all notes for a single merge request

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the issue ID to get the notes for

Returns:

a list of the merge request's notes

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotes

public java.util.List<Note> getMergeRequestNotes(java.lang.Object projectIdOrPath,
                                                 java.lang.Long mergeRequestIid,
                                                 Constants.SortOrder sortOrder,
                                                 Note.OrderBy orderBy)
                                          throws GitLabApiException

Gets a list of all notes for a single merge request.

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the issue ID to get the notes for

sortOrder - return merge request notes sorted in the specified sort order, default is DESC

orderBy - return merge request notes ordered by CREATED_AT or UPDATED_AT, default is CREATED_AT

Returns:

a list of the merge request's notes

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotes

public java.util.List<Note> getMergeRequestNotes(java.lang.Object projectIdOrPath,
                                                 java.lang.Long mergeRequestIid,
                                                 int page,
                                                 int perPage)
                                          throws GitLabApiException

Gets a list of all notes for a single merge request using the specified page and per page settings.

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the merge request IID to get the notes for

page - the page to get

perPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotes

public java.util.List<Note> getMergeRequestNotes(java.lang.Object projectIdOrPath,
                                                 java.lang.Long mergeRequestIid,
                                                 Constants.SortOrder sortOrder,
                                                 Note.OrderBy orderBy,
                                                 int page,
                                                 int perPage)
                                          throws GitLabApiException

Gets a list of all notes for a single merge request using the specified page and per page settings.

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the merge request IID to get the notes for

sortOrder - return merge request notes sorted in the specified sort order, default is DESC

orderBy - return merge request notes ordered by CREATED_AT or UPDATED_AT, default is CREATED_AT

page - the page to get

perPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotes

public Pager<Note> getMergeRequestNotes(java.lang.Object projectIdOrPath,
                                        java.lang.Long mergeRequestIid,
                                        int itemsPerPage)
                                 throws GitLabApiException

Get a Pager of all notes for a single merge request

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the merge request IID to get the notes for

itemsPerPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotesStream

public java.util.stream.Stream<Note> getMergeRequestNotesStream(java.lang.Object projectIdOrPath,
                                                                java.lang.Long mergeRequestIid)
                                                         throws GitLabApiException

Gets a Stream of all notes for a single merge request

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the issue ID to get the notes for

Returns:

a Stream of the merge request's notes

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotes

public Pager<Note> getMergeRequestNotes(java.lang.Object projectIdOrPath,
                                        java.lang.Long mergeRequestIid,
                                        Constants.SortOrder sortOrder,
                                        Note.OrderBy orderBy,
                                        int itemsPerPage)
                                 throws GitLabApiException

Get a Pager of all notes for a single merge request

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the merge request IID to get the notes for

sortOrder - return merge request notes sorted in the specified sort order, default is DESC

orderBy - return merge request notes ordered by CREATED_AT or UPDATED_AT, default is CREATED_AT

itemsPerPage - the number of notes per page

Returns:

the list of notes in the specified range

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNotesStream

public java.util.stream.Stream<Note> getMergeRequestNotesStream(java.lang.Object projectIdOrPath,
                                                                java.lang.Long mergeRequestIid,
                                                                Constants.SortOrder sortOrder,
                                                                Note.OrderBy orderBy)
                                                         throws GitLabApiException

Gets a Stream of all notes for a single merge request.

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes

Parameters:

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

mergeRequestIid - the issue ID to get the notes for

sortOrder - return merge request notes sorted in the specified sort order, default is DESC

orderBy - return merge request notes ordered by CREATED_AT or UPDATED_AT, default is CREATED_AT

Returns:

a Stream of the merge request's notes

Throws:

GitLabApiException - if any exception occurs

getMergeRequestNote

public Note getMergeRequestNote(java.lang.Object projectIdOrPath,
                                java.lang.Long mergeRequestIid,
                                java.lang.Long noteId)
                         throws GitLabApiException

Get the specified merge request's note.

GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/notes/:note_id

Parameters:

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

mergeRequestIid - the merge request IID to get the notes for

noteId - the ID of the Note to get

Returns:

a Note instance for the specified IDs

Throws:

GitLabApiException - if any exception occurs

createMergeRequestNote

public Note createMergeRequestNote(java.lang.Object projectIdOrPath,
                                   java.lang.Long mergeRequestIid,
                                   java.lang.String body)
                            throws GitLabApiException

Create a merge request's note.

GitLab Endpoint: POST /projects/:id/merge_requests/:merge_request_iid/notes/:note_id

Parameters:

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

mergeRequestIid - the merge request IID to create the notes for

body - the content of note

Returns:

the created Note instance

Throws:

GitLabApiException - if any exception occurs

updateMergeRequestNote

public Note updateMergeRequestNote(java.lang.Object projectIdOrPath,
                                   java.lang.Long mergeRequestIid,
                                   java.lang.Long noteId,
                                   java.lang.String body)
                            throws GitLabApiException

Update the specified merge request's note.

GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/notes/:note_id

Parameters:

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

mergeRequestIid - the merge request IID to update the notes for

noteId - the ID of the node to update

body - the update content for the Note

Returns:

the modified Note instance

Throws:

GitLabApiException - if any exception occurs

deleteMergeRequestNote

public void deleteMergeRequestNote(java.lang.Object projectIdOrPath,
                                   java.lang.Long mergeRequestIid,
                                   java.lang.Long noteId)
                            throws GitLabApiException

Delete the specified merge request's note.

GitLab Endpoint: DELETE /projects/:id/merge_requests/:merge_request_iid/notes/:note_id

Parameters:

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

mergeRequestIid - the merge request IID to delete the notes for

noteId - the ID of the node to delete

Throws:

GitLabApiException - if any exception occurs