Interface AttachmentDataFileSystem
-
- All Known Implementing Classes:
ContentDirectoryStructureAttachmentDataFileSystemAdapter,ContentDirectoryStructureAttachmentDataFileSystemV003,ContentDirectoryStructureAttachmentDataFileSystemV004,ObjectStorageAttachmentDataFileSystem
public interface AttachmentDataFileSystemRepresents the filesystem used to store attachment data files.- Since:
- 7.12
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description booleandataExistsForAttachment(AttachmentRef attachment)Indicates whether the filesystem contains data for the given attachmentvoiddeleteAllAttachmentVersions(AttachmentRef attachment, AttachmentRef.Container contentEntity)Delete all data corresponding to all versions of the given attachmentvoiddeleteSingleAttachmentVersion(AttachmentRef attachment, AttachmentRef.Container contentEntity)Delete the data corresponding to a single attachment versionvoiddeleteSingleAttachmentVersion(AttachmentRef attachment, AttachmentRef.Container contentEntity, AttachmentDataStreamType dataStreamType)Delete the data of the specified stream type corresponding to a single attachment versionAttachmentDataStreamgetAttachmentData(AttachmentRef attachment, AttachmentDataStreamType dataStreamType)Fetches the data for a given attachment version and data stream typeAttachmentDataStreamgetAttachmentData(AttachmentRef attachment, AttachmentDataStreamType dataStreamType, Optional<RangeRequest> range)Fetches the specified range of data for a given attachment version and data stream typeAttachmentDataFile<com.atlassian.dc.filestore.api.compat.FilesystemPath>getAttachmentDataFile(long attachmentId, Long containerId, Long spaceId, Integer attachmentVersion, AttachmentDataStreamType dataStreamType)voidmoveAttachment(AttachmentRef oldAttachment, AttachmentRef newAttachment, AttachmentRef.Container newContentEntity)Deprecated.since 8.1.0voidmoveAttachments(AttachmentRef.Container contentEntity, AttachmentRef.Space oldSpace, AttachmentRef.Space newSpace)Deprecated.since 8.1.0voidmoveDataForAttachmentVersion(AttachmentRef sourceAttachmentVersion, AttachmentRef targetAttachmentVersion)Deprecated.since 8.1.0voidprepareForMigrationTo()Deprecated.since 8.1.0booleansaveAttachmentData(AttachmentRef attachment, AttachmentDataStream dataStream, boolean overwrite, org.springframework.util.unit.DataSize expectedFileSize)Save new data corresponding to the given attachment.
-
-
-
Method Detail
-
dataExistsForAttachment
boolean dataExistsForAttachment(AttachmentRef attachment)
Indicates whether the filesystem contains data for the given attachment
-
moveAttachment
@Deprecated void moveAttachment(AttachmentRef oldAttachment, AttachmentRef newAttachment, AttachmentRef.Container newContentEntity)
Deprecated.since 8.1.0Move all data relating to one attachment to a new directory corresponding to the given new attachment and content entity.- Parameters:
oldAttachment- The attachment whose data is to be movednewAttachment- The attachment to which the data should be moved tonewContentEntity- The content entity corresponding to the new attachment
-
saveAttachmentData
boolean saveAttachmentData(AttachmentRef attachment, AttachmentDataStream dataStream, boolean overwrite, org.springframework.util.unit.DataSize expectedFileSize)
Save new data corresponding to the given attachment.- Parameters:
attachment- The attachment to which the data should be associateddataStream- The new dataoverwrite- If true, any existing data will be overwritten. If false, does nothing if data already exists.expectedFileSize- The expected size of the data being written- Returns:
- true if the data was written, false otherwise (e.g. no overwrite)
-
deleteAllAttachmentVersions
void deleteAllAttachmentVersions(AttachmentRef attachment, AttachmentRef.Container contentEntity)
Delete all data corresponding to all versions of the given attachment- Parameters:
attachment- the attachment whose data is to be deletedcontentEntity- The content entity associated with the attachment
-
moveDataForAttachmentVersion
@Deprecated void moveDataForAttachmentVersion(AttachmentRef sourceAttachmentVersion, AttachmentRef targetAttachmentVersion)
Deprecated.since 8.1.0Move the data associated with one attachment version, to being associated with a different attachment version- Parameters:
sourceAttachmentVersion- The attachment version containing the datatargetAttachmentVersion- The attachment version to which the data should be moved
-
deleteSingleAttachmentVersion
void deleteSingleAttachmentVersion(AttachmentRef attachment, AttachmentRef.Container contentEntity)
Delete the data corresponding to a single attachment version- Parameters:
attachment- The attachment whose data should be deletedcontentEntity- The content entity associated with the attachment
-
deleteSingleAttachmentVersion
void deleteSingleAttachmentVersion(AttachmentRef attachment, AttachmentRef.Container contentEntity, AttachmentDataStreamType dataStreamType)
Delete the data of the specified stream type corresponding to a single attachment version- Parameters:
attachment- The attachment whose data should be deletedcontentEntity- The content entity associated with the attachmentdataStreamType- The attachment stream type- Since:
- 6.5
-
getAttachmentData
AttachmentDataStream getAttachmentData(AttachmentRef attachment, AttachmentDataStreamType dataStreamType)
Fetches the data for a given attachment version and data stream type- Parameters:
attachment- The attachment version for which the data is to be fetcheddataStreamType- The type of the data stream to be fetched- Returns:
- The
AttachmentDataStreamcontaining the result
-
getAttachmentData
AttachmentDataStream getAttachmentData(AttachmentRef attachment, AttachmentDataStreamType dataStreamType, Optional<RangeRequest> range)
Fetches the specified range of data for a given attachment version and data stream type- Parameters:
attachment- The attachment version for which the data is to be fetcheddataStreamType- The type of the data stream to be fetchedrange- The range of the data stream to be fetched- Returns:
- The
AttachmentDataStreamcontaining the result
-
moveAttachments
@Deprecated void moveAttachments(AttachmentRef.Container contentEntity, AttachmentRef.Space oldSpace, AttachmentRef.Space newSpace)
Deprecated.since 8.1.0Move 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.- Parameters:
contentEntity- The content entity whose attachment data is to be movedoldSpace- The original space of the content entitynewSpace- The new space of the content entity
-
prepareForMigrationTo
@Deprecated void prepareForMigrationTo()
Deprecated.since 8.1.0Prepare the data store for a migration from another type of data store.
-
getAttachmentDataFile
AttachmentDataFile<com.atlassian.dc.filestore.api.compat.FilesystemPath> getAttachmentDataFile(long attachmentId, @Nullable Long containerId, @Nullable Long spaceId, Integer attachmentVersion, AttachmentDataStreamType dataStreamType)
-
-