com.atlassian.jira.imports.project.parser
Interface AttachmentParser

All Known Implementing Classes:
AttachmentParserImpl

public interface AttachmentParser

Converts issue attachment xml in a JIRA backup to an object representation.

Since:
v3.13

Field Summary
static String ATTACHMENT_ENTITY_NAME
           
 
Method Summary
 String getFileAttachmentUrl(ExternalAttachment attachment, String attachmentPath, String projectKey, String issueKey)
          Returns the full path, on disk, to where the attachment file should be stored based on the provided inputs.
 ExternalAttachment parse(Map<String,String> attributes)
          Parses the file attachment data from the backup XML.
 

Field Detail

ATTACHMENT_ENTITY_NAME

static final String ATTACHMENT_ENTITY_NAME
See Also:
Constant Field Values
Method Detail

parse

ExternalAttachment parse(Map<String,String> attributes)
                         throws ParseException
Parses the file attachment data from the backup XML.

Parameters:
attributes - is a map of key value pairs that represent the attributes of an ExternalAttachment. The following attributes are required, otherwise a ParseException will be thrown:
  • id (required)
  • issue (required)
  • filename (required)
  • created (required)
An optional attribute is:
  • author
Returns:
an ExternalAttachment if the attributes contain the required fields
Throws:
ParseException - if the required fields are not found in the attributes map

getFileAttachmentUrl

String getFileAttachmentUrl(ExternalAttachment attachment,
                            String attachmentPath,
                            String projectKey,
                            String issueKey)
Returns the full path, on disk, to where the attachment file should be stored based on the provided inputs.

Parameters:
attachment - represents the database row for an attachment from the backup.
attachmentPath - is the path, on disk, the user has specified that should contain all attachments.
projectKey - the backup project key, used to determine the path to the attachment file.
issueKey - the issue key that the attachment is associated with, used to determine the path to the attachment file.
Returns:
the full path, on disk, to where the attachment file should be stored based on the provided inputs.


Copyright © 2002-2013 Atlassian. All Rights Reserved.