JasperReport原理

JRXML:报表填充模板，本质是一个XML.

JasperReport已经封装了一个dtd，只要按照规定的格式写这个xml文件，那么jasperReport就可以将其解析最终生成报表，但是jasperReport所解析的不是我们常见的.xml文件，而是.jrxml文件，其实跟xml是一样的，只是后缀不一样。

Jasper:由JRXML模板编译生成的二进制文件，用于代码填充数据。

解析完成后JasperReport就开始编译.jrxml文件，将其编译成.jasper文件，因为JasperReport只可以对.jasper文件进行填充数据和转换，这步操作就跟我们java中将java文件编译成class文件是一样的

Jrprint:当用数据填充完Jasper后生成的文件，用于输出报表。

这一步才是JasperReport的核心所在，它会根据你在xml里面写好的查询语句来查询指定是数据库，也可以控制在后台编写查询语句，参数，数据库。在报表填充完后，会再生成一个.jrprint格式的文件（读取jasper文件进行填充，然后生成一个jrprint文件）

骚戴理解：Jrprint是JasperReport报表库所生成的报表文档文件格式之一，它包含了报表生成时使用的所有信息，包括设计好的模板、填充数据、用于输出的控件以及生成的样式等等。因此，Jrprint文件中确实包含了数据填充后的内容。在填充数据之后，JasperReport会将结果存储在内存中，并为每一个页面创建一个对应的子报表元素，最终将这些子报表元素合并到一个整体的Jrprint文件中。需要注意的是，Jrprint文件不同于JasperReport的模板文件（.jrxml），它不能作为原始模板来进行编辑和修改。如果您需要调整报表的外观或逻辑，需要打开对应的.jrxml模板文件，并且重新编译和生成报表。

Exporter:决定要输出的报表为何种格式，报表输出的管理类。

Jasperreport可以输出多种格式的报表文件，常见的有Html,PDF,xls等

骚戴理解：Jasper文件和Jrprint文件有什么区别？

Jasper文件和Jrprint文件都是JasperReports报表库所使用的文件格式，但它们在生成和使用上有一些区别。

Jasper文件（.jasper）是由JasperReports编译器将.jrxml文件（JasperReports模板文件）转换为二进制格式的文件。Jasper文件包含了填充后的数据集、样式、和可视化控件等元素，并且可以作为原始的模板来进行编辑和修改。当需要生成报表时，应通过JasperReports API加载Jasper文件，并为其填充数据集，然后使用所提供的输出组件将其导出为所需的格式（如PDF、HTML、Excel等）。

而Jrprint 文件（.jrprint），则是一个二进制格式的文件，其中包含了通过JasperReports API运行报表后生成的完整报表内容，包括所有页面和分页信息、数据以及渲染样式等。这个文件通常被用于在Java应用程序中查看或打印报表，以便在运行时进行一些更复杂的逻辑处理操作。

总之，Jasper文件主要用于设计与编译报表模板，而Jrprint文件用于展示或处理已经生成的完整报表。需要注意的是，Jasper文件和Jrprint文件都不能直接打开或修改，必须通过相关的JasperReports库来进行操作。

开发流程概述

制作报表模板模板编译
构造数据
填充模板数据

模板工具Jaspersoft Studio

概述

Jaspersoft Studio是JasperReports库和JasperReports服务器的基于Eclipse的报告设计器; 它可以作为Eclipse插件或作为独立的应用程序使用。Jaspersoft Studio允许您创建包含图表，图像，子报表，交叉表等的复杂布局。您可以通过JDBC，TableModels，JavaBeans，XML，Hibernate，大数据（如Hive），CSV，XML / A以及自定义来源等各种来源访问数据，然后将报告发布为PDF，RTF， XML，XLS，CSV，HTML，XHTML，文本，DOCX或OpenOﬃce。

Jaspersoft Studio 是一个可视化的报表设计工具,使用该软件可以方便地对报表进行可视化的设计，设计结果为格式.jrxml 的 XML 文件，并且可以把.jrxml 文件编译成.jasper 格式文件方便 JasperReport 报表引擎解析、显示。

安装配置

到JasperReport官网下载 Download Jaspersoft Business Intelligence Suite | Jaspersoft Community

下载 Library Jar包（传统导入jar包工程需下载）和模板设计器Jaspersoft studio。并安装Jaspersoft studio，安装的过程比较简单，一直下一步直至安装成功即可。

骚戴理解：安装下面这个，别安装错了！

面板介绍

