Package com.atlassian.confluence.pages

Class DefaultAttachmentManager

java.lang.Object

com.atlassian.confluence.pages.DefaultAttachmentManager

All Implemented Interfaces:

AttachmentManagerInternal, AttachmentManager

public class DefaultAttachmentManager
extends Object
implements AttachmentManagerInternal

Default implementation of AttachmentManager. The storage location of attachments is not defined, and is handled by the AttachmentDao.

Constructor Summary

Constructors

Constructor	Description
DefaultAttachmentManager()	Deprecated. since 5.2, use invalid input: '{@link #DefaultAttachmentManager(AttachmentDaoInternal, ContentEntityObjectDaoInternal<>, EventPublisher, UserPreferencesAccessor, NotificationManager, RelationManager, RetentionFeatureChecker, ContentReconciliationManager, ContentPermissionManager)'}
DefaultAttachmentManager(AttachmentDaoInternal attachmentDao, ContentEntityObjectDaoInternal contentEntityObjectDao, com.atlassian.event.api.EventPublisher eventPublisher, UserPreferencesAccessor userPreferencesAccessor, NotificationManager notificationManager, RelationManager relationManager, RetentionFeatureChecker retentionFeatureChecker, ContentReconciliationManager reconciliationManager, ContentPermissionManager contentPermissionManager, PermissionManager permissionManager)

Method Summary

