com.saperion.connector.render.engine

Class BaseRenderEngine

java.lang.Object

com.saperion.connector.render.engine.BaseRenderEngine

All Implemented Interfaces:

RenderEngine

public abstract class BaseRenderEngine
extends Object
implements RenderEngine

Render engine base implementation which does necessary pre-checks. (null, supported formats, ...)

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_EXTENSION

Constructor Summary

Constructors

Constructor and Description
BaseRenderEngine()

Method Summary

Modifier and Type	Method and Description
void	configure(Map<String,String> engineProperties) Configures the rendering engine with the specified properties.
protected static com.saperion.common.io.InputStreamDescriptor	createInputStreamDescriptor(byte[] content, String filename)
protected static com.saperion.common.io.InputStreamDescriptor	createInputStreamDescriptor(byte[] content, URL url)
static String	getFileFromUrl(URL url)
Map<String,String>	getProperties()
String	parseExtension(String filename) Parses the extension the filename.
List<Rendition>	render(com.saperion.common.io.InputStreamDescriptor content, Options options) Loads the content that should be rendered with the specified options and creates the list containing the renditions.
abstract List<Rendition>	safeRender(com.saperion.common.io.InputStreamDescriptor content, SourceFormat format, Options options) Creates the collection of Rendition instances which represent rendered content incl.
boolean	supportsSourceFormat(SourceFormat format) Checks if the source format is supported.
boolean	supportsTargetFormat(TargetFormat format) Checks if the target format is supported.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.saperion.connector.render.engine.RenderEngine

getSupportedSourceFormats, getSupportedTargetFormats

Field Detail

DEFAULT_EXTENSION

public static final String DEFAULT_EXTENSION

See Also:

Constant Field Values

Constructor Detail

BaseRenderEngine

public BaseRenderEngine()

Method Detail

configure

public void configure(Map<String,String> engineProperties)

Configures the rendering engine with the specified properties.

Specified by:

configure in interface RenderEngine

Parameters:

engineProperties - Configuration for the Render Engine

See Also:

RenderEngine.configure(java.util.Map)

render

public List<Rendition> render(com.saperion.common.io.InputStreamDescriptor content,
                              Options options)
                       throws TimeoutException,
                              RenderingException

Loads the content that should be rendered with the specified options and creates the list containing the renditions.

Specified by:

render in interface RenderEngine

Parameters:

content - Content as InputStreamDescriptor which should be rendered incl. filename

options - Options which are describing how to render the content

Returns:

the collection of Rendition instances which represent rendered content incl. informations

Throws:

TimeoutException - if a timeout was specified and it was reached

RenderingException - if engine is not available or internal initialization failures

See Also:

RenderEngine.render(com.saperion.common.io.InputStreamDescriptor, com.saperion.connector.options.Options)

supportsSourceFormat

public boolean supportsSourceFormat(SourceFormat format)

Checks if the source format is supported.

Specified by:

supportsSourceFormat in interface RenderEngine

Parameters:

format - the source format to be checked

Returns:

true if the SourceFormat which was recognized from the content filename is supported

See Also:

supportsSourceFormat(com.saperion.connector.formats.SourceFormat)

supportsTargetFormat

public boolean supportsTargetFormat(TargetFormat format)

Checks if the target format is supported.

Specified by:

supportsTargetFormat in interface RenderEngine

Parameters:

format - the target format to be checked

Returns:

true if the TargetFormat which specifies how to render is supported

See Also:

supportsTargetFormat(com.saperion.connector.formats.TargetFormat)

parseExtension

public String parseExtension(String filename)

Parses the extension the filename.

Parameters:

filename - filename which should be parsed

Returns:

the extension or an empty string if nothing was found

getProperties

public Map<String,String> getProperties()

Returns:

configuration properties for the engine

safeRender

public abstract List<Rendition> safeRender(com.saperion.common.io.InputStreamDescriptor content,
                                           SourceFormat format,
                                           Options options)
                                    throws TimeoutException,
                                           RenderingException

Creates the collection of Rendition instances which represent rendered content incl. information.

Method to be implemented by the specific render engine.

Parameters:

content - Content as InputStreamDescriptor which should be rendered incl. filename

format - SourceFormat determined by the file extension

options - Options which are describing how to render the content

Returns:

the collection of Rendition instances which represent rendered content incl. informations

Throws:

FormatNotSupportedException - if the input or output format is not supported

PreconditionFailedException - if parts of the options are missing

TimeoutException - if a timeout was specified and it was reached

RenderingException - if engine is not available or internal initialization failures

createInputStreamDescriptor

protected static com.saperion.common.io.InputStreamDescriptor createInputStreamDescriptor(byte[] content,
                                                                                          URL url)

getFileFromUrl

public static String getFileFromUrl(URL url)

createInputStreamDescriptor

protected static com.saperion.common.io.InputStreamDescriptor createInputStreamDescriptor(byte[] content,
                                                                                          String filename)