javax.print.attribute
인터페이스 AttributeSet

알려진 서브 인터페이스 목록 :

DocAttributeSet, PrintJobAttributeSet, PrintRequestAttributeSet, PrintServiceAttributeSet

알려진 구현 클래스 목록:

HashAttributeSet, HashDocAttributeSet, HashPrintJobAttributeSet, HashPrintRequestAttributeSet, HashPrintServiceAttributeSet

public interface AttributeSet

AttributeSet 인터페이스는 인쇄 속성 세트의 인터페이스를 지정합니다. 인쇄 속성 세트는 그 클래스가 인터페이스 Attribute를 구현하는 객체입니다.

속성 세트에는 「속성값」의 그룹이 포함됩니다. 이 세트에서는 복제치를 설정할 수가 없습니다. 게다가 속성 세트의 각 치는 어떠한 「카테고리」의 멤버이며, 특정의 카테고리내에 1개 만 값을 설정할 수 있습니다 . 속성 세트의 경우, 값은 Attribute 객체이며, 카테고리는 Class 객체입니다. 속성의 카테고리는 그 속성의 종류에 대한 클래스 계층 루트의 클래스 또는 인터페이스입니다. 속성 객체의 카테고리는 속성 객체의 클래스 그 자체가 아니고, 속성 객체의 클래스의 슈퍼 클래스인 것에 주의해 주세요. 속성 객체의 카테고리는 Attribute 인터페이스로 정의된 getCategory() 메서드의 호출에 의해 정해집니다.

AttributeSet 인터페이스는 Java 컬렉션 API java.util.Map 인터페이스를 닮아 있습니다만, 받아들이는 형태에 의해 큰 제한이 있어, 키와 값을 Attribute에 정리합니다.

속성 세트는 Print Service API 몇개의 장소에서 사용됩니다. 각 컨텍스트 으로 특정의 종류의 속성만이 속성 세트에 표시할 수 있습니다. 이것은 속성 클래스가 구현하는 태그 기능 인터페이스 DocAttribute, PrintRequestAttribute, PrintJobAttribute 및 PrintServiceAttribute 에 의해 지정됩니다. 속성의 특성에는 4 개 있어, 각각 다음의 4 종류의 속성중 1개 만을 가지도록 제한되고 있습니다. 이것들은 DocAttributeSet, PrintRequestAttributeSet, PrintJobAttributeSet 및 PrintServiceAttributeSet 입니다. 많은 속성 클래스는 복수의 태그 기능 인터페이스를 구현하기 위해, 복수의 컨텍스트 으로 표시되는 것에 주의해 주세요.

• DocAttribute를 가지는 DocAttributeSet 는 개개의 문서의 특성 및 개개의 문서에 적용되는 인쇄 작업의 설정을 지정한다

• PrintRequestAttribute 을 가지는 PrintRequestAttributeSet 는 인쇄 작업 전체 및 인쇄 작업의 모든 문서에 적용되는 설정을 지정한다

• PrintJobAttribute 을 가지는 PrintJobAttributeSet 는 인쇄 작업 상태를 보고한다

• PrintServiceAttribute 을 가지는 PrintServiceAttributeSet 는 Print Service 인스턴스 상태를 보고한다

일부의 컨텍스트에 서는 클라이언트는 속성 세트의 내용의 검사만이 할 수 있어 변경은 할 수 없습니다 (설정이 읽기 전용). 그 외의 경우, 클라이언트는 속성 세트의 내용의 검사라고 변경의 양쪽 모두를 실시할 수 있습니다 (설정이 읽기, 출력 가능). read 전용 속성 세트의 경우, 변경 오퍼레이션의 호출은 UnmodifiableSetException을 Throw 합니다.

Print Service API는 HashAttributeSet 클래스의 AttributeSet 인터페이스의 1개를 구현합니다. 클라이언트는 HashAttributeSet 클래스를 사용하는지, 또는 독자적인 AttributeSet 인터페이스를 구현합니다. 또, Print Service API는 AttributeSet 인터페이스의 서브 인터페이스도 구현합니다. 그 클래스는 HashDocAttributeSet, HashPrintRequestAttributeSet, HashPrintJobAttributeSet 및 HashPrintServiceAttributeSet 입니다.

메서드 개요

