Java打印程序設(shè)計(jì)全攻略

　　前言

　　在我們的實(shí)際工作中，經(jīng)常需要實(shí)現(xiàn)打印功能。但由于歷史原因，Java提供的打印功能一直都比較弱。實(shí)際上最初的jdk根本不支持打印，直到j(luò)dk1.1才引入了很輕量的打印支持。所以，在以前用Java/Applet/JSP/Servlet設(shè)計(jì)的程序中，較復(fù)雜的打印都是通過調(diào)用ActiveX/OCX控件或者VB/VC程序來實(shí)現(xiàn)的，非常麻煩。實(shí)際上，SUN公司也一直致力于Java打印功能的完善，而Java2平臺(tái)則終于有了一個(gè)健壯的打印模式的開端，該打印模式與Java2D圖形包充分結(jié)合成一體。更令人鼓舞的是，新發(fā)布的jdk1.4則提供了一套完整的"Java 打印服務(wù) API" (Java Print Service API)，它對已有的打印功能是積極的補(bǔ)充。利用它，我們可以實(shí)現(xiàn)大部分實(shí)際應(yīng)用需求，包括打印文字、圖形、文件及打印預(yù)覽等等。本文將通過一個(gè)具體的程序?qū)嵗齺碚f明如何設(shè)計(jì)Java打印程序以實(shí)現(xiàn)這些功能，并對不同版本的實(shí)現(xiàn)方法進(jìn)行分析比較,希望大家能從中獲取一些有益的提示。

　　Java中的打印

　　1、Java的打印API

　　Java的打印API主要存在于java.awt.print包中。而jdk1.4新增的類則主要存在于javax.print包及其相應(yīng)的子包javax.print.event和javax.print.attribute中。其中javax.print包中主要包含打印服務(wù)的相關(guān)類，而javax.print.event則包含打印事件的相關(guān)定義，javax.print.attribute則包括打印服務(wù)的可用屬性列表等。

　　2、如何實(shí)現(xiàn)打印

　　要產(chǎn)生一個(gè)打印，至少需要考慮兩條：

　　需要一個(gè)打印服務(wù)對象。這可通過三種方式實(shí)現(xiàn)：在jdk1.4之前的版本，必須要實(shí)現(xiàn)java.awt.print.Printable接口或通過Toolkit.getDefaultToolkit().getPrintJob來獲取打印服務(wù)對象；在jdk1.4中則可以通過javax.print.PrintSerivceLookup來查找定位一個(gè)打印服務(wù)對象。

　　需要開始一個(gè)打印工作。這也有幾種實(shí)現(xiàn)方法：在jdk1.4之前可以通過java.awt.print.PrintJob(jdk1.1提供的，現(xiàn)在已經(jīng)很少用了)調(diào)用print或printAll方法開始打印工作；也可以通過java.awt.print.PrinterJob的printDialog顯示打印對話框，然后通過print方法開始打印；在jdk1.4中則可以通過javax.print.ServiceUI的printDialog顯示打印對話框，然后調(diào)用print方法開始一個(gè)打印工作。

　　3、打印機(jī)對話框

　　3.1 Printable的打印對話框

　　開始打印工作之前，可以通過PrinterJob.printDialog來顯示一個(gè)打印對話框。它給用戶一個(gè)機(jī)會(huì)以選擇應(yīng)該打印的頁碼范圍，并可供用戶改變打印設(shè)置。它是一個(gè)本地對話框。

　　事實(shí)上，當(dāng)從一個(gè)Printable對象進(jìn)行一個(gè)打印工作時(shí)，打印對象并不知道需要打印多少頁。它只是不停地調(diào)用print方法。只要print方法返回Printable.PAGE_EXISTS值，打印工作就不停地產(chǎn)生打印頁，直到print方法返回Printable.NO_SUCH_PAGE時(shí)，打印工作才停止。

