fr.opensagres.xdocreport.document

Interface IXDocReport

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

AbstractXDocReport

public interface IXDocReport
extends java.io.Serializable

XML Document reporting used to load XML document (odt, docx...) and generate reporting by merging it with Java data model by using a template engine ITemplateEngine.

To generate reporting, here steps to follow :

1. Create an XML Document (docx with MS Word, odt with Open Office) by writing your fields with syntax wich depends on template engine :
   • with Freemarker : you can write Hello ${name}! in your docx, odt document.
   • with Velocity : you can write Hello $name! in your docx, odt document.
2. Create an instance of IXDocReport switch the type of the document:
   • for docx : IXDocReport report = new fr.opensagres.xdocreport.document.docx.DocXReport();
   • for odt : IXDocReport report = new fr.opensagres.xdocreport.document.odt.ODTReport();
3. Initialize template engine by using setTemplateEngine(ITemplateEngine) to set the template engine (Velocity, Freemarker..) to use :
   • for freemarker : report.setTemplateEngine(net.sourceforge.rtf.template.freemarker.FreemarkerTemplateEngine.DEFAULT);
   • for velocity : report.setTemplateEngine(net.sourceforge.rtf.template.velocity.VelocityTemplateEngine.DEFAULT);
4. Load XML Document (odt, docx) by using load(InputStream).
5. Prepare your Java model by calling createContext() and put your Java model with IContext.put(String, Object). For instance :

   IContext context = report.createContext(); context.put("name", "word");

6. Merge the docx, odt document with Java model by calling process(IContext, OutputStream). For instance :

   report.process(context, new FileOutputStream(new File("myfile.odt")));

   This method call will generate myfile.odt file wich will contains Hello word!

Method Summary

Modifier and Type	Method and Description
void	addPreprocessor(java.lang.String entryName, IXDocPreprocessor preprocessor) Register a processor for the entry name.
void	clearData(java.lang.String key) Clear data.
void	convert(IContext context, Options options, java.io.OutputStream out) Generate report and Convert it to another format (PDF, XHTML, etc).
void	convert(java.util.Map<java.lang.String,java.lang.Object> contextMap, Options options, java.io.OutputStream out) Generate report and Convert it to another format (PDF, XHTML, etc).
IContext	createContext() Create a new instance of IContext to put the Java model.
IContext	createContext(java.util.Map<java.lang.String,java.lang.Object> contextMap) Create a new instance of IContext to put the Java model.
FieldsMetadata	createFieldsMetadata() Create fields metadata.
void	dump(IContext context, DumperOptions options, java.io.OutputStream out) Dump
void	dump(IContext context, java.io.InputStream document, DumperOptions options, java.io.OutputStream out) Dump
void	extractFields(FieldsExtractor extractor) Extract declared fields which use syntax of the template egine of the report.
void	extractFields(FieldsExtractor extractor, ITemplateEngine templateEngine) Extract declared fields which use syntax of the given template egine of the report.
IConverter	getConverter(Options options) Returns converter for the report and options.
<T> T	getData(java.lang.String key) Returns custom data.
IDumper	getDumper(DumperOptions options) Returns the dumper for the given options.
FieldsMetadata	getFieldsMetadata() Returns fields metadata used to manage lazy loop for table row.
java.lang.String	getId() Returns the id of the IXDocReport.
java.lang.String	getKind() Returns the kind of the report (ODT, docx...).
long	getLastModified() Returns the last modified time when the report is loaded.
MimeMapping	getMimeMapping() Returns mime mapping switch the kind of the report (odt, docx...).
XDocArchive	getOriginalDocumentArchive() Returns the original zipped XML document (odt, docx...) and null if : no load was done.
XDocArchive	getPreprocessedDocumentArchive() Returns the preprocessed zipped XML document (odt, docx...) and null if no load was done.
ITemplateEngine	getTemplateEngine() Returns the template engine (Velocity, Freemarker..) to use switch the syntax used in the XML document.
boolean	isPreprocessed() Returns true if report was processed and false otherwise.
void	load(java.io.InputStream sourceStream) Load XML document (odt, docx...) from input stream.
void	preprocess() Force the preprocessing step.
void	process(IContext context, java.io.OutputStream out) Merge the docx, odt document with Java model from the context and register the result to the output stream.
void	process(IContext context, java.lang.String entryName, java.io.OutputStream outputStream) Merge the docx, odt document with Java model from the context and register the entryName transformed to the output stream.
void	process(java.util.Map<java.lang.String,java.lang.Object> contextMap, java.io.OutputStream out) Merge the docx, odt document with Java model from the context Map and register the result to the output stream.
void	process(java.util.Map<java.lang.String,java.lang.Object> contextMap, java.lang.String entryName, java.io.OutputStream outputStream) Merge the docx, odt document with Java model from the context Map and register the entryName transformed to the output stream.
void	removeAllPreprocessors() Clear processor.
void	removePreprocessor(java.lang.String entryName) Remove processor for the entry name.
void	save(ProcessState processState, java.io.OutputStream out) Save original|preprocessed XML document archive in the given output stream.
void	saveEntry(java.lang.String entryName, ProcessState processState, java.io.OutputStream out) Save original|preprocessed entryName from XML document archive in the given output stream.
void	setCacheOriginalDocument(boolean cacheOriginalDocument) Set cache or not for original document archive.
void	setData(java.lang.String key, java.lang.Object value) Store custom data.
void	setDocumentArchive(XDocArchive documentArchive) Returns the zipped XML document (odt, docx...).
void	setFieldsMetadata(FieldsMetadata metadata) Set fields metadat used to manage lazy loop in table row.
void	setId(java.lang.String id) Set the id of the IXDocReport.
void	setTemplateEngine(ITemplateEngine templateEngine) Set the template engine (Velocity, Freemarker..) to use switch the syntax used in the XML document.