boolean	add (Attribute attribute) 속성을 아직 보관 유지하고 있지 않는 경우, 최초로 지정된 속성값와 같은 속성 카테고리에 있는 값을 삭제하고 나서, 속성 세트로 지정된 속성을 추가합니다.
boolean	addAll (AttributeSet attributes) 이 속성으로 지정된 세트의 모든 요소를 추가합니다.
void	clear () 이 속성 세트로부터 모든 속성을 삭제합니다.
boolean	containsKey (Class <? > category) 속성 세트가 지정된 카테고리의 속성을 보관 유지하고 있는 경우에 true를 리턴합니다.
boolean	containsValue (Attribute attribute) 속성 세트가 지정된 속성값을 보관 유지하고 있는 경우에 true를 리턴합니다.
boolean	equals (Object object) 지정된 객체와 이 속성 세트가 동일한지 어떤지를 비교합니다.
Attribute	get (Class <? > category) 지정된 속성 카테고리에 포함되는 속성 세트의 속성값을 리턴합니다.
int	hashCode () 속성 세트의 해시 코드값을 리턴합니다.
boolean	isEmpty () 이 속성 세트에 속성이 포함되어 있지 않은 경우에 true를 리턴합니다.
boolean	remove (Attribute attribute) 속성 세트로부터 지정된 속성을 삭제합니다 (존재하는 경우).
boolean	remove (Class <? > category) 속성 세트로부터 카테고리의 임의의 속성을 삭제합니다 (존재하는 경우).
int	size () 속성 세트내의 속성수를 리턴합니다.
Attribute []	toArray () 이 세트에 포함되어 있는 속성의 배열을 리턴합니다.

메서드의 상세

get

Attribute  get(Class <? > category)

지정된 속성 카테고리에 포함되는 속성 세트의 속성값을 리턴합니다. 속성 세트가 지정된 속성 카테고리에 속성값을 가지지 않는 경우는 null을 리턴합니다.

파라미터:

category - 관련된 속성값이 리턴된 속성 카테고리. Attribute 인터페이스를 구현하는 Class 가 아니면 안된다

반환값:

속성 세트에 포함되는 지정된 속성 카테고리의 속성값, 또는 속성 세트가 지정된 속성 카테고리에 속성값을 가지지 않는 경우는 null

예외:

NullPointerException - 미확인의 예외. category가 null인 경우, Throw 된다

ClassCastException - 미확인의 예외. category가 Attribute 인터페이스를 구현하는 Class 가 아닌 경우에 Throw 된다

add

boolean add(Attribute  attribute)

속성을 아직 보관 유지하고 있지 않는 경우, 최초로 지정된 속성값와 같은 속성 카테고리에 있는 값을 삭제하고 나서, 속성 세트로 지정된 속성을 추가합니다.

파라미터:

attribute - 속성 세트에 추가되는 속성값

반환값:

속성 세트가 호출의 결과 변경되었을 경우, 즉 지정된 속성값이 이미 속성 세트의 멤버가 아니게 되고 있는 경우는 true

예외:

NullPointerException - 미확인의 예외. attribute가 null인 경우, Throw 된다

UnmodifiableSetException - 미확인의 예외. 속성 세트가 add() 오퍼레이션을 지원 하지 않는 경우, Throw 된다

remove

boolean remove(Class <? > category)

속성 세트로부터 카테고리의 임의의 속성을 삭제합니다 (존재하는 경우). category가 null인 경우, remove()는 아무것도 하지 않고 false를 리턴합니다.

파라미터:

category - 이 속성 세트로부터 삭제되는 속성 카테고리

반환값:

속성 세트가 호출의 결과 변경되었을 경우, 즉 지정된 속성값이 속성 세트의 멤버가 되어 있는 경우는 true

예외:

UnmodifiableSetException - 미확인의 예외. 속성 세트가 remove() 오퍼레이션을 지원 하지 않는 경우, Throw 된다

remove

boolean remove(Attribute  attribute)

속성 세트로부터 지정된 속성을 삭제합니다 (존재하는 경우). attribute가 null인 경우, remove()는 아무것도 하지 않고 false를 리턴합니다.

파라미터:

attribute - 속성 세트로부터 삭제되는 속성값

반환값:

속성 세트가 호출의 결과 변경되었을 경우, 즉 지정된 속성값이 속성 세트의 멤버가 되어 있는 경우는 true