　　由于打印工作只有在打印完成后才進(jìn)行準(zhǔn)確的頁數(shù)計(jì)算，所以在對話框上的頁碼范圍是尚未初始化的[1,9999]。我們可以通過構(gòu)建一個(gè)java.awt.print.Book對象傳遞給打印對象；也可以通過指定的格式計(jì)算需要打印的頁數(shù)并傳遞給打印對象，使其準(zhǔn)確地知道要打印多少頁。

　　3.2 ServiceUI的打印對話框
　　
　　與Printable的對話框不同的是，在jdk1.4提供ServiceUI的打印機(jī)對話框的缺省行為已經(jīng)用新的 API 更改了：缺省情況下對話框不顯示。我們必須使用ServiceUI類調(diào)用printDialog方法創(chuàng)建如下所示的打印對話框。

　　 Java打印程序設(shè)計(jì)實(shí)例

　　1、打印文本

　　1.1 應(yīng)用場景

　　假設(shè)我們需要打印一個(gè)窗體的某個(gè)文本編輯域(可能只有幾行，也可能包含多頁)的內(nèi)容，并且每頁最多打印54行，如何實(shí)現(xiàn)呢？

　　1.2 解決方法

　　基本思路如下：首先我們需要實(shí)現(xiàn)Printable接口，然后按照每頁最多54行的格式計(jì)算共需要打印多少頁，當(dāng)打印文本的按鈕被點(diǎn)擊時(shí)，執(zhí)行相應(yīng)的打印動(dòng)作。打印文本的具體操作可通過Graphics2D的drawString方法來實(shí)現(xiàn)。

　　1) 實(shí)現(xiàn)Printable接口


　　/*Graphic指明打印的圖形環(huán)境；PageFormat指明打印頁格式(頁面大小以點(diǎn)為計(jì)量單位，1點(diǎn)為1英寸的1/72，1英寸為25.4毫米。A4紙大致為595×842點(diǎn))；page指明頁號(hào)*/

　　public int print(Graphics g, PageFormat pf, int page) throws PrinterException {
　　Graphics2D g2 = (Graphics2D)g;
　　g2.setPaint(Color.black); //設(shè)置打印顏色為黑色
　　if (page >= PAGES) //當(dāng)打印頁號(hào)大于需要打印的總頁數(shù)時(shí)，打印工作結(jié)束
　　return Printable.NO_SUCH_PAGE;
　　g2.translate(pf.getImageableX(), pf.getImageableY());//轉(zhuǎn)換坐標(biāo)，確定打印邊界
　　drawCurrentPageText(g2, pf, page); //打印當(dāng)前頁文本
　　return Printable.PAGE_EXISTS; //存在打印頁時(shí)，繼續(xù)打印工作
　　}

　　/*打印指定頁號(hào)的具體文本內(nèi)容*/
　　private void drawCurrentPageText(Graphics2D g2, PageFormat pf, int page) {
　　String s = getDrawText(printStr)[page]; //獲取當(dāng)前頁的待打印文本內(nèi)容
　　//獲取默認(rèn)字體及相應(yīng)的尺寸
　　FontRenderContext context = g2.getFontRenderContext();
　　Font f = area.getFont();
　　String drawText;
　　float ascent = 16; //給定字符點(diǎn)陣
　　int k, i = f.getSize(), lines = 0;
　　while(s.length() > 0 && lines < 54) //每頁限定在54行以內(nèi)
　　{
　　k = s.indexOf(' '); //獲取每一個(gè)回車符的位置
　　if (k != -1) //存在回車符
　　{
　　　lines += 1; //計(jì)算行數(shù)
　　　drawText = s.substring(0, k); //獲取每一行文本
　　　g2.drawString(drawText, 0, ascent); //具體打印每一行文本，同時(shí)走紙移位
　　　if (s.substring(k + 1).length() > 0) {
　　　　s = s.substring(k + 1); //截取尚未打印的文本
　　　　ascent += i;
　　　}
　　}
　　else //不存在回車符
　　{
　　　lines += 1; //計(jì)算行數(shù)
　　　drawText = s; //獲取每一行文本
　　　g2.drawString(drawText, 0, ascent); //具體打印每一行文本，同時(shí)走紙移位
　　　s = ""; //文本已結(jié)束
　　}
　　}
　　}

