Package com.saperion.connector.render.engine

Class BaseRenderEngine

java.lang.Object

com.saperion.connector.render.engine.BaseRenderEngine

All Implemented Interfaces:

RenderEngine

Direct Known Subclasses:

ISYSRenderEngine

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	Description
static final String	DEFAULT_EXTENSION

Constructor Summary

Constructors

Constructor	Description
BaseRenderEngine()

Method Summary

Modifier and Type	Method	Description
void	configure(Map<String,String> engineProperties)	Configures the rendering engine with the specified properties.
protected static InputStreamDescriptor	createInputStreamDescriptor(byte[] content, String filename)
protected static 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(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(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 Details

DEFAULT_EXTENSION

public static final String DEFAULT_EXTENSION

See Also:

• Constant Field Values

Constructor Details

BaseRenderEngine

public BaseRenderEngine()

Method Details

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(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:

• RenderEngine.supportsSourceFormat(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:

• RenderEngine.supportsTargetFormat(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 wDummyRenderEngineas found

getProperties

public Map<String,String> getProperties()

Returns:

configuration properties for the engine

safeRender

public abstract List<Rendition> safeRender(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 InputStreamDescriptor createInputStreamDescriptor(byte[] content,
 URL url)

getFileFromUrl

public static String getFileFromUrl(URL url)

createInputStreamDescriptor

protected static InputStreamDescriptor createInputStreamDescriptor(byte[] content,
 String filename)