クラスSimpleDoc

java.lang.Object
javax.print.SimpleDoc
すべての実装されたインタフェース:
Doc
public final class SimpleDoc extends Object implements Doc
このクラスは、一般的な多くの印刷要求で使用可能なDocインタフェースの実装です。 これは、DocFlavorクラスの静的変数として定義されている現在定義されている"pre-defined" docバーのすべてを処理できます。

特に、このクラスは、次のように、Doc仕様の特定の必要なセマンティクスを実装します:

  • 要求されていて適切な場合に、サービス用のストリームを構築する
  • メソッドに対する各呼出しで、同じオブジェクトが返されるようにする
  • 複数のスレッドがDocにアクセスできるようにします
  • データとdocフレーバの一致確認をいくつか実行する
他のジョブでdocオブジェクトを再利用したい、またはMultiDocを必要とするクライアントは、このクラスを使用したくないでしょう。

印刷データがストリームの場合、または印刷ジョブがデータをストリームとして要求する場合、SimpleDocは、データ転送やジョブの完了後にサービスがストリームを適切に閉じるかどうかを監視しません。 クライアントは、リスナーを追加する独自のdoc実装を提供して、ジョブの完了を監視したり、ストリームなどのリソースの解放(クローズ)を確認することもできます。

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

    コンストラクタ
    コンストラクタ
    説明
    SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
    指定された印刷データ、docフレーバ、およびdoc属性セットを使用して、SimpleDocを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    DocAttributeSet
    getAttributes()
    このdocオブジェクトの印刷属性セットを取得します。
    DocFlavor
    getDocFlavor()
    このdocオブジェクトが印刷データの一部を提供するdocフレーバを判別します。
    Object
    getPrintData()
    このdocオブジェクトの印刷データの一部を含む印刷データ表現オブジェクトを、サポートするdocフレーバに対応する形式で取得します。
    Reader
    getReaderForText()
    このdocから文字印刷データを抽出するためのリーダーを取得します。
    InputStream
    getStreamForBytes()
    このdocからバイト印刷データを抽出するための入力ストリームを取得します。

    クラスjava.lang.Objectで宣言されたメソッド

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

  • コンストラクタの詳細

    • SimpleDoc

      public SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes)
      指定された印刷データ、docフレーバ、およびdoc属性セットを使用して、SimpleDocを構築します。
      パラメータ:
      printData - 印刷データ・オブジェクト。
      flavor - DocFlavorオブジェクト
      attributes - DocAttributeSet (nullの場合あり)
      スロー:
      IllegalArgumentException - flavorまたはprintDataがnullの場合、またはprintDataが指定されたdocフレーバに対応しない場合-たとえば、DocFlavorの表現として指定されたタイプのデータではない

  • メソッドの詳細

    • getDocFlavor

      public DocFlavor getDocFlavor()
      このdocオブジェクトが印刷データの一部を提供するdocフレーバを判別します。
      定義:
      getDocFlavor、インタフェースDoc
      戻り値:
      ドキュメント風味

    • getAttributes

      public DocAttributeSet getAttributes()
      このdocオブジェクトの印刷属性セットを取得します。 返される属性セットに特定の属性Xのインスタンスが含まれる場合、プリンタはその属性値をこのdocに使用して、ジョブの属性セット内の属性Xの値をすべてオーバーライドする必要があります。 返された属性セットに特定の属性Xのインスタンスが含まれていない場合、またはnullが返された場合、プリンタはジョブの属性セットを参照して属性「バツ、」の値を取得する必要があり、見つからない場合、プリンタは実装に依存するデフォルト値を使用する必要があります。 返された属性セットは変更できません。
      定義:
      getAttributes、インタフェースDoc
      戻り値:
      このドキュメントの印刷属性の変更不可セット、またはジョブの属性セットからすべての属性値を取得するnull

    • getPrintData

      public Object getPrintData() throws IOException
      このdocオブジェクトの印刷データの一部を含む印刷データ表現オブジェクトを、サポートするdocフレーバに対応する形式で取得します。 getPrintData()メソッドは、getDocFlavor()によって名前が指定された表現クラスのインスタンスを返します。getRepresentationClassName()は、戻り値をクラスObjectからその表現クラスにキャストできます。
      定義:
      getPrintData、インタフェースDoc
      戻り値:
      印刷データ表現オブジェクト
      スロー:
      IOException - 表現クラスがストリームであり、ストリームの構成中にI/Oエラーが発生した場合

    • getReaderForText

      public Reader getReaderForText() throws IOException
      このdocから文字印刷データを抽出するためのリーダーを取得します。 DocFlavorが次の印刷データ表現クラスのどれかを保持する場合、Doc実装がこのメソッドをサポートする必要があります。保持しない場合、nullが返されます。
      • char[]
      • java.lang.String
      • java.io.Reader
      docの印刷データ表現オブジェクトを使用して、印刷データを文字のストリームとして読み取るためのReaderを構築して返します。 ただし、印刷データ表現オブジェクト自体がReaderの場合、印刷データ表現オブジェクトが返されるだけです。
      定義:
      getReaderForText、インタフェースDoc
      戻り値:
      このdocから印刷データ文字を読み取るためのReader。 このdocが上記の基準を満たさないためにリーダーを使用できない場合、nullが返される。
      スロー:
      IOException - リーダーの作成時に入出力エラーが発生した場合

    • getStreamForBytes

      public InputStream getStreamForBytes() throws IOException
      このdocからバイト印刷データを抽出するための入力ストリームを取得します。 DocFlavorが次の印刷データ表現クラスのどれかを保持する場合、Doc実装がこのメソッドをサポートする必要があります。そうでない場合はこのメソッドからnullが返されます。
      • byte[]
      • java.io.InputStream
      docの印刷データ表現オブジェクトが取得されます。 その後、印刷データ表現オブジェクトから印刷データをバイト・ストリームとして読み取るための入力ストリームが作成され、返されます。 ただし、印刷データ表現オブジェクト自体が入力ストリームの場合は、印刷データ表現オブジェクトが返されるだけです。
      定義:
      getStreamForBytes、インタフェースDoc
      戻り値:
      このdocから印刷データ・バイトを読み取るためのInputStream。 このdocが上記の基準を満たさないために入力ストリームを使用できない場合、nullが返される。
      スロー:
      IOException - 入力ストリームの作成中に入出力エラーが発生した場合