Method Detail

getKind

java.lang.String getKind()

Returns the kind of the report (ODT, docx...).

Returns:

getId

java.lang.String getId()

Returns the id of the IXDocReport. This id is used to cache an instance of IXDocReport with {@link XDocReportRegistry#loadReport(InputStream) and get instance from cache with

Returns:

the id of the IXDocReport

setId

void setId(java.lang.String id)

Set the id of the IXDocReport. This id is used to cache an instance of IXDocReport with {@link XDocReportRegistry#loadReport(InputStream) and get instance from cache with

Parameters:

id - of the IXDocReport

load

void load(java.io.InputStream sourceStream)
   throws java.io.IOException,
          XDocReportException

Load XML document (odt, docx...) from input stream.

Parameters:

sourceStream - stream of the XML Document zip (odt, docx...).

Throws:

java.io.IOException - when XML Document zip (odt, docx...) cannot be read.

XDocReportException - when preprocessing with IXDocPreprocessor cannot be done.

save

void save(ProcessState processState,
          java.io.OutputStream out)
   throws java.io.IOException,
          XDocReportException

Save original|preprocessed XML document archive in the given output stream.

Parameters:

out -

Throws:

java.io.IOException

XDocReportException

saveEntry

void saveEntry(java.lang.String entryName,
               ProcessState processState,
               java.io.OutputStream out)
        throws java.io.IOException,
               XDocReportException

Save original|preprocessed entryName from XML document archive in the given output stream.

Parameters:

out -

Throws:

java.io.IOException

XDocReportException

setDocumentArchive

void setDocumentArchive(XDocArchive documentArchive)
                 throws java.io.IOException,
                        XDocReportException

Returns the zipped XML document (odt, docx...).

Parameters:

documentArchive - XDocArchive.

Throws:

XDocReportException - when preprocessing with IXDocPreprocessor cannot be done.

java.io.IOException

getOriginalDocumentArchive

XDocArchive getOriginalDocumentArchive()

Returns the original zipped XML document (odt, docx...) and null if :

• no load was done.
• cache for original document is false (see setCacheOriginalDocument(boolean).

Returns:

getPreprocessedDocumentArchive

XDocArchive getPreprocessedDocumentArchive()

Returns the preprocessed zipped XML document (odt, docx...) and null if no load was done.

Returns:

setTemplateEngine

void setTemplateEngine(ITemplateEngine templateEngine)

Set the template engine (Velocity, Freemarker..) to use switch the syntax used in the XML document.

Parameters:

templateEngine -

getTemplateEngine

ITemplateEngine getTemplateEngine()

Returns the template engine (Velocity, Freemarker..) to use switch the syntax used in the XML document.

Returns:

setFieldsMetadata

void setFieldsMetadata(FieldsMetadata metadata)

Set fields metadat used to manage lazy loop in table row.

Parameters:

metadata -

createContext

IContext createContext()
                throws XDocReportException

Create a new instance of IContext to put the Java model.

Returns:

Throws:

XDocReportException

createContext

IContext createContext(java.util.Map<java.lang.String,java.lang.Object> contextMap)
                throws XDocReportException

Create a new instance of IContext to put the Java model.

Returns:

Throws:

XDocReportException

process

void process(IContext context,
             java.io.OutputStream out)
      throws XDocReportException,
             java.io.IOException

Merge the docx, odt document with Java model from the context and register the result to the output stream.

Parameters:

context - of the Java model.

out - output stream where merge must be saved.

Throws:

XDocReportException

java.io.IOException

process

void process(java.util.Map<java.lang.String,java.lang.Object> contextMap,
             java.io.OutputStream out)
      throws XDocReportException,
             java.io.IOException

Merge the docx, odt document with Java model from the context Map and register the result to the output stream.

Parameters:

context - of the Java model.

out - output stream where merge must be saved.

Throws:

XDocReportException

java.io.IOException

process

void process(IContext context,
             java.lang.String entryName,
             java.io.OutputStream outputStream)
      throws XDocReportException,
             java.io.IOException

Merge the docx, odt document with Java model from the context and register the entryName transformed to the output stream.

Parameters:

context - of the Java model.

entryName - entry name

out - output stream where merge must be saved.

Throws:

XDocReportException

java.io.IOException

process

void process(java.util.Map<java.lang.String,java.lang.Object> contextMap,
             java.lang.String entryName,
             java.io.OutputStream outputStream)
      throws XDocReportException,
             java.io.IOException

Merge the docx, odt document with Java model from the context Map and register the entryName transformed to the output stream.

Parameters:

context - of the Java model.

entryName - entry name

out - output stream where merge must be saved.

Throws:

XDocReportException

java.io.IOException

getConverter

IConverter getConverter(Options options)
                 throws XDocConverterException

Returns converter for the report and options.

Parameters:

options -

Returns:

Throws:

XDocConverterException

convert

void convert(IContext context,
             Options options,
             java.io.OutputStream out)
      throws XDocReportException,
             XDocConverterException,
             java.io.IOException

Generate report and Convert it to another format (PDF, XHTML, etc).

Parameters:

context -

options -

out -

Throws:

XDocReportException

XDocConverterException

java.io.IOException

convert

void convert(java.util.Map<java.lang.String,java.lang.Object> contextMap,
             Options options,
             java.io.OutputStream out)
      throws XDocReportException,
             XDocConverterException,
             java.io.IOException

Generate report and Convert it to another format (PDF, XHTML, etc).

Parameters:

contextMap -

options -

out -

Throws:

XDocReportException

XDocConverterException

java.io.IOException

getMimeMapping

MimeMapping getMimeMapping()

Returns mime mapping switch the kind of the report (odt, docx...).

Returns:

setData

void setData(java.lang.String key,
             java.lang.Object value)

Store custom data.

Parameters:

key -

value -

clearData

void clearData(java.lang.String key)

Clear data.

Parameters:

string -

getData

<T> T getData(java.lang.String key)

Returns custom data.

Parameters:

key -

Returns:

extractFields

void extractFields(FieldsExtractor extractor,
                   ITemplateEngine templateEngine)
            throws XDocReportException,
                   java.io.IOException

Extract declared fields which use syntax of the given template egine of the report.

Parameters:

extractor - the fields extractor.

templateEngine - the template engine.

Throws:

XDocReportException

java.io.IOException

extractFields

void extractFields(FieldsExtractor extractor)
            throws XDocReportException,
                   java.io.IOException

Extract declared fields which use syntax of the template egine of the report.

Parameters:

extractor - the fields extractor.

Throws:

XDocReportException

java.io.IOException

setCacheOriginalDocument

void setCacheOriginalDocument(boolean cacheOriginalDocument)

Set cache or not for original document archive.

Parameters:

cache -

isPreprocessed

boolean isPreprocessed()

Returns true if report was processed and false otherwise.

Returns:

getLastModified

long getLastModified()

Returns the last modified time when the report is loaded.

Returns:

getFieldsMetadata

FieldsMetadata getFieldsMetadata()

Returns fields metadata used to manage lazy loop for table row.

Returns:

createFieldsMetadata

FieldsMetadata createFieldsMetadata()

Create fields metadata.

Returns:

addPreprocessor

void addPreprocessor(java.lang.String entryName,
                     IXDocPreprocessor preprocessor)

Register a processor for the entry name.

Parameters:

entryName -

preprocessor -

removePreprocessor

void removePreprocessor(java.lang.String entryName)

Remove processor for the entry name.

Parameters:

entryName -

removeAllPreprocessors

void removeAllPreprocessors()

Clear processor.

preprocess

void preprocess()
         throws XDocReportException,
                java.io.IOException

Force the preprocessing step.

Throws:

XDocReportException

java.io.IOException

getDumper

IDumper getDumper(DumperOptions options)
           throws XDocReportException

Returns the dumper for the given options.

Parameters:

options -

Returns:

Throws:

XDocReportException

dump

void dump(IContext context,
          java.io.InputStream document,
          DumperOptions options,
          java.io.OutputStream out)
   throws java.io.IOException,
          XDocReportException

Dump

Parameters:

context -

kind -

options -

Throws:

java.io.IOException

XDocReportException

dump

void dump(IContext context,
          DumperOptions options,
          java.io.OutputStream out)
   throws java.io.IOException,
          XDocReportException

Dump

Parameters:

context -

kind -

options -

Throws:

java.io.IOException

XDocReportException