Modifier and Type	Method	Description
void	copyAttachment(Attachment attachment, ContentEntityObject destinationContent)	Copy specified attachment to specified destination content.
void	copyAttachments(ContentEntityObject sourceContent, ContentEntityObject destinationContent)	Copy the latest version of all the attachments on the sourceContent to the destinationContent.
void	copyAttachments(ContentEntityObject sourceContent, ContentEntityObject destinationContent, SaveContext saveContext)	Copy the latest version of all the attachments on the sourceContent to the destinationContent.
long	countAttachmentsBySpaceAndStatuses(Space space, List<ContentStatus> statuses)	This method only count the latest versions of attachments by statuses in a space
long	countAttachmentsByStatuses(List<ContentStatus> statuses)	This method only count the latest versions of attachments by statuses
int	countLatestVersionsOfAttachments(ContentEntityObject content)	Returns a count of the number of latest versions of attachments
int	countLatestVersionsOfAttachmentsOnPageSince(ContentEntityObject content, Date since)	Fetches number of attachments changed on a page since a specific timestamp
int	countLatestVersionsOfAttachmentsWithAnyStatus(ContentEntityObject content)	Returns a count of the number of latest versions of attachments (including trashed)
void	deepAttachmentDelete(AttachmentDeleteOptions attachmentDeleteOptions)	Support delete multiple attachments in batch
Optional<Attachment>	findAttachmentForDownloadPath(String downloadPath)	Find an Attachment for the given downloadPath.
List<Attachment>	getAllVersions(Attachment attachment)	Get all versions of an attachment, starting with the current version
List<Attachment>	getAllVersionsOfAttachments(ContentEntityObject content)	Returns a list of all attachments, old and new.
Attachment	getAttachment(long id)
Attachment	getAttachment(ContentEntityObject content, String attachmentFileName)	Get the most recent version of an attachment with a given name for a particular page.
Attachment	getAttachment(ContentEntityObject content, String attachmentFileName, int version)	Retrieve a named attachment from a page.
AttachmentDao	getAttachmentDao()	Provides a back door to the underlying AttachmentDao.
InputStream	getAttachmentData(Attachment attachment)	Retrieve the data for attachment
InputStream	getAttachmentData(Attachment attachment, Optional<RangeRequest> range)	Retrieve the specified range of data for attachment
String	getAttachmentDownloadPath(ContentEntityObject content, String attachmentFileName)	Get the download path for the most recent version of an attachment with the given name for some content
List<Attachment>	getAttachments(List<Long> ids)	Returns a list of attachments matching the given list of IDs.
Optional<AttachmentStatisticsDTO>	getAttachmentStatistics()	Fetches statistics about attachments
AttachmentDataStorageType	getBackingStorageType()	Returns the currently active storage type.
AttachmentDao.AttachmentCopier	getCopier(AttachmentManagerInternal destination)	Retrieves a AttachmentDao.AttachmentCopier that will allow the attachments from one data store to be copied across to another.
PageResponse<Attachment>	getFilteredAttachments(ContentEntityObject content, LimitedRequest pageRequest, Predicate<? super Attachment> filterPredicate)	Returns the current attachments under the CEO.
List<Attachment>	getLastAddedVersionsOf(Attachment attachment)	Retrieves all the last added versions for each user who has added a version of the attachment That is, if a user has added multiple versions, only the latest added version will be added to the list returned.
List<Attachment>	getLatestVersionsOfAttachments(ContentEntityObject content)	Returns a list of only latest versions of attachments.
List<Attachment>	getLatestVersionsOfAttachmentsForMultipleCeos(Iterable<? extends ContentEntityObject> contentEntityObjects)	Returns a list of all the latest versions of attachments for all the CEOs provided
List<Attachment>	getLatestVersionsOfAttachmentsWithAnyStatus(ContentEntityObject content)	Returns a list of only latest versions of attachments (including trashed).
List<Attachment>	getLatestVersionsOfAttachmentsWithAnyStatusForContainers(Iterable<? extends ContentEntityObject> contentEntityObjects)	Returns a list of all the latest versions of attachments for all the CEOs provided (including trashed)
List<Attachment>	getPreviousVersions(Attachment attachment)	Get all non-current versions of an attachment, not including the current version.
Map<Long,Long>	getRemappedAttachmentIds()	Gets a list of remapped attachment IDs.
void	moveAttachment(Attachment attachment, ContentEntityObject newContainer)	Moves an attachment to a different ContentEntityObject container.
void	moveAttachment(Attachment latestVersion, String newFileName, ContentEntityObject newContent)
void	removeAttachmentFromServer(Attachment latestVersion)	Removes the attachment and all previous versions
void	removeAttachments(List<? extends Attachment> attachments)	Removes the contents of attachments from the server
void	removeAttachmentVersionFromServer(Attachment attachment)	Removes the given version of the Attachment and its data from the server and data store.
void	removeAttachmentVersionFromServerWithoutNotifications(Attachment attachment)	Removes the given version of the Attachment and its data from the server and data store while suppressing notifications.
void	removeAttachmentWithoutNotifications(Attachment latestVersion)	Removes an Attachment and its data from the server while suppressing notifications.
void	restore(Attachment attachment)	Restores an attachment from trash.
void	saveAttachment(Attachment attachment, Attachment previousVersion, InputStream attachmentData)	Saves an Attachment and its data
void	saveAttachment(Attachment attachment, Attachment previousVersion, InputStream attachmentData, SaveContext saveContext)	Saves an Attachment and its data, taking a SaveContext to allow more useful event handling.
void	saveAttachments(List<SavableAttachment> savableAttachments)	Saves multiple attachment and their data
void	saveAttachments(List<SavableAttachment> savableAttachments, SaveContext saveContext)	Saves multiple attachment and their data
protected final void	saveNewAttachment(Attachment attachment, InputStream attachmentData, SaveContext saveContext)
protected final void	saveNewAttachmentVersion(Attachment attachment, Attachment previousVersion, InputStream attachmentData, SaveContext saveContext)
@NonNull PageResponse<Attachment>	scanFilteredAttachments(Space space, List<ContentStatus> statuses, LimitedRequest pageRequest, Predicate<? super Attachment>... filter)	Retrieves all the existing attachments associated with the instance of Confluence, while applying the specified pagination parameters to limit the number of results returned in each request.
@NonNull PageResponse<Attachment>	scanFilteredAttachments(List<ContentStatus> statuses, LimitedRequest pageRequest, Predicate<? super Attachment>... filter)	Retrieves all the current attachments within the specified space, with the results limited according to the provided pagination parameters.
void	setAttachmentDao(AttachmentDaoInternal attachmentDao)
void	setAttachmentData(Attachment attachment, InputStream attachmentData)	Set the data belonging to attachment
void	trash(Attachment attachment)	Moves an attachment to the trash.

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultAttachmentManager

public DefaultAttachmentManager(AttachmentDaoInternal attachmentDao,
 ContentEntityObjectDaoInternal contentEntityObjectDao,
 com.atlassian.event.api.EventPublisher eventPublisher,
 UserPreferencesAccessor userPreferencesAccessor,
 NotificationManager notificationManager,
 RelationManager relationManager,
 RetentionFeatureChecker retentionFeatureChecker,
 ContentReconciliationManager reconciliationManager,
 ContentPermissionManager contentPermissionManager,
 PermissionManager permissionManager)

Since:

7.16

DefaultAttachmentManager

@Deprecated
public DefaultAttachmentManager()

Deprecated.

since 5.2, use invalid input: '{@link #DefaultAttachmentManager(AttachmentDaoInternal, ContentEntityObjectDaoInternal<>, EventPublisher, UserPreferencesAccessor, NotificationManager, RelationManager, RetentionFeatureChecker, ContentReconciliationManager, ContentPermissionManager)'}

Method Details

getAttachment

public Attachment getAttachment(ContentEntityObject content,
 String attachmentFileName)

Get the most recent version of an attachment with a given name for a particular page. If the supplied content parameter is not a type which contains attachments (e.g. Comment) then attempt to find the nearest owner that does have attachments.

Specified by:

getAttachment in interface AttachmentManager

Parameters:

content - the page the attachment is attached to

attachmentFileName - the filename of the attachment to be retrieved

Returns:

the appropriate attachment, or null if no such attachment exists

getAttachmentDownloadPath

public String getAttachmentDownloadPath(ContentEntityObject content,
 String attachmentFileName)

Description copied from interface: AttachmentManager

Get the download path for the most recent version of an attachment with the given name for some content

Specified by:

getAttachmentDownloadPath in interface AttachmentManager

Parameters:

content - the content the attachment is attached to

attachmentFileName - the filename of the attachment to be retrieved

Returns:

the appropriate attachment download path, or null if no such attachment exists

getAttachment

public Attachment getAttachment(ContentEntityObject content,
 String attachmentFileName,
 int version)

Retrieve a named attachment from a page. If the supplied content parameter is not a type which contains attachments (e.g. Comment) then attempt to find the nearest owner that does have attachments.

Specified by:

getAttachment in interface AttachmentManager

Parameters:

content - the page the attachment is attached to

attachmentFileName - the filename of the attachment to retrieve

version - the version of the attachment to retrieve. If you provide a version of 0 or less, you'll get the most recent version, but you should probably use #getAttachment(AbstractPage, String) instead for that purpose instead

Returns:

the requested attachment, or null if the requested attachment does not exist.

saveAttachment

public void saveAttachment(Attachment attachment,
 Attachment previousVersion,
 InputStream attachmentData)
                    throws IOException

Description copied from interface: AttachmentManager

Saves an Attachment and its data

Specified by:

saveAttachment in interface AttachmentManager

Parameters:

attachment - the modified version of the Attachment

previousVersion - the original version of the Attachment (null if new)

attachmentData - an InputStream representing the data of the Attachment

Throws:

IOException

saveAttachment

public void saveAttachment(Attachment attachment,
 Attachment previousVersion,
 InputStream attachmentData,
 SaveContext saveContext)
                    throws IOException

Description copied from interface: AttachmentManager

Saves an Attachment and its data, taking a SaveContext to allow more useful event handling.

Specified by:

saveAttachment in interface AttachmentManager

Parameters:

attachment - the modified version of the Attachment

previousVersion - the original version of the Attachment (null if new)

attachmentData - an InputStream representing the data of the Attachment

saveContext - provides more information about the circumstances of the save

Throws:

IOException

saveAttachments

public void saveAttachments(List<SavableAttachment> savableAttachments)
                     throws IOException

Description copied from interface: AttachmentManager

Saves multiple attachment and their data

Specified by:

saveAttachments in interface AttachmentManager

Parameters:

savableAttachments - the modified version of the Attachment

Throws:

IOException

saveAttachments

public void saveAttachments(List<SavableAttachment> savableAttachments,
 SaveContext saveContext)
                     throws IOException

Description copied from interface: AttachmentManager

Saves multiple attachment and their data

Specified by:

