Package com.nomagic.magicreport.engine.velocity

Class PPTXEngine

java.lang.Object

java.util.Observable

com.nomagic.magicreport.engine.AbstractTemplateEngine

com.nomagic.magicreport.engine.velocity.DefaultTemplateEngine

com.nomagic.magicreport.engine.velocity.PPTXEngine

All Implemented Interfaces:

IExtensionTemplateEngine, com.nomagic.magicreport.engine.IRuntimeInstanceVelocityEngine, ITemplateEngine, StyledDocument

@OpenApiAll
public class PPTXEngine
extends DefaultTemplateEngine
implements StyledDocument

The Velocity engine for OpenXML PowerPoint Presentation (PPTX).

Since:

Dec 28, 2009

Field Summary

Fields inherited from class com.nomagic.magicreport.engine.velocity.DefaultTemplateEngine

velocityContext

Fields inherited from class com.nomagic.magicreport.engine.AbstractTemplateEngine

context, isAborted, preProcessFile, processFile, properties

Fields inherited from interface com.nomagic.magicreport.format.html.StyledDocument

CHARACTER, COLOR, FONT, PARAGRAPH, TABLE

Constructor Summary

Constructors

Constructor	Description
PPTXEngine()	A class constructor.

Method Summary

Modifier and Type	Method	Description
int	addColor(Color color)	Add color for html to PPTX.
int	addFont(Font font)	Add font for html to PPTX.
void	addImage(String format)	Add image format to list.
int	addList(List list)	Add list for html to PPTX.
int	addObject(Object object)	Appends object content into the document.
void	addRowSpanID(String id, int value)	Add rowspan id and its value to map
int	addStyle(Style style)	Add style for html to PPTX.
protected ParseErrorException	createParseErrorWrapper(ParseErrorException parseError, Reader source)	Create a ParseErrorException from the message.
Template	createTemplate()	Creates a new Template object for generating report by this engine.
Template	createTemplate(File input, File output)	Creates a new Template object.
Template	createTemplate(File input, File output, boolean ignoreLocation)	Creates a new Template object.
void	evaluate(Template template)	Merge a template with current context and rendered stream into the writer.
Set<String>	getEntrySet()	Return PPTX entry set.
Template	getTemplate()	Return template.
protected void	handleForColumn(Template template, StringBuilder inProcessBuffer)	Handle the #forcol directive.
protected void	handleForPage(Template template, StringBuilder inProcessBuffer)	Handle the #forpage directive.
protected void	handleForRow(Template template, StringBuilder inProcessBuffer)	Handle the #forrow directive.
protected void	handleIncludeSection(Template template, StringBuilder inProcessBuffer)	Handle the #includeSection directive.
protected void	handleMergeColumns(Template template, StringBuilder inProcessBuffer)	Handle $tableprop.mergeColumns directive
protected void	handleMergeRows(Template template, StringBuilder inProcessBuffer)	Handle $tableprop.mergeRows directive
protected void	handleSectionBegin(Template template, StringBuilder inProcessBuffer)	Handle the #sectionBegin directive.
protected int	lineCount(String content)	Count number of line from given content string.
protected void	postProcess(Template template)	Perform a post-processing after the template has been evaluated.
protected TemplateException	processException(Template template, ParseErrorException e)	Call this method to process a ParseErrorException.
protected TemplateException	processVelocityException(Template template, org.apache.velocity.exception.ParseErrorException e)	Call this method to process an Velocity exception and return in new format.
protected void	translate(Template template, StringBuilder inProcessBuffer)	Process the template in inProcessBuffer into valid format.

Methods inherited from class com.nomagic.magicreport.engine.velocity.DefaultTemplateEngine

abort, checkFileNotFoundException, clearTools, createComment, destroy, getClassLoader, getFormatter, getResolvedSectionName, handleImport, isNoSpaceException, preProcess, process, process, processVelocityException, setClassLoader, setFormatter, setLatestLocation, setLocation, setProperty, setWriterForEvaluate, trimTrailSpace

Methods inherited from class com.nomagic.magicreport.engine.AbstractTemplateEngine

addContext, addInvalidReferenceHandler, addObserver, addReferenceInsertionHandler, evaluate, getConcurrentToolException, getContext, getCurrentRuntimeInstance, getInvalidReferenceHandler, getProcessSize, getProperties, getProperty, getReferenceInsertionHandler, isMemoryMode, notifyObservers, observers, setConcurrentToolException, setContext, setCurrentRuntimeInstance

Methods inherited from class java.util.Observable

clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Constructor Details

PPTXEngine

public PPTXEngine()

A class constructor.

Method Details

createTemplate

public Template createTemplate()

Creates a new Template object for generating report by this engine.

Specified by:

createTemplate in interface ITemplateEngine

Overrides:

createTemplate in class DefaultTemplateEngine

Returns:

an instance of Template

See Also:

• DefaultTemplateEngine.createTemplate(File, File)

createTemplate

public Template createTemplate(File input,
 File output)
                        throws IOException

Creates a new Template object.

Specified by:

createTemplate in interface ITemplateEngine

Overrides:

createTemplate in class DefaultTemplateEngine

Parameters:

input - template file.

output - output file.

Returns:

an instance of Template

Throws:

FileNotFoundException - if the file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened.

IOException - If an I/O error occurs

createTemplate

public Template createTemplate(File input,
 File output,
 boolean ignoreLocation)
                        throws IOException

Creates a new Template object.

Overrides:

createTemplate in class DefaultTemplateEngine

Parameters:

input - template file.

output - output file.

ignoreLocation - true to ignore location property for child document

Returns:

an instance of Template

Throws:

