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

Fields

Modifier and Type	Field and Description
static String	ATTACHMENT_ENTITY_NAME

Method Summary

Modifier and Type	Method and Description
File	getExternalAttachmentFile(ExternalAttachment attachment, ExternalProject project, String issueKey) Returns the full path, on disk, of the external attachment to be imported.
static String	getProjectKeyInUse(ExternalProject project)
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

getProjectKeyInUse

static String getProjectKeyInUse(ExternalProject project)

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

getExternalAttachmentFile

File getExternalAttachmentFile(ExternalAttachment attachment,
                               ExternalProject project,
                               String issueKey)

Returns the full path, on disk, of the external attachment to be imported.

Parameters:

attachment - represents the database row for an attachment from the backup.

project - 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 file store path to where the attachment file should be stored based on the provided inputs. In case the file cannot be found, a path to the non-existent file where it would normally be stored at will be returned.