saveAttachments in interface AttachmentManager

Parameters:

savableAttachments - the modified version of the Attachment

saveContext - provides more details about saving. If in doubt pass DefaultSaveContext.DEFAULT.

Throws:

IOException

saveNewAttachment

protected final void saveNewAttachment(Attachment attachment,
 InputStream attachmentData,
 SaveContext saveContext)

saveNewAttachmentVersion

protected final void saveNewAttachmentVersion(Attachment attachment,
 Attachment previousVersion,
 InputStream attachmentData,
 SaveContext saveContext)
                                       throws IOException

Throws:

IOException

getPreviousVersions

public List<Attachment> getPreviousVersions(Attachment attachment)

Description copied from interface: AttachmentManager

Get all non-current versions of an attachment, not including the current version. (ordered from most recent)

Specified by:

getPreviousVersions in interface AttachmentManager

Parameters:

attachment - the attachment to get all non-current versions for.

getLastAddedVersionsOf

public List<Attachment> getLastAddedVersionsOf(Attachment attachment)

Description copied from interface: AttachmentManager

Retrieves all the last added versions for each user who has added a version of the attachment That is, if a user has added multiple versions, only the latest added version will be added to the list returned. Result will be sorted with the earliest version coming first.

Specified by:

getLastAddedVersionsOf in interface AttachmentManager

Parameters:

attachment - attachment (must be the latest version)

Returns:

the last added versions for each user who has added a version of the attachment

getAttachmentData

public InputStream getAttachmentData(Attachment attachment)

Description copied from interface: AttachmentManager

Retrieve the data for attachment

Specified by:

getAttachmentData in interface AttachmentManager

Parameters:

attachment - the Attachment the data belongs to

Returns:

InputStream representing the data

getAttachmentData

public InputStream getAttachmentData(Attachment attachment,
 Optional<RangeRequest> range)

Description copied from interface: AttachmentManager

Retrieve the specified range of data for attachment

Specified by:

getAttachmentData in interface AttachmentManager

Parameters:

attachment - the Attachment the data belongs to

range - the range of data to retrieve. See

invalid reference

com.atlassian.filestore.client.api.entity.ByteRanges

Returns:

InputStream representing the data

getLatestVersionsOfAttachments

public List<Attachment> getLatestVersionsOfAttachments(ContentEntityObject content)

Description copied from interface: AttachmentManager

Returns a list of only latest versions of attachments.

Specified by:

getLatestVersionsOfAttachments in interface AttachmentManager

getLatestVersionsOfAttachmentsForMultipleCeos

public List<Attachment> getLatestVersionsOfAttachmentsForMultipleCeos(Iterable<? extends ContentEntityObject> contentEntityObjects)

Description copied from interface: AttachmentManager

Returns a list of all the latest versions of attachments for all the CEOs provided

Specified by:

getLatestVersionsOfAttachmentsForMultipleCeos in interface AttachmentManager

Parameters:

contentEntityObjects -

getLatestVersionsOfAttachmentsWithAnyStatusForContainers

public List<Attachment> getLatestVersionsOfAttachmentsWithAnyStatusForContainers(Iterable<? extends ContentEntityObject> contentEntityObjects)

Description copied from interface: AttachmentManagerInternal

Returns a list of all the latest versions of attachments for all the CEOs provided (including trashed)

Specified by:

getLatestVersionsOfAttachmentsWithAnyStatusForContainers in interface AttachmentManagerInternal

Parameters:

contentEntityObjects -

getLatestVersionsOfAttachmentsWithAnyStatus

public List<Attachment> getLatestVersionsOfAttachmentsWithAnyStatus(ContentEntityObject content)

Description copied from interface: AttachmentManager

Returns a list of only latest versions of attachments (including trashed).

Specified by:

getLatestVersionsOfAttachmentsWithAnyStatus in interface AttachmentManager

getFilteredAttachments

public PageResponse<Attachment> getFilteredAttachments(ContentEntityObject content,
 LimitedRequest pageRequest,
 Predicate<? super Attachment> filterPredicate)

Description copied from interface: AttachmentManagerInternal

Returns the current attachments under the CEO.

Specified by:

