public class

RemoteVersionLinkServiceImpl

extends AbstractRemoteEntityLinkService
implements RemoteVersionLinkService
java.lang.Object
   ↳ com.atlassian.jira.entity.remotelink.AbstractRemoteEntityLinkService
     ↳ com.atlassian.jira.bc.project.version.remotelink.RemoteVersionLinkServiceImpl

Summary

Constants
String REMOTE_VERSION_LINK Entity name
[Expand]
Inherited Constants
From class com.atlassian.jira.entity.remotelink.AbstractRemoteEntityLinkService
[Expand]
Inherited Fields
From class com.atlassian.jira.entity.remotelink.AbstractRemoteEntityLinkService
Public Constructors
RemoteVersionLinkServiceImpl(JsonEntityPropertyManager jsonEntityPropertyManager, PermissionManager permissionManager, VersionManager versionManager, EventPublisher eventPublisher, I18nHelper.BeanFactory i18nFactory)
Public Methods
void delete(ApplicationUser user, RemoteVersionLinkService.DeleteValidationResult deleteValidationResult)
Deletes the remote version link that links with the given JIRA version and has the given global id, if the current user has permission to do so.
RemoteVersionLinkService.RemoteVersionLinkResult getRemoteVersionLinkByVersionIdAndGlobalId(ApplicationUser user, Long versionId, String globalId)
Retrieves the remote version link that links with the given JIRA version and has the given globalId.
Long getRemoteVersionLinkCountByGlobalId(String globalId)
Retrieves the count of remote version links that are associated with the given remote resource.
RemoteVersionLinkService.RemoteVersionLinkListResult getRemoteVersionLinksByGlobalId(ApplicationUser user, String globalId)
Retrieves the remote version links that are associated with the given remote resource.
RemoteVersionLinkService.RemoteVersionLinkListResult getRemoteVersionLinksByVersionId(ApplicationUser user, Long versionId)
Retrieves all of the remote version links that link with the given JIRA version.
@EventListener void onVersionDeleted(VersionDeleteEvent event)
RemoteVersionLinkService.RemoteVersionLinkResult put(ApplicationUser user, RemoteVersionLinkService.PutValidationResult putValidationResult)
Creates a remote version link using the validated request returned by a prior call to validatePut(ApplicationUser, Long, String, String)
RemoteVersionLinkService.DeleteValidationResult validateDelete(ApplicationUser user, Long versionId, String globalId)
Validates parameters and checks permissions, and if all checks pass it will create a RemoteVersionLinkService.DeleteValidationResult that can be passed to the delete(ApplicationUser, DeleteValidationResult) method to delete the specified remote version link.
RemoteVersionLinkService.DeleteValidationResult validateDeleteByVersionId(ApplicationUser user, Long versionId)
Validates parameters and checks permissions, and if all checks pass it will create a RemoteVersionLinkService.DeleteValidationResult that can be passed to the delete(ApplicationUser, DeleteValidationResult) method to delete all remote version links for the specified version.
RemoteVersionLinkService.PutValidationResult validatePut(ApplicationUser user, Long versionId, String globalId, String json)
Validates parameters and checks permissions, and if all checks pass it will create a RemoteVersionLinkService.PutValidationResult that can be passed to the put(ApplicationUser, PutValidationResult) method.
[Expand]
Inherited Methods
From class com.atlassian.jira.entity.remotelink.AbstractRemoteEntityLinkService
From class java.lang.Object
From interface com.atlassian.jira.bc.project.version.remotelink.RemoteVersionLinkService

Constants

public static final String REMOTE_VERSION_LINK

Entity name

Constant Value: "RemoteVersionLink"

Public Constructors

public RemoteVersionLinkServiceImpl (JsonEntityPropertyManager jsonEntityPropertyManager, PermissionManager permissionManager, VersionManager versionManager, EventPublisher eventPublisher, I18nHelper.BeanFactory i18nFactory)

Public Methods

public void delete (ApplicationUser user, RemoteVersionLinkService.DeleteValidationResult deleteValidationResult)

Deletes the remote version link that links with the given JIRA version and has the given global id, if the current user has permission to do so.

Parameters
user user user who the permission checks will be run against (can be null, indicating an anonymous user).
deleteValidationResult contains the remote version link id to delete. This should have been created by one of the validateDeleteBy... methods. The result must be DeleteValidationResult#isValid() valid.

public RemoteVersionLinkService.RemoteVersionLinkResult getRemoteVersionLinkByVersionIdAndGlobalId (ApplicationUser user, Long versionId, String globalId)

Retrieves the remote version link that links with the given JIRA version and has the given globalId.

