JasperReport JSON datasource 快速上

2019-11-19  本文已影响0人  竹鼠不要中暑

JasperReport库是世界上最流行的开源报告引擎。它完全用Java编写，可以使用任何数据源的数据生成像素级的完美文档。然后，可以以各种格式（包括HTML、PDF、Excel、OpenOffice和Word）查看、打印或导出这些文档。

关于Jaspersoft Studio的安装可以参考我们一位同事的文章JasperReport 中踩过的坑
以及官方文档，安装社区版即可。
Jasper的页面设计分为9个Bands。关于Bands的基本介绍请阅读官方文档：Understanding Bands
。
本文主要记录下我们使用JSON格式的数据创建JasperRepor时遇到的一些坑和经验。

json data adapter

创建jasper report时需要选择data source



可选的数据链接有csv文件，jdbc连接，java beans，json等等



json数据方便前端开发快速开始，官方文档中又无详细介绍，因此本文以json为例，创建一个jasper report.

数据： valuation-list-data.json

{
    "valuationOrder": {
        "company": {
            "nameCN": "珠海仁孚南星",
            "nameSuffix": "汽车销售服务有限公司",
            "nameEn": "Zhuhai Zungfu NanXing Co.,Ltd",
            "address": "珠海市香洲区南屏科技园西路1号华科汽车城内",
            "postCode": "519000",
            "phone": "+86-756-8520011",
            "fax": "+86-756-8520011"
        },
        "customer": {
            "name": "王圆圆",
            "gender": "女士"
        },
        "id": "39524395243952",
        "operator": "parts manager",
        "printDatetime": "2010/04/11 14:09:45",
        "totalPrice": 1111111111165.69,
        "lineItems": [
            {
                "id": "2",
                "stock": "y",
                "name": "2010087/气缸盖密封",
                "identify": "原厂G",
                "quantity": 1.00,
                "unitPrice": 70.00,
                "discount": 0.71556,
                "salePrice": 9999999.99
            }
         ]
}

elements

jaspersoft studion提供了一些常用的elements，如可插入变量的text field和静态文本static filed. image, line, list, chart, tabl， page number等等。frame类似div，可将elements在bands内分组。



我们可以在三种模式下操作元素：

design

design模式下可以直接拖拽元素进行设计布局，在右下角可以对元素进行定位，设置大小，颜色，border, padding等操作。


source

source模式下可以利用代码编辑、更改元素。


design

design模式预览report，查看元素渲染。

text field

当变量的长度未知时，勾选上stretch with overflow选项， text filed的高度会随文本的长度而相应增高。


当需要在一个text filed内对文本使用不用的样式时，可以将style标签
写进text field，如： 
<textField>
    <reportElement x="314" y="133" width="100" height="30" uuid="f1bebe59-b953-4449-bdde-6bbc70fc89d1"/>
    <textFieldExpression><![CDATA["<style size='14' >" + $F{customer.name} + "</style>  <style size='10' >" + $F{customer.gender} + "</style>"]]></textFieldExpression>
</textField>

对customer.name和customer.gender采用不同的字号。
此时，text field的Markup需为styled.

customer font

当我们要引入jaspersoft studio未提供的字体时，可以通过如下步骤实现：
Jaspersoft Studio -> Preferences -> Jaspersoft Studio -> fonts，选择要导入的字体的路径


添加成功后apply，导入的字体即可使用。
注意：导入的customer字体位于font下拉列表的最前面！

当我们要将jasper reposrt导出为pdf时，可能会出现customer font导致的错误，因为pdf格式有自己的font set。将customer font添加至pdf font，可解决此问题。

table

对于valuationOrder.lineItems这类的数组数据，常见的需求是通过table来展示。
我们可以使用 columnHeader, detail, columnFooter等bands组合创建table，eg: create a new report，也可以使用jaspersoft studio提供的table元素。
以下为table元素的添加步骤：

((net.sf.jasperreports.engine.data.JsonDataSource)$P{REPORT_DATA_SOURCE}).subDataSource("lineItems")

其中lineItems为json中数组的key，与dataset的名字无关。

为了使表格更美观，我们需要给表格添加样式。除了在创建table时的layout中可以添加样式，还可以在design 模式下双击表格，进入table，左下角可以看到table的结构，选择table中的元素，编辑其样式。


当然也可以在source 中直接编辑table代码。

参考链接

  1. https://www.jianshu.com/p/b46b158a8289
  2. https://community.jaspersoft.com/documentation/tibco-jaspersoft-studio-user-guide/v630/creating-new-report#jss-user-basicreport_293982575_1024061
  3. https://community.jaspersoft.com/documentation/tibco-jaspersoft-studio-user-guide/v720/design-tab-3
  4. https://community.jaspersoft.com/documentation/tibco-jaspersoft-studio-user-guide/v720/working-font-extensions-0
  5. http://jasperreports.sourceforge.net/sample.reference/jsondatasource/index.html
  6. https://stackoverflow.com/questions/42821983/display-json-array-in-table-on-jasper-report
  7. https://stackoverflow.com/questions/42821983/display-json-array-in-table-on-jasper-report
上一篇下一篇

猜你喜欢

热点阅读