表現類

MIME類型描述將要打印的數據的類型，表現的類則表示如何讓打印服務得到這些數據。DocFlavor包含了幾個靜態的內部類，每一個相對應一個表現類和如何裝載要打印得數據。

表1中列出了上面提到的內部類和表現類。注意在SERVICE_FORMATTED（一會我會更詳細地解釋）旁邊，每一個和"binary"或者 "character"相對應。事實上，這些差別是人為的，因為"character"數據類型本身就是一種特殊的binary類型。這種情況下，我們說的二進制（binary）數據包括人們可以看懂的字符和一些格式化的字符比如tabs，換行回車等。當然，這些差別很重要，反映出面向字符的表現類并不適合存儲二進制數據。

例如，你不會用字符隊列或者字符串來保存一個gif文件，你也不能通過Reader接口來訪問它。另一方面，因為字符也是一種特殊的二進制數據，它完全適合儲存文本信息到字節數組里或者通過InputStream或者一個URL來訪問它。

Table 1. DocFlavor的表現類

上面定義的任何一個靜態內部類相對應一個表現類，但是請記住我說過每一個DocFlavor的實例通過一個表現類和一個MIME來確認要打印的數據的類型。

要訪問這樣一個實例，你要通過表1總列出的內部類。例如，我們假設你要打印一個在網上通過URL訪問的gif文件，這樣的話，就選擇表現類是javav.net.url，對應的在DocFlavor中的靜態類就是URL類。如果你打開那個內部類的文檔，你會發現其實它定義了一系列靜態的內部類，每一個對應一種打印機支持的MIME類型。表2描述了在DocFlavor.URL里的內部類和MIME

Table 2. The DocFlavor.URL inner classes

因為要通過URL打印gif圖片，你可以用一下代碼來獲得實例

DocFlavor flavor = DocFlavor.URL.GIF;

這個代碼創建了一個DocFlavor實例，代表類是java.net.URL，MIME是image/gif。
表2列出的了DocFlavor.URL的類，那么其他六個內部類呢？我們等下來討論一下SERVICE_FORMATTED，這之前，看看與二進制數據聯系的所有三種類型（BYTE_ARRAY, INPUT_STREAM, and URL)相關的內部類。例如，如果你把gif儲存到了一個字節數組里，那么你可以用以下代碼：

DocFlavor flavor = DocFlavor.BYTE_ARRAY.GIF;

正如有三個與二進制類型關聯的內部類一樣，與字符類型相關的另外三個類列在表3里

Table 3. CHAR_ARRAY, READER, and STRING

所以，如果你想打印儲存在字符串中的文本數據，用以下代碼： DocFlavor flavor = DocFlavor.STRING.TEXT_PLAIN;

類似的，如果文本來自于網頁上的HTML文檔，用以下代碼：

DocFlavor flavor = DocFlavor.STRING.TEXT_HTML;

選擇正確的打印機

還記得我們在開始關于討論DocFlavor之前關于打印機的那個精確支持你想要打印的數據類型的假設嗎？這似乎看起來沒有必要。實際上，你會對給你的打印機所支持的文檔類型感到吃驚。例如，剛提到文本類型看起來似乎是最容易支持的，所以，如果你的程序要打印一個普通文本或者HTML文本，你可以隨便選擇一個打印服務并把它送到打印機那去。然而大部分打印機不支持基于文本的表現類，如果你試圖向打印機發送它不支持的DocFlavor，會產生下面的異常：

Exception in thread "main" sun.print.PrintJobFlavorException: invalid flavor at sun.print.Win32PrintJob.print(Win32PrintJob.java:290) at PrintTest.main(PrintTest.java:11)

現在你已經知道了如何得到一個DocFlavor的引用而且我們也討論了選擇支持這個flavor的打印機重要性，接下來我來告訴你如何確定你使用的打印機支持它。我先前說過lookupPrintServices()允許你指定一個DocFlavor作為第一個參數，如果你指定的參數非空，那么方法會返回相應支持這個的打印機的實例。例如以下代碼將返回可以通過URL來打印gif文件的打印機的列表：