Parameters
user user who the permission checks will be run against (may be null, indicating an anonymous user).
versionId the ID of the version to get the remote version link for
globalId the globalId to get the remote version link for
Returns
  • a result object containing a RemoteVersionLink if all went well. If there was an error the remote version link will be null and the error collection will contain details of what went wrong. Some possible error cases include a remote version link with the given globalId not existing or the user not having BROWSE permission for the version's project.

public Long getRemoteVersionLinkCountByGlobalId (String globalId)

Retrieves the count of remote version links that are associated with the given remote resource. This method does not perform a permission check.

Parameters
globalId the globalId to get the remote version links for
Returns
  • The count of RemoteVersionLinks associated with the given remote resource global id.

public RemoteVersionLinkService.RemoteVersionLinkListResult getRemoteVersionLinksByGlobalId (ApplicationUser user, String globalId)

Retrieves the remote version links that are associated with the given remote resource.

Parameters
user user who the permission checks will be run against (may be null, indicating an anonymous user).
globalId the globalId to get the remote version links for
Returns
  • a result object containing a List of RemoteVersionLinks if all went well. If no remote version links are stored against the global ID, then the list will be empty. If there was an error, the remote version links list will be null and the error collection will contain details of what went wrong.

public RemoteVersionLinkService.RemoteVersionLinkListResult getRemoteVersionLinksByVersionId (ApplicationUser user, Long versionId)

Retrieves all of the remote version links that link with the given JIRA version.

Parameters
user user who the permission checks will be run against (may be null, indicating an anonymous user).
versionId the ID of the version to get the remote version links for
Returns
  • a result object containing a List of RemoteVersionLinks if all went well. If no remote version links are stored against the version, then the list will be empty. If there was an error, the remote version links list will be null and the error collection will contain details of what went wrong. Some possible error cases include the given version not existing, or the user not having BROWSE permission for the version's project.

@EventListener public void onVersionDeleted (VersionDeleteEvent event)

public RemoteVersionLinkService.RemoteVersionLinkResult put (ApplicationUser user, RemoteVersionLinkService.PutValidationResult putValidationResult)

Creates a remote version link using the validated request returned by a prior call to validatePut(ApplicationUser, Long, String, String)

Parameters
user user who the permission checks will be run against (may be null, indicating an anonymous user).
putValidationResult contains the remote version link to store. This should have been created by the validatePut(ApplicationUser, Long, String, String) method. The result must be PutValidationResult#isValid() valid.
Returns
  • a result object containing the persisted String if all went well. If there was an error creating the remote version link then the remote version link will be null and the error collection will contain details of what went wrong.

public RemoteVersionLinkService.DeleteValidationResult validateDelete (ApplicationUser user, Long versionId, String globalId)

Validates parameters and checks permissions, and if all checks pass it will create a RemoteVersionLinkService.DeleteValidationResult that can be passed to the delete(ApplicationUser, DeleteValidationResult) method to delete the specified remote version link.

Parameters
user who the permission checks will be run against (can be null, indicating an anonymous user).
versionId the ID of the version associated with the remote version link to be deleted
globalId the global id associated with the remote version link to be deleted
Returns
  • a DeleteValidationResult, if all validation and permission passes it will contain the information relevant to the deletion; otherwise, the error collection will contain the errors generated during validation.

public RemoteVersionLinkService.DeleteValidationResult validateDeleteByVersionId (ApplicationUser user, Long versionId)

Validates parameters and checks permissions, and if all checks pass it will create a RemoteVersionLinkService.DeleteValidationResult that can be passed to the delete(ApplicationUser, DeleteValidationResult) method to delete all remote version links for the specified version.

Parameters
user who the permission checks will be run against (can be null, indicating an anonymous user).
versionId the version associated with the remote version links to be deleted
Returns
  • a DeleteValidationResult, if all validation and permission passes it will contain the information relevant to the deletion; otherwise, the error collection will contain the errors generated during validation.

public RemoteVersionLinkService.PutValidationResult validatePut (ApplicationUser user, Long versionId, String globalId, String json)

Validates parameters and checks permissions, and if all checks pass it will create a RemoteVersionLinkService.PutValidationResult that can be passed to the put(ApplicationUser, PutValidationResult) method.

If any validation fails the result will contain a null String.

Parameters
user user who the permission checks will be run against (may be null, indicating an anonymous user).
versionId the ID of the version for which to create/update this remote version link
globalId the global id to associate with the remote version link. If this is null, then the JSON value will be checked for a field with RemoteEntityLink#GLOBAL_ID as the key. If that does not exist, then a new global ID is generated. After a successful call to put(ApplicationUser, PutValidationResult), the RemoteVersionLinkResult that it returns can be used to obtain the newly created RemoteVersionLink
json the JSON representation of the remote version link
Returns
  • a RemoteVersionLinkService.PutValidationResult. If all validation and permission checks pass, then it will contain the information required to create the link; otherwise, the result will contain an error collection with any error messages that may have been generated when performing the operation.