com.atlassian.jira.web.util

Interface WebAttachmentManager

All Known Implementing Classes:

DefaultWebAttachmentManager

Deprecated.

Use TemporaryWebAttachmentManager instead. Since v6.4.

@Deprecated
public interface WebAttachmentManager

Manager for issue attachments.

See Also:

AttachmentManager

Method Summary

Methods

Modifier and Type	Method and Description
ChangeItemBean	createAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper, com.atlassian.crowd.embedded.api.User remoteUser, org.ofbiz.core.entity.GenericValue issue, String fileParamName, Map<String,Object> attachmentProperties) Deprecated. Use createAttachment(webwork.multipart.MultiPartRequestWrapper, com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue, String, java.util.Map) instead. Since v5.0.
ChangeItemBean	createAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper, com.atlassian.crowd.embedded.api.User remoteUser, Issue issue, String fileParamName, Map<String,Object> attachmentProperties) Deprecated. Use TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, com.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) instead. Since v6.4.
TemporaryAttachment	createTemporaryAttachment(InputStream stream, String fileName, String contentType, long size, Issue issue, Project project) Deprecated. Use createTemporaryAttachment(java.io.InputStream, String, String, long, com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project, String)
TemporaryAttachment	createTemporaryAttachment(InputStream stream, String fileName, String contentType, long size, Issue issue, Project project, String formToken) Deprecated. Use TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, com.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) instead. Since v6.4.
TemporaryAttachment	createTemporaryAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper, String fileParamName, Issue issue, Project project) Deprecated. Use createTemporaryAttachment(webwork.multipart.MultiPartRequestWrapper, String, com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project, String)
TemporaryAttachment	createTemporaryAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper, String fileParamName, Issue issue, Project project, String formToken) Deprecated. Use TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, com.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) instead. Since v6.4.
boolean	validateAttachmentIfExists(webwork.multipart.MultiPartRequestWrapper requestWrapper, String fileParamName, boolean required) Deprecated. This method doesn't have replacement as it is not needed anymore in the new API. See instead. Since v6.4.

Method Detail

createAttachment

@Deprecated
ChangeItemBean createAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper,
                                         com.atlassian.crowd.embedded.api.User remoteUser,
                                         Issue issue,
                                         String fileParamName,
                                         Map<String,Object> attachmentProperties)
                                throws AttachmentException

Deprecated. Use TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, com.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) instead. Since v6.4.

Create an issue's attachment.

Parameters:

requestWrapper - eg. obtained from ServletActionContext.getMultiPartRequest()

remoteUser - eg. from JiraWebActionSupport.getLoggedInUser()

issue - Issue to associate attachment with

fileParamName - Name of form parameter specifying filename (in requestWrapper).

attachmentProperties - Arbitrary key:value properties to store with this attachment. Key is a String, value is an Object mappable to a PropertySet. Eg. {"attachment.copyright.licensed" -> Boolean.TRUE}

Throws:

AttachmentException

createAttachment

@Deprecated
ChangeItemBean createAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper,
                                         com.atlassian.crowd.embedded.api.User remoteUser,
                                         org.ofbiz.core.entity.GenericValue issue,
                                         String fileParamName,
                                         Map<String,Object> attachmentProperties)
                                throws AttachmentException,
                                       org.ofbiz.core.entity.GenericEntityException

Deprecated. Use createAttachment(webwork.multipart.MultiPartRequestWrapper, com.atlassian.crowd.embedded.api.User, com.atlassian.jira.issue.Issue, String, java.util.Map) instead. Since v5.0.

Create an issue's attachment.

Parameters:

requestWrapper - eg. obtained from ServletActionContext.getMultiPartRequest()

remoteUser - eg. from JiraWebActionSupport.getLoggedInUser()

issue - Issue to associate attachment with

fileParamName - Name of form parameter specifying filename (in requestWrapper).

attachmentProperties - Arbitrary key:value properties to store with this attachment. Key is a String, value is an Object mappable to a PropertySet. Eg. {"attachment.copyright.licensed" -> Boolean.TRUE}

Throws:

AttachmentException

org.ofbiz.core.entity.GenericEntityException

createTemporaryAttachment

@Deprecated
TemporaryAttachment createTemporaryAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper,
                                                       String fileParamName,
                                                       Issue issue,
                                                       Project project,
                                                       String formToken)
                                              throws AttachmentException

Deprecated. Use TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, com.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) instead. Since v6.4.

Creates a temporary attachment on disk. These attachment generally only live for the duration of a user's session and will also be deleted on exit of the JVM. This method will not create a link to the issue yet, but simply copy the attachment to a temp directory in the attachments folder and store all the relevant details in the returned TemporaryAttachment object

Parameters:

requestWrapper - the wrapper containing getFile() and getFilesystemName() describing the attachment

fileParamName - ame of form parameter specifying filename (in requestWrapper).

