Package org.miaixz.bus.gitlab

Class ReleaseLinksApi

java.lang.Object

org.miaixz.bus.gitlab.AbstractApi

org.miaixz.bus.gitlab.ReleaseLinksApi

All Implemented Interfaces:

Constants

public class ReleaseLinksApi
extends AbstractApi

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

See Also:

• ReleaseLinks API at GitLab

Nested Class Summary

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

Constants.ActionType, Constants.ApplicationScope, Constants.ArchiveFormat, 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, 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.ProjectCreationLevel, Constants.ProjectOrderBy, Constants.ProjectSearchScope, Constants.SearchScope, 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.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
ReleaseLinksApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method	Description
Link	createLink(Object projectIdOrPath, ReleaseLinkParams params)	Create a Link.
void	deleteLink(Object projectIdOrPath, String tagName, Integer linkId)	Delete a Link.
Link	getLink(Object projectIdOrPath, String tagName, Integer linkId)	Get a Link for the given tag name and link id.
List<Link>	getLinks(Object projectIdOrPath, String tagName)	Get assets as Links from a Release.
Pager<Link>	getLinks(Object projectIdOrPath, String tagName, int itemsPerPage)	Get assets as Links from a Release.
Stream<Link>	getLinksStream(Object projectIdOrPath, String tagName)	Get a Stream of assets as Links from a Release.
Optional<Link>	getOptionalLink(Object projectIdOrPath, String tagName, Integer linkId)	Get an Optional instance holding a Link instance for the specific tag name and link id.
Link	updateLink(Object projectIdOrPath, Integer linkId, ReleaseLinkParams params)	Updates the attributes of a given Link.

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, 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

ReleaseLinksApi

public ReleaseLinksApi(GitLabApi gitLabApi)

Method Details

getLinks

public List<Link> getLinks(Object projectIdOrPath,
 String tagName)
                    throws GitLabApiException

Get assets as Links from a Release.

 GitLab Endpoint: GET /projects/:id/releases/:tagName/assets/links
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

tagName - the tag name that the release was created from

Returns:

the list of assets for the specified release

Throws:

GitLabApiException - if any exception occurs

getLinks

public Pager<Link> getLinks(Object projectIdOrPath,
 String tagName,
 int itemsPerPage)
                     throws GitLabApiException

Get assets as Links from a Release.

 GitLab Endpoint: GET /projects/:id/releases/:tagName/assets/links
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

tagName - the tag name that the release was created from

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

Returns:

the Pager of Link instances for the specified project ID

Throws:

GitLabApiException - if any exception occurs

getLinksStream

public Stream<Link> getLinksStream(Object projectIdOrPath,
 String tagName)
                            throws GitLabApiException

Get a Stream of assets as Links from a Release.

 GitLab Endpoint: GET /projects/:id/releases/:tagName/assets/links
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

tagName - the tag name that the release was created from

Returns:

a Stream of Link instances for the specified project ID

Throws:

GitLabApiException - if any exception occurs

getLink

public Link getLink(Object projectIdOrPath,
 String tagName,
 Integer linkId)
             throws GitLabApiException

Get a Link for the given tag name and link id.

 GitLab Endpoint: GET /projects/:id/releases/:tagName/assets/links/:linkId
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

tagName - the name of the tag to fetch the Link for

linkId - the id of the Link to fetch for

Returns:

a Link instance with info on the specified tag and id

Throws:

GitLabApiException - if any exception occurs

getOptionalLink

public Optional<Link> getOptionalLink(Object projectIdOrPath,
 String tagName,
 Integer linkId)

Get an Optional instance holding a Link instance for the specific tag name and link id.

 GitLab Endpoint: GET /projects/:id/releases/:tagName/assets/links/:linkId
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

tagName - the name of the tag to fetch the Link for

linkId - the id of the Link to fetch for

Returns:

an Optional instance with the specified Link as the value

createLink

public Link createLink(Object projectIdOrPath,
 ReleaseLinkParams params)
                throws GitLabApiException

Create a Link. You need push access to the repository to create a Link.

 GitLab Endpoint: POST /projects/:id/releases/:tagName/assets/links
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

params - a ReleaseLinksParams instance holding the parameters for the link

Returns:

a Link instance containing the newly created Link info

Throws:

GitLabApiException - if any exception occurs

updateLink

public Link updateLink(Object projectIdOrPath,
 Integer linkId,
 ReleaseLinkParams params)
                throws GitLabApiException

Updates the attributes of a given Link.

 GitLab Endpoint: PUT /projects/:id/releases/:tagName/assets/links/:linkId
 

Parameters:

projectIdOrPath - id, path of the project, or a Project instance holding the project ID or path

linkId - the id of the Link to fetch for

params - a ReleaseLinksParams instance holding the parameters for the Link

Returns:

a Link instance containing info on the updated Link

Throws:

GitLabApiException - if any exception occurs

deleteLink

public void deleteLink(Object projectIdOrPath,
 String tagName,
 Integer linkId)
                throws GitLabApiException

Delete a Link.

 GitLab Endpoint: DELETE /projects/:id/releases/:tagName/assets/links/:linkId
 

Parameters:

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

tagName - the tag name that the link was created from

linkId - the id of the Link to delete

Throws:

GitLabApiException - if any exception occurs