Package com.atlassian.jira.issue.attachment

Class DefaultTemporaryWebAttachmentManager

java.lang.Object

com.atlassian.jira.issue.attachment.DefaultTemporaryWebAttachmentManager

All Implemented Interfaces:

InitializingComponent, TemporaryWebAttachmentManager

@ParametersAreNonnullByDefault
public class DefaultTemporaryWebAttachmentManager
extends Object
implements TemporaryWebAttachmentManager, InitializingComponent

Default implementation of TemporaryWebAttachmentManager.

Since:

v6.4

Constructor Summary

Constructors

Constructor

Description

DefaultTemporaryWebAttachmentManager(AttachmentManager attachmentManager, AttachmentValidator attachmentValidator, I18nHelper.BeanFactory beanFactory, TemporaryWebAttachmentsMonitorLocator temporaryWebAttachmentsMonitorLocator, TemporaryWebAttachmentFactory temporaryWebAttachmentsFactory, com.atlassian.cache.CacheManager cacheManager, ProjectManager projectManager, IssueManager issueManager, FeatureManager featureManager, AttachmentConfigStore attachmentConfigStore, StreamAttachmentStore streamAttachmentStore, AttachmentValidatorInvoker attachmentValidatorInvoker)

Method Summary

Modifier and Type	Method	Description
void	afterInstantiation()	Called after all the beans are constructed and the ApplicationContext is fully populated.
boolean	canGetTemporaryWebAttachment(String attachmentId, ApplicationUser user)
void	clearTemporaryAttachmentsByFormToken(String formToken)	Removes all remaining temporary attachments which were created with given form token.
AttachmentsBulkOperationResult<ChangeItemBean>	convertTemporaryAttachments(ApplicationUser user, Issue issue, List<String> temporaryAttachmentsIds)	Converts temporary attachments created by TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, io.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) into real attachments.
io.atlassian.fugue.Either<AttachmentError,TemporaryWebAttachment>	createTemporaryWebAttachment(InputStream stream, String fileName, String contentType, long size, io.atlassian.fugue.Either<Issue,Project> target, String formToken, ApplicationUser user)	Creates new temporary attachment that may be later converted into real attachment.
io.atlassian.fugue.Option<TemporaryWebAttachment>	getTemporaryWebAttachment(String temporaryAttachmentId)	Gets temporary web attachment by string ID, which was produced by TemporaryWebAttachment.getStringId().
Collection<TemporaryWebAttachment>	getTemporaryWebAttachmentsByFormToken(String formToken)	Gets all temporary attachments associated with given form token.
void	updateTemporaryWebAttachment(String temporaryAttachmentId, TemporaryWebAttachment updated)	Updates existing temporary attachment object to new state.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DefaultTemporaryWebAttachmentManager

public DefaultTemporaryWebAttachmentManager(AttachmentManager attachmentManager,
 AttachmentValidator attachmentValidator,
 I18nHelper.BeanFactory beanFactory,
 TemporaryWebAttachmentsMonitorLocator temporaryWebAttachmentsMonitorLocator,
 TemporaryWebAttachmentFactory temporaryWebAttachmentsFactory,
 com.atlassian.cache.CacheManager cacheManager,
 ProjectManager projectManager,
 IssueManager issueManager,
 FeatureManager featureManager,
 AttachmentConfigStore attachmentConfigStore,
 StreamAttachmentStore streamAttachmentStore,
 AttachmentValidatorInvoker attachmentValidatorInvoker)

Method Details

afterInstantiation

public void afterInstantiation()
                        throws Exception

Description copied from interface: InitializingComponent

Called after all the beans are constructed and the ApplicationContext is fully populated. Order of execution is order of bean creation, driven by InitializingComponentProcessor.

Specified by:

afterInstantiation in interface InitializingComponent

Throws:

Exception

createTemporaryWebAttachment

@ParametersAreNonnullByDefault
public io.atlassian.fugue.Either<AttachmentError,TemporaryWebAttachment> createTemporaryWebAttachment(InputStream stream,
 String fileName,
 String contentType,
 long size,
 io.atlassian.fugue.Either<Issue,Project> target,
 String formToken,
 @Nullable
 ApplicationUser user)

Description copied from interface: TemporaryWebAttachmentManager

Creates new temporary attachment that may be later converted into real attachment. This attachment will be put to internal store and can be later retrieved using TemporaryWebAttachmentManager.getTemporaryWebAttachment(java.lang.String).

Specified by:

createTemporaryWebAttachment in interface TemporaryWebAttachmentManager

Parameters:

stream - attachment content

fileName - name of attachment file

contentType - content type

size - size of attachment

target - target for attachment - issue or project (in case if temporary attachment will be converted into real attachment during issue creation)

formToken - token representing attachment group (usually a token for a web form)

user - the author of attachment

Returns:

created temporary attachment or error if creation failed

canGetTemporaryWebAttachment

public boolean canGetTemporaryWebAttachment(String attachmentId,
 ApplicationUser user)

getTemporaryWebAttachment

public io.atlassian.fugue.Option<TemporaryWebAttachment> getTemporaryWebAttachment(String temporaryAttachmentId)

Description copied from interface: TemporaryWebAttachmentManager

Gets temporary web attachment by string ID, which was produced by TemporaryWebAttachment.getStringId().

Specified by:

getTemporaryWebAttachment in interface TemporaryWebAttachmentManager

Parameters:

temporaryAttachmentId - string attachment ID

Returns:

an option to temporary attachment - it will be empty if attachment was not found

getTemporaryWebAttachmentsByFormToken

public Collection<TemporaryWebAttachment> getTemporaryWebAttachmentsByFormToken(String formToken)

Description copied from interface: TemporaryWebAttachmentManager

Gets all temporary attachments associated with given form token.

Specified by:

getTemporaryWebAttachmentsByFormToken in interface TemporaryWebAttachmentManager

Parameters:

formToken - temporary attachments group token used during temporary attachments creation

Returns:

collection of matching TemporaryWebAttachment objects

updateTemporaryWebAttachment

public void updateTemporaryWebAttachment(String temporaryAttachmentId,
 TemporaryWebAttachment updated)

Description copied from interface: TemporaryWebAttachmentManager

Updates existing temporary attachment object to new state. This may be useful to change attachment file name (for example if user may provide custom name).

Specified by:

updateTemporaryWebAttachment in interface TemporaryWebAttachmentManager

Parameters:

temporaryAttachmentId - string id of temporary attachment to update

updated - object that holds new values for the temporary attachment

convertTemporaryAttachments

public AttachmentsBulkOperationResult<ChangeItemBean> convertTemporaryAttachments(@Nullable
 ApplicationUser user,
 Issue issue,
 List<String> temporaryAttachmentsIds)

Description copied from interface: TemporaryWebAttachmentManager

Converts temporary attachments created by TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, io.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) into real attachments.

Specified by:

convertTemporaryAttachments in interface TemporaryWebAttachmentManager

Parameters:

user - user which is performing conversion

issue - target issue for new attachments

temporaryAttachmentsIds - temporary attachments string IDs.

Returns:

bulk operation result

clearTemporaryAttachmentsByFormToken

public void clearTemporaryAttachmentsByFormToken(String formToken)

Description copied from interface: TemporaryWebAttachmentManager

Removes all remaining temporary attachments which were created with given form token.

Specified by:

clearTemporaryAttachmentsByFormToken in interface TemporaryWebAttachmentManager

Parameters:

formToken - form toke used to identify temporary attachments to remove