Package net.sf.jasperreports.engine

Class 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, JRXlsxExporter, JRCsvExporter

    • Method Detail

      • 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

      • 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)