javax.print.attribute
클래스 AttributeSetUtilities

java.lang.Object 
  javax.print.attribute.AttributeSetUtilities

public final class AttributeSetUtilities
extends Object 

AttributeSetUtilities 클래스는, AttributeSets 를 조작하는 다음의 정적 메소드를 제공합니다.

• 속성 세트의 수정 불가능한 동기 뷰를 작성하는 메소드
• AttributeSet 인터페이스의 구현을 구축하기 위해서 도움이 되는 오퍼레이션

AttributeSet 「S」의수정 불가능한 뷰「U」는, 클라이언트에 「S」에의 「read 전용」액세스를 제공합니다. 「U」의 쿼리오퍼레이션은 「S」를 직접 읽어들입니다. 이 때문에, 「S」의 변경은 「U」에 반영됩니다. 다만, 「U」를 변경하려고 하면(자) UnmodifiableSetException 가 표시됩니다. 속성 세트 객체 「S」가 직렬화 가능의 경우, 수정 불가능한 뷰객체 「U」는 직렬화 가능합니다.

속성 세트 「S」의동기 뷰「V」에 의해, 클라이언트는 「S」에의 복수의 thread 세이프인 동기 액세스가 생기게 됩니다. 「V」의 각 오퍼레이션은, 「V」자체를 락 객체로서 사용해 동기화 되어 「S」의 대응하는 오퍼레이션을 단지 호출합니다. 서로 배타적인 액세스를 보증하기 위해서는, 「S」에 대한 모든 액세스가 「V」를 개입시켜 실행되는 것이 중요합니다. 속성 세트 객체 「S」가 직렬화 가능의 경우, 동기 뷰객체 「V」는 직렬화 가능합니다.

javax.print 의 패키지의 설명으로 말한 것처럼, 의미가 있는 해석을 가지는 것으로서 메소드에 명시적으로 문서화되어 있지 않은 경우, 메소드에 대한 null 참조 파라미터는 부정합니다. 이것에 반하는 사용은 무효인 코딩이며, 곧바로 또는 나중에 실행시의 예외가 발생하는 결과가 됩니다. IllegalArgumentException 및 NullPointerException 는, 이러한 경우의 전형적이어 허용 할 수 있는 실행시의 예외의 사례입니다.

메소드의 개요

static AttributeSet	synchronizedView (AttributeSet attributeSet) 지정된 속성 세트의 동기 뷰를 작성합니다.
static DocAttributeSet	synchronizedView (DocAttributeSet attributeSet) 지정된 문서의 속성 세트의 동기 뷰를 작성합니다.
static PrintJobAttributeSet	synchronizedView (PrintJobAttributeSet attributeSet) 지정된 인쇄 작업의 속성 세트의 동기 뷰를 작성합니다.
static PrintRequestAttributeSet	synchronizedView (PrintRequestAttributeSet attributeSet) 지정된 인쇄 요구의 속성 세트의 동기 뷰를 작성합니다.
static PrintServiceAttributeSet	synchronizedView (PrintServiceAttributeSet attributeSet) 지정된 인쇄 서비스의 속성 세트의 동기 뷰를 작성합니다.
static AttributeSet	unmodifiableView (AttributeSet attributeSet) 지정된 속성 세트의 변경 불가능한 뷰를 작성합니다.
static DocAttributeSet	unmodifiableView (DocAttributeSet attributeSet) 지정된 문서의 속성 세트의 변경 불가능한 뷰를 작성합니다.
static PrintJobAttributeSet	unmodifiableView (PrintJobAttributeSet attributeSet) 지정된 인쇄 작업의 속성 세트의 변경 불가능한 뷰를 작성합니다.
static PrintRequestAttributeSet	unmodifiableView (PrintRequestAttributeSet attributeSet) 지정된 인쇄 요구의 속성 세트의 변경 불가능한 뷰를 작성합니다.
static PrintServiceAttributeSet	unmodifiableView (PrintServiceAttributeSet attributeSet) 지정된 인쇄 서비스의 속성 세트의 변경 불가능한 뷰를 작성합니다.
static Class <? >	verifyAttributeCategory (Object object, Class <? > interfaceName) 지정된 객체가, 지정된 인터페이스를 구현하는 Class 인 것을 판정합니다.
static Attribute	verifyAttributeValue (Object object, Class <? > interfaceName) 지정된 객체가, 지정된 인터페이스의 인스턴스인 것을 판정합니다.
static void	verifyCategoryForValue (Class <? > category, Attribute attribute) 지정된 속성 카테고리의 객체가, 지정된 속성치의 객체의 카테고리와 동일한지 어떤지를 판정합니다.