getFilteredAttachments in interface AttachmentManagerInternal

Parameters:

content - the content to return attachments for

pageRequest - the pagination requested

filterPredicate - the predicate for filtering found attachments

Returns:

the paginated response of Page entities

countLatestVersionsOfAttachments

public int countLatestVersionsOfAttachments(ContentEntityObject content)

Description copied from interface: AttachmentManager

Returns a count of the number of latest versions of attachments

Specified by:

countLatestVersionsOfAttachments in interface AttachmentManager

countLatestVersionsOfAttachmentsWithAnyStatus

public int countLatestVersionsOfAttachmentsWithAnyStatus(ContentEntityObject content)

Description copied from interface: AttachmentManager

Returns a count of the number of latest versions of attachments (including trashed)

Specified by:

countLatestVersionsOfAttachmentsWithAnyStatus in interface AttachmentManager

countLatestVersionsOfAttachmentsOnPageSince

public int countLatestVersionsOfAttachmentsOnPageSince(ContentEntityObject content,
 Date since)

Description copied from interface: AttachmentManager

Fetches number of attachments changed on a page since a specific timestamp

Specified by:

countLatestVersionsOfAttachmentsOnPageSince in interface AttachmentManager

Parameters:

content - the content object

since - the date of earliest change

Returns:

the number of attachments on a content object (including trashed) changed since

getAttachmentStatistics

public Optional<AttachmentStatisticsDTO> getAttachmentStatistics()

Description copied from interface: AttachmentManager

Fetches statistics about attachments

Specified by:

getAttachmentStatistics in interface AttachmentManager

Returns:

an AttachmentStatisticsDTO object with statistics about attachments such as total and current count

deepAttachmentDelete

public void deepAttachmentDelete(AttachmentDeleteOptions attachmentDeleteOptions)

Description copied from interface: AttachmentManager

Support delete multiple attachments in batch

Specified by:

deepAttachmentDelete in interface AttachmentManager

Parameters:

attachmentDeleteOptions -

getAttachment

public Attachment getAttachment(long id)

Specified by:

getAttachment in interface AttachmentManager

Parameters:

id -

Returns:

attachment with id

getAttachments

public List<Attachment> getAttachments(List<Long> ids)

Description copied from interface: AttachmentManager

Returns a list of attachments matching the given list of IDs. Returns an empty list if no such attachments exist. In the case where some IDs exist and some don't, only the existing Attachments will be returned.

Specified by:

getAttachments in interface AttachmentManager

Parameters:

ids - list of IDs to retrieve.

Returns:

attachments matching ids in the list

getAllVersionsOfAttachments

public List<Attachment> getAllVersionsOfAttachments(ContentEntityObject content)

Description copied from interface: AttachmentManager

Returns a list of all attachments, old and new.

Specified by:

getAllVersionsOfAttachments in interface AttachmentManager

getAllVersions

public List<Attachment> getAllVersions(Attachment attachment)

Description copied from interface: AttachmentManager

Get all versions of an attachment, starting with the current version

Specified by:

getAllVersions in interface AttachmentManager

removeAttachments

public void removeAttachments(List<? extends Attachment> attachments)

Description copied from interface: AttachmentManager

Removes the contents of attachments from the server

Specified by:

removeAttachments in interface AttachmentManager

Parameters:

attachments - a List of Attachments

See Also:

• AttachmentManager.removeAttachmentFromServer(Attachment)

removeAttachmentFromServer

public void removeAttachmentFromServer(Attachment latestVersion)

Removes the attachment and all previous versions

Specified by:

removeAttachmentFromServer in interface AttachmentManager

Parameters:

latestVersion - latest version of the attachment to remove

removeAttachmentWithoutNotifications

public void removeAttachmentWithoutNotifications(Attachment latestVersion)

Description copied from interface: AttachmentManager

Removes an Attachment and its data from the server while suppressing notifications. This is useful when you don't want to send notifications when removing the file.

Specified by:

removeAttachmentWithoutNotifications in interface AttachmentManager

removeAttachmentVersionFromServer

public void removeAttachmentVersionFromServer(Attachment attachment)

Description copied from interface: AttachmentManager