예외:

UnmodifiableSetException - 미확인의 예외. 속성 세트가 remove() 오퍼레이션을 지원 하지 않는 경우, Throw 된다

containsKey

boolean containsKey(Class <? > category)

속성 세트가 지정된 카테고리의 속성을 보관 유지하고 있는 경우에 true를 리턴합니다.

파라미터:

category - 이 속성 세트에 있을지 어떨지가 조사할 수 있다

반환값:

속성 세트가 지정된 카테고리의 속성값을 보관 유지하고 있는 경우는 true

containsValue

boolean containsValue(Attribute  attribute)

속성 세트가 지정된 속성값을 보관 유지하고 있는 경우에 true를 리턴합니다.

파라미터:

attribute - 속성 세트에 있을지 어떨지가 조사할 수 있는 속성값

반환값:

속성 세트가 지정된 속성값을 보관 유지하고 있는 경우는 true

addAll

boolean addAll(AttributeSet  attributes)

이 속성으로 지정된 세트의 모든 요소를 추가합니다. 그 결과는 = add(Attribute) 오퍼레이션이, 지정된 세트의 각 요소를 가지는 속성 세트에 연속적으로 적용되었을 경우와 같습니다. 오퍼레이션을 하고 있는 동안에 지정된 세트가 변경되었을 경우, addAll(AttributeSet) 오퍼레이션의 동작은 지정되지 않습니다.

addAll(AttributeSet) 오퍼레이션이 예외를 Throw 하는 경우, 속성 세트 상태에 대한 영향은 구현에 의존합니다. 이 예외보다 전으로 지정된 세트의 요소는 속성 세트에 추가되는 경우로 여겨지지 않는 경우가 있습니다.

파라미터:

attributes - 속성 세트에 추가되는 요소

반환값:

이 호출의 결과, 이 속성 세트가 변경되었을 경우는 true

예외:

UnmodifiableSetException - 미확인의 예외. 속성 세트가 addAll(AttributeSet) 메서드를 지원 하지 않는 경우, Throw 된다

NullPointerException - 미확인의 예외. 지정된 세트의 일부의 요소가 null인 경우, 발생되는

관련 항목:

add(Attribute)

size

int size()

속성 세트내의 속성수를 리턴합니다. 이 속성 세트에 Integer.MAX_VALUE 보다 많은 요소가 있는 경우는 Integer.MAX_VALUE를 리턴합니다.

반환값:

이 속성 세트의 속성수

toArray

Attribute [] toArray()

이 세트에 포함되어 있는 속성의 배열을 리턴합니다.

반환값:

이 세트에 배열로서 보관 유지되는 Attribute. AttributeSet가 비어있는 경우는 길이 제로

clear

void clear()

이 속성 세트로부터 모든 속성을 삭제합니다.

예외:

UnmodifiableSetException - 미확인의 예외. 속성 세트가 clear() 오퍼레이션을 지원 하지 않는 경우, Throw 된다

isEmpty

boolean isEmpty()

이 속성 세트에 속성이 포함되어 있지 않은 경우에 true를 리턴합니다.

반환값:

이 속성 세트에 속성이 포함되어 있지 않은 경우는 true

equals

boolean equals(Object  object)

지정된 객체와 이 속성 세트가 동일한지 어떤지를 비교합니다. 지정된 객체도 속성 세트이며, 2개의 속성 세트가 같은 속성 카테고리의 속성값의 매핑을 보관 유지하는 경우는 true를 리턴합니다. 이것은 다른 AttributeSet 인터페이스의 구현으로 equals() 메서드가 정상적으로 동작하는 것을 보증합니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

object - 이 속성 세트와 동일한지 어떤지가 비교된다

반환값:

지정의 객체가 이 속성 세트와 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

int hashCode()

속성 세트의 해시 코드값을 리턴합니다. 속성 세트의 해시 코드는 AttributeSet 각 엔트리의 해시 코드의 합계가 되도록 정의됩니다. 이것에 의해 Object.hashCode() 일반 규약에 의해 요구되도록, 임의의 2개의 속성 세트 t1와 t2에 대해, t1.equals(t2) 이면 t1.hashCode() ==t2.hashCode()가 되는 것이 보증됩니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

속성 세트의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable