net.sf.jasperreports.engine

Class JasperExportManager

java.lang.Object

net.sf.jasperreports.engine.JasperExportManager

public final class JasperExportManager
extends Object

Facade class for exporting generated reports into more popular formats such as PDF, HTML and XML.

This class contains convenience methods for exporting to only these 3 formats. These methods can process data that comes from different sources and goes to different destinations (files, input and output streams, etc.).

For exporting to XLS and CSV format or for using special exporter parameters, the specific exporter class should be used directly.

Author:

Teodor Danciu (teodord@users.sourceforge.net)

See Also:

JasperPrint, HtmlExporter, JRPdfExporter, JRXmlExporter, JRXlsExporter, JRCsvExporter

Method Summary

Methods

Modifier and Type	Method and Description
static void	exportReportToHtmlFile(JasperPrint jasperPrint, String destFileName)
static String	exportReportToHtmlFile(String sourceFileName)
static void	exportReportToHtmlFile(String sourceFileName, String destFileName)
static byte[]	exportReportToPdf(JasperPrint jasperPrint)
static void	exportReportToPdfFile(JasperPrint jasperPrint, String destFileName)
static String	exportReportToPdfFile(String sourceFileName)
static void	exportReportToPdfFile(String sourceFileName, String destFileName)
static void	exportReportToPdfStream(InputStream inputStream, OutputStream outputStream)
static void	exportReportToPdfStream(JasperPrint jasperPrint, OutputStream outputStream) Exports the generated report object received as first parameter into PDF format and writes the results to the output stream specified by the second parameter.
static String	exportReportToXml(JasperPrint jasperPrint)
static void	exportReportToXmlFile(JasperPrint jasperPrint, String destFileName, boolean isEmbeddingImages)
static String	exportReportToXmlFile(String sourceFileName, boolean isEmbeddingImages)
static void	exportReportToXmlFile(String sourceFileName, String destFileName, boolean isEmbeddingImages)
static void	exportReportToXmlStream(InputStream inputStream, OutputStream outputStream)
static void	exportReportToXmlStream(JasperPrint jasperPrint, OutputStream outputStream)
void	exportToHtmlFile(JasperPrint jasperPrint, String destFileName) Exports the generated report object received as parameter into HTML format, placing the result into the second file parameter.
String	exportToHtmlFile(String sourceFileName) Exports the generated report file specified by the parameter into HTML format.
void	exportToHtmlFile(String sourceFileName, String destFileName) Exports the generated report file specified by the first parameter into HTML format, placing the result into the second file parameter.
byte[]	exportToPdf(JasperPrint jasperPrint) Exports the generated report object received as parameter into PDF format and returns the binary content as a byte array.
void	exportToPdfFile(JasperPrint jasperPrint, String destFileName) Exports the generated report file specified by the first parameter into PDF format, the result being placed in the second file parameter.
String	exportToPdfFile(String sourceFileName) Exports the generated report file specified by the parameter into PDF format.
void	exportToPdfFile(String sourceFileName, String destFileName) Exports the generated report file specified by the first parameter into PDF format, the result being placed in the second file parameter.
void	exportToPdfStream(InputStream inputStream, OutputStream outputStream) Exports the generated report read from the supplied input stream into PDF format and writes the results to the output stream specified by the second parameter.
void	exportToPdfStream(JasperPrint jasperPrint, OutputStream outputStream) Exports the generated report object received as first parameter into PDF format and writes the results to the output stream specified by the second parameter.
String	exportToXml(JasperPrint jasperPrint) Exports the generated report object supplied as parameter into XML format and returs the result as String.
void	exportToXmlFile(JasperPrint jasperPrint, String destFileName, boolean isEmbeddingImages) Exports the generated report object received as parameter into XML format, placing the result into the second file parameter.
String	exportToXmlFile(String sourceFileName, boolean isEmbeddingImages) Exports the generated report file specified by the parameter into XML format.
void	exportToXmlFile(String sourceFileName, String destFileName, boolean isEmbeddingImages) Exports the generated report file specified by the first parameter into XML format, placing the result into the second file parameter.
void	exportToXmlStream(InputStream inputStream, OutputStream outputStream) Exports the generated report object read from the supplied input stream into XML format, and writes the result to the output stream specified by the second parameter.
void	exportToXmlStream(JasperPrint jasperPrint, OutputStream outputStream) Exports the generated report object supplied as the first parameter into XML format, and writes the result to the output stream specified by the second parameter.
static JasperExportManager	getInstance(JasperReportsContext jasperReportsContext)

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static JasperExportManager getInstance(JasperReportsContext jasperReportsContext)

exportToPdfFile

public String exportToPdfFile(String sourceFileName)
                       throws JRException

Exports the generated report file specified by the parameter into PDF format. The resulting PDF file has the same name as the report object inside the source file, plus the *.pdf extension and it is located in the same directory as the source file.

Parameters:

sourceFileName - source file containing the generated report

Returns:

resulting PDF file name

Throws:

JRException

See Also:

JRPdfExporter

exportToPdfFile

public void exportToPdfFile(String sourceFileName,
                   String destFileName)
                     throws JRException

Exports the generated report file specified by the first parameter into PDF format, the result being placed in the second file parameter.

Parameters:

sourceFileName - source file containing the generated report

destFileName - file name to place the PDF content into

Throws:

JRException

See Also:

JRPdfExporter

exportToPdfFile

public void exportToPdfFile(JasperPrint jasperPrint,
                   String destFileName)
                     throws JRException

Exports the generated report file specified by the first parameter into PDF format, the result being placed in the second file parameter.

Parameters:

jasperPrint - report object to export

destFileName - file name to place the PDF content into

Throws:

JRException

See Also:

JRPdfExporter

exportToPdfStream

public void exportToPdfStream(InputStream inputStream,
                     OutputStream outputStream)
                       throws JRException

Exports the generated report read from the supplied input stream into PDF format and writes the results to the output stream specified by the second parameter.

Parameters:

inputStream - input stream to read the generated report object from

outputStream - output stream to write the resulting PDF content to

Throws:

JRException

See Also:

JRPdfExporter

exportToPdfStream

public void exportToPdfStream(JasperPrint jasperPrint,
                     OutputStream outputStream)
                       throws JRException

Exports the generated report object received as first parameter into PDF format and writes the results to the output stream specified by the second parameter.

Parameters:

jasperPrint - report object to export

outputStream - output stream to write the resulting PDF content to

Throws:

JRException

See Also:

JRPdfExporter

exportToPdf

public byte[] exportToPdf(JasperPrint jasperPrint)
                   throws JRException

Exports the generated report object received as parameter into PDF format and returns the binary content as a byte array.

Parameters:

jasperPrint - report object to export

Returns:

byte array representing the resulting PDF content

Throws:

JRException

See Also:

JRPdfExporter

exportToXmlFile

public String exportToXmlFile(String sourceFileName,
                     boolean isEmbeddingImages)
                       throws JRException

Exports the generated report file specified by the parameter into XML format. The resulting XML file has the same name as the report object inside the source file, plus the *.jrpxml extension and it is located in the same directory as the source file.

When exporting to XML format, the images can be either embedded in the XML content itself using the Base64 encoder or be referenced as external resources. If not embedded, the images are placed as distinct files inside a directory having the same name as the XML destination file, plus the "_files" suffix.

Parameters:

sourceFileName - source file containing the generated report

isEmbeddingImages - flag that indicates whether the images should be embedded in the XML content itself using the Base64 encoder or be referenced as external resources

Returns:

XML representation of the generated report

Throws:

JRException

See Also:

JRPdfExporter

exportToXmlFile

public void exportToXmlFile(String sourceFileName,
                   String destFileName,
                   boolean isEmbeddingImages)
                     throws JRException

Exports the generated report file specified by the first parameter into XML format, placing the result into the second file parameter.

If not embedded into the XML content itself using the Base64 encoder, the images are placed as distinct files inside a directory having the same name as the XML destination file, plus the "_files" suffix.

Parameters:

sourceFileName - source file containing the generated report

destFileName - file name to place the XML representation into

isEmbeddingImages - flag that indicates whether the images should be embedded in the XML content itself using the Base64 encoder or be referenced as external resources

Throws:

JRException

See Also:

JRPdfExporter

exportToXmlFile

public void exportToXmlFile(JasperPrint jasperPrint,
                   String destFileName,
                   boolean isEmbeddingImages)
                     throws JRException

Exports the generated report object received as parameter into XML format, placing the result into the second file parameter.

If not embedded into the XML content itself using the Base64 encoder, the images are placed as distinct files inside a directory having the same name as the XML destination file, plus the "_files" suffix.

Parameters:

jasperPrint - report object to export

destFileName - file name to place the XML representation into

isEmbeddingImages - flag that indicates whether the images should be embedded in the XML content itself using the Base64 encoder or be referenced as external resources

Throws:

JRException

See Also:

JRPdfExporter

exportToXmlStream

public void exportToXmlStream(InputStream inputStream,
                     OutputStream outputStream)
                       throws JRException

Exports the generated report object read from the supplied input stream into XML format, and writes the result to the output stream specified by the second parameter. The images are embedded into the XML content itself using the Base64 encoder.

Parameters:

inputStream - input stream to read the generated report object from

outputStream - output stream to write the resulting XML representation to

Throws:

JRException

See Also:

JRPdfExporter

exportToXmlStream

public void exportToXmlStream(JasperPrint jasperPrint,
                     OutputStream outputStream)
                       throws JRException

Exports the generated report object supplied as the first parameter into XML format, and writes the result to the output stream specified by the second parameter. The images are embedded into the XML content itself using the Base64 encoder.

Parameters:

jasperPrint - report object to export

outputStream - output stream to write the resulting XML representation to

Throws:

JRException

See Also:

JRPdfExporter

exportToXml

public String exportToXml(JasperPrint jasperPrint)
                   throws JRException

Exports the generated report object supplied as parameter into XML format and returs the result as String. The images are embedded into the XML content itself using the Base64 encoder.

