org.ametys.plugins.linkdirectory

Class LinkMetadataURIResolver

java.lang.Object

org.ametys.plugins.linkdirectory.LinkMetadataURIResolver

All Implemented Interfaces:

URIResolver, PluginAware, Contextualizable, Serviceable

public class LinkMetadataURIResolver
extends Object
implements URIResolver, Serviceable, Contextualizable, PluginAware

URIResolver for type "link-metadata".
These links or images point to a file from the metadata of a Link.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	LinkMetadataURIResolver.MetaInfo Metadata information.

Field Summary

Fields

Modifier and Type	Field and Description
private Context	_context The context
private static Pattern	_OBJECT_URI_PATTERN
private String	_pluginName
private URIPrefixHandler	_prefixHandler
private RenderingContextHandler	_renderingContexthandler
private AmetysObjectResolver	_resolver
private SiteManager	_siteManager

Constructor Summary

Constructors

Constructor and Description
LinkMetadataURIResolver()

Method Summary

Modifier and Type	Method and Description
protected LinkMetadataURIResolver.MetaInfo	_getMetaInfo(String uri, Request request) Get metadata name and link.
protected String	_resolveImage(String uri, String uriArgument, 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.
ConsistencyChecker.CHECK	checkLink(String uri, boolean shortTest) Tests if the URI is not broken.
void	contextualize(Context context)
protected BinaryMetadata	getBinaryMetadata(MetadataAwareAmetysObject link, String path) Get the binary metadata
I18nizableText	getLabel(String uri) Get an URI label.
String	getType() Returns the type of links handled by this URIResolver.
protected String	getUri(String path, MetadataAwareAmetysObject object, boolean download, boolean absolute, boolean internal) Get the URI prefix
String	resolve(String uri, boolean download, boolean absolute, boolean internal) Resolves a link URI for rendering purposes. The output must be a properly encoded path, relative to the webapp context, accessible from a browser.
String	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.
String	resolveBoundedImageAsBase64(String uri, int maxHeight, int maxWidth) Resolve an image and return it as a base64-encoded string.
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.
String	resolveCroppedImageAsBase64(String uri, int cropHeight, int cropWidth) Resolve an image and return it as a base64-encoded string.
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.
String	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 java.lang.Object

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

Field Detail

_OBJECT_URI_PATTERN

private static final Pattern _OBJECT_URI_PATTERN

_resolver

private AmetysObjectResolver _resolver

_prefixHandler

private URIPrefixHandler _prefixHandler

_renderingContexthandler

private RenderingContextHandler _renderingContexthandler

_siteManager

private SiteManager _siteManager

_context

private Context _context

The context

_pluginName

private String _pluginName

Constructor Detail

LinkMetadataURIResolver

public LinkMetadataURIResolver()

Method Detail

setPluginInfo

public void setPluginInfo(String pluginName,
                          String featureName,
                          String id)

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 interface PluginAware

Parameters:

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

id - Unique identifier of this component

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

getType

public String getType()

Description copied from interface: URIResolver

Returns the type of links handled by this URIResolver.

Specified by:

getType in interface URIResolver

Returns:

the type of links handled by this URIResolver.

resolve

public String resolve(String uri,
                      boolean download,
                      boolean absolute,
                      boolean internal)

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 interface URIResolver

Parameters:

uri - the link URI.

download - true if the pointed resource is to be downloaded.

absolute - true if the url must be absolute

internal - 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 interface URIResolver

Parameters:

uri - the link URI.

height - the height of the image.

width - the width of the image

download - true if the pointed resource is to be downloaded.

absolute - true if the url must be absolute

internal - true to get an internal URI.

Returns:

the path to the image.

resolveImageAsBase64

public String resolveImageAsBase64(String uri,
                                   int height,
                                   int width)

Description copied from interface: URIResolver

Resolve an image and return it as a base64-encoded string.

Specified by:

resolveImageAsBase64 in interface URIResolver

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 interface URIResolver

Parameters:

uri - the link URI.

maxHeight - the max height

maxWidth - the max width

download - true if the pointed resource is to be downloaded.

absolute - true if the url must be absolute

internal - true to get an internal URI.

Returns:

the path to the image.

resolveBoundedImageAsBase64

public String resolveBoundedImageAsBase64(String uri,
                                          int maxHeight,
                                          int maxWidth)

Description copied from interface: URIResolver

Resolve an image and return it as a base64-encoded string.

Specified by:

resolveBoundedImageAsBase64 in interface URIResolver

Parameters:

uri - the link URI.

maxHeight - the max height

maxWidth - 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 interface URIResolver

Parameters:

uri - the link URI.

cropHeight - the crop height

cropWidth - the crop width

download - true if the pointed resource is to be downloaded.

absolute - true if the url must be absolute

internal - true to get an internal URI.

Returns:

the path to the image.

_resolveImage

protected String _resolveImage(String uri,
                               String uriArgument,
                               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.

Parameters:

uri - the link URI.

uriArgument - the argument to append to the uri

download - true if the pointed resource is to be downloaded.

absolute - true if the url must be absolute

internal - true to get an internal URI.

Returns:

the path to the image.

resolveCroppedImageAsBase64

public String resolveCroppedImageAsBase64(String uri,
                                          int cropHeight,
                                          int cropWidth)

Description copied from interface: URIResolver

Resolve an image and return it as a base64-encoded string.

Specified by:

resolveCroppedImageAsBase64 in interface URIResolver

Parameters:

uri - the link URI.

cropHeight - the crop height

cropWidth - the crop width

Returns:

a base64-encoded string representing the image.

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.

getUri

protected String getUri(String path,
                        MetadataAwareAmetysObject object,
                        boolean download,
                        boolean absolute,
                        boolean internal)

Get the URI prefix

Parameters:

path - the resource path

object - The object

download - true if the pointed resource is to be downloaded.

absolute - true if the url must be absolute

internal - true to get an internal URI.

Returns:

the URI prefix

checkLink

public ConsistencyChecker.CHECK checkLink(String uri,
                                          boolean shortTest)

Description copied from interface: URIResolver

Tests if the URI is not broken.

Specified by:

checkLink in interface URIResolver

Parameters:

uri - The uri to test

shortTest - 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

public I18nizableText getLabel(String uri)

Description copied from interface: URIResolver

Get an URI label.

Specified by:

getLabel in interface URIResolver

Parameters:

uri - the uri which label to get.

Returns:

the label.

getBinaryMetadata

protected BinaryMetadata getBinaryMetadata(MetadataAwareAmetysObject link,
                                           String path)

Get the binary metadata

Parameters:

link - the link

path - the metadata path

Returns:

the binary metadata

_getMetaInfo

protected LinkMetadataURIResolver.MetaInfo _getMetaInfo(String uri,
                                                        Request request)

Get metadata name and link.

Parameters:

uri - the metadata URI.

request - the request.

Returns:

the metadata info.