issue - The issue that this temporary attachment is for. Can be null when creating a new issue

project - The project where the attachment is to be placed. This is used to do security checks when creating an issue and there is no issue to run a check on. Will be ignored when issue is not null.

formToken -

Returns:

A TemporaryAttachment containing details about where the temp attachment was created

Throws:

AttachmentException - if there was an error saving the temporary attachment.

createTemporaryAttachment

@Deprecated
TemporaryAttachment createTemporaryAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper,
                                                       String fileParamName,
                                                       Issue issue,
                                                       Project project)
                                              throws AttachmentException

Deprecated. Use createTemporaryAttachment(webwork.multipart.MultiPartRequestWrapper, String, com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project, String)

Creates a temporary attachment on disk. These attachment generally only live for the duration of a user's session and will also be deleted on exit of the JVM. This method will not create a link to the issue yet, but simply copy the attachment to a temp directory in the attachments folder and store all the relevant details in the returned TemporaryAttachment object

Parameters:

requestWrapper - the wrapper containing getFile() and getFilesystemName() describing the attachment

fileParamName - ame of form parameter specifying filename (in requestWrapper).

issue - The issue that this temporary attachment is for. Can be null when creating a new issue

project - The project where the attachment is to be placed. This is used to do security checks when creating an issue and there is no issue to run a check on. Will be ignored when issue is not null.

Returns:

A TemporaryAttachment containing details about where the temp attachment was created

Throws:

AttachmentException - if there was an error saving the temporary attachment.

createTemporaryAttachment

@Deprecated
TemporaryAttachment createTemporaryAttachment(InputStream stream,
                                                       String fileName,
                                                       String contentType,
                                                       long size,
                                                       Issue issue,
                                                       Project project,
                                                       String formToken)
                                              throws AttachmentException

Deprecated. Use TemporaryWebAttachmentManager.createTemporaryWebAttachment(java.io.InputStream, java.lang.String, java.lang.String, long, com.atlassian.fugue.Either<com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project>, java.lang.String, com.atlassian.jira.user.ApplicationUser) instead. Since v6.4.

Creates a temporary attachment on disk. These attachment generally only live for the duration of a user's session and will also be deleted on exit of the JVM. This method will not create a link to the issue yet, but simply copy the attachment to a temp directory in the attachments folder and store all the relevant details in the returned TemporaryAttachment object

Parameters:

stream - the input stream for the attachment.

fileName - the name of the attachment.

contentType - the content type of the passed stream.

size - the size of the passed stream.

issue - The issue that this temporary attachment is for. Can be null when creating a new issue.

project - The project where the attachment is to be placed. This is used to do security checks when creating an issue and there is no issue to run a check on. Will be ignored when issue is not null.

formToken -

Returns:

A TemporaryAttachment containing details about where the temp attachment was created

Throws:

AttachmentException - if there was an error saving the temporary attachment.

createTemporaryAttachment

@Deprecated
TemporaryAttachment createTemporaryAttachment(InputStream stream,
                                                       String fileName,
                                                       String contentType,
                                                       long size,
                                                       Issue issue,
                                                       Project project)
                                              throws AttachmentException

Deprecated. Use createTemporaryAttachment(java.io.InputStream, String, String, long, com.atlassian.jira.issue.Issue, com.atlassian.jira.project.Project, String)

Creates a temporary attachment on disk. These attachment generally only live for the duration of a user's session and will also be deleted on exit of the JVM. This method will not create a link to the issue yet, but simply copy the attachment to a temp directory in the attachments folder and store all the relevant details in the returned TemporaryAttachment object

Parameters:

stream - the input stream for the attachment.

fileName - the name of the attachment.

contentType - the content type of the passed stream.

size - the size of the passed stream.

issue - The issue that this temporary attachment is for. Can be null when creating a new issue.

project - The project where the attachment is to be placed. This is used to do security checks when creating an issue and there is no issue to run a check on. Will be ignored when issue is not null.

Returns:

A TemporaryAttachment containing details about where the temp attachment was created

Throws:

AttachmentException - if there was an error saving the temporary attachment.

validateAttachmentIfExists

@Deprecated
boolean validateAttachmentIfExists(webwork.multipart.MultiPartRequestWrapper requestWrapper,
                                            String fileParamName,
                                            boolean required)
                                   throws AttachmentException

Deprecated. This method doesn't have replacement as it is not needed anymore in the new API. See instead. Since v6.4.

Determine whether an attachment exists and is valid (i.e. non-zero and contains no invalid characters)

Parameters:

requestWrapper - the wrapper containing getFile() and getFilesystemName() describing the attachment

fileParamName - the parameter in the wrapper to use to find attachment info

required - whether having an valid and existent attachment is mandatory

Returns:

whether the attachment is valid and exists

Throws:

AttachmentException - if the attachment is zero-length, contains invalid characters, or simply doesn't exist when required