【JasperReports笔记06】JasperReport报表开发之常见的组件元素（Table、Subreport、Barcode等）-支持Android

- 日理万妓 2024-02-17 08:24 48阅读 0赞

> **这篇文章，主要介绍JasperReport报表开发之常见的组件元素（Table、Subreport、Barcode等）。**

**目录**

一、基础组件元素

1.1、StaticText

1.2、TextField

1.3、Image

1.4、Break分页

1.5、Rectangle矩形区域

1.6、Ellipse椭圆区域

1.7、Line斜线

1.8、Generic组件（TODO）

1.9、Frame组件（TODO）

1.10、Subreport组件

1.11、Barcode条码组件

1.12、List列表组件

1.13、Chart图表（TODO）

1.14、Crosstab组件（TODO）

1.15、Table表格组件

1.16、Map组件（TODO）

1.17、SpiderChart组件（TODO）

二、复合元素

2.1、PageNumber

2.2、TotalPages

2.3、CurrentDate

2.4、Time

--------------------

### 一、基础组件元素 ###

#### 1.1、StaticText ####

StaticText是Jasper中的一个基础组件，用于表示静态文本内容，它表示的内容在程序运行过程中是不可以改变的，在制作模板文件的时候，就已经固定了文本内容。

![668e2e776e1745b6a71ae212082385c1.png][]

#### 1.2、TextField ####

TextField是一个基础组件，它表示的是一个文本域，可以设置一个表达式对象，例如：Parameters、Fields等，也就是说，TextField文本域组件可以在程序运行过程中，动态的显示文本内容。

![f0cf943508304159af8cf2dbb42691d2.png][]

#### 1.3、Image ####

Image是一个图片组件，可以添加多种来源的图片，有下面几种来源：

*  工作空间中的资源：在工作空间中的元素。
 *  文件系统中的绝对路径：只是快速测试，实际报表中不会使用。
 *  URL资源：一个远程的图片URL地址。
 *  从Jasper服务器中选择的图片。
 *  自定义表达式：使用表达式。
 *  没有图片，只是创建一个图片元素，之后在修改表达式。

![95ac3c1762774217a86150e3c0613a59.png][]

**显示图片的Base64字符串：**

在Java中可以将图片转换成字节输入流，然后将其传入到Jasper模板文件里面。制作图片模板文件，创建一个名称叫做【imageBase64】的Parameters参数，接着添加一个Image组件，设置它的表达式为字节输入流，如下所示：

new ByteArrayInputStream(org.apache.commons.codec.binary.Base64.decodeBase64($P{imageBase64}.getBytes()))

模板文件设置：

![71418c361ab842f4b90507ca2e18b789.png][]

![5c8e09056adf472297c89b76a3fc5679.png][]

制作的图片模板文件如下所示：

![a49e5f5cfc78406f8dfa0a7cee6ea31f.png][]

在Java代码中将图片转换成Base64字符串存入到Parameters参数里面。

