• 跨平台导PDF,结合wkhtmltopdf很顺手


    前言

    好东西要分享,之前一直在使用wkhtmltopdf进行pdf文件的生成,常用的方式就是先安装wkhtmltopdf,然后在程序中用命令的方式将对应的html生成pdf文件,简单而且方便;但重复的编码使得想在wkhtmltopdf基础上进行封装,偶然间发现有小伙伴已经封装的还不错啦,常用的功能都已经实现,源码地址:https://github.com/fpanaccia/Wkhtmltopdf.NetCore。

    作者将其打包成Nuget包(Wkhtmltopdf.NetCore),直接引入使用即可;

    正文

    既然用到了.NetCore,肯定就要考虑到跨平台兼容性,对于wkhtmltopdf之前一直是在Windows上使用,还没有在其他平台尝试;这个包封装的行不行,拉出来遛遛就知道啦,接下来就试试:

    1. 建个API项目,引入包和兼容对应平台的wkhtmltopdf执行文件

    image-20210120162314648

    注: 默认依赖的wkhtmltopdf执行文件需要存放在Rotativa目录下,可以自定义名称,如果自定义,需要再注册服务时指定对应的文件名;这里的wkhtmltopdf已经根据不同平台进行编译打包了,无需安装,这些文件在源码那就有;

    2.创建PDFTestController控制器,添加如下接口进行测试

    首先把生成pdf的服务注入进来,后续直接使用就可以啦:

    image-20210120162846169

    接下来就开始写接口啦,这里只是测试,代码冗余没有考虑,在实际项目中小伙伴可以根据自己需求进行封装;

    • ExportPDFByHtml 接口,用html直接生成pdf文件,但这里没有保存,以文件流的形式访问,通过浏览器查看文件,可以自行下载;html模板在实际开发过程中可以单独用文件存储;

      image-20210120163444523

    • SavePDFByHtml接口,直接保存文件,文件名可以根据需要进行自定义;

      image-20210120163838699

    • TestMarginAndPageSize接口,设置Margin和PageSize参数,其他参数也可以设置;

      image-20210120164237413

      ConvertOptions默认封装了以下属性,小伙伴也可以自定义扩展,只要继承IConvertOptions即可,这里就不演示的,因为官方有对应的案例,下伙伴下去搞搞,wkhtmltopdf的参数挺多的,都可以进行封装使用。

      image-20210120170024098

    • ExportByRazorView使用Razor视图的方式进行pdf文件生成,此库已经支持cshtml文件的读取

      image-20210120164613249

      根据指定视图生成对应的pdf效果,如下:

      image-20210120164735123

    • ExportByRazorViewData数据动态绑定,既然支持视图,那就应该支持Razor语法,一般常用的就是数据绑定了,上面是静态的,接下来来个动态绑定的。

      image-20210120165238787

      根据指定视图生成对应的pdf效果,如下:

      image-20210120165449173

      如上基本的使用演示就说那么多,使用还是很简单,小伙伴后续可以根据自己的需要进行相关扩展;当然还有其他功能,比如设置页眉/页脚等,作者提供有对应的案例;这里不说那么多,不然又是长文。

    3. 小伙伴用的时候可能会遇到的问题

    • 在开发调试运行项目时,会报找不到wkhtmltopdf文件,那是因为运行时的确找不到对应的文件,将对应Rotativa下的文件设置为始终复制即可:

      image-20210120170946016

    • 在Windows下怎么玩都没问题啦,开始发布到Linux(我用的centos 7),我擦,莫名其妙的错。

      image-20210120171410682

      看见这个错我懵的,一顿搜索猛如虎,还是没找到答案;冷静下来,重新捋捋,原来是自己在犯傻;

      两个问题需要解决,1.上传到Linux下的wkhtmltopdf没有给执行权限;2.可能环境缺少对应的依赖库;

      设置可执行权限

      在Linux环境下,可以通过ll命令查看权限,刚开始是没有权限的,只需要执行chmod 777 wkhtmltopdf 命令,执行权限就有了,如下图中红框中的x就是可执行权限;

      image-20210120171951473

      安装缺少的依赖库

      可执行权限开启之后,别急着去访问页面,这样可能还是错误。因为可能缺少依赖库,那咋知道缺少呢,我是直接执行wkhtmltopdf,执行成功就没啥,不成功就会报缺少相关依赖,然后直接安装就行啦;执行./wkhtmltopdf https://www.baidu.com ./test.pdf试试就知道啦,因为wkhtmltopdf本身是可以单独运行的,并不依赖我们写的程序。

    • 当执行成功之后,然后开始访问接口导出功能,如果不出意外,遇到中文就产生乱码啦,那是因为Linux环境下缺少相关的字体文件,将对应的字体文件拷贝到Linux上即可,字体我找好了,下载地址如下:

      链接: https://pan.baidu.com/s/1jikC0DUkpEzpXL5ysjEQPA 提取码: tn4j

      将下载下来的字体解压,然后拷贝到Linux下的 /usr/share/fonts目录下即可

    image-20210120173348468

    最后这样应该就没啥问题啦,剩下的就交给小伙伴自己摸索搞实践吧;

    ​此文源码地址:https://github.com/zyq025/DotNetCoreStudyDemo

    ​wkhtmltopdf官网地址​:https://wkhtmltopdf.org/

    总结

    使用还是很简单的,常规的需求没啥问题,如果需要功能定制化,小伙伴可以参考源码,自己封装一个(封装思路不难的); 如果小伙伴有比较好的导出库,免费开源的那种,一起分享出来玩玩。

    一个被程序搞丑的帅小伙,关注"Code综艺圈",识别关注跟我一起学~~~

  • 相关阅读:
    C#:String.Format数字格式化输出
    System.BadImageFormatException : 未能加载文件或程序集“Medici.PaymentRecover, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null”或它的某一个依赖项。试图加载格式不正确的程序。
    How to debug windows service
    中文字符utf-8编码原则
    获取当前文件的绝对路径
    finfo_file
    usort 函数
    snmp 简单网管协议
    $this
    prinft he sprintf
  • 原文地址:https://www.cnblogs.com/zoe-zyq/p/14311462.html
Copyright © 2020-2023  润新知