Removes the given version of the Attachment and its data from the server and data store.

In case of the given attachment being the latest version, the previous version (if any) gets removed and the given object impersonates the previous version as the latest version.

Specified by:

removeAttachmentVersionFromServer in interface AttachmentManager

Parameters:

attachment - the Attachment to remove

removeAttachmentVersionFromServerWithoutNotifications

public void removeAttachmentVersionFromServerWithoutNotifications(Attachment attachment)

Description copied from interface: AttachmentManager

Removes the given version of the Attachment and its data from the server and data store while suppressing notifications. This is useful when you don't want to send notifications when removing the file.

In case of the given attachment being the latest version, the previous version (if any) gets removed and the given object impersonates the previous version as the latest version.

Specified by:

removeAttachmentVersionFromServerWithoutNotifications in interface AttachmentManager

Parameters:

attachment - the Attachment to remove

moveAttachment

public void moveAttachment(Attachment latestVersion,
 String newFileName,
 ContentEntityObject newContent)

Specified by:

moveAttachment in interface AttachmentManager

Parameters:

latestVersion - The attachment to be moved

newFileName - New name of the file

newContent - The new contentEntiityObject which will be parent to the attachment

moveAttachment

public void moveAttachment(Attachment attachment,
 ContentEntityObject newContainer)

Description copied from interface: AttachmentManagerInternal

Moves an attachment to a different ContentEntityObject container.

Specified by:

moveAttachment in interface AttachmentManagerInternal

Parameters:

attachment - The attachment to be moved

newContainer - The new ContentEntiityObject which will be parent to the attachment

copyAttachments

public void copyAttachments(ContentEntityObject sourceContent,
 ContentEntityObject destinationContent,
 SaveContext saveContext)
                     throws IOException

Description copied from interface: AttachmentManager

Copy the latest version of all the attachments on the sourceContent to the destinationContent.

Specified by:

copyAttachments in interface AttachmentManager

Parameters:

sourceContent - the content with attachments to be copied.

destinationContent - the content to copy the attachments to.

saveContext - details the circumstances under which the attachments are being copied.

Throws:

IOException - if there are problems reading or writing attachment data during the copy.

copyAttachments

public void copyAttachments(ContentEntityObject sourceContent,
 ContentEntityObject destinationContent)
                     throws IOException

Description copied from interface: AttachmentManager

Copy the latest version of all the attachments on the sourceContent to the destinationContent.

Specified by:

copyAttachments in interface AttachmentManager

Parameters:

sourceContent - the content with attachments to be copied.

destinationContent - the content to copy the attachments to.

Throws:

IOException - if there are problems reading or writing attachment data during the copy.

copyAttachment

public void copyAttachment(Attachment attachment,
 ContentEntityObject destinationContent)
                    throws IOException

Description copied from interface: AttachmentManager

Copy specified attachment to specified destination content.

Specified by:

copyAttachment in interface AttachmentManager

Parameters:

attachment - the attachment

destinationContent - the destination

Throws:

IOException

setAttachmentData

public void setAttachmentData(Attachment attachment,
 InputStream attachmentData)
                       throws AttachmentDataExistsException

Description copied from interface: AttachmentManager

Set the data belonging to attachment

This method can be used when there is missing data for an Attachment (e.g. during imports) and the data needs to be set manually.

Specified by:

setAttachmentData in interface AttachmentManager

Parameters:

attachment - Attachment the data belongs to

attachmentData - the data to be saved

Throws:

AttachmentDataExistsException - if data for attachment already exists

getCopier

public AttachmentDao.AttachmentCopier getCopier(AttachmentManagerInternal destination)

Description copied from interface: AttachmentManagerInternal

Retrieves a AttachmentDao.AttachmentCopier that will allow the attachments from one data store to be copied across to another.

Specified by:

getCopier in interface AttachmentManagerInternal

Parameters:

destination - the AttachmentManager the data is being copied to

Returns:

an AttachmentCopier object

countAttachmentsByStatuses

public long countAttachmentsByStatuses(List<ContentStatus> statuses)

Description copied from interface: AttachmentManagerInternal

This method only count the latest versions of attachments by statuses

Specified by:

