com.atlassian.confluence.pages.persistence.dao.filesystem

Class HierarchicalMultiStreamAttachmentDataFileSystem

java.lang.Object

com.atlassian.confluence.pages.persistence.dao.filesystem.HierarchicalMultiStreamAttachmentDataFileSystem

All Implemented Interfaces:

AttachmentDataFileSystem

public class HierarchicalMultiStreamAttachmentDataFileSystem
extends Object
implements AttachmentDataFileSystem

An implementation of AttachmentDataFileSystem which stores the attachment data as files on a filesystem, using the standard File API.

The files are stored within a hierarchical directory structure that incorporates the IDs of the space, content entity and attachment IDs to which the attachment data belongs to. Data corresponding to each version of the attachment are stored, as are different "streams" of data for each version (see AttachmentDataStreamType.

For attachments belonging to "spaced" content entities (e.g. pages, blogs), the directory structure is described by the following pattern: "h1/h2/spaceId/h3/h4/contentId/attachmentId/attachmentFile"

where h1 and h2 are hashcodes generated from the spaceId, h3 and h4 are hashcodes generated from the contentId, and attachmentFile represents a combination of the attachment version and the data stream type. For backwards compatibility with HierarchicalFileSystemAttachmentDataDao, attachment files of type AttachmentDataStreamType.RAW_BINARY have a filename of just the numeric attachment version. For other stream types, the filename is "version.streamType" (e.g. "1.extracted_text").

For "non-spaced" entity attachments (e.g. user profile pictures), a simpler but similar structure is used: "nonspaced/h3/h4/contentId/attachmentId/attachmentFile"

Since:

5.5

Field Summary

Fields

Modifier and Type	Field and Description
static String	NON_SPACED_DIRECTORY_NAME

Constructor Summary

Constructors

Constructor and Description
HierarchicalMultiStreamAttachmentDataFileSystem(FileLocationResolver rootDir) Deprecated. Since 5.7.1. Inject the hierarchicalMultiStreamAttachmentDataFileSystem bean instead.
HierarchicalMultiStreamAttachmentDataFileSystem(FileLocationResolver rootDir, DeferredFileDeletionQueue deferredFileDeletionQueue)

Method Summary

Modifier and Type	Method and Description
boolean	dataExistsForAttachment(Attachment attachment) Indicates whether the filesystem contains data for the given attachment
void	deleteAllAttachmentVersions(Attachment attachment, ContentEntityObject originalContent) Delete all data corresponding to all versions of the given attachment
void	deleteSingleAttachmentVersion(Attachment attachment, ContentEntityObject originalContent) Delete the data corresponding to a single attachment version
void	deleteSingleAttachmentVersion(Attachment attachment, ContentEntityObject originalContent, AttachmentDataStreamType dataStreamType) Delete the data of the specified stream type corresponding to a single attachment version
AttachmentDataStream	getAttachmentData(Attachment attachment, AttachmentDataStreamType dataStreamType) Fetches the data for a given attachment version and data stream type
AttachmentDataStream	getAttachmentData(Attachment attachment, AttachmentDataStreamType dataStreamType, Optional<RangeRequest> range) Fetches the specified range of data for a given attachment version and data stream type
File	getContainerDirectoryForAttachmentVersions(long latestVersionAttachmentId, long contentId, com.atlassian.fugue.Maybe<Long> spaceId) Get the File representing the directory that contains all the versions of an attachment
File	getDirectoryForSpace(com.atlassian.fugue.Maybe<Long> spaceId)
void	moveAttachment(Attachment oldAttachment, Attachment newAttachment, ContentEntityObject newContent) Move all data relating to one attachment to a new directory corresponding to the given new attachment and content entity.
void	moveAttachments(ContentEntityObject contentEntity, Space oldSpace, Space newSpace) Move all data for all versions of all attachments corresponding to the given content entity in the given space, to the same entity in a different space.
void	moveDataForAttachmentVersion(Attachment sourceAttachmentVersion, Attachment targetAttachmentVersion) Move the data associated with one attachment version, to being associated with a different attachment version
void	prepareForMigrationTo() In this implementation, we want to make sure the attachments directory is empty, otherwise we will have attachments or files that don't belong.
boolean	saveAttachmentData(Attachment attachmentVersion, AttachmentDataStream attachmentDataStream, boolean overwrite) Save new data corresponding to the given attachment.

Methods inherited from class java.lang.Object

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

Field Detail

NON_SPACED_DIRECTORY_NAME

public static final String NON_SPACED_DIRECTORY_NAME

See Also:

Constant Field Values

Constructor Detail

HierarchicalMultiStreamAttachmentDataFileSystem

@Deprecated
public HierarchicalMultiStreamAttachmentDataFileSystem(FileLocationResolver rootDir)

Deprecated. Since 5.7.1. Inject the hierarchicalMultiStreamAttachmentDataFileSystem bean instead.

Do not use this. Consumers used to create their own HierarchicalMultiStreamAttachmentDataFileSystem but no longer need to as it is now a bean.

HierarchicalMultiStreamAttachmentDataFileSystem

public HierarchicalMultiStreamAttachmentDataFileSystem(FileLocationResolver rootDir,
                                                       DeferredFileDeletionQueue deferredFileDeletionQueue)

Method Detail

dataExistsForAttachment

public boolean dataExistsForAttachment(Attachment attachment)

Description copied from interface: AttachmentDataFileSystem

Indicates whether the filesystem contains data for the given attachment

Specified by:

dataExistsForAttachment in interface AttachmentDataFileSystem

moveAttachment

public void moveAttachment(Attachment oldAttachment,
                           Attachment newAttachment,
                           ContentEntityObject newContent)

Description copied from interface: AttachmentDataFileSystem

Move all data relating to one attachment to a new directory corresponding to the given new attachment and content entity.

Specified by:

moveAttachment in interface AttachmentDataFileSystem

Parameters:

oldAttachment - The attachment whose data is to be moved

newAttachment - The attachment to which the data should be moved to

newContent - The content entity corresponding to the new attachment

saveAttachmentData

public boolean saveAttachmentData(Attachment attachmentVersion,
                                  AttachmentDataStream attachmentDataStream,
                                  boolean overwrite)

Description copied from interface: AttachmentDataFileSystem

Save new data corresponding to the given attachment.

Specified by:

saveAttachmentData in interface AttachmentDataFileSystem

Parameters:

attachmentVersion - The attachment to which the data should be associated

attachmentDataStream - The new data

overwrite - If true, any existing data will be overwritten. If false, does nothing if data already exists.

Returns:

true if the data was written, false otherwise (e.g. no overwrite)

getContainerDirectoryForAttachmentVersions

public File getContainerDirectoryForAttachmentVersions(long latestVersionAttachmentId,
                                                       long contentId,
                                                       com.atlassian.fugue.Maybe<Long> spaceId)

Get the File representing the directory that contains all the versions of an attachment

Parameters:

latestVersionAttachmentId - this should be the ID of the latest version or the directory will not exist

contentId - the ID of the content containing the attachment

spaceId - the ID of the space the content belongs to

Returns:

the File representing the directory that contains all the versions of an attachment

Since:

5.7

deleteAllAttachmentVersions

public void deleteAllAttachmentVersions(Attachment attachment,
                                        ContentEntityObject originalContent)

Delete all data corresponding to all versions of the given attachment

This method will remove any empty folders left after removing the attachment data.

Specified by:

deleteAllAttachmentVersions in interface AttachmentDataFileSystem

Parameters:

attachment - the attachment for which data should be removed

originalContent - the content the attachment belongs to

moveDataForAttachmentVersion

public void moveDataForAttachmentVersion(Attachment sourceAttachmentVersion,
                                         Attachment targetAttachmentVersion)

Description copied from interface: AttachmentDataFileSystem

Move the data associated with one attachment version, to being associated with a different attachment version

Specified by:

moveDataForAttachmentVersion in interface AttachmentDataFileSystem

Parameters:

sourceAttachmentVersion - The attachment version containing the data

targetAttachmentVersion - The attachment version to which the data should be moved

deleteSingleAttachmentVersion

public void deleteSingleAttachmentVersion(Attachment attachment,
                                          ContentEntityObject originalContent)

Delete the data corresponding to a single attachment version

This method will remove any empty folders left after removing the attachment data.

Specified by:

deleteSingleAttachmentVersion in interface AttachmentDataFileSystem

Parameters:

attachment - the attachment for which data should be removed

originalContent - the content the attachment belongs to

deleteSingleAttachmentVersion

public void deleteSingleAttachmentVersion(Attachment attachment,
                                          ContentEntityObject originalContent,
                                          AttachmentDataStreamType dataStreamType)

Description copied from interface: AttachmentDataFileSystem

Delete the data of the specified stream type corresponding to a single attachment version

Specified by:

deleteSingleAttachmentVersion in interface AttachmentDataFileSystem

Parameters:

attachment - The attachment whose data should be deleted

originalContent - The content entity associated with the attachment

dataStreamType - The attachment stream type

getDirectoryForSpace

public File getDirectoryForSpace(com.atlassian.fugue.Maybe<Long> spaceId)

getAttachmentData

public AttachmentDataStream getAttachmentData(Attachment attachment,
                                              AttachmentDataStreamType dataStreamType)

Description copied from interface: AttachmentDataFileSystem

Fetches the data for a given attachment version and data stream type

Specified by:

getAttachmentData in interface AttachmentDataFileSystem

Parameters:

attachment - The attachment version for which the data is to be fetched

dataStreamType - The type of the data stream to be fetched

Returns:

The AttachmentDataStream containing the result

getAttachmentData

public AttachmentDataStream getAttachmentData(Attachment attachment,
                                              AttachmentDataStreamType dataStreamType,
                                              Optional<RangeRequest> range)

Description copied from interface: AttachmentDataFileSystem

Fetches the specified range of data for a given attachment version and data stream type

Specified by:

getAttachmentData in interface AttachmentDataFileSystem

Parameters:

attachment - The attachment version for which the data is to be fetched

dataStreamType - The type of the data stream to be fetched

range - The range of the data stream to be fetched

Returns:

The AttachmentDataStream containing the result

moveAttachments

public void moveAttachments(ContentEntityObject contentEntity,
                            Space oldSpace,
                            Space newSpace)

Description copied from interface: AttachmentDataFileSystem

Move all data for all versions of all attachments corresponding to the given content entity in the given space, to the same entity in a different space.

Specified by:

moveAttachments in interface AttachmentDataFileSystem

Parameters:

contentEntity - The content entity whose attachment data is to be moved

oldSpace - The original space of the content entity

newSpace - The new space of the content entity

prepareForMigrationTo

public void prepareForMigrationTo()

In this implementation, we want to make sure the attachments directory is empty, otherwise we will have attachments or files that don't belong.

We also want to make sure the attachments directory actually exists, prior to moving data across.

It is the responsibility of the action performing the migration to warn the user about this.

Specified by:

prepareForMigrationTo in interface AttachmentDataFileSystem