クラスStreamPrintService

java.lang.Object

javax.print.StreamPrintService

すべての実装されたインタフェース:

PrintService

public abstract class StreamPrintService extends Object implements PrintService

このクラスは、PrintServiceを拡張し、クライアントによって指定された出力ストリームに別の形式でデータを印刷する印刷サービスを表します。 このクラスは主に、表示や保管に適したドキュメント型を出力形式とするサービスを対象に設計されています。 出力形式は、MIMEタイプとして宣言される必要があります。 これは、表現クラスが常に「java.io.OutputStream」である出力ドキュメント・フレーバと等価です。StreamPrintServiceクラスのインスタンスは、StreamPrintServiceFactoryインスタンスから取得されます。

StreamPrintServiceは、Destination属性をサポートするPrintServiceとは異なることに留意してください。 StreamPrintServiceは常に出力ストリームを必要とするのに対し、PrintServiceはDestinationをオプションで受け入れることも可能です。 StreamPrintServiceには、フォーマットされた出力のデフォルトのあて先が存在しません。 また、StreamPrintServiceには、ほかのコンテキストでも利用可能な形式で出力を生成することが期待されます。 StreamPrintServiceは、Destination属性をサポートするものではありません。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	StreamPrintService(OutputStream out)	StreamPrintServiceオブジェクトを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	dispose()	このStreamPrintServiceを破棄します。
abstract String	getOutputFormat()	この印刷サービスにより発行されたドキュメント形式を返します。
OutputStream	getOutputStream()	出力ストリームを取得します。
boolean	isDisposed()	このStreamPrintServiceが破棄されているかどうかを示すbooleanを返します。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

インタフェースで宣言されたメソッド PrintService

addPrintServiceAttributeListener, createPrintJob, equals, getAttribute, getAttributes, getDefaultAttributeValue, getName, getServiceUIFactory, getSupportedAttributeCategories, getSupportedAttributeValues, getSupportedDocFlavors, getUnsupportedAttributes, hashCode, isAttributeCategorySupported, isAttributeValueSupported, isDocFlavorSupported, removePrintServiceAttributeListener

修飾子と型	メソッド	説明
void	addPrintServiceAttributeListener(PrintServiceAttributeListener listener)	このPrintServiceのイベントのリスナーを登録します。
DocPrintJob	createPrintJob()	サポートされているドキュメント・フレーバのいずれかからデータを処理できるPrintJobを作成して返します。
boolean	equals(Object obj)	2つのサービスが同じ基本サービスを参照しているかどうかを判別します。
<T extends PrintServiceAttribute> T	getAttribute(Class<T> category)	指定された単一のサービス属性の値を取得します。
PrintServiceAttributeSet	getAttributes()	この印刷サービスのプリンタ記述属性セットを取得します。プリンタ記述属性セットは、このPrint Serviceの状態を指定します。
Object	getDefaultAttributeValue(Class<? extends Attribute> category)	この印刷サービスの指定されたカテゴリ内でのデフォルト印刷属性値を判別します。
String	getName()	このプリント・サービスの文字列名を返します。この文字列名は、アプリケーションが特定のプリント・サービスをリクエストするために使用することができます。
ServiceUIFactory	getServiceUIFactory()	さまざまなロールのサービスとの対話処理をユーザーに提供するUIコンポーネントのファクトリを返します。
Class<?>[]	getSupportedAttributeCategories()	この印刷サービスのジョブ設定時に、クライアントが指定可能な印刷属性カテゴリを判別します。
Object	getSupportedAttributeValues(Class<? extends Attribute> category, DocFlavor flavor, AttributeSet attributes)	この印刷サービス用のジョブ設定時に、クライアントが特定のカテゴリ内で指定可能な印刷属性値を判別します。
DocFlavor[]	getSupportedDocFlavors()	このPrintService用のジョブ設定時に、クライアントが指定可能な印刷データ形式を判定します。
AttributeSet	getUnsupportedAttributes(DocFlavor flavor, AttributeSet attributes)	特定のDocFlavorのコンテキストで印刷リクエストに対してサポートされていない属性を識別します。
int	hashCode()	このメソッドの実装には、equals(Object)を一貫して使用するようにしてください。
boolean	isAttributeCategorySupported(Class<? extends Attribute> category)	この印刷サービスのジョブ設定時に、クライアントが特定の印刷属性カテゴリを指定可能かどうかを判別します。
boolean	isAttributeValueSupported(Attribute attrval, DocFlavor flavor, AttributeSet attributes)	このPrint Service用のジョブ設定時に、クライアントが特定の印刷属性値を指定可能かどうかを判別します。
boolean	isDocFlavorSupported(DocFlavor flavor)	この印刷サービスが特定のDocFlavorをサポートするかどうかを判定します。
void	removePrintServiceAttributeListener(PrintServiceAttributeListener listener)	この印刷サービスから印刷サービス・リスナーを削除します。

コンストラクタの詳細

StreamPrintService

protected StreamPrintService(OutputStream out)

StreamPrintServiceオブジェクトを構築します。

パラメータ:

out - フォーマットされた印刷データの送信先ストリーム

メソッドの詳細

getOutputStream

public OutputStream getOutputStream()

出力ストリームを取得します。

戻り値:

このサービスがフォーマットされた印刷データを送信するストリーム

getOutputFormat

public abstract String getOutputFormat()

この印刷サービスにより発行されたドキュメント形式を返します。 mimetype形式でなければならず、DocFlavorsのMIMEタイプのコンポーネントと互換性があります。

戻り値:

出力形式を示すMIMEタイプ

関連項目:

• DocFlavor

dispose

public void dispose()

このStreamPrintServiceを破棄します。 ストリーム・サービスが再利用できない場合は、利用できないことを示すためにそれを破棄する必要があります。 通常は、クライアントがこのメソッドを呼び出します。 理由があって追加できないデータを記述するサービスでも、ストリームを破棄することがあります。 破棄することによって、ストリームが閉じることはありません。 このサービスで今後使用されることがないようにマークが付けられるだけです。

isDisposed

public boolean isDisposed()

このStreamPrintServiceが破棄されているかどうかを示すbooleanを返します。 このオブジェクトが破棄された場合、trueが返されます。 サービスおよびクライアント・アプリケーションは、これを使用して、データの書込みがこれ以上行われないストリームを識別します。

戻り値:

このStreamPrintServiceが破棄されている場合はtrue、falseそうでなければ