Module bus.gitlab

Package org.miaixz.bus.gitlab

Class SystemHooksApi

java.lang.Object

org.miaixz.bus.gitlab.AbstractApi

org.miaixz.bus.gitlab.SystemHooksApi

All Implemented Interfaces:

Constants

public class SystemHooksApi
extends AbstractApi

This class implements the client side API for the GitLab System Hooks Keys API calls.

Nested Class Summary

Nested classes/interfaces inherited from interface org.miaixz.bus.gitlab.models.Constants

Constants.ActionType, Constants.ApplicationScope, Constants.ArchiveFormat, Constants.AutoCancelPendingPipelines, Constants.AutoDevopsDeployStrategy, Constants.BuildGitStrategy, Constants.CommitBuildState, Constants.ContributorOrderBy, Constants.DefaultBranchProtectionLevel, Constants.DeploymentOrderBy, Constants.DeploymentStatus, Constants.DeployTokenScope, Constants.Encoding, Constants.EpicOrderBy, Constants.EventScope, Constants.GroupOrderBy, Constants.GroupSearchScope<T>, 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.PipelineSource, Constants.ProjectAccessTokenScope, Constants.ProjectCreationLevel, Constants.ProjectFeatureVisibilityAccessLevel, Constants.ProjectOrderBy, Constants.ProjectSearchScope<T>, Constants.SearchScope<T>, Constants.SortOrder, Constants.SquashOption, Constants.StateEvent, Constants.SubgroupCreationLevel, Constants.TagOrderBy, Constants.TargetType, Constants.TodoAction, Constants.TodoState, Constants.TodoType, Constants.TokenType

Field Summary

Fields inherited from class org.miaixz.bus.gitlab.AbstractApi

gitLabApi

Fields inherited from interface org.miaixz.bus.gitlab.models.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	Description
SystemHooksApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method	Description
SystemHook	addSystemHook(String url, String token, Boolean pushEvents, Boolean tagPushEvents, Boolean enableSslVerification)	Add a new system hook.
SystemHook	addSystemHook(String url, String token, SystemHook systemHook)	Add a new system hook.
void	addSystemHookUrlVariable(Long hookId, String key, String value)	Add a new URL variable.
void	deleteSystemHook(Long hookId)	Deletes a system hook.
void	deleteSystemHook(SystemHook hook)	Deletes a system hook.
void	deleteSystemHookUrlVariable(Long hookId, String key)	Delete a URL variable.
SystemHook	getSystemHook(Long hookId)	Get a list of all system hooks.
List<SystemHook>	getSystemHooks()	Get a list of all system hooks.
Pager<SystemHook>	getSystemHooks(int itemsPerPage)	Get a Pager of all system hooks.
List<SystemHook>	getSystemHooks(int page, int perPage)	Get a list of all system hooks using the specified page and per page settings.
Stream<SystemHook>	getSystemHookStream()	Get a Stream of all system hooks.
void	testSystemHook(Long hookId)	Test a system hook.
void	testSystemHook(SystemHook hook)	Test a system hook.
SystemHook	updateSystemHook(SystemHook systemHook, String token)	Add a new system hook.

Methods inherited from class org.miaixz.bus.gitlab.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getDefaultPerPageParam, getGroupIdOrPath, getLabelIdOrName, getNamespaceIdOrPath, getPageQueryParams, getPageQueryParams, getPerPageQueryParam, getProjectIdOrPath, getUserIdOrUsername, getWithAccepts, handle, head, isApiVersion, patch, patch, post, post, post, post, post, put, put, put, putUpload, putUpload, putWithFormData, 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 Details

SystemHooksApi

public SystemHooksApi(GitLabApi gitLabApi)

Method Details

getSystemHooks

public List<SystemHook> getSystemHooks()
                                throws GitLabApiException

Get a list of all system hooks. This method requires admin access.

 GitLab Endpoint: GET /hooks
 

Returns:

a list of SystemHook

Throws:

GitLabApiException - if any exception occurs

getSystemHooks

public List<SystemHook> getSystemHooks(int page,
 int perPage)
                                throws GitLabApiException

Get a list of all system hooks using the specified page and per page settings. This method requires admin access.

 GitLab Endpoint: GET /hooks
 

Parameters:

page - the page to get

perPage - the number of deploy keys per page

Returns:

the list of SystemHook in the specified range

Throws:

GitLabApiException - if any exception occurs

getSystemHooks

public Pager<SystemHook> getSystemHooks(int itemsPerPage)
                                 throws GitLabApiException

