com.atlassian.confluence.importexport.resource

Class AttachmentDownloadResourceManager

java.lang.Object

com.atlassian.confluence.importexport.resource.AttachmentDownloadResourceManager

All Implemented Interfaces:

DownloadResourceManager, PartialDownloadResourceManager

Direct Known Subclasses:

ThumbnailDownloadResourceManager

public class AttachmentDownloadResourceManager
extends Object
implements PartialDownloadResourceManager

Constructor Summary

Constructors

Constructor and Description
AttachmentDownloadResourceManager(AttachmentUrlParser attachmentUrlParser, AttachmentManager attachmentManager, PermissionManager permissionManager)

Method Summary

Modifier and Type	Method and Description
Attachment	getAttachment(ConfluenceUser user, String resourcePath, Map parameters, String urlPrefix)
PartialDownloadResourceReader	getPartialResourceReader(ConfluenceUser user, String resourcePath, Map parameters, String requestRange) Returns a DownloadResourceReader for part of a downloadable resource.
DownloadResourceReader	getResourceReader(ConfluenceUser user, String resourcePath, Map parameters) Returns a AttachmentDownloadResourceReader for retrieving attachment content.
boolean	matches(String resourcePath) Returns a boolean to indicate whether the current DownloadResourceManager will know how to handle the given resourcePath.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.confluence.importexport.resource.PartialDownloadResourceManager

getPartialResourceReader

Methods inherited from interface com.atlassian.confluence.importexport.resource.DownloadResourceManager

getResourceReader

Constructor Detail

AttachmentDownloadResourceManager

public AttachmentDownloadResourceManager(AttachmentUrlParser attachmentUrlParser,
                                         AttachmentManager attachmentManager,
                                         PermissionManager permissionManager)

Method Detail

matches

public boolean matches(String resourcePath)

Description copied from interface: DownloadResourceManager

Returns a boolean to indicate whether the current DownloadResourceManager will know how to handle the given resourcePath.

Specified by:

matches in interface DownloadResourceManager

Parameters:

resourcePath - the relative URL of the resource including the application context path. For example, "/confluence/download/attachments/12345/temp.png".

Returns:

true if the manager can handle the given resource path

getResourceReader

@Nonnull
public DownloadResourceReader getResourceReader(@Nullable
                                                         ConfluenceUser user,
                                                         String resourcePath,
                                                         Map parameters)
                                                  throws UnauthorizedDownloadResourceException,
                                                         DownloadResourceNotFoundException

Returns a AttachmentDownloadResourceReader for retrieving attachment content. Typically used by HTML/PDF export and attachment downloads.

Specified by:

getResourceReader in interface DownloadResourceManager

Parameters:

user - the user who is retrieving the attachment content.

resourcePath - the relative URL of the resource including the application context path. For example, "/confluence/download/thumbnails/12345/temp.png".

parameters - a map of url parameters for the resource

Returns:

a DownloadResourceReader to read the resource content from

Throws:

UnauthorizedDownloadResourceException - if the user requesting the attachment content does not have the permissions to view it

DownloadResourceNotFoundException - if the attachment content associated with the resourcePath cannot be found

getAttachment

public Attachment getAttachment(@Nullable
                                ConfluenceUser user,
                                String resourcePath,
                                Map parameters,
                                String urlPrefix)
                         throws DownloadResourceNotFoundException,
                                UnauthorizedDownloadResourceException

Throws:

DownloadResourceNotFoundException

UnauthorizedDownloadResourceException

getPartialResourceReader

@Nonnull
public PartialDownloadResourceReader getPartialResourceReader(@Nullable
                                                                       ConfluenceUser user,
                                                                       String resourcePath,
                                                                       Map parameters,
                                                                       String requestRange)
                                                                throws UnauthorizedDownloadResourceException,
                                                                       DownloadResourceNotFoundException,
                                                                       RangeNotSatisfiableException

Description copied from interface: PartialDownloadResourceManager

Returns a DownloadResourceReader for part of a downloadable resource. Currently being used by attachment downloads

Use this method only if DownloadResourceManager.matches(String) returns true.

Specified by:

getPartialResourceReader in interface PartialDownloadResourceManager

Parameters:

user - the user who is retrieving the downloadable resource.

resourcePath - the relative URL of the resource including the application context path. For example, "/confluence/download/attachments/12345/temp.png".

parameters - a map of url paramaters for the resource

requestRange - range of the resource as defined in RFC-2616 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.1

Returns:

a DownloadResourceReader to read the resource content from

Throws:

UnauthorizedDownloadResourceException - if the user requesting the downloadable resource does not have the permissions to get it

DownloadResourceNotFoundException - if the downloadable resource associated with the resourcePath cannot be found

RangeNotSatisfiableException - if the requested range cannot be served