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 의 경우 슬로우 된다. null 는 a 가 되지 않는다

unmodifiableView

public static DocAttributeSet  unmodifiableView(DocAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

unmodifiableView

public static PrintRequestAttributeSet  unmodifiableView(PrintRequestAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

unmodifiableView

public static PrintJobAttributeSet  unmodifiableView(PrintJobAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

unmodifiableView

public static PrintServiceAttributeSet  unmodifiableView(PrintServiceAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 변경 불가능한 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

synchronizedView

public static AttributeSet  synchronizedView(AttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

synchronizedView

public static DocAttributeSet  synchronizedView(DocAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

synchronizedView

public static PrintRequestAttributeSet  synchronizedView(PrintRequestAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

synchronizedView

public static PrintJobAttributeSet  synchronizedView(PrintJobAttributeSet  attributeSet)

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

파라미터:

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

반환값:

attributeSet 의 동기 뷰

예외:

NullPointerException - attributeSet 가 null 의 경우는 슬로우 된다

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 를 입력하는 downcast 가 돌려주어진다. 그 이외의 경우는 예외가 슬로우 된다

예외:

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

ClassCastException - 미확인의 예외. object 가 interfaceName 를 구현하는 Class 가 아닌 경우, 슬로우 된다

verifyAttributeValue

public static Attribute  verifyAttributeValue(Object  object,
                                             Class  interfaceName)

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

파라미터:

object - 판정되는 오브젝트

interfaceName - 오브젝트가 인스턴스가 아니면 안되는 인터페이스

반환값:

object 가 interfaceName 의 인스턴스의 경우,object 는 Attribute 를 입력하는 downcast 가 돌려주어진다. 그 이외의 경우는 예외가 슬로우 된다

예외:

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

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

verifyCategoryForValue

public static void verifyCategoryForValue(Class  category,
                                          Attribute  attribute)

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

파라미터:

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

attribute - 판정되는 속성치

예외:

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

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