Report editing area （主编辑区域）中，您直观地通过拖动，定位，对齐和通过 Designer palette（设计器调色板）对报表元素调整大小。JasperSoft Studio 有一个多标签编辑器，Design,Source 和 Preview：

Design tab：当你打开一个报告文件，它允许您以图形方式创建报表选中Source tab：包含用于报表的 JRXML 源代码。

Preview tab：允许在选择数据源和输出格式后，运行报表预览。

Repository Explorer view：包含 JasperServer 生成的连接和可用的数据适配器列表

Project Explorer view：包含 JasperReports 的工程项目清单

Outline view：在大纲视图中显示了一个树的形式的方式报告的完整结构。

Properties view：通常是任何基于 Eclipse 的产品/插件的基础之一。它通常被填充与实际所选元素的属性的信息。这就是这样，当你从主设计区域（即：一个文本字段）选择一个报表元素或从大纲，视图显示了它的信息。其中一些属性可以是只读的，但大部分都是可编辑的，对其进行修改，通常会通知更改绘制的元素（如：元素的宽度或高度）。

Problems view：显示的问题和错误，例如可以阻断报告的正确的编译。

Report state summary 提供了有关在报表编译/填充/执行统计用户有用的信息。错误会显示在这里

基本使用

模板制作

打开Jaspersoft Studio ，新建一个project, 步骤： File -> New -> Project-> JasperReports Project

新建一个Jasper Report模板，在 Stidio的左下方Project Explorer 找到刚才新建的Project (我这里新建的是DemoReport),步骤：项目右键 -> New -> Jasper Report

选择 Blank A4 (A4纸大小的模板)，然后 Next 命名为DemoReport1.jrxml.

如图所示，报表模板被垂直的分层，每一个部分都是一个Band,每一个Band的特点不同：

Title(标题)：只在整个报表的第一页的最上端显示。只在第一页显示，其他页面均不显示。

Page Header(页头)：在整个报表中每一页都会显示。在第一页中，出现的位置在 Title的下面。在除了第一页的其他页面中Page Header 的内容均在页面的最上端显示。

Page Footer(页脚)：在整个报表中每一页都会显示。显示在页面的最下端。一般用来显示页码。

Detail 1(详细)：报表内容，每一页都会显示。

Column Header(列头)：Detail中打印的是一张表的话，这Column Header就是表中列的列头。Column Footer(列脚)：Detail中打印的是一张表的话，这Column Footer就是表中列的列脚。

Summary(统计)：表格的合计段，出现在整个报表的最后一页中，在Detail1后面。主要是用来做报表的合计显示。

骚戴理解：上面的这些都是可以按delete按钮删除的！注意在玩的时候需要先ctrl+s进行保存然后才可以在Preview里面预览到效果！

编译模板

右键单机模板文件 -> compile Report 对模板进行编译，生成.jasper文件

骚戴理解：首先在Jaspersoft Studio 里面通过拖拽的方式设计好模板，设计模板的时候其实就是jrxml文件，然后通过编译变成jasper文件，jasper文件才是Java代码里要用到的，后续会把这个jasper文件放在Resource目录下！在Java代码里对jasper文件填充数据生成jrprint文件，然后以pdf报表的形式展示在前端！

可以看到编译后就会生成jasper文件，然后把这个文件导入项目里即可！

整合工程

新建SpringBoot工程引入坐标

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.5.RELEASE</version>
        <relativePath/>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>net.sf.jasperreports</groupId>
            <artifactId>jasperreports</artifactId>
            <version>6.5.0</version>
        </dependency>
        <dependency>
            <groupId>org.olap4j</groupId>
            <artifactId>olap4j</artifactId>
            <version>1.2.0</version>
        </dependency>
        <dependency>
            <groupId>com.lowagie</groupId>
            <artifactId>itext</artifactId>
            <version>2.1.7</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
            <version>4.0.1</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
            <version>4.0.1</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml-schemas</artifactId>
            <version>4.0.1</version>
        </dependency>
    </dependencies>

引入配置文件

server:
 port: 8181
spring:
 application:
   name: jasper-demo #指定服务名
 resources:
   static-locations: classpath:/templates/
 datasource:
   driver-class-name: com.mysql.jdbc.Driver
   url: jdbc:mysql://localhost:3306/ihrm?useUnicode=true&characterEncoding=utf8
   username: root
   password: 111111

创建启动类

@SpringBootApplication(scanBasePackages = "cn.itcast")
public class JasperApplication {
    public static void main(String[] args) {
        SpringApplication.run(JasperApplication.class, args);
   }
}

导入生成的.jasper文件

创建测试controller