package com.gitcode.demo.web;
     
    import com.gitcode.demo.util.JasperReportsUtil;
    import org.springframework.core.io.ClassPathResource;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    import sun.misc.BASE64Encoder;
     
    import java.io.InputStream;
    import java.util.HashMap;
    import java.util.Map;
     
    /**
     * @version 1.0.0
     * @Date: 2023/8/28 21:47
     * @Author ZhuYouBin
     * @Description: 图片组件
     */
    @RestController
    @RequestMapping("/api/report")
    public class ImageController {
     
        @GetMapping("/image")
        public String imageDemo() throws Exception {
            ClassPathResource resource = new ClassPathResource("jasper/ImageDemo.jasper");
            String templatePath = resource.getPath();
            String fileName = "图片模板文件";
            // 设置 parameters 参数
            Map<String, Object> parameters = new HashMap<>();
            // TODO 读取图片
            ClassPathResource imageResource = new ClassPathResource("image/demo.jpg");
            InputStream is = imageResource.getInputStream();
            byte[] data = null;
            try {
                data = new byte[is.available()];
                is.read(data);
                is.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
            // 对字节数组Base64编码
            BASE64Encoder encoder = new BASE64Encoder();
            String base64 = encoder.encode(data);
            parameters.put("imageBase64", base64);
            // 执行导出操作
            return JasperReportsUtil.generateReport(templatePath, fileName, "pdf", parameters);
        }
    }

运行结果：

![5bf13c9919b7443086973478ad76bc44.png][]

JasperReport中图片的大小固定之后，填充的图片宽度、高度会自动缩放来适应模板文件中图片的宽度和高度。

#### 1.4、Break分页 ####

Break是一个分页组件，它必须放在Detail区域里面，它的作用就是让内容分成两页显示，如下所示：

![d59e865af8df417a9323f2c53710bef9.png][]

预览的效果如下所示：

![e7199b7ff56342adb7a93f74be63c8a5.png][]

#### 1.5、Rectangle矩形区域 ####

Rectangle是一个矩形区域元素组件，它没有内容，只是一个矩形区域，可以设置背景颜色、边框等样式，如下所示：

![eadad7231c0345d59ee500457e3749ea.png][]

运行效果：

![70dfe375cde24c2c98bf965bbffb0d89.png][]

#### 1.6、[Ellipse][]椭圆区域 ####

Ellipse是一个椭圆区域，和Rectangle矩形区域类型，都不能设置显示的内容，仅仅是表示一块区域。

![8826cd12c582457f8138b05d7d1f7201.png][]

运行效果：

![bb3b3fa440e146a0b82f30e5fd3f2f20.png][]

#### 1.7、Line斜线 ####

Line是表示的线条元素，线条只有两个方向，分别是：从左上到右下的方向、从左下到右上的方向。

![823dac5865b145f3801d2871f401147f.png][]

**如果你想要一个水平的线条，那么你可以使用StaticText静态文本组件代替，只要设置StaticText组件的高度等于1px，这样从视觉上也就实现了水平线条的效果拉。**

#### 1.8、Generic组件（TODO） ####

TODO，目前我还不了解这个组件。

#### 1.9、Frame组件（TODO） ####

TODO，目前我还不了解这个组件。

#### 1.10、Subreport组件 ####

Subreport是子报表组件，它可以在一张报表中嵌入另一个报表，从而实现父子报表的功能，父子报表我在之前的文章中有介绍了，可以看下这篇文章【[【JasperReports笔记04】如何使用Jasper Studio制作父子报表，并且通过Java + Parameters参数填充模板文件][JasperReports_04_Jasper Studio_Java _ Parameters]】。

![1fb5e0489a3e4d7e8deffdedf477296c.png][]

#### 1.11、Barcode条码组件 ####

Barcode是一个条码组件，条码的类型有很多种可以选择：

![f099030fb1584404a9a3b448a9d05d91.png][]

条码组件是可以使用某种设备，扫描对应的条码就可以读取到条码中保存的数据内容，例如：二维码。Barcode可以设置一个Code Expression代码表达式，这个就是条码所表示的信息内容。

![f4aaada8768145b6aa4c88a1bef9118e.png][]

当我们使用微信扫描对应的条码之后，就可以获取到条码中保存的数据信息。

#### 1.12、List列表组件 ####

List是一个列表组件，顾名思义，List是可以显示很多个的一个组件，List组件最外层是一个列表项区域，然后再每一项中可以定义具体的内容，可以放置其他的组件元素，从而制作出复杂的模板文件，如下所示：

![faca9f3611d3463685c2886471ac910e.png][]

双击List组件，此时会进入到列表项的编辑区域，如下：

![de7ab279edf64ca2a86bbd639a932dc2.png][]

Java代码中渲染List组件，代码如下：

package com.gitcode.demo.web;
     
    import com.gitcode.demo.util.JasperReportsUtil;
    import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;
    import org.springframework.core.io.ClassPathResource;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
     
    import java.util.ArrayList;
    import java.util.HashMap;
    import java.util.List;
    import java.util.Map;
     
    /**
     * @version 1.0.0
     * @Date: 2023/8/29 22:08
     * @Author ZhuYouBin
     * @Description: JasperReport 中的 List 组件
     */
    @RestController
    @RequestMapping("/api/report")
    public class ListDemoController {
     
        @GetMapping("/list")
        public String listDemo() throws Exception {
            ClassPathResource resource = new ClassPathResource("jasper/ListDemo.jasper");
            String templatePath = resource.getPath();
            String fileName = "List列表模板文件";
            // 设置 parameters 参数
            Map<String, Object> parameters = new HashMap<>();
            // TODO 模拟数据
            List<Map<String, Object>> list = this.getData(10);
            parameters.put("list_data", list);
            // 执行导出操作
            return JasperReportsUtil.generateReport(templatePath, fileName, "pdf", parameters);
        }
     
        private List<Map<String, Object>> getData(int num) {
            List<Map<String, Object>> ansMap = new ArrayList<>();
            for (int i = 0; i < num; i++) {
                Map<String, Object> main = new HashMap<>();
                main.put("name", "名称_00" + i);
                main.put("type", "类型_00" + i);
                ansMap.add(main);
            }
            return ansMap;
        }
    }

运行效果：

![f806ffbd667c4f358b2531b2254194dc.png][]

列表项可以自定义，根据实际需求来搞呗！！！

#### 1.13、Chart图表（TODO） ####

TODO，目前我还不了解这个组件。

#### 1.14、Crosstab组件（TODO） ####

TODO，目前我还不了解这个组件。

#### 1.15、[Table表格][Table]组件 ####

Table是一个表格组件，如下所示：

![0428e7c3e2c84610a5ec767c32ccf2ee.png][]

拖拽Table表格到Detail区域之后，设置一下表格的样式，双击选中的表格组件，此时会跳转到Table编辑区域，如下：

![26fb0b2b0fa84bac814b2c2aef27db5f.png][]

表格模板文件制作如下：

![9f56dc72d3c447a0bfd75b6dff052eb5.png][]

创建一个parameters参数，并且设置类型是**【net.sf.jasperreports.engine.data.JRBeanCollectionDataSource】**集合，如下：

![fbaa5e553dc44f6fa24bff2efef98d99.png][]

修改Table表格的数据源为表达式，如下。

![9e6a90215b4d46f8925a2a26017c1027.png][]

在Java代码中通过进行数据源的传递。

package com.gitcode.demo.web;
     
    import com.gitcode.demo.util.JasperReportsUtil;
    import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;
    import org.springframework.core.io.ClassPathResource;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
     
    import java.util.ArrayList;
    import java.util.HashMap;
    import java.util.List;
    import java.util.Map;
     
    /**
     * @version 1.0.0
     * @Date: 2023/8/30 22:12
     * @Author ZhuYouBin
     * @Description:
     */
    @RestController
    @RequestMapping("/api/report")
    public class TableDemoController {
     
     
        @GetMapping("/table-demo")
        public String exportFile(String format) throws Exception {
            ClassPathResource resource = new ClassPathResource("jasper/TableDemo.jasper");
            String templatePath = resource.getPath();
            String fileName = "Table表格模板文件";
            // 表格数据集是 JRBeanCollectionDataSource 类型的，也就是 JavaBean 实体类类型
            List<Map<String, String>> data = this.getData(100);
            JRBeanCollectionDataSource dataSource = new JRBeanCollectionDataSource(data);
            // 执行导出操作
            return JasperReportsUtil.generateReport(templatePath, fileName, format, new HashMap<>(), dataSource);
        }
     
        private List<Map<String, String>> getData(int num) {
            List<Map<String, String>> ansMap = new ArrayList<>();
            for (int i = 0; i < num; i++) {
                Map<String, String> map = new HashMap<>();
                // 这里的 key 必须和模板文件中的 Field 字段的名称相同
                map.put("name", "name" + i);
                map.put("sex", i % 2 == 0 ? "male" : "female");
                map.put("age", (i + 20) + "");
                ansMap.add(map);
            }
            return ansMap;
        }
    }

运行效果：

![826cf25328614f50919fbaf95f5f9aa7.png][]

#### 1.16、Map组件（TODO） ####

TODO，目前我还不了解这个组件。

#### 1.17、SpiderChart组件（TODO） ####

TODO，目前我还不了解这个组件。

### 二、复合元素 ###

#### 2.1、PageNumber ####

PageNumber表示的是当前页码，从1开始，依次递增。

![1d3f37f6487543dc87463d349b9a3ccf.png][]

运行效果：

![1d2f47dc720047489e376c58ebc93d38.png][]

#### 2.2、TotalPages ####

Total Pages表示的总页码，也就是对应的报表总页数。

![2f9da02c37d445ea9fa82137550a0927.png][]

运行效果：

![d177e4df33f1422fb12fe17515b17f64.png][]

#### 2.3、CurrentDate ####

Current Date表示的是当前时间（年月日），对应Java中的java.util.Date，可以指定显示的日期格式。

#### 2.4、Time ####

Time表示的是当前时间（时分），对应Java中的java.util.Date，可以指定显示的日期格式。

![04466945f43a47e2b8982f7563e03501.png][]

运行效果：

![5c36c68fb8734044a6aeb58e9b949699.png][]

到此，JasperReports报表中的基础组件元素就介绍完啦，还是要在实际的需求中去使用，才能够明白这些组件应该使用在哪些场景下。

> **综上，这篇文章结束了，主要介绍JasperReport报表开发之常见的组件元素（Table、Subreport、Barcode等）。**

[668e2e776e1745b6a71ae212082385c1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/8af194ac31d84b348006f9eae728f78d.png
[f0cf943508304159af8cf2dbb42691d2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/e55efe0bdef04696b6a92c95c93afa64.png
[95ac3c1762774217a86150e3c0613a59.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/38c152639db24bbeb1521a50bb6e1d6c.png
[71418c361ab842f4b90507ca2e18b789.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/3a182de60bd84a3899e0d82eadd75566.png
[5c8e09056adf472297c89b76a3fc5679.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/80c373e80566481ea77666061b96c4aa.png
[a49e5f5cfc78406f8dfa0a7cee6ea31f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/6698118750f44c2ab1072594c1d08ed4.png
[5bf13c9919b7443086973478ad76bc44.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/9414be5b02bb409d91cf8e7637430e79.png
[d59e865af8df417a9323f2c53710bef9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/b527231d025a4d7ca1da1a26ea9f5ec2.png
[e7199b7ff56342adb7a93f74be63c8a5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/d8866013f8fe4c7483590125b6fd4020.png
[eadad7231c0345d59ee500457e3749ea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/e45c5088cc0e4b1bb5ae135a11a7eff4.png
[70dfe375cde24c2c98bf965bbffb0d89.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/505e3b513b23472d92cc040d71443323.png
[Ellipse]: https://so.csdn.net/so/search?q=Ellipse&spm=1001.2101.3001.7020
[8826cd12c582457f8138b05d7d1f7201.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/a302452d7c4a4a98b7db82da25a45d09.png
[bb3b3fa440e146a0b82f30e5fd3f2f20.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/445abed51b5e4ace8fc746f9e3a9675f.png
[823dac5865b145f3801d2871f401147f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/194c5cbf85da41dab1946ed2f217f9e2.png
[JasperReports_04_Jasper Studio_Java _ Parameters]: https://zhuyb.blog.csdn.net/article/details/132379227
[1fb5e0489a3e4d7e8deffdedf477296c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/015be076355d4a3081aed0c6ee0e4172.png
[f099030fb1584404a9a3b448a9d05d91.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/b15d06053f584431b748eb14126e98b9.png
[f4aaada8768145b6aa4c88a1bef9118e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/b55d95aa547845cdb06c6c889d824da5.png
[faca9f3611d3463685c2886471ac910e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/83b9f23ea5494572b552dd620d013421.png
[de7ab279edf64ca2a86bbd639a932dc2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/07e0f58485954bcda0338e2a45c16bfb.png
[f806ffbd667c4f358b2531b2254194dc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/9c8f6c01f32d404a9de6299068b8955e.png
[Table]: https://so.csdn.net/so/search?q=Table%E8%A1%A8%E6%A0%BC&spm=1001.2101.3001.7020
[0428e7c3e2c84610a5ec767c32ccf2ee.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/121001a4460342f2a562298af1b65259.png
[26fb0b2b0fa84bac814b2c2aef27db5f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/369c5bc5c0554f98b36e0ac5240c3fe0.png
[9f56dc72d3c447a0bfd75b6dff052eb5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/bc55b833b4bf40cf9c53cae07c9ee7ad.png
[fbaa5e553dc44f6fa24bff2efef98d99.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/cd9b5d2734554d12b862b9ed1dac223a.png
[9e6a90215b4d46f8925a2a26017c1027.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/106ce698f3d346dbb6228aa6be2d152c.png
[826cf25328614f50919fbaf95f5f9aa7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/b7f3509ffa534a57b7b6830e3f663ac9.png
[1d3f37f6487543dc87463d349b9a3ccf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/56dc720ddc4b454891e6a32f1565e517.png
[1d2f47dc720047489e376c58ebc93d38.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/b45961d0fa1d41a3b89b2eca4bf3b742.png
[2f9da02c37d445ea9fa82137550a0927.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/67ef708cbdfc4f33973e9ab42a811d3c.png
[d177e4df33f1422fb12fe17515b17f64.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/a59cf6508e50453abeee698d44e6e5eb.png
[04466945f43a47e2b8982f7563e03501.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/1794cac815cf4ed79bcd307221874753.png
[5c36c68fb8734044a6aeb58e9b949699.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/06/ceeabaae68624fce83976206e917aca2.png