Get a Pager of all system hooks. This method requires admin access.

 GitLab Endpoint: GET /hooks
 

Parameters:

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

Returns:

a Pager of SystemHook

Throws:

GitLabApiException - if any exception occurs

getSystemHookStream

public Stream<SystemHook> getSystemHookStream()
                                       throws GitLabApiException

Get a Stream of all system hooks. This method requires admin access.

 GitLab Endpoint: GET /hooks
 

Returns:

a Stream of SystemHook

Throws:

GitLabApiException - if any exception occurs

getSystemHook

public SystemHook getSystemHook(Long hookId)
                         throws GitLabApiException

Get a list of all system hooks. This method requires admin access.

 GitLab Endpoint: GET /hooks
 

Parameters:

hookId - the ID of the system hook.

Returns:

the SystemHook

Throws:

GitLabApiException - if any exception occurs

addSystemHook

public SystemHook addSystemHook(String url,
 String token,
 Boolean pushEvents,
 Boolean tagPushEvents,
 Boolean enableSslVerification)
                         throws GitLabApiException

Add a new system hook. This method requires admin access.

 GitLab Endpoint: POST /hooks
 

Parameters:

url - the hook URL, required

token - secret token to validate received payloads, optional

pushEvents - when true, the hook will fire on push events, optional

tagPushEvents - when true, the hook will fire on new tags being pushed, optional

enableSslVerification - do SSL verification when triggering the hook, optional

Returns:

an SystemHook instance with info on the added system hook

Throws:

GitLabApiException - if any exception occurs

addSystemHook

public SystemHook addSystemHook(String url,
 String token,
 SystemHook systemHook)
                         throws GitLabApiException

Add a new system hook. This method requires admin access.

 GitLab Endpoint: POST /hooks
 

Parameters:

url - the hook URL, required

token - secret token to validate received payloads, optional

systemHook - the systemHook to create

Returns:

an SystemHook instance with info on the added system hook

Throws:

GitLabApiException - if any exception occurs

updateSystemHook

public SystemHook updateSystemHook(SystemHook systemHook,
 String token)
                            throws GitLabApiException

Add a new system hook. This method requires admin access.

 GitLab Endpoint: PUT /hooks/:hook_id
 

Parameters:

systemHook - the systemHook to update

token - secret token to validate received payloads, optional

Returns:

an SystemHook instance with info on the added system hook

Throws:

GitLabApiException - if any exception occurs

deleteSystemHook

public void deleteSystemHook(SystemHook hook)
                      throws GitLabApiException

Deletes a system hook. This method requires admin access.

 GitLab Endpoint: DELETE /hooks/:hook_id
 

Parameters:

hook - the SystemHook instance to delete

Throws:

GitLabApiException - if any exception occurs

deleteSystemHook

public void deleteSystemHook(Long hookId)
                      throws GitLabApiException

Deletes a system hook. This method requires admin access.

 GitLab Endpoint: DELETE /hooks/:hook_id
 

Parameters:

hookId - the ID of the system hook to delete

Throws:

GitLabApiException - if any exception occurs

testSystemHook

public void testSystemHook(SystemHook hook)
                    throws GitLabApiException

Test a system hook. This method requires admin access.

 GitLab Endpoint: GET /hooks/:hook_id
 

Parameters:

hook - the SystemHook instance to test

Throws:

GitLabApiException - if any exception occurs

testSystemHook

public void testSystemHook(Long hookId)
                    throws GitLabApiException

Test a system hook. This method requires admin access.

 GitLab Endpoint: GET /hooks/:hook_id
 

Parameters:

hookId - the ID of the system hook to test

Throws:

GitLabApiException - if any exception occurs

addSystemHookUrlVariable

public void addSystemHookUrlVariable(Long hookId,
 String key,
 String value)
                              throws GitLabApiException

Add a new URL variable.

 GitLab Endpoint: PUT /hooks/:hook_id/url_variables/:key
 

Parameters:

hookId - the ID of the system hook

key - Key of the URL variable

value - Value of the URL variable.

Throws:

GitLabApiException - if any exception occurs

deleteSystemHookUrlVariable

public void deleteSystemHookUrlVariable(Long hookId,
 String key)
                                 throws GitLabApiException

Delete a URL variable.

 GitLab Endpoint: DELETE /hooks/:hook_id/url_variables/:key
 

Parameters:

hookId - the ID of the system hook

key - Key of the URL variable

Throws:

GitLabApiException - if any exception occurs