com.atlassian.jira.web.util
Interface WebAttachmentManager

All Known Implementing Classes:

DefaultWebAttachmentManager

public interface WebAttachmentManager

Manager for issue attachments.

Method Summary

ChangeItemBean	createAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper, User remoteUser, org.ofbiz.core.entity.GenericValue issue, String fileParamName, Map attachmentProperties) Create an issue's attachment.
boolean	validateAttachmentIfExists(File file, String fileName) Determine whether an attachment exists and is valid (i.e.
boolean	validateAttachmentIfExists(webwork.multipart.MultiPartRequestWrapper requestWrapper, String fileParamName, boolean required) Determine whether an attachment exists and is valid (i.e.

Method Detail

createAttachment

ChangeItemBean createAttachment(webwork.multipart.MultiPartRequestWrapper requestWrapper,
                                User remoteUser,
                                org.ofbiz.core.entity.GenericValue issue,
                                String fileParamName,
                                Map attachmentProperties)
                                throws AttachmentException,
                                       org.ofbiz.core.entity.GenericEntityException

Create an issue's attachment.

Parameters:

requestWrapper - eg. obtained from ServletActionContext.getMultiPartRequest()

remoteUser - eg. from JiraWebActionSupport.getRemoteUser()

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

validateAttachmentIfExists

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

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

validateAttachmentIfExists

boolean validateAttachmentIfExists(File file,
                                   String fileName)
                                   throws AttachmentException

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

Parameters:

file - the attachment File object

fileName - the filename of the attachment

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