　　/*將打印目標(biāo)文本按頁存放為字符串?dāng)?shù)組*/
　　public String[] getDrawText(String s) {
　　String[] drawText = new String[PAGES]; //根據(jù)頁數(shù)初始化數(shù)組
　　for (int i = 0; i < PAGES; i++)
　　drawText[i] = ""; //數(shù)組元素初始化為空字符串
　　int k, suffix = 0, lines = 0;
　　while (s.length() > 0) {
　　if (lines < 54) //不夠一頁時(shí)
　　{
　　　k = s.indexOf(' ');
　　　if (k != -1) //存在回車符
　　　{
　　　　lines += 1; //行數(shù)累加
　　　　//計(jì)算該頁的具體文本內(nèi)容，存放到相應(yīng)下標(biāo)的數(shù)組元素
　　　　drawText[suffix] = drawText[suffix] + s.substring(0, k + 1);
　　　　if (s.substring(k + 1).length() > 0)
　　　　　s = s.substring(k + 1);
　　　}
　　　else
　　　{
　　　　lines += 1; //行數(shù)累加
　　　　//將文本內(nèi)容存放到相應(yīng)的數(shù)組元素
　　　　drawText[suffix] = drawText[suffix] + s;
　　　　s = "";
　　　}
　　}
　　else //已滿一頁時(shí)
　　{
　　　lines = 0; //行數(shù)統(tǒng)計(jì)清零
　　　suffix++; //數(shù)組下標(biāo)加1
　　}
　　}
　　return drawText;
　　}


　　2) 計(jì)算需要打印的總頁數(shù)


　　public int getPagesCount(String curStr) {
　　int page = 0;
　　int position, count = 0;
　　String str = curStr;
　　while(str.length() > 0) //文本尚未計(jì)算完畢
　　{
　　position = str.indexOf(' '); //計(jì)算回車符的位置
　　count += 1; //統(tǒng)計(jì)行數(shù)
　　if (position != -1)
　　　str = str.substring(position + 1); //截取尚未計(jì)算的文本
　　else
　　　str = ""; //文本已計(jì)算完畢
　　}
　　if (count > 0)
　　page = count / 54 + 1; //以總行數(shù)除以54獲取總頁數(shù)
　　return page; //返回需打印的總頁數(shù)
　　}


　　以jdk1.4以前的版本實(shí)現(xiàn)打印動(dòng)作按鈕監(jiān)聽，并完成具體的打印操作


　　private void printTextAction() {
　　printStr = area.getText().trim(); //獲取需要打印的目標(biāo)文本
　　if (printStr != null && printStr.length() > 0) //當(dāng)打印內(nèi)容不為空時(shí)
　　{
　　PAGES = getPagesCount(printStr); //獲取打印總頁數(shù)
　　PrinterJob myPrtJob = PrinterJob.getPrinterJob(); //獲取默認(rèn)打印作業(yè)
　　PageFormat pageFormat = myPrtJob.defaultPage(); //獲取默認(rèn)打印頁面格式
　　myPrtJob.setPrintable(this, pageFormat); //設(shè)置打印工作
　　if (myPrtJob.printDialog()) //顯示打印對話框
　　{
　　　try {
　　　　myPrtJob.print(); //進(jìn)行每一頁的具體打印操作
　　　}
　　　catch(PrinterException pe) {
　　　　pe.printStackTrace();
　　　}
　　}
　　}
　　else { //如果打印內(nèi)容為空時(shí)，提示用戶打印將取消
　　JOptionPane.showConfirmDialog(null, "Sorry, Printer Job is Empty, Print Cancelled!", "Empty", JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE);
　　}
　　}


　　以jdk1.4新版本提供的API實(shí)現(xiàn)打印動(dòng)作按鈕監(jiān)聽，并完成具體的打印操作


