com.jalios.jcms
Class WysiwygMediasRewriter

java.lang.Object
  com.jalios.jcms.WysiwygMediasRewriter

public class WysiwygMediasRewriter
extends Object

Provides facilities to rewrite object tag in HTML wysiwyg content with content generated by the MediaTag and its template API.

html = WysiwygMediasRewriter.rewriteMedias(html)

As of current implementation, this process REQUIRES Tomcat for a fully functionnal behavior, also it MUST be invoked at rendering time when a valid http servlet request is available.

It is invoked automatically by WysiwygRenderer through <jalios:wysiwyg> tag, if the following property was defined :

wysiwyg.medias-rewrite.enabled: true

Since:

jcms-7.1.3 jcms-8.0.2 JCMS-3680

Constructor Summary

WysiwygMediasRewriter()

Method Summary

static boolean	canRewrite() Check if the current context information required to rewrite a media are available.
static String	renderMedia(String mediaPath, int maxWidth, int maxHeight) Render the specified media path using the appropriate MediaTag template .
static String	rewriteMedias(String html) Find all the "object" tags in the specified html and replace them with a rendering performed by the MediaTag.

Methods inherited from class java.lang.Object

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

Constructor Detail

WysiwygMediasRewriter

public WysiwygMediasRewriter()

Method Detail

rewriteMedias

public static String rewriteMedias(String html)

Find all the "object" tags in the specified html and replace them with a rendering performed by the MediaTag.

Parameters:

html - the HTML fragment to be modified

Returns:

the modified HTML never return null

canRewrite

public static boolean canRewrite()

Check if the current context information required to rewrite a media are available.

Depending on the implementation (Tomcat or JspEngine), the requirements may not be the same (current request available, ...).

Returns:

true if rewrite can be performed, false otherwise

renderMedia

public static String renderMedia(String mediaPath,
                                 int maxWidth,
                                 int maxHeight)

Render the specified media path using the appropriate MediaTag template .

Parameters:

mediaPath - a media path, relative to the webapp (as expected by MediaTag.setPath(String)

maxWidth - a maximum width, value is ignored if equals or lower than 0

maxHeight - a maximum height, value is ignored if equals or lower than 0

Returns:

null if media could not be rendered, otherwise the rendering of the JSP