클래스 java.lang. Object 로부터 상속된 메소드

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

메소드의 상세

unmodifiableView

public static AttributeSet  unmodifiableView(AttributeSet  attributeSet)

지정된 속성 세트의 변경 불가능한 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 속성 세트

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 되는 null 는 a 가 되지 않는다

unmodifiableView

public static DocAttributeSet  unmodifiableView(DocAttributeSet  attributeSet)

지정된 문서의 속성 세트의 변경 불가능한 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 문서의 속성 세트

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

unmodifiableView

public static PrintRequestAttributeSet  unmodifiableView(PrintRequestAttributeSet  attributeSet)

지정된 인쇄 요구의 속성 세트의 변경 불가능한 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 인쇄 요구의 속성 세트

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

unmodifiableView

public static PrintJobAttributeSet  unmodifiableView(PrintJobAttributeSet  attributeSet)

지정된 인쇄 작업의 속성 세트의 변경 불가능한 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 인쇄 작업의 속성 세트

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

unmodifiableView

public static PrintServiceAttributeSet  unmodifiableView(PrintServiceAttributeSet  attributeSet)

지정된 인쇄 서비스의 속성 세트의 변경 불가능한 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 인쇄 서비스의 속성 세트

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

synchronizedView

public static AttributeSet  synchronizedView(AttributeSet  attributeSet)

지정된 속성 세트의 동기 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 속성 세트

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

synchronizedView

public static DocAttributeSet  synchronizedView(DocAttributeSet  attributeSet)

지정된 문서의 속성 세트의 동기 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 문서의 속성 세트

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

synchronizedView

public static PrintRequestAttributeSet  synchronizedView(PrintRequestAttributeSet  attributeSet)

지정된 인쇄 요구의 속성 세트의 동기 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 인쇄 요구의 속성 세트

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

synchronizedView

public static PrintJobAttributeSet  synchronizedView(PrintJobAttributeSet  attributeSet)

지정된 인쇄 작업의 속성 세트의 동기 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 인쇄 작업의 속성 세트

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 throw 된다

synchronizedView

public static PrintServiceAttributeSet  synchronizedView(PrintServiceAttributeSet  attributeSet)

지정된 인쇄 서비스의 속성 세트의 동기 뷰를 작성합니다.

파라미터:

attributeSet - 기본으로 되는 인쇄 서비스의 속성 세트

반환값:

attributeSet 의 동기 뷰

verifyAttributeCategory

public static Class <? > verifyAttributeCategory(Object  object,
                                               Class <? > interfaceName)

지정된 객체가, 지정된 인터페이스를 구현하는 Class 인 것을 판정합니다. 이 인터페이스는 Attribute 또는 그 서브 인터페이스이다고 추정됩니다.

파라미터:

object - 판정되는 객체

interfaceName - 객체가 구현해야 하는 인터페이스

반환값:

object 가 interfaceName 를 구현하는 Class 의 경우, object 는 Class 형에 반환된다. 그 이외의 경우는 예외가 throw 된다

예외:

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

ClassCastException - 미확인의 예외. object 가 interfaceName 를 구현한다 Class 가 아닌 경우에 throw 된다

verifyAttributeValue

public static Attribute  verifyAttributeValue(Object  object,
                                             Class <? > interfaceName)

지정된 객체가, 지정된 인터페이스의 인스턴스인 것을 판정합니다. 이 인터페이스는 Attribute 또는 그 서브 인터페이스이다고 추정됩니다.

파라미터:

object - 판정되는 객체

interfaceName - 객체가 인스턴스가 아니면 안되는 인터페이스

반환값:

object 가 interfaceName 의 인스턴스의 경우,object 는 Attribute 형에 반환된다. 그 이외의 경우는 예외가 throw 된다

예외:

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

ClassCastException - 미확인의 예외. object 가 interfaceName 의 인스턴스가 아닌 경우, throw 된다

verifyCategoryForValue

public static void verifyCategoryForValue(Class <? > category,
                                          Attribute  attribute)

지정된 속성 카테고리의 객체가, 지정된 속성치의 객체의 카테고리와 동일한지 어떤지를 판정합니다. 동일한 경우, 이 메소드는 아무것도 하지 않고 복귀합니다. 동일하지 않은 경우, 이 메소드는 예외를 throw 합니다.

파라미터:

category - 판정되는 속성 카테고리

attribute - 판정되는 속성치

예외:

NullPointerException - 미확인의 예외. category 가 null 의 경우, 또는 attribute 가 null 의 경우, throw 된다

IllegalArgumentException - 미확인의 예외. category 가 attribute 의 카테고리와 동일하지 않은 경우, throw 된다