DocFlavor flavor = DocFlavor.URL.GIF; PrintService[] services = PrintServiceLookup.lookupPrintServices(flavor, null);

另外，如果你的程序已經獲得了打印服務的實例，而你想知道它是否支持另一種特定的flavor，你可以調用isDocFlavorSupported()方法。在下面的代碼里，將得到一個默認打印機的引用，如果不能打印gif就會出現錯誤信息：

PrintService service = PrintServiceLookup.lookupDefaultPrintService(); DocFlavor flavor = DocFlavor.URL.GIF; if (!service.isDocFlavorSupported(flavor)) { System.err.println("The printer does not support the appropriate DocFlavor"); }

AttributeSet

正如你看到的，DocFlavor描述打印數據而且可以用來確定打印服務是否支持這種數據。然而，你的程序需要選擇一個基于那些支持的元素的打印機。例如，你要打印圖片用不同的顏色來描述不同的信息，你想知道提供的服務是否支持彩色打印，如果不，那么要么禁止它使用或者要求提供一個黑白圖片。

類似彩色打印，兩邊打印或者使用不同的定位取決于打印機本身的屬性，而javax.print.attribute包包含了許多你可以用于描述這些屬性的包和接口。其中一個接口是前面提到的lookupPrintServices()中第二個參數AttributeSet。正如你愿，它返回屬性的集合，在調用lookupPrintServices()指定一個不為空的值將返回支持這些屬性的打印服務。換句話說，如果DocFlavor和 AttributeSet都不為空，那么方法將返回那些這兩種屬性都支持的打印機

Attribute

AttributeSet 是屬性的集合,一個顯而易見的問題是如何指定屬性的值呢？ javax.print.attribute包里同時含有一個叫Attribute的接口，你馬上可以看到通過調用add方法來給AttributeSet創建一個Attribute實例來獲得這個集合。在javax.print.attribute.standard包里定義了大量你將要用到的接口。在之前，你可以查看javax.print.attribute這個包里的其他接口。

屬性模塊

目前為止，我們把屬性描述成打印服務的功能，而實際上在java支持的屬性中算很簡單的。對應每個屬性，java都有相應的模塊。只有遵循這些模塊屬性才有效。在不同的java打印服務位置使用不同的屬性，而不是所有的屬性在任何地方都適用。

為了更好的理解這個，來看一下javax.print.attribute.standard 包里定義的

OrientationRequested和 ColorSupported接口。創建一個新的打印文檔時可以指定OrientationRequested屬性和用于打印的定位。ColorSupported在你調用PrintService接口的getAttributes方法時返回。OrientationRequested是一個你用來傳給打印機的屬性，而ColorSupported是打印服務用來提供給你關于打印機能力信息的工具。你可以在創建打印文檔時把ColorSupported作為屬性指定，因為打印機是否支持彩色打印是你的程序不能控制的。

接口和繼承

你第一次查看javax.print.attribute包里的接口和類時你也許會感到選擇那些列表里的接口和類很麻煩。除了Attribute 和AttributeSet和繼承AttributeSet的HashAttributeSet，javax.print.attribute包里有4個子接口和類，列出在表4和圖1中。

Table 4. javax.print.attribute 里定義的接口和類

Figure 1. javax.print.attribute 包的一部分類的層次結構.

那么有了Attribute, AttributeSet, 和 HashAttributeSet為什么需要使用這些不同的接口和繼承類呢？是因為這些特殊的類是為那些特殊的屬性量身定做的。比方說，我提到過當你創建打印文檔的時候有個地方可以使用的屬性例如ColorSupported在那里不能使用。當創建這樣的文檔，你可以使用DocAttributeSet接口（或者更專業一點，HashDocAttributeSet這個繼承的類），這個繼承類只允許你添加繼承DocAttribute這個接口的屬性。這四種不同的模塊如下：

·Doc: 在創建文檔時指定如何打印文檔

·PrintJob: 打印任務的屬性描述任務的狀態

·PrintRequest: 初始化打印時傳給任務的請求

·PrintService:由打印服務返回來描述打印機的功能

要知道如何工作，我們來創建一個DocAttributeSet的實例然后為AttributeSet設置DocAttributeSet和OrientationRequested屬性。HashDocAttributeSet定義了很好的結構，所有你可以很簡便的如下創建實例：

