属性セット

AttributeSet インタフェースは、java.util.Map インタフェースと似ています。つまり、値およびキーの対応関係を指定し、各キーは一意で、1 つの値しか指定できません。ただし、AttributeSet インタフェースは、Java 印刷サービス API の要件に対応するためのインタフェースです。AttributeSet の要件は次のとおりです。

• AttributeSet の各キーはカテゴリに対応し、キーの値はキーによって表されるカテゴリに属する属性値の 1 つだけをとることができる。このため、Map と異なり、AttributeSet はキーの使用可能な値を制限する。つまり、属性カテゴリはそのカテゴリに属さない属性値を設定できない。
• 属性セットには、Attribute インタフェースを実装している属性だけを追加できる。
• AttributeSet には、特定のカテゴリの 1 つの属性だけを含めることができる。たとえば、特定の属性セットに Media 属性がすでに含まれているとする。この属性セットに別の Media 属性を追加すると、元の Media 属性は上書きされる。

Java 印刷サービス API には、AttributeSet インタフェースの固定実装として HashAttributeSet が組み込まれていますが、開発者が独自の実装を組み込むこともできます。多くのアプリケーションでは、HashAttributeSet を直接使用せずに、HashAttributeSet のサブクラス (HashPrintRequestAttributeSet、HashPrintJobAttributeSet、HashDocumentAttributeSet、および HashPrintServiceAttributeSet) のいずれかを使用します。これらのサブクラスには、AttributeSet の対応するサブインタフェースが実装されます。たとえば、PrintRequestAttributeSet は AttributeSet を継承し、PrintRequestAttributeSet の固定実装は HashPrintRequestAttributeSet になります。属性セットを作成するときに、HashPrintRequestAttributeSet、または PrintRequestAttributeSet の任意の実装を使用したときは、要求属性だけを含めることができます。

そのサブクラスとは異なり、HashAttributeSet には任意の種類の属性を含めることができます。複数の種類の属性を属性セットに含めるときは、HashAttributeSet をアプリケーションから直接使用します。たとえば、PrintService の getUnsupportedAttributes メソッドから返される属性セットを挙げることができます。サポートされない属性が返されたときに、その属性は複数の属性機能に属している可能性があります。

印刷要求の指定は印刷アプリケーションの主要な機能であるため、単一の属性と同様に、多くのアプリケーションは要求属性セットを作成します。要求属性セットを作成するときは、HashPrintRequestAttributeSet クラスのいずれかのコンストラクタを使用します。

PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();