EAS套打接口生成PDF文件

一、业务场景

       大部分情况下，套打服务于业务单据的打印，例如在客户端、浏览器打印费用报销单。打印之前需要先选择相应的套打模板或者是使用用户先前设定的默认模板。有些客户场景想要将套打预览的内容生成pdf文件或图片保存在EAS系统或者推送到一些企业内部集成的系统进行统一管理，这个时候我们需要灵活的使用套打相关的接口来实现这个操作。

二、实践思路

      首先，我们要清楚EAS现有的打印实现。EAS在客户端和web端都支持打印，但是二者的原理存在一定的差异。如图所示：

可以得知：

1. 客户端的打印逻辑是完全运行在客户端的本地的。客户端的打印支持打印预览、打印机的直接调用，支持导出pdf，excel两个额外功能。

2. 浏览器的打印逻辑是运行在服务器的，浏览器的打印本质上是EAS后台生成pdf文件，然后调用浏览器本身插件渲染pdf，调用打印机打印是浏览器行为，不是由EAS发起。

因此，客户端和web端打印的数据源实现思路就不一样，如果是客户端打印，数据源由于在客户端的上下文运行，需要采用getRemoteInstance的方法调用服务端来取数,web端的打印由于是在后台Controller层面运行，需要取得web框架的上下文再取数，例如WafContext.getInstance().getContext()。以凭证打印为例，客户端打印的数据源是com.kingdee.eas.fi.gl.VoucherRowSetProvider ，可以通过凭证列表界面代码跟踪：

web打印的数据源是：com.kingdee.eas.fi.gl.web.voucher.controller.VoucherQueryDelegate，可以通过浏览器F12打开开发者工具捕获网络请求参数来跟踪：

两者实现不可复用,两个类所在的jar包的位置也不一样。

因此要实现此功能需要考虑扩展代码运行的环境：

1. 扩展代码写在客户端或者是Controller，则可以完全利用已有的单据打印逻辑来实现，只需要改动一点参数即可实现

2. 扩展代码写在服务端ControllerBean或者是ControllerBeanEx类，有两种方案

   a.则自己实现业务的打印数据源来实现，或者是改造已有数据源

       b.模拟web登录打印

三、详细设计

打印接口类：

客户端和服务端：com.kingdee.bos.ctrl.report.forapp.kdnote.client.KDNoteHelper

web端：com.kingdee.bos.ctrl.report.forapp.kdnote.webserver.KDNoteWebServerHelper

KDNoteWebServerHelper 继承 KDNoteHelper，提供了web上下文的方法覆写

导出pdf方法：

outputPdf(String,Object,OutputStream)

详细方案原理：

四、代码样例

以权限申请单为例，样例中数据写死，可以根据参数来设置

客户端直接生成pdf:   

    /**

     * 客户端打印，直接使用已有数据源

     */

    public static byte[] exportPdfWithProviderForClient(String template,String billId) throws Exception {

        String templatePath = "/EM/SM/PM/PRMREQ/PERREQPRINT.r1-print";

        List ids = new ArrayList<String>();

        ids.add("M25HxqTATrCO1FNahgAx6HtQXsI=");

        com.kingdee.eas.base.permission.client.helper.PermissionReqBillPrintDataProvider  dataProvider

                = new com.kingdee.eas.base.permission.client.helper.PermissionReqBillPrintDataProvider (ids);

        ByteArrayOutputStream out = new ByteArrayOutputStream();

        KDNoteHelper kdNoteHelper = new KDNoteHelper();

        kdNoteHelper.outputPdf(templatePath,dataProvider,out);

        //写到临时目录查看pdf文件是否正确，在EAS客户端安装目录

        String eas_home = System.getProperty("EAS_HOME");

        FileOutputStream fout = new FileOutputStream(eas_home+ File.separator+"test.pdf");

        fout.write(out.toByteArray());

        fout.flush();

        fout.close();

        return out.toByteArray();

    }

服务端生成pdf:

   /**

     * 普通打印下载pdf，ControllerBean已登录,样例权限申请单

     * 因为后台无法使用标准权限申请单的数据源，              com.kingdee.eas.base.permission.client.helper.PermissionReqB