DocAttributeSet attrs = new HashDocAttributeSet();

現在你已經創建了AttributeSet，你可以調用add方法并把它傳給Attribute的繼承實例去。如果你看了OrientationRequested這個類的文檔，你會發現它包含了一系列靜態的OrientationRequest實例，每一個對應一種文檔定位方式。要指定你想要的類型，你所要做的只是按下面的方法傳給add方法一個靜態的實例的引用：

DocAttributeSet attrs = new HashDocAttributeSet(); attrs.add(OrientationRequested.PORTRAIT);

ColorSupported類有一點不同但一樣很簡單，它定義了兩種靜態實例:一個表示支持彩色打印另一個不是。你可以試著增加一個ColorSupported屬性到DocAttributeSet去，代碼如下：

DocAttributeSet attrs = new HashDocAttributeSet(); attrs.add(OrientationRequested.PORTRAIT); attrs.add(ColorSupported.SUPPORTED);

早先提過，去指定是否支持彩色打印不恰當因為這不是程序所能控制的內容。換句話說，ColorSupported這個屬性放到一系列文檔屬性中并不合適，所以，運行先前的代碼當添加ColorSupported屬性時會拋出一個ClassCastException異常。

要學習怎么運行，記住每一個AttributeSet子接口都有一個相應Attribute子接口和繼承子類。當添加一個屬性時，繼承的子類試圖把Attribute作為參數給相應的子接口，這樣來確保只有當前適當的屬性會成功添加。

這樣的話，HashDocAttributeSet 的add方法第一次和OrientationRequested的一個實例一起調用，并成功的把它作為一個object傳給DocAttribute。因為如圖2所示，OrientationRequested繼承了那個接口。與之相對應，傳ColorSupported實例的時候因為沒有繼承DocAttribute所以失敗了。

Figure 2. javax.print.attribute 包的一部分類的層次結構

這個例子舉例說明，表4里的四個接口和類組來保證使用正確的屬性。注意模塊和不同的屬性之間有大量的交互，所以很多屬性與不止一個模塊關聯。例如，許多屬性繼承了PrintJobAttribute 和 PrintRequestAttribute因為大部分是通過一個相關的打印任務獲得提供給你的。你可以在初始化時指定它們。舉個例子，你可以把它加到PrintRequestAttributeSet中去來指定任務名，并且在打印的時候通過PrintJobAttributeSet來返回它。因此，JobName屬性類同時繼承PrintRequestAttribute 和 PrintJobAttribute。

AttributeSet and HashAttributeSet

你已經知道了為什么會有四個子類，但是AttributeSet接口和HashAttributeSet父類又是什么呢？AttributeSet/HashAttributeSet在你不能確定要存儲在這個集合中的那些僅僅和一個模塊相關的屬性時使用。記得我以前提到的lookupPrintServices()方法允許你指定AttributeSet參數來限制返回的打印服務。表面上看來最好指定PrintServiceAttributeSet的實例，但是很多你可能用到的屬性并不繼承PrintServiceAttribute。

我們假設你想要讓lookupPrintServices()方法返回支持彩色打印和風景畫打印的打印機。這些屬性與ColorSupported和OrientationRequested屬性關聯，但是請注意這些類并不共享模塊，前者是一個PrintServiceAttribute而OrientationRequested與另外三個模塊(Doc, PrintRequest,和 PrintJob)關聯。這意味著不存在單個的AttributeSet接口或類來同時包含ColorSupported和Sides屬性。

創建AttributeSet的方法使用一個HashAttributeSet實例同時包含一個OrientationRequested 和 ColorSupported太簡單了。不像它的子類，它并不限制你往上加特殊的屬性，所以可以用以下代碼成功執行：

AttributeSet attrs = new HashAttributeSet(); attrs.add(ColorSupported.SUPPORTED); attrs.add(OrientationRequested.LANDSCAPE); PrintService[] services = PrintServiceLookup.lookupPrintServices(null, attrs);

通過用戶界面的打印機選擇

就此觀點而言，我認為使用的打印機應該由應用程序計劃選擇。但操作過程中，打印輸出內容時往往會顯示一個對話框讓用戶選擇。幸運的是，Java通過使用ServiceUI類（在javax.print包中定義）中的靜態printDialog()方法使得這些操作簡單化。

在顯示的對話框旁邊，僅在調用printDialog()時必須指定的參數值如下：

·用戶可選用的PrintService實例數組。

·默認的PrintService。

·PrintRequestAttributeSet實例。這用來彈出顯示的對話框，并在對話框消失之前返回用戶所作的任何更改。

要解釋這些如何運作，可使用下列簡單的代碼段來顯示打印對話：

PrintService[] services = PrintServiceLookup.lookupPrintServices(null, null); PrintService svc = PrintServiceLookup.lookupDefaultPrintService(); PrintRequestAttributeSet attrs = new HashPrintRequestAttributeSet(); PrintService selection = ServiceUI.printDialog( null, 100, 100, services, svc, null, attrs);

運行時，代碼產生如圖例3中所示的對話框

Figure 3. The printer dialog

隨著代碼的說明，從printDialog()方法返回的值是一個PrintService實例，識別用戶所選的打印機，或在用戶取消打印機對話時識別為空。此外，PrintRequestAttributeSet已更新到可通過對話框來反映用戶作出的更改，比如要打印的份數。

通過使用printDialog()方法，可讓用戶選擇其輸出要發往的打印機，提供用戶對于專業應用程序的期望功能。

創建打印任務

這是打印中的一個簡單步驟；因為一旦獲得PrintService的一個參考，你需要做的就是調用createPrintJob()方法，如：

PrintService service; ... DocPrintJob job = service.createPrintJob();

代碼中顯示，從createPrintJob()返回的值是一個DocPrintJob實例，可讓您控制并監控打印操作的狀態。要啟動打印，您會調用DocPrintJob對象的print()方法，但是，這之前，您需要定義待打印的文檔或選用PrintRequestAttributeSe。您已經知道如何構造并彈出AttributeSet，這個步驟不再重復，接下來，您將了解定義待打印的文檔。

定義要打印的文檔

接下來這一步是定義要打印的文檔，用一個在javax.print包里的Doc的接口實例來創建。每一個Doc的實例有兩個必須定義的屬性和一個可選擇的屬性：

·Object 代表要打印的內容

·DocFlavor的一個實例描述數據類型

·可選的DocAttributeSet 包含打印時的屬性

復習Doc接口的文檔可以看出javax.print包里包含了一個叫SimpleDoc 的接口的繼承，它的構造函數包含了上面三個參數。要知道如何構建SimpleDoc 的實例，我們假設你要打印兩份存在http://www.apress.com/ApressCorporate/supplement/1/421/bcm.gif的gif文件拷貝。
我們要做的就是構建一個SimpleDoc實例來描述這個文檔創建了一個URL來指向圖片，并且引用了DocFlavor，并把這兩個傳給SimpleDoc構造函數：

URL url = new URL( "http://www.apress.com/ApressCorporate/supplement/1/421/bcm.gif"); DocFlavor flavor = DocFlavor.URL.GIF; SimpleDoc doc = new SimpleDoc(url, flavor, null);

啟動打印

打印的最后一個步驟就是調用DocPrintJob的 print()方法，傳遞待打印數據的Doc對象，或選用PrintRequestAttributeSet實例。為簡單起見，假設默認打印機支持你所需要的flavor和屬性，在此情況下要使用下列代碼將上一個例子提及的gif文件打印兩份：

PrintService service = PrintServiceLookup.lookupDefaultPrintService(); DocPrintJob job = service.createPrintJob(); URL url = new URL( "http://www.apress.com/ApressCorporate/supplement/1/421/bcm.gif "); DocFlavor flavor = DocFlavor.URL.GIF; Doc doc = new SimpleDoc(url, flavor, null); PrintRequestAttributeSet attrs = new HashPrintRequestAttributeSet(); attrs.add(new Copies(2)); job.print(doc, attrs);

注意，一些情況下，打印不同步執行，這可能會在實際打印完成之前返回對print()的調用。