html - 使用 JasperReports 将 html 内容导出为 pdf

Question

如何使用将 HTML 内容导出为 PDF JasperReports，我有一个带有 HTML 类型值的参数，我必须将其导出到 pdf 文件，其中 pdf 必须解析 html 内容

score 10 · Accepted Answer

为了在报告中显示html代码，我们可以使用Jaspersoft 开发的htmlcomponent（我在查看源代码后了解到作者是 Narcis Marcu）。

这个组件有很多限制，不能在任何情况下为任何复杂的 html 页面提供帮助。无论如何，下面是解释如何使用这个组件。

借助iReport 5.6.0可以轻松地将这个组件添加到报表中。在Jaspersoft Studio ( JSS ) 的最新版本中，由于某些原因，该组件已从调色板中删除。

iReport中的Html组件：

使用 JSS

如果您使用的是JSS，没有理由感到不安 - Studio中仍然存在对Html组件的支持。您可以在这样的文件夹中找到htmlcomponent.jar：.Jaspersoft Studio-6.3.1.final\configuration\org.eclipse.osgi\38\0\.cp\lib\

我们可以在JSS中使用通用组件来使用Html组件的所有功能。

为此，我们应该设置至少几个通用组件的属性：

通用类型名称应该是：通用类型命名空间应该是：htmlelement
http://jasperreports.sourceforge.net/jasperreports/html

我们可以使用Html组件的这个属性进行操作：

scaleType - 图像显示类型。支持以下值之一：Clip、FillFrame、RetainShape、RealHeight、RealSize
HorizontalAlign - 水平图像对齐。支持以下值之一：左、中、右
verticalAlign - 垂直图像对齐。支持以下值之一：Top、Middle、Bottom
剪辑溢出
评估时间
评估组

它是JSS ，这个属性可以在组件属性的高级选项卡的帮助下设置：

在iReport中，设置相同的属性要容易得多：

正如我之前提到的，JSS仍然具有htmlcomponent支持。如果您有带有htmlcomponent的jrxml文件，您可以像在iReport中一样查看JSS中的所有属性。

htmlcomponent 组件使用示例

我们可以在JRPdfExporter的帮助下在pdf报告中显示这个简单的html页面。

html页面：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html>
<head>
    <title>Sample of html based report</title>
    <style type="text/css">
        body {
            padding-left: 11em;
            font-family: Georgia, "Times New Roman",
            Times, serif;
            color: purple;
            background-color: #a5d8da
        }

        h1 {
            font-family: Helvetica, Geneva, Arial,
            SunSans-Regular, sans-serif
        }
    </style>
</head>

<body>
<h1>This is a sample of html based report</h1>

<p>Only minimal html features are supported</p>

<p>At least images are supported</p>
<br/><br/>

<img src='file://C:\images\smile.png' alt='Smile' height='100' width='100'>
</body>
</html>

我们将尝试在HTML 组件的包装器（本机组件）和通用组件的帮助下使用htmlcomponent。

html代码将通过报告的参数（htmlCode在示例中）传递

使用原生htmlcomponent组件。

jrxml文件：

<?xml version="1.0" encoding="UTF-8"?>
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="Html component" pageWidth="595" pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20">
    <parameter name="htmlCode" class="java.lang.String"/>
    <title>
        <band height="742">
            <componentElement>
                <reportElement x="0" y="0" width="555" height="742"/>
                <hc:html xmlns:hc="http://jasperreports.sourceforge.net/htmlcomponent" xsi:schemaLocation="http://jasperreports.sourceforge.net/htmlcomponent http://jasperreports.sourceforge.net/xsd/htmlcomponent.xsd" scaleType="RetainShape" horizontalAlign="Left" verticalAlign="Top">
                    <hc:htmlContentExpression><![CDATA[$P{htmlCode}]]></hc:htmlContentExpression>
                </hc:html>
            </componentElement>
        </band>
    </title>
</jasperReport>

使用通用组件。

jrxml文件：

<?xml version="1.0" encoding="UTF-8"?>
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="Generic builds html" pageWidth="595" pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20">
    <parameter name="htmlCode" class="java.lang.String"/>
    <title>
        <band height="742">
            <genericElement>
                <reportElement x="0" y="0" width="555" height="742"/>
                <genericElementType namespace="http://jasperreports.sourceforge.net/jasperreports/html" name="htmlelement"/>
                <genericElementParameter name="htmlContent">
                    <valueExpression><![CDATA[$P{htmlCode}]]></valueExpression>
                </genericElementParameter>
                <genericElementParameter name="scaleType">
                    <valueExpression><![CDATA["RetainShape"]]></valueExpression>
                </genericElementParameter>
                <genericElementParameter name="verticalAlign">
                    <valueExpression><![CDATA["Top"]]></valueExpression>
                </genericElementParameter>
                <genericElementParameter name="horizontalAlign">
                    <valueExpression><![CDATA["Left"]]></valueExpression>
                </genericElementParameter>
            </genericElement>
        </band>
    </title>
</jasperReport>

在这两种情况下，我们都可以使用相同的Java代码：

Map<String, Object> params = new HashMap<>();
params.put("htmlCode", "<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01//EN\">\n" +
        "<html>\n" +
        "<head>\n" +
        "    <title>Sample of html based report</title>\n" +
        "    <style type=\"text/css\">\n" +
        "        body {\n" +
        "            padding-left: 11em;\n" +
        "            font-family: Georgia, \"Times New Roman\",\n" +
        "            Times, serif;\n" +
        "            color: purple;\n" +
        "            background-color: #a5d8da\n" +
        "        }\n" +
        "\n" +
        "        h1 {\n" +
        "            font-family: Helvetica, Geneva, Arial,\n" +
        "            SunSans-Regular, sans-serif\n" +
        "        }\n" +
        "    </style>\n" +
        "</head>\n" +
        "\n" +
        "<body>\n" +
        "<h1>This is a sample of html based report</h1>\n" +
        "\n" +
        "<p>Only minimal html features are supported</p>\n" +
        "\n" +
        "<p>At least images are supported</p>\n" +
        "<br/><br/>\n" +
        "<img src='file:/C:\\images\\smile.png' alt='Smile' height='100' width='100'>\n" +
        "</body>\n" +
        "</html>");
JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, params, new JREmptyDataSource());

对于有效的工作（报告编译），我们应该将htmlcomponent.jar添加到类路径中！

输出结果

两种情况的输出结果将相同：

更多信息：

有关使用通用元素的信息 - JasperReports - 通用元素示例
Petter Friberg 的回答很好：如何使用 htmlcomponent 导出带有嵌入图像（base64、数据 uri）的 HTML 文本？
htmlcomponent组件的源代码和使用示例可以在文件夹下的JasperReports库包中找到jasperreports-6.x\demo\samples\htmlcomponent
另一个示例可以在JasperReports 库包的另一个文件夹中找到 -jasperreports-6.x\demo\samples\genericelement