Java印刷サービスAPIユーザー・ガイド3 - ドキュメントの種類の指定

クライアント指定書式付き印刷データ

Theクライアントは、DocFlavorを使用して、印刷データ形式を記述し、印刷サービスへのデータの配信方法を示します。 MIMEタイプには、データ書式を指定します。表現クラス名には、データをプリンタに配信する方法を指定します。

DocFlavorクラスには、共通表現クラス名ごとに内部クラスがあります。各内部クラスには、表現クラスを使用して配信できる形式を表す一連のDocFlavorオブジェクト定数が含まれています。たとえば、入力ストリームは、DocFlavor.INPUT_STREAM.GIFで表されるGIFや、DocFlavor.INPUT_STREAM.POSTSCRIPTで表されるPostScriptなど、様々な種類の印刷データ形式をストリーミングできます。 DocFlavorオブジェクト定数のいずれかが、指定された印刷データの形式を正確に記述している場合、クライアントはDocFlavorを構築するかわりにこの定数を使用できます。

適切なDocFlavorがJPS APIにまだ定義されていない場合、クライアントはDocFlavorコンストラクタを使用して作成できます。クライアントは、次の2つの項で説明するMIMEタイプおよび表現クラス名を使用して、DocFlavorを構築できます。

書式設定済みデータのMIMEタイプ

もっとも一般的な種類の書式設定済みデータとして、テキスト・データ、ページ記述言語ドキュメント、イメージ・データ、自動感知印刷データの4つがあります。この項では、これらのデータ型のそれぞれについて説明し、対応するMIMEタイプを示します。

テキスト・データ

Preformattedテキスト・データは、通常、文字配列、String、Readerなどの文字指向表現クラス、またはバイト配列、入力ストリーム、URLなどのバイト指向表現クラスで提供されます。書式設定済みテキスト・データの一般的な書式は、プレーン・テキストおよびHTMLです。 DocFlavorの作成時に、次のMIMEタイプ文字列を使用してデータの形式を表すことができます:

MIMEタイプ	データ書式
`"text/plain"`	プレーン・テキスト。文字セットはデフォルトのUS-ASCII
`"text/plain;charset=xxx"`	文字セットxxxのプレーン・テキスト
`"text/html"`	デフォルト文字セット(US-ASCII)のハイパーテキスト・マークアップ言語
`"text/html;charset=xxx"`	HyperText文字セットxxxのマークアップ範囲

ページ記述言語ドキュメント

事前フォーマット済ページ記述言語(PDL)ドキュメントは、通常、バイト配列、InputStream、URLなどのバイト指向表現クラスで提供されます。これらのMIMEタイプ文字列を使用して、DocFlavor:

の構築時にデータの形式を表すことができます

MIMEタイプ	データ書式
`"application/pdf"`	Portable Document Formatドキュメント
`"application/postscript"`	PostScriptドキュメント
`"application/vnd.hp-PCL"`	Printer Control Languageドキュメント

イメージ・データ

事前にフォーマットされたイメージ・データは、バイト指向の表現クラスで提供されます: バイト配列、InputStreamまたはURL。これらのMIMEタイプ文字列を使用して、DocFlavor:

の構築時にデータの形式を表すことができます

MIMEタイプ	データ書式
`"image/gif"`	Graphics Interchange Formatイメージ
`"image/jpeg"`	Joint Photographic Experts Groupイメージ
`"image/png"`	Portable Network Graphicsイメージ

自動感知印刷データ

書式設定済みの自動感知印刷データを使用すると、プリンタは印刷データの解釈方法を判定できます。この種類のデータは通常、バイト指向の表現クラスとして提供されます。 DocFlavorの作成時に、このMIMEタイプ文字列を使用してデータの形式を表すことができます:

"application/octet-stream"

Representationクラス

クライアント指定書式付き印刷データの表現クラスは通常、次のいずれかです。

印刷データの表現クラス	説明
文字配列(`char[]`)	印刷データは、配列内のUnicode文字から構成される。テキスト・データおよびPDLデータを表現する。
`java.lang.String`	印刷データは、文字列内のUnicode文字から構成される。テキスト・データを表現する。
`java.io.Reader`で表される`Character`ストリーム	印刷データは、ストリーム全体から読み込まれたUnicode文字で構成される。テキスト・データを表現する。
バイト配列(`byte[]`)	印刷データは、配列内のバイトから構成される。バイトは、`DocFlavor`のMIMEタイプで指定された文字セットでエンコードされます。 MIMEタイプで文字セットが指定されない場合、デフォルトの文字セットであるUS-ASCIIが使用される。テキスト・データ、PDLドキュメント、およびイメージ・データを表現する。
`java.io.InputStream`で表される`Byte`ストリーム	印刷データは、ストリーム全体から読み込まれたバイトから構成される。バイトは、`DocFlavor`のMIMEタイプで指定された文字セットでエンコードされます。 MIMEタイプで文字セットが指定されない場合、デフォルトの文字セットであるUS-ASCIIが使用される。テキスト・データ、PDLドキュメント、およびイメージ・データを表現する。
Uniform Resource Locator、`java.net.URL`	印刷データは、URLの場所から読み込まれたバイトから構成される。バイトは、`DocFlavor`のMIMEタイプで指定された文字セットでエンコードされます。 MIMEタイプで文字セットが指定されない場合、デフォルトの文字セットであるUS-ASCIIが使用される。テキスト・データ、PDLドキュメント、およびイメージ・データを表現する。ネットワーク印刷サービスにドキュメントを出力するときに、このURLへのアクセス権がネットワーク印刷サービスに割り当てられていない場合は、このURL上で入力ストリームを開き、入力ストリーム・データのフレーバを代わりに使用する。

目次|前|次

連絡先