JavaPrintService_Java打印API用户手册
- 格式:docx
- 大小:84.98 KB
- 文档页数:47
目录第一章介绍Java平台打印的历史JDK 1.3JDK 1.2JDK 1.1Java Print Service API能做什么Java Print Service 构架javax.print包发现打印服务指定打印数据格式创建打印工作javax.print.event包应用程序如何使用JPS一个基本的例子第二章属性属性的类别和值属性角色属性集如何指定属性标准属性OrientationRequestedCopiesMediaMediaSizeMediaPrintableAreaDestinationSheetCollateSidesFidelity使用JPS属性第三章指定文档类型用户格式打印数据预定义数据格式的MIME类型文本数据页面描述语言文档图像数据自适应打印数据表示类字符编码的重要性服务格式打印数据怎样使用DocFlavor第四章打印及流化文档比较StreamPrintService与PrintService定位服务发现打印服务发现流打印服务获得一个打印工作创建DOC注册事件打印服务事件打印工作事件PrintJobAttributeListenerPrintJobListener提交打印工作向打印机提交打印工作向流提交打印工作打印服务提供商第五章打印及流化2D图像使用打印工作打印或流化图像打印2D图像流化2D图像使用服务格式数据打印服务格式数据流化服务格式打印数据示例:PrintPS.java示例:PrintGIFtoStream.java示例:Print2DPrinterJob.java示例:Print2DGraphics.java示例:Print2DtoStream.java示例:PrintGIF.javaJava Print Service 词汇表第一章介绍Java Print Service (JPS)是一个Java打印API,设计此API是为了支持在所有Java 平台上的打印工作——包括微空间平台,并且支持现有的API。
Java高级编程:打印--学习如何使用打印服务API摘要在这篇文章里,来自Pro Java Programming(Apress,June2005)专家Brett Spell解释了如何一步一步的定位打印设备,创建打印工程,创建一个Doc文档接口的实例来描述你想要打印的数据并且初始化打印。
(4500字,2005年7月25日)Java自从问世以来在各方面发展迅速,但是一直以来,打印输出是java最弱的方面。
事实上,java1.0不支持任何打印功能。
Java1.1在java.awt包里包含了一个叫做PrintJob的类,但是这个类提供的打印功能十分粗糙和不可靠。
当java1.2问世,它围绕PrinterJob设计了一个完整独立的打印机制(叫做java2D printing API),并且在java.awt.print包里定义了一些新的类和接口。
这些使得基于PrintJob打印机制(就是AWT printing)基本荒废,虽然PrintJob 从未被抨击而且至少在这篇文章里仍然是一个提供技术的类。
在J2SE1.3里当PrintJob的功能扩展到可以通过在java.awt包里的JobAttributes和PageAttributes两个类设定工程和页面的属性时发生了一些额外的改变。
随着J2SE1.3的发布,打印功能相应的得到了完善;但是在混合使用这两种完全不同的打印机制的时候仍然存在一些问题。
比如,这两种机制使用java.awt.Graphics这个类的一个接口来展现打印内容,意味着所有要打印的东西都必须用一张图片表示。
另外,完善的PrintJob提供了很有限的工程相关属性的设置;这两种机制都没有办法通过程序来选择目标打印机。
Java打印最大的改变来自于J2SE的发布带来的Java打印服务API。
这个第三代Java打印支持接口突破了先前提到的使用javax.print包的PrintService和DocPrintJob接口的局限性。
java print用法==========Java Print是一个Java平台提供的打印API,它提供了多种方式来处理打印任务。
在本文档中,我们将介绍Java Print API的主要用法和功能。
一、打印服务------Java Print API需要一个打印服务来执行打印任务。
打印服务可以是本地打印机,也可以是远程打印机。
要使用Java Print API,首先需要设置一个打印服务。
### 1. 获取打印服务可以使用`PrintServiceLookup`类来获取本地打印服务列表。
以下是一个示例代码:```javaPrintServiceLookup lookup =PrintServiceLookup.lookupPrintServices(null);```这将返回一个`PrintService[]`数组,其中包含了本地可用的打印服务列表。
### 2. 选择打印服务可以根据需要选择一个特定的打印服务来执行打印任务。
可以使用`PrintService`类的构造函数来创建一个打印服务对象,并指定其名称或标识符。
以下是一个示例代码:```javaPrintService printService =PrintServiceLookup.lookupDefaultPrintService();```这将返回默认的打印服务对象。
二、打印任务------Java Print API提供了多种方式来创建和执行打印任务。
以下是一些常用的打印任务类型:### 1. 文本打印任务可以使用`PrinterJob`类创建一个文本打印任务,并指定要打印的文本内容。
以下是一个示例代码:```javaPrinterJob job = PrinterJob.getPrinterJob();job.setPrintable(new Printable() {public int print(Graphics graphics, PageFormat pageFormat, int pageIndex) throws PrinterException {if (pageIndex > 0) {return NO_SUCH_PAGE; // Skip this page if it's not the first page}String text = "Hello, world!"; // The text to be printedgraphics.drawString(text, 100, 100); // Position the text at (100, 100) on the pagereturn PAGE_EXISTS; // Return success if this page exists, indicating that more pages may follow.}});job.print(); // Execute the print job```### 2. 图像打印任务可以使用`Graphics2D`对象绘制图像,并将其作为打印任务的内容。
⽤JAVA实现打印功能⽤java实现打印,java.awt中提供了⼀些打印的API,要实现打印,⾸先要获得打印对象,然后继承Printable实现接⼝⽅法print,以便打印机进⾏打印,最后⽤Graphics2D直接输出直接输出。
下⾯的例⼦实现了打印字符串,线(包括虚线)和打印图⽚。
⽽且通过Paper的setImageableArea可以设置打印的区域和边距,让开发者随意的设置打印的位置。
package .gao;import java.awt.Graphics;import java.awt.print.Book;import java.awt.print.PageFormat;import java.awt.print.Paper;import java.awt.print.Printable;import java.awt.print.PrinterException;import java.awt.print.PrinterJob;import java.awt.*;public class PrintTest implements Printable{/*** @param Graphic指明打印的图形环境* @param PageFormat指明打印页格式(页⾯⼤⼩以点为计量单位,1点为1英才的1/72,1英⼨为25.4毫⽶。
A4纸⼤致为595×842点)* @param pageIndex指明页号**/public int print(Graphics gra, PageFormat pf, int pageIndex) throws PrinterException {System.out.println("pageIndex="+pageIndex);Component c = null;//print stringString str = "中华民族是勤劳、勇敢和富有智慧的伟⼤民族。
java实现打印功能的⼀些APIjava实现打印功能的⼀些类主要类与接⼝位置(包): (1)java.awt.print (2)(JDK1.4新增)。
其中 a). java.print包中主要包含打印服务的相关类; b). 其⼦包javax.print.event则包含打印事件的相关定义; c). 其⼦包javax.print.attribute则包括打印服务的可⽤属性列表等;主要类与接⼝: 1.PrintJob 2.PageFormat 3.Page1.java.awt.print1.1 PrintJob实现打印功能的核⼼类1.1.1 getPrintJob()作⽤:返回默认打印机。
如果没有打印机,则仍返回⼀个PrintJob对象,但是getPrintService()返回null。
throws:SecurityException1.2 PageFormat设置打印的纸的⼤⼩与⽅向2.javax.print2.1 PrintService 接⼝ PrintService 是 DocPrintJob 的⼯⼚。
PrintService 描述了打印机的功能,并可查询它来了解打印机⽀持的属性2.2 DocFlavor 类 DocFlavor 封装了⼀个提供给 DocPrintJob 打印数据的格式的对象。
2.3 PrintServiceLookup 此类为特定类型的 PrintService提供查找服务3.javax.print.attribute4.javax.print.attribute.standard4.1 Copies打印副本的数量5.javax.print.event6.涉及到的属性(Attribute)实现类 每⼀个AttributeSet⼦接⼝都有⼀个相应Attribute⼦接⼝和继承⼦类。
当添加⼀个属性时,继承的⼦类试图把Attribute作为参数给相应的⼦接⼝,这样来确保只有当前适当的属性会成功添加 注:打印属性较多,查找时可以从DocAttribute, PrintRequestAttribute, PrintJobAttribute这三个接⼝的实现类⼊⼿。
Java 打印事务BufferedWriter和PrintWriter都可以写入数据,但BufferedWriter没有相关的格式化的方法,而PrintWriter可以在写入同时对写入的数据进行格式化。
JAVA屏幕大小获取方式01.Dimension scrSize=Toolkit.getDefaultToolkit().getScreenSize();此语句可取得屏幕实际大小。
如屏幕分辨率是1024*768时,scrSize.width的值为1024,scrSize.height的值为768。
02.InsetsscrInsets=Toolkit.getDefaultToolkit().getScreenInsets(GraphicsEnvironment.getLocalGraphicsEnvironment() .getDefaultScreenDevice().getDefaultConfiguration());此语句用于取得屏幕已占用范围,如任务栏。
scrInsets对象的left、right、top、bottom的值分别就是屏幕四边已占用的大小。
int w = this.getContext().getResources().getDisplayMetrics().heightPixels;int h = this.getContext().getResources().getDisplayMetrics().widthPixels;关于JAVA的打印机设定1、需要一个打印服务对象。
这可通过三种方式实现:在jdk1.4之前的版本,必须要实现java.awt.print.Printable接口或通过Toolkit.getDefaultToolkit().getPrintJob来获取打印服务对象;在jdk1.4中则还可以通过javax.print.PrintSerivceLookup来查找定位一个打印服务对象。
Java打印程序设计SUN公司一直致力于Java打印功能的完善,而Java2平台则终于有了一个健壮的打印模式的开端,该打印模式与Java2D图形包充分结合成一体。
更令人鼓舞的是,新发布的jdk1.4则提供了一套完整的“Java打印服务API”(Java Print Service API),它对已有的打印功能是积极的补充。
利用它,我们可以实现大部分实际应用需求,包括打印文字、图形、文件及打印预览等等。
本文将通过一个具体的程序实例来说明如何设计Java打印程序以实现这些功能,并对不同版本的实现方法进行分析比较。
希望大家能从中获取一些有益的提示。
前言在我们的实际工作中,经常需要实现打印功能。
但由于历史原因,Java提供的打印功能一直都比较弱。
实际上最初的jdk根本不支持打印,直到jdk1.1才引入了很轻量的打印支持。
所以,在以前用Java/Applet/JSP/Servlet设计的程序中,较复杂的打印都是通过调用ActiveX/OCX控件或者VB/VC程序来实现的,非常麻烦。
实际上,SUN公司也一直致力于Java打印功能的完善,而Java2平台则终于有了一个健壮的打印模式的开端,该打印模式与Java2D图形包充分结合成一体。
更令人鼓舞的是,新发布的jdk1.4则提供了一套完整的"Java 打印服务API" (Java Print Service API),它对已有的打印功能是积极的补充。
利用它,我们可以实现大部分实际应用需求,包括打印文字、图形、文件及打印预览等等。
本文将通过一个具体的程序实例来说明如何设计Java打印程序以实现这些功能,并对不同版本的实现方法进行分析比较。
希望大家能从中获取一些有益的提示。
Java中的打印2.1 Java的打印APIJava的打印API主要存在于java.awt.print包中。
而jdk1.4新增的类则主要存在于javax.print包及其相应的子包javax.print.event和javax.print.attribute中。
java实现打印功能Java是一门具有强大打印功能的编程语言,它提供了多种打印方式和工具,可以满足不同场景的需求。
首先,Java提供了标准输出流System.out,它是Java程序默认的打印输出流。
我们可以使用System.out.println()方法打印字符串、数值、变量等内容到控制台。
例如:```System.out.println("Hello, World!");```这段代码会在控制台输出"Hello, World!"。
除了System.out,Java还提供了PrintStream类和PrintWriter类,它们是更通用、功能更强大的打印输出流。
PrintStream类位于java.io包中,可以向不同输出设备打印文本。
我们可以使用PrintStream的println()方法打印内容到指定输出流,例如:```PrintStream ps = new PrintStream("output.txt");ps.println("Hello, World!");```这段代码会将"Hello, World!"打印到名为output.txt的文件中。
PrintWriter类也位于java.io包中,提供了更多的打印选项和功能。
与PrintStream类似,我们可以使用PrintWriter的println()方法进行打印,例如:```PrintWriter pw = new PrintWriter(System.out);pw.println("Hello, World!");```这段代码会将"Hello, World!"打印到控制台。
除了基本的打印功能,Java还提供了其他高级的打印库和工具,例如Java打印服务API(Java Print Service API),它允许我们通过Java程序对打印机进行操作,实现打印PDF、图片、文本等文件类型。
Java实现打印功能用java实现打印,java.awt中提供了一些打印的API,要实现打印,首先要获得打印对象,然后继承Printable实现接口方法print,以便打印机进行打印,最后用用Graphics2D直接输出直接输出。
下面代码实现了简单的打印功能:import java.awt.BasicStroke;import java.awt.Color;import ponent;import java.awt.Font;import java.awt.Graphics;import java.awt.Graphics2D;import java.awt.Image;import java.awt.Toolkit;import java.awt.RenderingHints;import java.awt.font.FontRenderContext;import java.awt.font.LineBreakMeasurer;import java.awt.font.TextAttribute;import java.awt.font.TextLayout;import java.awt.geom.Point2D;import java.awt.image.BufferedImage;import java.awt.print.Book;import java.awt.print.PageFormat;import java.awt.print.Paper;import java.awt.print.Printable;import java.awt.print.PrinterException;import java.awt.print.PrinterJob;import java.text.AttributedString;import javax.swing.JApplet;public class PrintTest implements Printable{/*** @param Graphic指明打印的图形环境* @param PageFormat指明打印页格式(页面大小以点为计量单位,1点为1英才的1/72,1英寸为25.4毫米。
Java实现打印功能⽤java实现打印,java.awt中提供了⼀些打印的API,要实现打印,⾸先要获得打印对象,然后继承Printable实现接⼝⽅法print,以便打印机进⾏打印,最后⽤Graphics2D直接输出直接输出。
下⾯的例⼦实现了打印字符串,线(包括虚线)和打印图⽚。
⽽且通过Paper的setImageableArea可以设置打印的区域和边距,让开发者随意的设置打印的位置。
package .gao;import java.awt.Graphics;import java.awt.print.Book;import java.awt.print.PageFormat;import java.awt.print.Paper;import java.awt.print.Printable;import java.awt.print.PrinterException;import java.awt.print.PrinterJob;import java.awt.*;public class PrintTest implements Printable{/*** @param Graphic指明打印的图形环境* @param PageFormat指明打印页格式(页⾯⼤⼩以点为计量单位,1点为1英才的1/72,1英⼨为25.4毫⽶。
A4纸⼤致为595×842点)* @param pageIndex指明页号**/public int print(Graphics gra, PageFormat pf, int pageIndex) throws PrinterException {System.out.println("pageIndex="+pageIndex);Component c = null;//print stringString str = "中华民族是勤劳、勇敢和富有智慧的伟⼤民族。
目录第一章介绍Java平台打印的历史JDK 1.3JDK 1.2JDK 1.1Java Print Service API能做什么Java Print Service 构架javax.print包发现打印服务指定打印数据格式创建打印工作javax.print.event包应用程序如何使用JPS一个基本的例子第二章属性属性的类别和值属性角色属性集如何指定属性标准属性OrientationRequestedCopiesMediaMediaSizeMediaPrintableAreaDestinationSheetCollateSidesFidelity使用JPS属性第三章指定文档类型用户格式打印数据预定义数据格式的MIME类型文本数据页面描述语言文档图像数据自适应打印数据表示类字符编码的重要性服务格式打印数据怎样使用DocFlavor第四章打印及流化文档比较StreamPrintService与PrintService定位服务发现打印服务发现流打印服务获得一个打印工作创建DOC注册事件打印服务事件打印工作事件PrintJobAttributeListenerPrintJobListener提交打印工作向打印机提交打印工作向流提交打印工作打印服务提供商第五章打印及流化2D图像使用打印工作打印或流化图像打印2D图像流化2D图像使用服务格式数据打印服务格式数据流化服务格式打印数据示例:PrintPS.java示例:PrintGIFtoStream.java示例:Print2DPrinterJob.java示例:Print2DGraphics.java示例:Print2DtoStream.java示例:PrintGIF.javaJava Print Service 词汇表第一章介绍Java Print Service (JPS)是一个Java打印API,设计此API是为了支持在所有Java 平台上的打印工作——包括微空间平台,并且支持现有的API。
这个统一的打印API包括了IETF规范RFC 2911中Internet Printing Protocol (IPP) 1.1 所指定的标准属性以及在此基础上的可扩展的打印属性。
通过这些属性,客户端和服务器端应用程序就能够发现并选定具有完成属性设置所指定的功能的打印机。
除了API中包含的StreamPrintServece,它还允许应用程序将打印数据转码为不同的格式,第三方也可以通过Service Provider Interface (SPI)动态安装他们自己的打印服务。
Java平台打印的历史JDK 1.3为了使用户的应用程序能够指定打印工作的参数和页面属性,JDK 1.3向AWT 引入了JobAttributes和PageAttributes类。
两个API支持基本的页面绘制,作为打印子系统的一部分,它会表示和格式化一个页面。
虽然用户可以从打印对话框中选择打印机并使用JobAttributes和PageAttribtes来设定打印属性,但无论是AWT还是Java 2D打印API都不支持基于打印功能寻找打印机,而这对于任何一个打印系统都是必不可少的组成部分。
要了解更多关于Java平台打印的历史请参看Printing Help for Java Developers。
JDK 1.2JDK 1.2为Java平台添加了java.awt.print包,它允许应用程序打印所有的Java 2D图像,包括2D图表、文本和图片。
JDK 1.1Java Development Kit版本1.1首次为Java平台引入了对基本打印功能的支持。
JDK 1.1打印API为开发者提供了一个基本的框架用于从客户应用程序中打印用户接口上下文。
JDK 1.1打印API,也叫做AWT Printing API,是围绕java.awt.PrintJob 类来设计的,它封装了一个打印请求。
PrintJob类创建一个Graphics的子类,它实现了对页面的渲染调用和绘制。
Java Print Service API能做什么Java Print Service API解决了当前Java Print API所不具备的关于客户端以及服务器端应用程序中常见的打印需求,统一和扩展了Java平台的打印能力。
除了支持现有的Java 2D打印功能之外,Java Print Service还新增了许多新特性,包括:·客户端和服务器端应用程序都可以自主寻找、选择打印设备,并指定打印工作的各种属性。
这样,JPS就提供了打印子系统中一直缺失的部分:可编程的打印设备搜索。
·标准IPP属性的实现被作为一级类对象包含在了JPS API中。
·应用程序可以扩展包括在JPS API中的属性。
·第三方可以通过Service Provider Interface接口添加自己的打印服务。
Java Print Service 构架Java print service API 包含四个包,分别是:javax.printjavax.print.attributejavax.print.attribute.standardjavax.print.eventjavax.print包javax.print包是API的主包,其中包含的类和接口能够让你:·发现打印服务(Print Services)·指定打印数据的格式·从一个打印服务创建打印工作(print jobs)·向一个打印设备或者数据流发送打印数据发现打印服务应用程序通过调用虚拟类PrintServiceLookup的静态方法来定位能够满足应用程序打印需求的打印服务。
例如,需要双面打印一个文档,应用程序就必须首先找到具备双面打印能力的打印设备。
PrintServiceLookup返回的某个PrintService接口的实现类代表一个真实的打印设备。
PrintService接口具有众多能够返回打印服务所支持的属性的方法,通过调用其中的一个便可以确定这个PrintService对象所具备的功能。
在《打印及流化文档》章节的《定位服务》小节对PrintService类和PrintServiceLookup类进行了讨论。
JDK自带的PrintServiceLookup实现类能够定位标准平台下的打印设备。
如果需要定位其他类型的打印设备,如IPP打印机或JINI打印机,则打印服务的提供者可以重新编写PrintServiceLookup类的实现。
打印服务提供者可以使用SPI JAR 文件规范来动态安装自定义的PrintServiceLookup实现。
除了向一台打印设备发送数据,应用程序还可以使用StreamPrintService对象将数据打印到一个输出流中,这就使得应用程序能够将打印数据转换为不同的格式。
为了获得一个StreamPrintService对象,应用程序需要使用虚拟类StreamPrintServiceFactory提供的查找方法,这与PrintServiceLookup类发现打印服务的办法类似。
在《打印及流化文档》章节中讲述了如何使用StreamPrintServiceFactory类和StreamPrintService类。
StreamPrintService对象还可以被用于向输出流发送2D图像数据,这在《打印及流化2D图像》章节中有详细的说明。
指定打印数据格式DocFlavor类代表了打印数据的格式,如JPEG或PostScript。
一个DocFlavor 对象包括了一个MIME类型,它用于描述格式和代表该格式的表示类名,如java.io.InputStream,它指明了如何将文件发送给打印服务。
为了方便起见,JPS API已经预定义了一些代表通用数据格式的DocFlavor对象。
在《指定文档类型》章节中讲述了关于如何使用DocFlavor对象的细节。
创建打印工作当一个适合的打印服务被找到,应用程序就会从中创建一个打印工作,打印工作由DocPrintJob类对象来表示,该对象提供了实际的打印方法。
在呼叫打印之前,应用程序会创建一个Doc对象,该对象用来封装打印数据以及打印要求的属性,这些属性被定义在包javax.print.attribute和包javax.print.attribute.standard 《打印及流化文档》章节中讲述了如何使用Doc类和DocPrintJob类。
通过JPS,中。
《打应用程序既可以使用PrinterJob类也可以使用DocPrintJob类来打印2D图像。
印及流化2D图像》章节对此进行了讨论。
javax.print.attribute包和javax.print.attribute.standard包定义了打印属性。
它们描述了打印服务的功能、文档的特性、操作文档或整个打印工作的指令、以及打印工作或打印设备的状态。
javax.print.attribute包描述了属性的类型以及它们如何被归类于集合之中。
Attribute接口是所有打印属性的父接口。
javax.print.attribute包所包含的类和接口定义了五种不同类型的属性,其中每一种描述了一个打印服务所具备的功能。
例如,PrintRequestAttribute接口定义了用户用来描述打印工作特性的一些属性,如打印成几份等。
javax.print.attribute.standard包中列举了API所支持的所有的标准属性,其中大部分是IPP规范所规定的属性。
《属性》章节讨论了关于属性API的更多细节。
javax.print.event包javax.print.event包内包括了允许应用程序在打印工作和打印服务上注册事件的类。
要获得关于注册打印工作事件的详细信息,请阅读《注册事件》小节。
应用程序如何使用JPS应用程序使用JPS API操作打印请求的典型方法包括以下几步:·获得一个适合的DocFlavor,它是定义打印数据格式的类。
·创建并填写AttributeSet,它封装了描述打印服务功能的属性集,如打印5份,装订,以及双面打印。
·查找一个能够处理由DocFlavor和属性集指定的打印请求的打印服务。
·在该打印服务上创建一个打印工作。
·调用打印工作的print方法。
以上步骤,应用程序会根据打印对象和打印方式的不同进行不同的操作。
应用程序也可以向一个打印设备或输出流发送打印数据。
打印数据可以是文本文档或图形,也可以是封装了2D图像的Java对象。
如果打印数据是2D图像,则打印工作既可以由DocPrintJob表示,也可以由PrinterJob表示。