countAttachmentsByStatuses in interface AttachmentManagerInternal

Parameters:

statuses - list of ContentStatus

Returns:

since 9.2.5

countAttachmentsBySpaceAndStatuses

public long countAttachmentsBySpaceAndStatuses(Space space,
 List<ContentStatus> statuses)

Description copied from interface: AttachmentManagerInternal

This method only count the latest versions of attachments by statuses in a space

Specified by:

countAttachmentsBySpaceAndStatuses in interface AttachmentManagerInternal

Parameters:

space - the space which the attachments belong to

statuses - list of ContentStatus

Returns:

since 9.2.5

scanFilteredAttachments

public @NonNull PageResponse<Attachment> scanFilteredAttachments(Space space,
 List<ContentStatus> statuses,
 LimitedRequest pageRequest,
 Predicate<? super Attachment>... filter)

Description copied from interface: AttachmentManagerInternal

Retrieves all the existing attachments associated with the instance of Confluence, while applying the specified pagination parameters to limit the number of results returned in each request.

Specified by:

scanFilteredAttachments in interface AttachmentManagerInternal

Parameters:

space - the space to locate attachments in

statuses - list of content status which we are interested to fetch

pageRequest - the pagination requested

filter - a Predicate to apply to the results before returning

Returns:

the paginated response of Attachment entities in the given space

scanFilteredAttachments

public @NonNull PageResponse<Attachment> scanFilteredAttachments(List<ContentStatus> statuses,
 LimitedRequest pageRequest,
 Predicate<? super Attachment>... filter)

Description copied from interface: AttachmentManagerInternal

Retrieves all the current attachments within the specified space, with the results limited according to the provided pagination parameters.

Specified by:

scanFilteredAttachments in interface AttachmentManagerInternal

Parameters:

statuses - list of content status which we are interested to fetch

pageRequest - the pagination requested

filter - a Predicate to apply to the results before returning

Returns:

the paginated response of Attachment entities in any space

getAttachmentDao

public AttachmentDao getAttachmentDao()

Description copied from interface: AttachmentManagerInternal

Provides a back door to the underlying AttachmentDao. Obviously it's better access the DAO directly, so this is deprecated.

Specified by:

getAttachmentDao in interface AttachmentManagerInternal

setAttachmentDao

public void setAttachmentDao(AttachmentDaoInternal attachmentDao)

getBackingStorageType

public AttachmentDataStorageType getBackingStorageType()

Description copied from interface: AttachmentManager

Returns the currently active storage type.

Specified by:

getBackingStorageType in interface AttachmentManager

See Also:

• AttachmentDao.getBackingStorageType()

findAttachmentForDownloadPath

public Optional<Attachment> findAttachmentForDownloadPath(String downloadPath)

Description copied from interface: AttachmentManager

Find an Attachment for the given downloadPath.

The path must at least contain the segment produced by Attachment.getDownloadPath(), that is /download/attachments/<contentId>/<fileName> where <contentId> identifies a valid ContentEntityObject and <fileName> identifies a valid Attachment attached to that ContentEntityObject.

Specified by:

findAttachmentForDownloadPath in interface AttachmentManager

Parameters:

downloadPath - the download path identifying an Attachment.This value is expected to be url encoded, with spaces converted to %20 instead of a '+'

Returns:

maybe the attachment if the given download path matches the criteria as described above and the referenced objects are known to the system

See Also:

• Attachment.getDownloadPath()

getRemappedAttachmentIds

public Map<Long,Long> getRemappedAttachmentIds()

Description copied from interface: AttachmentManager

Gets a list of remapped attachment IDs. The key is the old ID and the value is the new ID.

Specified by:

getRemappedAttachmentIds in interface AttachmentManager

Returns:

A map where the key is the original ID and the value is the new ID.

trash

public void trash(Attachment attachment)

Description copied from interface: AttachmentManager

Moves an attachment to the trash.

Specified by:

trash in interface AttachmentManager

Parameters:

attachment - the attachment to be trashed

restore

public void restore(Attachment attachment)

Description copied from interface: AttachmentManager

Restores an attachment from trash.

Specified by:

restore in interface AttachmentManager

Parameters:

attachment - the attachment to restore