　　private void printText2Action() {
　　printFlag = 0; //打印標(biāo)志清零
　　printStr = area.getText().trim();//獲取需要打印的目標(biāo)文本
　　if (printStr != null && printStr.length() > 0) //當(dāng)打印內(nèi)容不為空時(shí)
　　{
　　PAGES = getPagesCount(printStr); //獲取打印總頁數(shù)
　　//指定打印輸出格式
　　DocFlavor flavor = DocFlavor.SERVICE_FORMATTED.PRINTABLE;
　　//定位默認(rèn)的打印服務(wù)
　　PrintService printService = PrintServiceLookup.lookupDefaultPrintService();
　　//創(chuàng)建打印作業(yè)
　　DocPrintJob job = printService.createPrintJob();
　　//設(shè)置打印屬性
　　PrintRequestAttributeSet pras = new HashPrintRequestAttributeSet();
　　DocAttributeSet das = new HashDocAttributeSet();
　　//指定打印內(nèi)容
　　Doc doc = new SimpleDoc(this, flavor, das);
　　//不顯示打印對話框，直接進(jìn)行打印工作
　　try {
　　　job.print(doc, pras); //進(jìn)行每一頁的具體打印操作
　　}
　　catch(PrintException pe) {
　　　pe.printStackTrace();
　　}
　　}
　　else { //如果打印內(nèi)容為空時(shí)，提示用戶打印將取消
　　JOptionPane.showConfirmDialog(null, "Sorry, Printer Job is Empty, Print Cancelled!", "Empty", JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE);
　　}
　　}


　　 打印預(yù)覽

　　1、應(yīng)用場景

　　大多少商業(yè)應(yīng)用都需要提供打印預(yù)覽機(jī)制，它可以讓我們在屏幕上看到頁面，這樣就不會(huì)因?yàn)椴幌矚g的打印結(jié)果而浪費(fèi)紙張。假設(shè)我們在打印上一節(jié)所說的文本之前，需要先進(jìn)行打印預(yù)覽。那么該怎么實(shí)現(xiàn)呢？ 界面實(shí)現(xiàn)圖示如下：(Next預(yù)覽下一頁，Preview預(yù)覽前一頁，Close則關(guān)閉預(yù)覽)

　　2、解決方法

　　基本思路：雖然Java2平臺(tái)的打印API并不提供標(biāo)準(zhǔn)的打印預(yù)覽對話框，但是自己來進(jìn)行設(shè)計(jì)也并不復(fù)雜。正常情況下，print方法將頁面環(huán)境繪制到一個(gè)打印機(jī)圖形環(huán)境上，從而實(shí)現(xiàn)打印。而事實(shí)上，print方法并不能真正產(chǎn)生打印頁面，它只是將待打印內(nèi)容繪制到圖形環(huán)境上。所以，我們可以忽略掉屏幕圖形環(huán)境，經(jīng)過適當(dāng)?shù)目s放比例，使整個(gè)打印頁容納在一個(gè)屏幕矩形里，從而實(shí)現(xiàn)精確的打印預(yù)覽。

　　在打印預(yù)覽的設(shè)計(jì)實(shí)現(xiàn)中，主要需要解決兩個(gè)問題。

　　第一，如何將打印內(nèi)容按合適的比例繪制到屏幕；

　　第二，如何實(shí)現(xiàn)前后翻頁。

　　下面我給出這兩個(gè)問題的具體實(shí)現(xiàn)方法，完整的實(shí)現(xiàn)請參看附件中的PrintPreviewDialog.java文件。


　　/*將待打印內(nèi)容按比例繪制到屏幕*/
　　public void paintComponent(Graphics g) {
　　super.paintComponent(g);
　　Graphics2D g2 = (Graphics2D)g;
　　PageFormat pf = PrinterJob.getPrinterJob().defaultPage(); //獲取頁面格式
　　double xoff; //在屏幕上頁面初始位置的水平偏移
　　double yoff; //在屏幕上頁面初始位置的垂直偏移
　　double scale; //在屏幕上適合頁面的比例
　　double px = pf.getWidth(); //頁面寬度
　　double py = pf.getHeight(); //頁面高度
　　double sx = getWidth() - 1;
　　double sy = getHeight() - 1;
　　if (px/py < sx/sy) {
　　scale = sy / py; //計(jì)算比例
　　xoff = 0.5 * (sx - scale * px); //水平偏移量
　　yoff = 0;
　　}
　　else {
　　scale = sx / px; //計(jì)算比例
　　xoff = 0;
　　yoff = 0.5 * (sy - scale * py); //垂直偏移量
　　}
　　g2.translate((float)xoff, (float)yoff); //轉(zhuǎn)換坐標(biāo)
　　g2.scale((float)scale, (float)scale);
　　Rectangle2D page = new Rectangle2D.Double(0, 0, px, py); //繪制頁面矩形
　　g2.setPaint(Color.white); //設(shè)置頁面背景為白色
　　g2.fill(page);
　　g2.setPaint(Color.black);//設(shè)置頁面文字為黑色
　　g2.draw(page);
　　try {
　　preview.print(g2, pf, currentPage); //顯示指定的預(yù)覽頁面
　　}
　　catch(PrinterException pe) {
　　g2.draw(new Line2D.Double(0, 0, px, py));
　　g2.draw(new Line2D.Double(0, px, 0, py));
　　}
　　}

　　/*預(yù)覽指定的頁面*/
　　public void viewPage(int pos) {
　　int newPage = currentPage + pos; //指定頁面在實(shí)際的范圍內(nèi)
　　if (0 <= newPage && newPage < preview.getPagesCount(printStr)) {
　　currentPage = newPage; //將指定頁面賦值為當(dāng)前頁
　　repaint();
　　}
　　}


　　這樣，在按下"Next"按鈕時(shí)，只需要調(diào)用canvas.viewPage(1)；而在按下"Preview"按鈕時(shí)，只需要調(diào)用canvas.viewPage(-1)即可實(shí)現(xiàn)預(yù)覽的前后翻頁。

    打印圖形

　　1、應(yīng)用場景

　　在實(shí)際應(yīng)用中，我們還需要打印圖形。譬如，我們有時(shí)需要將一個(gè)Java Applet的完整界面或一個(gè)應(yīng)用程序窗體及其所包含的全部組件都打印出來，又應(yīng)該如何實(shí)現(xiàn)呢？

　　2、解決方法

　　基本思路如下：在Java的Component類及其派生類中都提供了print和printAll方法，只要設(shè)置好屬性就可以直接調(diào)用這兩個(gè)方法，從而實(shí)現(xiàn)對組件及圖形的打印。

　　/*打印指定的窗體及其包含的組件*/
　　private void printFrameAction() {
　　Toolkit kit = Toolkit.getDefaultToolkit(); //獲取工具箱
　　Properties props = new Properties();
　　props.put("awt.print.printer", "durango"); //設(shè)置打印屬性
　　props.put("awt.print.numCopies", "2");
　　if (kit != null) {
　　//獲取工具箱自帶的打印對象
　　PrintJob printJob = kit.getPrintJob(this, "Print Frame", props);
　　if (printJob != null) {
　　　Graphics pg = printJob.getGraphics(); //獲取打印對象的圖形環(huán)境
　　　if (pg != null) {
　　　　try {
　　　　　this.printAll(pg); //打印該窗體及其所有的組件
　　　　}
　　　　finally {
　　　　　pg.dispose(); //注銷圖形環(huán)境
　　　　}
　　　}
　　　printJob.end(); //結(jié)束打印作業(yè)
　　}
　　}
　　}

　　打印文件

　　1、應(yīng)用場景

　　在很多實(shí)際應(yīng)用情況下，我們可能都需要打印用戶指定的某一個(gè)文件。該文件可能是圖形文件，如GIF、JPEG等等；也可能是文本文件，如TXT、Java文件等等；還可能是復(fù)雜的PDF、DOC文件等等。那么對于這樣的打印需求，我們又應(yīng)該如何實(shí)現(xiàn)呢？

　　2、解決方法

　　基本思路：在jdk1.4以前的版本，要實(shí)現(xiàn)這樣的打印功能將非常麻煩和復(fù)雜，甚至是難以想象的。但幸運(yùn)的是，jdk1.4的打印服務(wù)API提供了一整套的打印文件流的類和方法。利用它們，我們可以非常方便快捷地實(shí)現(xiàn)各式各樣不同類型文件的打印功能。下面給出一個(gè)通用的處理方法。

　　/*打印指定的文件*/
　　private void printFileAction() {
　　//構(gòu)造一個(gè)文件選擇器，默認(rèn)為當(dāng)前目錄
　　JFileChooser fileChooser = new JFileChooser(SystemProperties.USER_DIR);
　　int state = fileChooser.showOpenDialog(this); //彈出文件選擇對話框
　　if (state == fileChooser.APPROVE_OPTION) //如果用戶選定了文件
　　{
　　File file = fileChooser.getSelectedFile(); //獲取選擇的文件
　　//構(gòu)建打印請求屬性集
　　PrintRequestAttributeSet pras = new HashPrintRequestAttributeSet();
　　//設(shè)置打印格式，因?yàn)槲创_定文件類型，這里選擇AUTOSENSE
　　DocFlavor flavor = DocFlavor.INPUT_STREAM.AUTOSENSE;
　　//查找所有的可用打印服務(wù)
　　PrintService printService[] = PrintServiceLookup.lookupPrintServices(flavor, pras);
　　//定位默認(rèn)的打印服務(wù)
　　PrintService defaultService = PrintServiceLookup.lookupDefaultPrintService();
　　//顯示打印對話框
　　PrintService service = ServiceUI.printDialog(null, 200, 200, printService, defaultService, flavor, pras);
　　if (service != null) {
　　　try {
　　　　DocPrintJob job = service.createPrintJob(); //創(chuàng)建打印作業(yè)
　　　　FileInputStream fis = new FileInputStream(file); //構(gòu)造待打印的文件流
　　　　DocAttributeSet das = new HashDocAttributeSet();
　　　　Doc doc = new SimpleDoc(fis, flavor, das); //建立打印文件格式
　　　　job.print(doc, pras); //進(jìn)行文件的打印
　　　}
　　　catch(Exception e) {
　　　　e.printStackTrace();
　　　}
　　}
　　}
　　}

　　在上面的示例中，因尚未確定文件的類型，所以將指定文件的打印格式定義為DocFlavor.INPUT_STREAM.AUTOSENSE。事實(shí)上，如果在進(jìn)行打印之前，就已確定地知道文件的格式，如為GIF，就應(yīng)定義為DocFlavor.INPUT_STREAM.GIF ；如為PDF，就應(yīng)該定義為DocFlavor.INPUT_STREAM.PDF；如為純ASCII文件，就可以定義為 DocFlavor.INPUT_STREAM.TEXT_HTML_US_ASCII。等等。

　　jdk1.4的javax.print.DocFlavor提供了極為豐富的文件流類型，你可以根據(jù)具體的應(yīng)用需求進(jìn)行合適的選擇。具體的API參考文檔可見本文的參考資料3。

　　結(jié)束語

　　以上是本人在兩年多J2EE應(yīng)用開發(fā)中，總結(jié)的關(guān)于用Java進(jìn)行打印程序設(shè)計(jì)的一些經(jīng)驗(yàn)，希望能給大家一些啟示和裨益。盡管目前用Java來實(shí)現(xiàn)打印功能與用Microsoft的MFC API相比確實(shí)有更多的麻煩。但jdk1.4的推出，對Java以前較弱的打印功能是一個(gè)極好的補(bǔ)充。相信大家如果能夠很好地理解前文所述的打印程序設(shè)計(jì)實(shí)例，并加以應(yīng)用和拓展，應(yīng)該可以解決目前大部分應(yīng)用的實(shí)際編程問題。而隨著Java的進(jìn)一步發(fā)展和完善，必將更好地充實(shí)其基礎(chǔ)類庫及打印API，相信用Java實(shí)現(xiàn)高級打印功能也將越來越不成為我們這些Java癡迷者頭痛的問題。