net.windward.xmlreport
Class ProcessExcelML

java.lang.Object
  |
  +--net.windward.xmlreport.ProcessReport
        |
        +--net.windward.xmlreport.ProcessExcelML

All Implemented Interfaces:

ProcessExcelMLAPI, ProcessReportAPI, ProcessReportAPIBase

public class ProcessExcelML

extends ProcessReport

implements ProcessExcelMLAPI

This class is the main program that takes a template stream and a datasource and merges them to create an ExcelML report stream. The way to use this is to construct a ProcessExcelML object, set any options, then call process.
The calling method must close all streams after calling process. process will flush the output (report) stream before returning. This provides limited functionality specifically; 1) Cell widths are set to that of the first table encountered, 2) Section breaks are ignored, 3) Formatting within a cell is ignored, 4) No images, 5) no hyperlinks, 6) all fields just display their default value, and 7) No tables inside tables (treated as just text).

Version:

3.1 3 December 2004

Fields inherited from class net.windward.xmlreport.ProcessReport

TEMPLATE_TYPE_DOCX, TEMPLATE_TYPE_RTF, TEMPLATE_TYPE_UNKNOWN, TEMPLATE_TYPE_WORD_11, TEMPLATE_TYPE_XLSX

Fields inherited from interface net.windward.xmlreport.ProcessReportAPI

CHARSET_DEFAULT, CHARSET_RTF, CHARSET_UNICODE, LOCALE_DEFAULT, LOCALE_SYSTEM, TYP_DOCX, TYP_EXCEL_ML, TYP_HTML, TYP_PDF, TYP_RTF, TYP_TXT, TYP_WORD_ML, TYP_XLS, TYP_XLSX

Constructor Summary

ProcessExcelML(java.io.InputStream rtfTemplate)
Create a ProcessExcelML object with the passed in template.

ProcessExcelML(java.io.InputStream xmlData, java.io.InputStream rtfTemplate, java.io.OutputStream report)
Create a ProcessExcelML object with the passed in template & data streams, writing it to the passed in report stream.

ProcessExcelML(java.io.InputStream rtfTemplate, java.io.OutputStream report)
Create a ProcessExcelML object with the passed in template, writing it to the passed in report stream.

Method Summary

ProcessReportAPIBase	duplicate(java.io.OutputStream out) Creates and returns a copy of this object.
int	getReportType() Get the report format of the output stream.

Methods inherited from class net.windward.xmlreport.ProcessReport

addBean, close, dispose, getBaseDirectory, getCharset, getChartProvider, getCompany, getImportingProvider, getInfo, getKeywords, getLocale, getNumPages, getReport, getSubject, getTitle, getVersion, getVersionMajor, getVersionMinor, getVersionRelease, init, isDebugMode, process, processComplete, processData, processSetup, processSetup, setBaseDirectory, setCharset, setChartProvider, setDebugMode, setKeywords, setLocale, setSubject, setTitle, statLine

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.windward.xmlreport.ProcessReportAPI

setChartProvider

Methods inherited from interface net.windward.xmlreport.ProcessReportAPIBase

addBean, close, getBaseDirectory, getCharset, getInfo, getKeywords, getLocale, getNumPages, getReport, getSubject, getTitle, isDebugMode, process, processComplete, processData, processSetup, processSetup, setBaseDirectory, setCharset, setDebugMode, setKeywords, setLocale, setSubject, setTitle

Constructor Detail

ProcessExcelML

public ProcessExcelML(java.io.InputStream rtfTemplate)
               throws LicenseException,
                      SetupException

Create a ProcessExcelML object with the passed in template. Objects created with this constructor must call processSetup, processData, and processComplete. Objects created with this constructor cannot call process. The report will be in the ExcelML format.

Parameters:

rtfTemplate - The report template, as a rtf document.

Throws:

LicenseException - thrown if the license licenseKey check fails. The message will list the license check that failed.

ProcessExcelML

public ProcessExcelML(java.io.InputStream rtfTemplate,
                      java.io.OutputStream report)
               throws LicenseException,
                      SetupException

Create a ProcessExcelML object with the passed in template, writing it to the passed in report stream. Objects created with this constructor must call processSetup, processData, and processComplete. Objects created with this constructor cannot call process. The report will be in the ExcelML format.

Parameters:

rtfTemplate - The report template, as a rtf document.

report - The stream to write the report to.

Throws:

LicenseException - thrown if the license licenseKey check fails. The message will list the license check that failed.

ProcessExcelML

public ProcessExcelML(java.io.InputStream xmlData,
                      java.io.InputStream rtfTemplate,
                      java.io.OutputStream report)
               throws DataSourceException,
                      LicenseException,
                      SetupException

Create a ProcessExcelML object with the passed in template & data streams, writing it to the passed in report stream. The report will be in the ExcelML format.

Parameters:

xmlData - The xml data that will be placed into the report where there are xml elements.

rtfTemplate - The report template, as a rtf document.

report - The stream to write the report to.

Throws:

DataSourceException - thrown if there is a problem with the datasource.

LicenseException - thrown if the license licenseKey check fails. The message will list the license check that failed.

Method Detail

duplicate

public ProcessReportAPIBase duplicate(java.io.OutputStream out)
                               throws AlreadyProcessedException,
                                      LicenseException,
                                      SetupException

Creates and returns a copy of this object. You may call this before or after calling processData(). You may then call processData() on the created object. You must call this after calling processSetup() and before calling processComplete(). While this mostly does a deep copy, it does not do a deep copy of bean objects or image data. This will always return a ProcessExcellML object.

Specified by:

duplicate in interface ProcessReportAPIBase

Parameters:

out - The stream to write the report to. If null will create a ByteArrayOutputStream.

Throws:

AlreadyProcessedException - thrown if call the process steps out of order or call ones other than data twice.

LicenseException - thrown if the license licenseKey check fails. The message will list the license check that failed.

getReportType

public int getReportType()

Get the report format of the output stream.

Specified by:

getReportType in interface ProcessExcelMLAPI

Returns:

The type (format) of the output report. Will be TYP_XLSF.