FileNotFoundException - if the file does not exist, is a directory rather than a regular file, or for some other reason cannot be opened.

IOException - If an I/O error occurs

getTemplate

public Template getTemplate()

Return template.

Returns:

a PPTX template

getEntrySet

public Set<String> getEntrySet()

Return PPTX entry set.

Returns:

PPTX entry set.

addImage

public void addImage(String format)

Add image format to list.

Parameters:

format - format of image

addRowSpanID

public void addRowSpanID(String id,
 int value)

Add rowspan id and its value to map

Parameters:

id - rowspan id

value - number of rows to be merged

evaluate

public void evaluate(Template template)
              throws TemplateException

Merge a template with current context and rendered stream into the writer.

Specified by:

evaluate in interface ITemplateEngine

Overrides:

evaluate in class AbstractTemplateEngine

Parameters:

template - Template being evaluated

Throws:

ParseErrorException - if a syntax or other error which prevents it from being parsed.

InitializationEngineException - error while initializing engine

TemplateException - other error while processing the template

See Also:

• ITemplateEngine.evaluate(Template)

translate

protected void translate(Template template,
 StringBuilder inProcessBuffer)
                  throws ParseErrorException,
IOException

Process the template in inProcessBuffer into valid format.

Overrides:

translate in class DefaultTemplateEngine

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

IOException - if IO Error occurs while reading template.

createParseErrorWrapper

protected ParseErrorException createParseErrorWrapper(ParseErrorException parseError,
 Reader source)

Create a ParseErrorException from the message.

Parameters:

parseError - root cause

source - source template

Returns:

instance of ParseErrorException

processException

protected TemplateException processException(Template template,
 ParseErrorException e)

Call this method to process a ParseErrorException. This method call internally by postProcess(Template). If code was performed by Velocity (DefaultTemplateEngine.process(Template)), uses method processVelocityException(Template, org.apache.velocity.exception.ParseErrorException). By default this method try to calculate line number from ParseErrorException.getSource().

Overrides:

processException in class DefaultTemplateEngine

Parameters:

template - Template

e - MagicReport parse error exception

Returns:

TemplateException

processVelocityException

protected TemplateException processVelocityException(Template template,
 org.apache.velocity.exception.ParseErrorException e)

Call this method to process an Velocity exception and return in new format. Override DefaultTemplateEngine.processVelocityException(Template, org.apache.velocity.exception.ParseErrorException) to return exception with valid ODF line count.

Overrides:

processVelocityException in class DefaultTemplateEngine

Parameters:

template - Template

e - Velocity exception

Returns:

TemplateException

lineCount

protected int lineCount(String content)

Count number of line from given content string.

Overrides:

lineCount in class DefaultTemplateEngine

Parameters:

content - the input string

Returns:

number of line

handleForColumn

protected void handleForColumn(Template template,
 StringBuilder inProcessBuffer)
                        throws ParseErrorException

Handle the #forcol directive.

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

handleMergeColumns

protected void handleMergeColumns(Template template,
 StringBuilder inProcessBuffer)
                           throws ParseErrorException

Handle $tableprop.mergeColumns directive

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

handleMergeRows

protected void handleMergeRows(Template template,
 StringBuilder inProcessBuffer)
                        throws ParseErrorException

Handle $tableprop.mergeRows directive

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

handleForRow

protected void handleForRow(Template template,
 StringBuilder inProcessBuffer)
                     throws ParseErrorException

Handle the #forrow directive.

Overrides:

handleForRow in class DefaultTemplateEngine

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

handleForPage

protected void handleForPage(Template template,
 StringBuilder inProcessBuffer)
                      throws ParseErrorException

Handle the #forpage directive.

Overrides:

handleForPage in class DefaultTemplateEngine

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

handleSectionBegin

protected void handleSectionBegin(Template template,
 StringBuilder inProcessBuffer)
                           throws ParseErrorException

Handle the #sectionBegin directive.

Overrides:

handleSectionBegin in class DefaultTemplateEngine

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

handleIncludeSection

protected void handleIncludeSection(Template template,
 StringBuilder inProcessBuffer)
                             throws ParseErrorException

Handle the #includeSection directive.

Overrides:

handleIncludeSection in class DefaultTemplateEngine

Parameters:

template - Template source.

inProcessBuffer - in process buffer.

Throws:

ParseErrorException - when error while translation, or syntax not recognized.

postProcess

protected void postProcess(Template template)
                    throws TemplateException

Perform a post-processing after the template has been evaluated.

Overrides:

postProcess in class DefaultTemplateEngine

Parameters:

template - template after evaluated.

Throws:

ParseErrorException - if a syntax or other error which prevents it from being parsed.

InitializationEngineException - error while initializing engine

TemplateException - other error while processing the template

See Also:

• DefaultTemplateEngine.postProcess(com.nomagic.magicreport.Template)

addFont

public int addFont(Font font)

Add font for html to PPTX.

Specified by:

addFont in interface StyledDocument

Parameters:

font - font

Returns:

font id

addList

public int addList(List list)

Add list for html to PPTX.

Specified by:

addList in interface StyledDocument

Parameters:

list - list

Returns:

list id

addStyle

public int addStyle(Style style)

Add style for html to PPTX.

Specified by:

addStyle in interface StyledDocument

Parameters:

style - style

Returns:

style id

addColor

public int addColor(Color color)

Add color for html to PPTX.

Specified by:

addColor in interface StyledDocument

Parameters:

color - color

Returns:

color id

addObject

public int addObject(Object object)

Appends object content into the document.

Specified by:

addObject in interface StyledDocument

Parameters:

object - adding object

Returns:

index to object