Parameters:

jasperPrint - report object to export

Returns:

XML representation of the generated report

Throws:

JRException

See Also:

JRPdfExporter

exportToHtmlFile

public String exportToHtmlFile(String sourceFileName)
                        throws JRException

Exports the generated report file specified by the parameter into HTML format. The resulting HTML file has the same name as the report object inside the source file, plus the *.html extension and it is located in the same directory as the source file. The images are placed as distinct files inside a directory having the same name as the HTML destination file, plus the "_files" suffix.

Parameters:

sourceFileName - source file containing the generated report

Returns:

resulting HTML file name

Throws:

JRException

See Also:

HtmlExporter

exportToHtmlFile

public void exportToHtmlFile(String sourceFileName,
                    String destFileName)
                      throws JRException

Exports the generated report file specified by the first parameter into HTML format, placing the result into the second file parameter.

The images are placed as distinct files inside a directory having the same name as the HTML destination file, plus the "_files" suffix.

Parameters:

sourceFileName - source file containing the generated report

destFileName - file name to place the HTML content into

Throws:

JRException

See Also:

JRPdfExporter

exportToHtmlFile

public void exportToHtmlFile(JasperPrint jasperPrint,
                    String destFileName)
                      throws JRException

Exports the generated report object received as parameter into HTML format, placing the result into the second file parameter.

The images are placed as distinct files inside a directory having the same name as the HTML destination file, plus the "_files" suffix.

Parameters:

jasperPrint - report object to export

destFileName - file name to place the HTML content into

Throws:

JRException

See Also:

JRPdfExporter

exportReportToPdfFile

public static String exportReportToPdfFile(String sourceFileName)
                                    throws JRException

Throws:

JRException

See Also:

exportToPdfFile(String)

exportReportToPdfFile

public static void exportReportToPdfFile(String sourceFileName,
                         String destFileName)
                                  throws JRException

Throws:

JRException

See Also:

exportToPdfFile(String, String)

exportReportToPdfFile

public static void exportReportToPdfFile(JasperPrint jasperPrint,
                         String destFileName)
                                  throws JRException

Throws:

JRException

See Also:

exportToPdfFile(JasperPrint, String)

exportReportToPdfStream

public static void exportReportToPdfStream(InputStream inputStream,
                           OutputStream outputStream)
                                    throws JRException

Throws:

JRException

See Also:

exportToPdfStream(InputStream, OutputStream)

exportReportToPdfStream

public static void exportReportToPdfStream(JasperPrint jasperPrint,
                           OutputStream outputStream)
                                    throws JRException

Exports the generated report object received as first parameter into PDF format and writes the results to the output stream specified by the second parameter.

Parameters:

jasperPrint - report object to export

outputStream - output stream to write the resulting PDF content to

Throws:

JRException

See Also:

JRPdfExporter, exportToPdfStream(JasperPrint, OutputStream)

exportReportToPdf

public static byte[] exportReportToPdf(JasperPrint jasperPrint)
                                throws JRException

Throws:

JRException

See Also:

exportToPdf(JasperPrint)

exportReportToXmlFile

public static String exportReportToXmlFile(String sourceFileName,
                           boolean isEmbeddingImages)
                                    throws JRException

Throws:

JRException

See Also:

exportToXmlFile(String, String, boolean)

exportReportToXmlFile

public static void exportReportToXmlFile(String sourceFileName,
                         String destFileName,
                         boolean isEmbeddingImages)
                                  throws JRException

Throws:

JRException

See Also:

exportToXmlFile(String, String, boolean)

exportReportToXmlFile

public static void exportReportToXmlFile(JasperPrint jasperPrint,
                         String destFileName,
                         boolean isEmbeddingImages)
                                  throws JRException

Throws:

JRException

See Also:

exportToXmlFile(JasperPrint, String, boolean)

exportReportToXmlStream

public static void exportReportToXmlStream(InputStream inputStream,
                           OutputStream outputStream)
                                    throws JRException

Throws:

JRException

See Also:

exportToXmlStream(InputStream, OutputStream)

exportReportToXmlStream

public static void exportReportToXmlStream(JasperPrint jasperPrint,
                           OutputStream outputStream)
                                    throws JRException

Throws:

JRException

See Also:

exportToXmlStream(JasperPrint, OutputStream)

exportReportToXml

public static String exportReportToXml(JasperPrint jasperPrint)
                                throws JRException

Throws:

JRException

See Also:

exportToXml(JasperPrint)

exportReportToHtmlFile

public static String exportReportToHtmlFile(String sourceFileName)
                                     throws JRException

Throws:

JRException

See Also:

exportToHtmlFile(String)

exportReportToHtmlFile

public static void exportReportToHtmlFile(String sourceFileName,
                          String destFileName)
                                   throws JRException

Throws:

JRException

See Also:

exportToHtmlFile(String, String)

exportReportToHtmlFile

public static void exportReportToHtmlFile(JasperPrint jasperPrint,
                          String destFileName)
                                   throws JRException

Throws:

JRException

See Also:

exportToHtmlFile(JasperPrint, String)