package cn.itcast.controller;
import net.sf.jasperreports.engine.*;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.HashMap;
@RestController
public class JasperController {
    @GetMapping("/testJasper")
    public void createPdf(HttpServletRequest request, HttpServletResponse response) throws IOException {
        //1.引入jasper文件
        Resource resource = new ClassPathResource("templates/test.jasper");
        FileInputStream fis = new FileInputStream(resource.getFile());
        //2.创建JasperPrint,向jasper文件中填充数据
        ServletOutputStream os = response.getOutputStream();
        try {
            /**
             * fis: jasper文件输入流
             * new HashMap ：向模板中输入的参数
             * JasperDataSource：数据源（和数据库数据源不同）
             *              填充模板的数据来源（connection，javaBean，Map）
             *               填充空数据来源：JREmptyDataSource
             */
            JasperPrint print = JasperFillManager.fillReport(fis, new HashMap<>(),new JREmptyDataSource());
            //3.将JasperPrint已PDF的形式输出
            JasperExportManager.exportReportToPdfStream(print,os);
        } catch (JRException e) {
            e.printStackTrace();
        }finally {
            os.flush();
        }
    }
}

骚戴理解：下面这句代码是把jasper文件进行填充数据，然后生成jrprint对象（文件），注意这三个参数的含义就好

fis: jasper文件输入流

new HashMap ：向模板中输入的参数

JasperDataSource：数据源（和数据库数据源不同）

填充模板的数据来源（connection，javaBean，Map）

填充空数据来源：JREmptyDataSource，如果是没有数据源就new JREmptyDataSource()

 JasperPrint print = JasperFillManager.fillReport(fis, new HashMap<>(),new JREmptyDataSource());

还要一行核心代码就是指定通过什么方式把jrprint文件导出，这里指定通过pdf导出流来导出！

JasperExportManager.exportReportToPdfStream(print,os);

中文处理

通过手动指定中文字体的形式解决中文不现实

添加properties文件：

net.sf.jasperreports.extension.registry.factory.simple.font.families=net.sf.jasperreports.engine.fonts.SimpleFontExtensionsRegistryFactory
net.sf.jasperreports.extension.simple.font.families.lobstertwo=stsong/fonts.xml

指定中文配置文件fonts.xml（放Resource目录下）

<?xml version="1.0" encoding="UTF-8"?>
<fontFamilies>
    <!--<fontFamily name="Lobster Two">-->
    <!--<normal>lobstertwo/LobsterTwo-Regular.otf</normal>-->
    <!--<bold>lobstertwo/LobsterTwo-Bold.otf</bold>-->
    <!--<italic>lobstertwo/LobsterTwo-Italic.otf</italic>-->
    <!--<boldItalic>lobstertwo/LobsterTwo-BoldItalic.otf</boldItalic>-->
    <!--<pdfEncoding>Identity-H</pdfEncoding>-->
    <!--<pdfEmbedded>true</pdfEmbedded>-->
    <!--<!–-->
    <!--<exportFonts>-->
    <!--<export key="net.sf.jasperreports.html">'Lobster Two', 'Times New Roman', Times, serif</export>-->
    <!--</exportFonts>-->
    <!--–>-->
    <!--</fontFamily>-->
    <fontFamily name="华文宋体">
        <normal>stsong/stsong.TTF</normal>
        <bold>stsong/stsong.TTF</bold>
        <italic>stsong/stsong.TTF</italic>
        <boldItalic>stsong/stsong.TTF</boldItalic>
        <pdfEncoding>Identity-H</pdfEncoding>
        <pdfEmbedded>true</pdfEmbedded>
        <exportFonts>
            <export key="net.sf.jasperreports.html">'华文宋体', Arial, Helvetica, sansserif</export>
            <export key="net.sf.jasperreports.xhtml">'华文宋体', Arial, Helvetica, sansserif</export>
        </exportFonts>
        <!--
        <locales>
            <locale>en_US</locale>
            <locale>de_DE</locale>
        </locales>
        -->
    </fontFamily>
</fontFamilies>

引入字体库stsong.TTF（放Resource目录下）

文件上传与PDF报表入门2

JasperReport原理

开发流程概述

模板工具Jaspersoft Studio

概述

安装配置

面板介绍

基本使用

模板制作

编译模板

整合工程

中文处理

热门文章

最新文章

相关电子书

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

文件上传与PDF报表入门2

JasperReport原理

开发流程概述

模板工具Jaspersoft Studio

概述

安装配置

面板介绍

基本使用

模板制作

编译模板

整合工程

中文处理

热门文章

最新文章

相关电子书