Class ProjectResourceURIResolver
java.lang.Object
org.ametys.runtime.plugin.component.AbstractLogEnabled
org.ametys.plugins.workspaces.documents.ProjectResourceURIResolver
- All Implemented Interfaces:
URIResolver
,LogEnabled
,PluginAware
,Contextualizable
,Serviceable
- Direct Known Subclasses:
WebdavProjectResourceURIResolver
public class ProjectResourceURIResolver
extends AbstractLogEnabled
implements URIResolver, PluginAware, Serviceable, Contextualizable
URIResolver
for type "project-resource". These links point to a file from the resources of a project.
-
Field Summary
Modifier and TypeFieldDescriptionprotected Context
The avalon context.protected String
plugin nameprotected AmetysObjectResolver
The ametys object resolver.protected URIPrefixHandler
The URI prefix handler -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected Project
_getProject
(AmetysObject resource) Retrieves parent projectprotected String
_resolve
(String uri, boolean download, boolean absolute, boolean internal, String prefix, String suffix) Creates a full uriTests if the URI is not broken.void
contextualize
(Context context) Get an URI label.protected String
getRealPrefix
(Resource resource, String prefix) Get the real prefixprotected String
getResourcePath
(Resource resource) Get the resource pathgetType()
Returns the type of links handled by thisURIResolver
.protected String
getUriPrefix
(AmetysObject object, boolean download, boolean absolute, boolean internal) Get the URI prefixResolves a link URI for rendering purposes.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.resolveBoundedImage
(String uri, int maxHeight, int maxWidth, boolean download, boolean absolute, boolean internal) Resolves a link URI for rendering image.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.resolveBoundedImageAsBase64
(String uri, int maxHeight, int maxWidth) Resolve an image and return it as a base64-encoded string.resolveCroppedImage
(String uri, int cropHeight, int cropWidth, boolean download, boolean absolute, boolean internal) Resolves a link URI for rendering image.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.resolveCroppedImageAsBase64
(String uri, int cropHeight, int cropWidth) Resolve an image and return it as a base64-encoded string.resolveImage
(String uri, int height, int width, boolean download, boolean absolute, boolean internal) Resolves a link URI for rendering image.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.resolveImageAsBase64
(String uri, int height, int width) Resolve an image and return it as a base64-encoded string.protected String
resolveImageAsBase64
(String uri, int height, int width, int maxHeight, int maxWidth, int cropHeight, int cropWidth) Get an image's bytes encoded as base64, optionally resized.void
service
(ServiceManager manager) void
setPluginInfo
(String pluginName, String featureName, String id) Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled
getLogger, setLogger
-
Field Details
-
_resolver
The ametys object resolver. -
_context
The avalon context. -
_pluginName
plugin name -
_webPrefixHandler
The URI prefix handler
-
-
Constructor Details
-
ProjectResourceURIResolver
public ProjectResourceURIResolver()
-
-
Method Details
-
contextualize
- Specified by:
contextualize
in interfaceContextualizable
- Throws:
ContextException
-
service
- Specified by:
service
in interfaceServiceable
- Throws:
ServiceException
-
setPluginInfo
Description copied from interface:PluginAware
Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.- Specified by:
setPluginInfo
in interfacePluginAware
- Parameters:
pluginName
- Unique identifier for the plugin hosting the extensionfeatureName
- Unique feature identifier (unique for a given pluginName)id
- Unique identifier of this component
-
getType
Description copied from interface:URIResolver
Returns the type of links handled by thisURIResolver
.- Specified by:
getType
in interfaceURIResolver
- Returns:
- the type of links handled by this
URIResolver
.
-
resolve
Description copied from interface:URIResolver
Resolves a link URI for rendering purposes.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.- Specified by:
resolve
in interfaceURIResolver
- Parameters:
uri
- the link URI.download
- true if the pointed resource is to be downloaded.absolute
- true if the url must be absoluteinternal
- true to get an internal URI.- Returns:
- the path to the resource.
-
resolveImage
public String resolveImage(String uri, int height, int width, boolean download, boolean absolute, boolean internal) Description copied from interface:URIResolver
Resolves a link URI for rendering image.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.- Specified by:
resolveImage
in interfaceURIResolver
- Parameters:
uri
- the link URI.height
- the height of the image.width
- the width of the imagedownload
- true if the pointed resource is to be downloaded.absolute
- true if the url must be absoluteinternal
- true to get an internal URI.- Returns:
- the path to the image.
-
resolveImageAsBase64
Description copied from interface:URIResolver
Resolve an image and return it as a base64-encoded string.- Specified by:
resolveImageAsBase64
in interfaceURIResolver
- Parameters:
uri
- the link URI.height
- the height of the image.width
- the width of the image- Returns:
- a base64-encoded string representing the image.
-
resolveBoundedImage
public String resolveBoundedImage(String uri, int maxHeight, int maxWidth, boolean download, boolean absolute, boolean internal) Description copied from interface:URIResolver
Resolves a link URI for rendering image.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.- Specified by:
resolveBoundedImage
in interfaceURIResolver
- Parameters:
uri
- the link URI.maxHeight
- the max heightmaxWidth
- the max widthdownload
- true if the pointed resource is to be downloaded.absolute
- true if the url must be absoluteinternal
- true to get an internal URI.- Returns:
- the path to the image.
-
resolveBoundedImageAsBase64
Description copied from interface:URIResolver
Resolve an image and return it as a base64-encoded string.- Specified by:
resolveBoundedImageAsBase64
in interfaceURIResolver
- Parameters:
uri
- the link URI.maxHeight
- the max heightmaxWidth
- the max width- Returns:
- a base64-encoded string representing the image.
-
resolveCroppedImage
public String resolveCroppedImage(String uri, int cropHeight, int cropWidth, boolean download, boolean absolute, boolean internal) Description copied from interface:URIResolver
Resolves a link URI for rendering image.
The output must be a properly encoded path, relative to the webapp context, accessible from a browser.- Specified by:
resolveCroppedImage
in interfaceURIResolver
- Parameters:
uri
- the link URI.cropHeight
- the crop heightcropWidth
- the crop widthdownload
- true if the pointed resource is to be downloaded.absolute
- true if the url must be absoluteinternal
- true to get an internal URI.- Returns:
- the path to the image.
-
resolveCroppedImageAsBase64
Description copied from interface:URIResolver
Resolve an image and return it as a base64-encoded string.- Specified by:
resolveCroppedImageAsBase64
in interfaceURIResolver
- Parameters:
uri
- the link URI.cropHeight
- the crop heightcropWidth
- the crop width- Returns:
- a base64-encoded string representing the image.
-
_resolve
protected String _resolve(String uri, boolean download, boolean absolute, boolean internal, String prefix, String suffix) Creates a full uri- Parameters:
uri
- the base uri, ie the resource iddownload
- true to create a forced download uriabsolute
- true to create an absolute uri (if internal is false)internal
- true to create an internal uriprefix
- Prefix on the urisuffix
- Suffix on the uri- Returns:
- The created uri
-
resolveImageAsBase64
protected String resolveImageAsBase64(String uri, int height, int width, int maxHeight, int maxWidth, int cropHeight, int cropWidth) Get an image's bytes encoded as base64, optionally resized.- Parameters:
uri
- the image URI.height
- the specified height. Ignored if negative.width
- the specified width. Ignored if negative.maxHeight
- the maximum image height. Ignored if height or width is specified.maxWidth
- the maximum image width. Ignored if height or width is specified.cropHeight
- The cropping height. Ignored if negative.cropWidth
- The cropping width. Ignored if negative.- Returns:
- the image bytes encoded as base64.
-
checkLink
Description copied from interface:URIResolver
Tests if the URI is not broken.- Specified by:
checkLink
in interfaceURIResolver
- Parameters:
uri
- The uri to testshortTest
- If shortTest is to true, only fast check should be done. If false, complete test (even if long) should be done.- Returns:
- SUCCESS if the test was done and ok, FAILURE if the test was done and ko, UNKNOWN if the test was not done (because too long). UNKNOWN can not be returned when shortTest is set to false
-
getLabel
Description copied from interface:URIResolver
Get an URI label.- Specified by:
getLabel
in interfaceURIResolver
- Parameters:
uri
- the uri which label to get.- Returns:
- the label.
-
getUriPrefix
protected String getUriPrefix(AmetysObject object, boolean download, boolean absolute, boolean internal) Get the URI prefix- Parameters:
object
- The objectdownload
- true if the pointed resource is to be downloaded.absolute
- true if the url must be absoluteinternal
- true to get an internal URI.- Returns:
- the URI prefix
-
getResourcePath
Get the resource path- Parameters:
resource
- the resource- Returns:
- the path
-
getRealPrefix
Get the real prefix- Parameters:
resource
- the resourceprefix
- the initial prefix- Returns:
- the real prefix
-
_getProject
Retrieves parent project- Parameters:
resource
- The resource which belongs to a project- Returns:
- The parent project
-