【项目管理】Java使用pdfbox调用打印机打印PDF文件

拼搏现实的明天。 2024-03-31 10:35 89阅读 0赞

#### 【项目管理】Java使用pdfbox调用打印机打印PDF文件 ####

*  1.项目前言
 *  2.项目实现
 *  3.关键代码
 *  4.效果演示
 *  5.问题处理
 *   *  5.1 安装对应字体
     *  5.2 修改对应代码

> 系统：Win10  
> Java：1.8.0\_333  
> IDEA：2020.3.4  
> Gitee：[**https://gitee.com/lijinjiang01/Printer**][https_gitee.com_lijinjiang01_Printer]

## 1.项目前言 ##

在工作中，有次收到一位同事给我提的建议，说公司的CS系统，能不能直接调用打印机打印PDF，因为我们的系统之前是将表单导出PDF到本地，然后再打开打印，而他的工作有很大一部分是需要打印表单的，所以为了减轻工作量，向我提了这份需求申请，我先考虑了一下这个需求的实现难度，感觉应该是可以实现的，就答应了下来。

## 2.项目实现 ##

为了实现这个功能，我先去网上查找了一下资料，对比了一下实现难度以及我们当前所处的环境（因为我们公司文件落地加密，所以直接调用打印机打印是不好实现的），我最终选择使用 Apache PDFbox 这个开源项目来实现 PDF 文件格式的打印。

Apache PDFbox 是一个开源的、基于 Java 的、支持 PDF 文档生成的工具库，它可以用于创建新的 PDF 文档，修改现有的 PDF 文档，还可以从 PDF 文档中提取所需的内容。Apache PDFBox 还包含了数个命令行工具。可以说，这个开源的工具库的功能是很强大的，在此，我们只研究打印功能。

Apache PDFbox 的优点：功能强大，代码开源，较完美的解决了 PDF 格式文件的一系列处理，使用方便。

## 3.关键代码 ##

这里我们获取了本地的所有打印机服务，并将系统的默认打印机作为首选项

//获取本地的打印服务，并且设置默认打印机
    private JComboBox<String> selectPrintService() {
        
        defaultPrintService = PrintServiceLookup.lookupDefaultPrintService();//获取默认打印机
        JComboBox<String> comboBox = new JComboBox<>();
        //获得本台电脑连接的所有打印机
        PrintService[] printServices = PrinterJob.lookupPrintServices();
        if (printServices == null || printServices.length == 0) {
        
            comboBox.addItem("获取本地打印机失败，请联系管理员！");
        } else {
        
            for (PrintService printService : printServices) {
        
                String value = printService.getName();
                serviceMap.put(value, printService);//将打印机名称及打印机服务添加到集合
                comboBox.addItem(value);
                //将默认打印机设置为下拉选的默认选择项
                if (defaultPrintService != null && defaultPrintService.getName().equals(value)) {
        
                    comboBox.setSelectedItem(value);
                }
            }
        }
        return comboBox;
    }

//打印功能实现
    public void print(Container parent) {
        
        PDDocument document = null;
        File file;
        try {
        
            file = new File(filepath);
            if (file == null || !file.exists()) {
        
                JOptionPane.showMessageDialog(parent, "要打印的PDF文件不存在！", "警告", JOptionPane.WARNING_MESSAGE);
                return;
            }
            document = PDDocument.load(file);
            PrinterJob printerJob = PrinterJob.getPrinterJob();
            printerJob.setJobName(file.getName());
            printerJob.setPrintService(defaultPrintService);//设置打印机
            //设置纸张及缩放
            PDFPrintable pdfPrintable = new PDFPrintable(document, scaling);
            //设置多页打印
            Book book = new Book();
            PageFormat pageFormat = new PageFormat();
            //设置打印方向
            pageFormat.setOrientation(orientation);//纵向
            Paper paper = getPaper();
            pageFormat.setPaper(paper);
            book.append(pdfPrintable, pageFormat, document.getNumberOfPages());
            printerJob.setPageable(book);
            printerJob.setCopies(copies);//设置打印份数
            //添加打印属性
            HashPrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet();
            attributes.add(sides); //设置单双页
            attributes.add(MediaSizeName.ISO_A4);//默认A4纸打印
            printerJob.print(attributes);
    
        } catch (Exception e) {
        
            e.printStackTrace();
        } finally {
        
            if (document != null) {
        
                try {
        
                    document.close();
                } catch (IOException e) {
        
                    e.printStackTrace();
                }
            }
        }
    }
    
    private Paper getPaper() {
        
        Paper paper = new Paper();
        // 默认为A4纸张，对应像素宽和高分别为 595, 842
        int width = 595;
        int height = 842;
        // 设置边距，单位是像素，10mm边距，对应 28px
        int marginLeft = 12;
        int marginRight = 12;
        int marginTop = 12;
        int marginBottom = 12;
        paper.setSize(width, height);
        // 下面一行代码，解决了打印内容为空的问题
        paper.setImageableArea(marginLeft, marginRight, width - (marginLeft + marginRight), height - (marginTop + marginBottom));
        return paper;
    }

## 4.效果演示 ##

运行之后，会弹出类似这个的界面，简单配置下（这里的参数都是默认的，一般用这些就可以直接打印），点击打印，就会将文件传送到打印机服务的打印队列进行打印  
![在这里插入图片描述][93d8c81f27684c50924ac50d40dc902b.png]  
我这里选择了 Microsoft Print to PDF 测试一下  
![在这里插入图片描述][9c6ce749ad744d1eb43b7762a01ab586.png]  
这里我们发现使用pdfbox打印出来的PDF的字体发生了改变，打印的结果和原PDF不一致  
![在这里插入图片描述][f1eb14867fbd4b72b7b3d7611133c71c.png]

## 5.问题处理 ##

这里我们去控制台看一下为什么会出现这个问题，在这里我们不难发现导致这个问题的原因在于：原PDF中用到了一种 STSong-Light 的字体，而我们系统没有安装这个字体，所以他就自动给我们换了一个字体，难怪变得这么丑了，这里我们给出两种解决办法  
![在这里插入图片描述][2afc3cd98c11461982397762f3621308.png]

### 5.1 安装对应字体 ###

因为程序检测到我们没有安装这种字体，我们只需要将对应字体安装上去，然后重启电脑，应该就能解决这个问题

### 5.2 修改对应代码 ###

因为我们不可能给每个用户加装一个字体，所以我们只能从程序出发

我们去交友网站上找到该项目的源码地址：[https://github.com/apache/pdfbox/tree/trunk/pdfbox][https_github.com_apache_pdfbox_tree_trunk_pdfbox]，本来想用源码的，不过可能版本不同，会报错。

所以我们可以在 pdfbox 的 org.apache.pdfbox.pdmodel.font 路径下找到 FontMapperImpl.class 文件，然后把他的反编译代码复制到我们项目中（记得先创建路径文件夹）![ba2e7c5f6abb47c9a246a83361dca568.png][]  
然后在字体映射集合中添加所缺字体的映射字体（映射的字体选择系统中有的，且和所缺字体近似的字体）就可以了

//添加STSong-Light字体映射
    this.substitutes.put("STSong-Light", Arrays.asList("STSong-Light", "SimSun", "SIMFANG", "STFangsong"));

![在这里插入图片描述][c56cc81216a74ea0984c7eb618b157f4.png]  
然后再重试下，就发现可以正常打印了  
![在这里插入图片描述][1d445a3eaf514ed3908dba9dd74daea5.png]

[https_gitee.com_lijinjiang01_Printer]: https://gitee.com/lijinjiang01/Printer
[93d8c81f27684c50924ac50d40dc902b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/96ab9dc838ea427dac6c6d18b45ddc90.png
[9c6ce749ad744d1eb43b7762a01ab586.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/85c7283f76174bd5a3bc48e7c46999b7.png
[f1eb14867fbd4b72b7b3d7611133c71c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/1b1a47947d7f4829b942ca84573e8b81.png
[2afc3cd98c11461982397762f3621308.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/4dbd8d756b144d18937cfdda4f856dee.png
[https_github.com_apache_pdfbox_tree_trunk_pdfbox]: https://github.com/apache/pdfbox/tree/trunk/pdfbox
[ba2e7c5f6abb47c9a246a83361dca568.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/59cf06877fe94708b55b45e069148ee5.png
[c56cc81216a74ea0984c7eb618b157f4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/b7cbad5b4b4c4236bb2e9ad863f99e0a.png
[1d445a3eaf514ed3908dba9dd74daea5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/2086b933ee274eb08dad8a84cffa6a57.png