>> customerDataListStrFun,
String... subTemplateName);
/**
* html转pdf
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @return @return {@link File }
*/
public static File htmlToPdf(String htmlString);
/**
* html转pdf
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @param isInsideGenerateHtml 是否内部生成的Html，HtmlRenderFactoryUtil产生的html为内部生成（做过特殊处理）
* @return @return {@link File }
*/
public static File htmlToPdf(String htmlString, Boolean isInsideGenerateHtml);
/**
* html转pdf
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @return @return {@link File }
*/
public static byte[] htmlToPdfBytes(String htmlString);
/**
* html转pdf
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @param isInsideGenerateHtml 是否内部生成的Html，HtmlRenderFactoryUtil产生的html为内部生成（做过特殊处理）
* @return @return {@link byte[] }
*/
public static byte[] htmlToPdfBytes(String htmlString, Boolean isInsideGenerateHtml);
// ========================================= OfdRenderFactoryUtil =========================================
/**
* 渲染（内部发pdf转ofd）
*
* @param templateName 模板名称
* @param htmlRenderData 填充数据（若dataList为空，则采用druid数据源）
* @param subTemplateName 子模板名称（在jasperReport中，添加相同个数名称为“SUB_REPORT_[0，1，2......]”；Class属性为“net.sf.jasperreports.engine.JasperReport”的Parameters参数）
* @return @return {@link File }
*/
public static File render(String templateName, HtmlRenderData htmlRenderData, String... subTemplateName);
/**
* 渲染（内部发pdf转ofd）
* 自定义数据并渲染为模板
*
* @param templateName 模板名称
* @param htmlRenderData 填充数据（若dataList为空，则采用druid数据源）
* @param customerParamMapStrFun 自定义数据对象转为JSON字符串后的处理
* @param customerDataListStrFun 自定义数据对象转为JSON字符串后的处理
* @param subTemplateName 子模板名称（在jasperReport中，添加相同个数名称为“SUB_REPORT_[0，1，2......]”；Class属性为“net.sf.jasperreports.engine.JasperReport”的Parameters参数）
* @return @return {@link File }
*/
public static File render(String templateName,
HtmlRenderData htmlRenderData,
JasperReportParametersCover> customerParamMapStrFun,
JasperReportParametersCover>> customerDataListStrFun,
String... subTemplateName);
/**
* 渲染（内部发pdf转ofd）
*
* @param templateName 模板名称
* @param htmlRenderData 填充数据（若dataList为空，则采用druid数据源）
* @param subTemplateName 子模板名称（在jasperReport中，添加相同个数名称为“SUB_REPORT_[0，1，2......]”；Class属性为“net.sf.jasperreports.engine.JasperReport”的Parameters参数）
* @return @return {@link byte[] }
*/
public static byte[] render2Bytes(String templateName, HtmlRenderData htmlRenderData, String... subTemplateName);
/**
* 渲染（内部发pdf转ofd）
* 自定义数据并渲染为模板
*
* @param templateName 模板名称
* @param htmlRenderData 填充数据（若dataList为空，则采用druid数据源）
* @param customerParamMapStrFun 自定义数据对象转为JSON字符串后的处理
* @param customerDataListStrFun 自定义数据对象转为JSON字符串后的处理
* @param subTemplateName 子模板名称（在jasperReport中，添加相同个数名称为“SUB_REPORT_[0，1，2......]”；Class属性为“net.sf.jasperreports.engine.JasperReport”的Parameters参数）
* @return @return {@link byte[] }
*/
public static byte[] render2Bytes(String templateName,
HtmlRenderData htmlRenderData,
JasperReportParametersCover> customerParamMapStrFun,
JasperReportParametersCover>> customerDataListStrFun,
String... subTemplateName);
/**
* html转ofd（内部生成html转换为pdf文件，最后再转为ofd文件）
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @return @return {@link File }
*/
public static File htmlToOfd(String htmlString);
/**
* html转ofd（内部生成html转换为pdf文件，最后再转为ofd文件）
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @param isInsideGenerateHtml 是否内部生成的Html，HtmlRenderFactoryUtil产生的html为内部生成（做过特殊处理）
* @return @return {@link File }
*/
public static File htmlToOfd(String htmlString, Boolean isInsideGenerateHtml);
/**
* html转ofd（内部生成html转换为pdf文件，最后再转为ofd文件）
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @param isInsideGenerateHtml 是否内部生成的Html，HtmlRenderFactoryUtil产生的html为内部生成（做过特殊处理）
* @return @return {@link byte[] }
*/
public static byte[] htmlToOfdBytes(String htmlString, Boolean isInsideGenerateHtml);
/**
* html转ofd（内部生成html转换为pdf文件，最后再转为ofd文件）
*
*
* 注：默认只处理宋体
* 页面中字体不能使用中文，需要使用英文名称，而且是大小写敏感的！例如宋体的英文名称是 SimSun(注意不是simsun！，首字母都是大写的)
* 错误写法：font-family:宋体 或者 font-family:simsun
* 正确写法：font-family:SimSun 或者 font-family:SimHei
*
*
* @param htmlString html字符串
* @return @return {@link File }
*/
public static byte[] htmlToOfdBytes(String htmlString);
```
### 安装软件
* [JaspersoftStudio-6.12.2](https://nchc.dl.sourceforge.net/project/jasperstudio/JaspersoftStudio-6.12.2/TIB_js-studiocomm_6.12.2_windows_x86_64.zip)
* [Lodop6.226](http://www.lodop.net/download/Lodop6.226_Clodop4.088.zip)
*注：JaspersoftStudio使用教程请参考根目录doc文件夹下的pdf文档。iReport是JaspersoftStudio的前身，用法几乎一致。*
### JasperReport模板
在`resource`下新建`print-template`打印模板存放目录。
模板文件如下：
Test_A4.jrxml
```xml
<band height="60" splitType="Stretch">
<textField>
<reportElement x="180" y="0" width="200" height="40" uuid="d07e7265-85f8-4e43-8050-5573734fd1e9"/>
<textElement textAlignment="Center" verticalAlignment="Middle">
<font fontName="宋体" size="21"/>
</textElement>
<textFieldExpression><![CDATA[$P{TABLE_TITLE}]]></textFieldExpression>
</textField>
</band>
```
*注：*
*1. 主表中每增加一个子表需要在`Parameters`下新增一个`SUB_REPORT_[0，1，2.....]`的`net.sf.jasperreports.engine.JasperReport`对象参数。*
*2. 子表的数据可以定义在`Parameters`下，参数类型为`Map`或`List`*
### 后端代码
关键代码：
```java
// 模板渲染
String html = HtmlRenderFactoryUtil.render("Test_A4",
new HtmlRenderData(paramMaps, detailList));
System.out.println("==================== JasperReport模板渲染后的Html代码 ====================");
System.out.println(html);
// 打印参数配置
PrintConfig printConfig = new PrintConfig(html);
// 生成打印控件需要的代码
String str = new Printer(printConfig).print();
System.out.println("==================== Lodop打印javascript脚本语句 ====================");
System.out.println(str);
```
举个web调用例子：
```java
/**
* 打印
*
* @param id id 记录ID
* @return {@link String}
*/
@PostMapping("{id}/print")
public Response print(@PathVariable("id") String id) {
Response response = null;
try {
// 获取待渲染的数据
Map dataMap = printData(id);
// 生成html表格
String html = HtmlRenderFactoryUtil.render("hospitality",
new HtmlRenderData(
MapUtil.get(dataMap, "entertainmentExpensesMap", new TypeReference>() {}),
HtmlRenderDataSource.DATA_FROM_COLLECTION_MAP
)
);
// 打印配置，如横向/纵向
// 不设置纸张样式时，默认是 A4 但 长宽全是 0
PrintConfig printConfig = new PrintConfig(html);
response = Response.ok();
// new Printer(printConfig).print() 该语句将生成调用Lodop控件的脚本
response.put("expression", new Printer(printConfig).print());
} catch (Exception e) {
logger.error("======> 打印出错", e);
response = Response.error(e.getMessage());
}
return response;
}
```
详细方法用例：
```java
package cn.nn200433.print;
import cn.hutool.core.date.DateUtil;
import cn.hutool.core.date.TimeInterval;
import cn.hutool.core.lang.Console;
import Printer;
import HtmlRenderData;
import PrintConfig;
import JasperReportParametersCover;
import HtmlRenderFactoryUtil;
import PdfRenderFactoryUtil;
import com.forte.util.utils.MockUtil;
import org.junit.Test;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* 打印测试
*
* @author sjx
* @date 2020年05月18日 0018 15:05:05
*/
public class PrintTest {
/**
* 示例1 - jasperReport导出html使用示例
*
* @throws Exception 异常
*/
@Test
public void demo1() throws Exception {
TimeInterval timer = DateUtil.timer();
Map paramMaps = new HashMap(1);
paramMaps.put("TABLE_TITLE", "测试标题");
List> detailList = new ArrayList>(20);
for (int i = 0; i < 20; i++) {
Map tempMap = new HashMap();
tempMap.put("FIELD_ACCOUNT", MockUtil.title(5));
tempMap.put("FIELD_REAL_NAME", MockUtil.cname());
detailList.add(tempMap);
}
// 模板渲染
String html = HtmlRenderFactoryUtil.render("Test_A4",
new HtmlRenderData(paramMaps, detailList), new JasperReportParametersCover>() {
@Override
public Map cover(Map parameterMap) throws Exception {
return parameterMap;
}
}, new JasperReportParametersCover>>() {
@Override
public List> cover(List> dataList) throws Exception {
return dataList;
}
});
System.out.println("==================== JasperReport模板渲染后的Html代码 ====================");
System.out.println(html);
// 打印参数配置
PrintConfig printConfig = new PrintConfig(html);
// 生成打印控件需要的代码
String str = new Printer(printConfig).print();
System.out.println("==================== Lodop打印javascript脚本语句 ====================");
System.out.println(str);
System.out.println("打印运行耗时 " + timer.intervalSecond() + " 秒");
}
/**
* 示例2 - jasperReport导出pdf示例
*
* @return
*/
@Test
public void demo2() {
TimeInterval timer = DateUtil.timer();
Map paramMaps = new HashMap(1);
paramMaps.put("TABLE_TITLE", "测试•标题");
List> detailList = new ArrayList>(20);
for (int i = 0; i < 20; i++) {
Map tempMap = new HashMap();
tempMap.put("FIELD_ACCOUNT", MockUtil.title(5) + ">");
tempMap.put("FIELD_REAL_NAME", MockUtil.cname());
detailList.add(tempMap);
}
// 模板渲染
File pdfFile = PdfRenderFactoryUtil.render("Test_A4",
new HtmlRenderData(paramMaps, detailList));
Console.log("======> 文件路径 = {}", pdfFile.getAbsolutePath());
System.out.println("打印运行耗时 " + timer.intervalSecond() + " 秒");
}
/**
* 示例3 - html转pdf
*
* @return
*/
@Test
public void demo3() {
// 字体只处理宋体！！！！
String s = "| | | | | | | | | | 测试标题 | | | | 帐号 | 真实姓名 | | | Vtvjo | 席皂斋 | | | Ltoix | 连雪空 | | | Jazsj | 屈速 | | | Tzans | 谷梁成 | | | Eqakb | 寿呈 | | | Izgmw | 萧菜铣 | | | Vizmk | 隆噶 | | | Nhbkv | 宦譬 | | | Hhpzy | 郇欠放 | | | Xyupx | 蔺换稍 | | | Usczd | 祖玩该 | | | Wkfkc | 韶芥写 | | | Qgrvq | 綦毋恋 | | | Dmkmb | 鲁驯 | | | Yzlsc | 籍仿 | | | Nfwkd | 都筒 | | | Nsegj | 莘喇距 | | | Mvnln | 覃知 | | | Tkbkb | 谈酸 | | | Zynak | 边捷 | | |
| |
";
File file = PdfRenderFactoryUtil.htmlToPdf(s, Boolean.FALSE);
Console.log("======> 文件路径1 = {}", file.getAbsolutePath());
// 该 html 的 style中的 font-family: \'宋体\' 经过特殊处理，需注意
String s1 = "| | | | | | | | | | 测试标题 | | | | 帐号 | 真实姓名 | | | Vtvjo | 席皂斋 | | | Ltoix | 连雪空 | | | Jazsj | 屈速 | | | Tzans | 谷梁成 | | | Eqakb | 寿呈 | | | Izgmw | 萧菜铣 | | | Vizmk | 隆噶 | | | Nhbkv | 宦譬 | | | Hhpzy | 郇欠放 | | | Xyupx | 蔺换稍 | | | Usczd | 祖玩该 | | | Wkfkc | 韶芥写 | | | Qgrvq | 綦毋恋 | | | Dmkmb | 鲁驯 | | | Yzlsc | 籍仿 | | | Nfwkd | 都筒 | | | Nsegj | 莘喇距 | | | Mvnln | 覃知 | | | Tkbkb | 谈酸 | | | Zynak | 边捷 | | |
| |
";
File file1 = PdfRenderFactoryUtil.htmlToPdf(s1);
Console.log("======> 文件路径2 = {}", file1.getAbsolutePath());
}
/**
* 示例4 - 使用beetl模板引擎
*
* @throws Exception 异常
*/
@Test
public void demo4() throws Exception {
TimeInterval timer = DateUtil.timer();
Map paramMaps = new HashMap(1);
paramMaps.put("title", "测试标题");
paramMaps.put("date", "2020-01-01 至 2020-02-28");
List> dataList = new ArrayList>(3);
for (int i = 0; i < 5; i++) {
HashMap stringObjectHashMap = new HashMap<>();
stringObjectHashMap.put("orgPosition", "测试" + i);
stringObjectHashMap.put("opinion", "测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试测试");
stringObjectHashMap.put("createByName", "姓名_" + i);
stringObjectHashMap.put("createDateStr", "2020-09-30");
dataList.add(stringObjectHashMap);
}
paramMaps.put("dataList", dataList);
// 模板渲染
String html = HtmlRenderFactoryUtil.render("demo4.html", paramMaps);
System.out.println("==================== beetl模板渲染后的Html代码 ====================");
System.out.println(html);
// 打印参数配置
PrintConfig printConfig = new PrintConfig(html);
// 生成打印控件需要的代码
String str = new Printer(printConfig).print();
System.out.println("==================== Lodop打印javascript脚本语句 ====================");
System.out.println(str);
System.out.println("打印运行耗时 " + timer.intervalSecond() + " 秒");
}
/**
* 示例5 - 套打
*
* @throws Exception 异常
*/
@Test
public void demo5() throws Exception {
TimeInterval timer = DateUtil.timer();
Map paramMaps = new HashMap(1);
paramMaps.put("TABLE_TITLE", "测试标题");
List> detailList = new ArrayList>(20);
for (int i = 0; i < 5; i++) {
Map tempMap = new HashMap();
tempMap.put("FIELD_ACCOUNT", MockUtil.title(5));
tempMap.put("FIELD_REAL_NAME", MockUtil.cname());
detailList.add(tempMap);
}
// 模板渲染
List htmlList = HtmlRenderFactoryUtil.renderList("Test_A4",
new HtmlRenderData(paramMaps, detailList), 4,
new JasperReportParametersCover>() {
@Override
public Map cover(Map paramMap) throws Exception {
paramMap.put("TABLE_TITLE", "测试标题2");
Console.log("======> {}", paramMap);
return paramMap;
}
}, null);
System.out.println("==================== JasperReport模板渲染后的Html代码 ====================");
Console.log(htmlList);
// 打印参数配置
PrintConfig printConfig = new PrintConfig(htmlList);
System.out.println("==================== Lodop打印javascript脚本语句 ====================");
// 生成打印控件需要的代码
String str = new Printer(printConfig).printList();
System.out.println(str);
System.out.println("打印运行耗时 " + timer.intervalSecond() + " 秒");
}
}
```
### 前端代码
引入javascript插件：
```html
```
调用方法：
```javascript
// html超文本内容打印
let htmlContent = $(layero).find('iframe').eq(0).contents().find('#detail').html();
printPreviewHtml(htmlContent);
// 图片打印
html2canvas($(layero).find('iframe').eq(0).contents().find('#detail').get(0)).then(canvas => {
// 截图质量（0-1）
printPreviewImg(canvas.toDataURL("image/png", 1), '5mm', 5, '99%', '50%');
});
// 模板渲染打印
printPreview("${adminPath}/oa/travelReimbursement/" + rowId + "/print", top.layer);
```
提供调用的javascript脚本：
```javascript
/**
* 打印预览，用于后台返回数据打印
*
* @param ajaxUrl ajax请求地址
* @param layerAlert layer弹窗组件对象
*/
function printPreview(ajaxUrl, layerAlert) {
try {
// 检查是否安装lodop
checkIsInstall();
let loadIndex;
$.ajax({
type: "POST",
url: ajaxUrl,
dataType: "json",
beforeSend: function() {
// 开启遮罩
loadIndex = layerAlert.msg('打印模板渲染中...', {
icon: 16,
shade: 0.6,
time: 120000
});
},
success: function(data) {
// 关闭遮罩
layerAlert.close(loadIndex);
if (data.code == 500) {
layerAlert.alert("打印异常：" + data.msg, {icon: 2});
return;
}
// 打印
eval(data.expression);
LODOP.PREVIEW();
}
});
} catch (e) {
console.log(e);
}
}
/**
* 打印预览，用于网页内容打印
*
* @param htmlContent 超文本标记内容
*/
function printPreviewHtml(htmlContent) {
try {
checkIsInstall();
LODOP.PRINT_INIT("网页内容打印");
LODOP.ADD_PRINT_HTM(0, 0, "100%", "100%", htmlContent);
LODOP.PREVIEW();
} catch (e) {
console.log(e);
}
}
/**
* 打印预览，用于图片打印
*
* @param base64ImgStr 图片的base64码
* @param pageTop 上边距
* @param pageLeft 左边距 34px(1px=1/96英寸）
* @param imgWidth 图片宽度（默认百分百），支持数值跟百分比
* @param imgHeight 图片高度（默认百分百），支持数值跟百分比
* @param zooming 1：(可变形)扩展缩放模式；2：按原图比例(不变形)缩放模式；
*/
function printPreviewImg(base64ImgStr, pageTop = '5mm', pageLeft = 34, imgWidth = '100%',
imgHeight = '100%', zooming = 2) {
try {
checkIsInstall();
LODOP.PRINT_INIT("图片打印");
LODOP.ADD_PRINT_IMAGE(pageTop, pageLeft, imgWidth, imgHeight, base64ImgStr);
// 按原图比例(不变形)缩放模式
LODOP.SET_PRINT_STYLEA(0, 'Stretch', zooming);
LODOP.PREVIEW();
} catch (e) {
console.log(e);
}
}
```
## test代码执行结果
