javax.print.attribute.standard
클래스 PrinterStateReasons

java.lang.Object 
  java.util.AbstractMap <K, V>
      java.util.HashMap <PrinterStateReason ,Severity >
          javax.print.attribute.standard.PrinterStateReasons

모든 구현된 인터페이스:

Serializable , Cloneable , Map <PrinterStateReason ,Severity >, Attribute , PrintServiceAttribute

public final class PrinterStateReasons
extends HashMap <PrinterStateReason ,Severity >
implements PrintServiceAttribute 

PrinterStateReasons 는, 프린터의 현재 상태에 대한 추가 정보, 즉 프린터 PrinterState 속성을 보다 알기 쉽게 하는 정보를, 값세트로서 열거하는 인쇄 속성 클래스입니다.

PrinterStateReason 자체는 인쇄 서비스의 속성 세트에서는 직접 사용되지 않고, PrinterStateReasons 속성이 사용됩니다. PriterStateReasons 속성에는, 인쇄 서비스의 상태에 관련하는 PrinterStateReason 객체가 전혀 포함되지 않는 경우도 있어, 1 개(살) 이상 포함되는 경우도 있습니다. PrinterStateReason 객체는, REPORT (중요도저), WARNING, 또는 ERROR (중요도고) Severity 레벨에 각각 관련지을 수 있습니다. 프린터는 대응하는 조건이 true 가 되었을 때에 PrinterStateReason 객체를 인쇄 서비스의 PrinterStateReasons 속성에 추가해, false 가 되었을 때에 이 객체를 삭제합니다. 인쇄 서비스 전체 PrinterState 의 변경 (와)는 관계없는 것으로 이 처리를 합니다.

PrinterStateReasons 클래스는 java.util.HashMap 클래스의 구현을 상속합니다. 맵의 각 엔트리는 Severity 객체 (값)에 매핑 된 PrinterStateReason 객체 (키)로 구성됩니다.

한 번 구축되어 버린다고 변경되지 않는 것이 많은 일반적으로의 인쇄 속성과는 달라, PrinterStateReasons 클래스는 변경 가능하게 설계되고 있습니다. PrinterStateReason 객체를 기존의 PrinterStateReasons 객체에 추가하거나 삭제하거나 할 수가 있습니다. 다만,java.util.HashMap 클래스와 같이, PrinterStateReasons 클래스도 multi-thread에 대해서 위험합니다. PrinterStateReasons 객체가 multi-thread로 사용되는 경우, 확실히 조작을 동기 시켜 주세요. 예를 들어 java.util.Collections 클래스로부터 취득된 동기화 맙뷰를 사용해 동기 시킬 수가 있습니다.

IPP 호환성:각 PrinterStateReason 객체와 관련지을 수 있었던 Severity 객체의 toString() 메소드로 반환되는 캐릭터 라인치를 하이픈 (-)으로 이은 것이, IPP 키워드치를 나타냅니다. getName() 에 의해 반환되는 카테고리명은 IPP 속성명을 나타냅니다.

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

클래스 java.util. AbstractMap 로부터 상속된 상자의 클래스/인터페이스

AbstractMap.SimpleEntry <K ,V >, AbstractMap.SimpleImmutableEntry <K ,V >

생성자 의 개요

PrinterStateReasons ()
빈 상태(empty)의 프린터 상태 이유 속성을 새롭게 구축합니다.

PrinterStateReasons (int initialCapacity)
빈 상태(empty)의 프린터 상태 이유 속성을 새롭게 구축합니다.

PrinterStateReasons (int initialCapacity, float loadFactor)
빈 상태(empty)의 프린터 상태 이유 속성을 새롭게 구축합니다.

PrinterStateReasons (Map <PrinterStateReason ,Severity > map)
지정된 맵과 같은 PrinterStateReason 로부터 Severity 에의 매핑을 가지는 프린터 상태 이유 속성을 새롭게 구축합니다.

메소드의 개요

Class <? extends Attribute >	getCategory () 이 인쇄 속성치의 「카테고리」로서 사용되는 인쇄 속성 클래스를 돌려줍니다.
String	getName () 속성치가 인스턴스가 되는 카테고리의 이름을 돌려줍니다.
Set <PrinterStateReason >	printerStateReasonSet (Severity severity) 이 PrinterStateReasons 속성의 지정된 중요도 레벨의 각 프린터 상태 이유 속성으로부터, 변경 불가능한 셋트뷰를 돌려줍니다.
Severity	put (PrinterStateReason reason, Severity severity) 지정된 프린터 상태 이유를 이 프린터 상태 이유 속성에 추가해, 동시에 지정된 중요도 레벨에 관련짓습니다.

클래스 java.util. HashMap 로부터 상속된 메소드

clear , clone , containsKey , containsValue , entrySet , get , isEmpty , keySet , putAll , remove , size , values

클래스 java.util. AbstractMap 로부터 상속된 메소드

equals , hashCode , toString

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

finalize , getClass , notify , notifyAll , wait , wait , wait

인터페이스 java.util. Map 로부터 상속된 메소드

equals , hashCode

생성자 의 상세

PrinterStateReasons

public PrinterStateReasons()

빈 상태(empty)의 프린터 상태 이유 속성을 새롭게 구축합니다. 기본이 되는 해시 맵은 기정의 초기 용량과 부하 계수를 가집니다.

PrinterStateReasons

public PrinterStateReasons(int initialCapacity)

빈 상태(empty)의 프린터 상태 이유 속성을 새롭게 구축합니다. 기본이 되는 해시 맵은 지정된 초기 용량과 기정의 부하 계수를 가집니다.

파라미터:

initialCapacity - 초기 용량

예외:

IllegalArgumentException - 초기 용량이 제로보다 작은 경우

PrinterStateReasons

public PrinterStateReasons(int initialCapacity,
                           float loadFactor)

빈 상태(empty)의 프린터 상태 이유 속성을 새롭게 구축합니다. 기본이 되는 해시 맵은 지정된 초기 용량과 부하 계수를 가집니다.

파라미터:

initialCapacity - 초기 용량

loadFactor - 부하 계수

예외:

IllegalArgumentException - 초기 용량이 제로보다 작은 경우

PrinterStateReasons

public PrinterStateReasons(Map <PrinterStateReason ,Severity > map)

지정된 맵과 같은 PrinterStateReason 로부터 Severity 에의 매핑을 가지는 프린터 상태 이유 속성을 새롭게 구축합니다. 기본이 되는 해시 맵의 초기 용량과 부하 계수는 슈퍼 클래스의 생성자 HashMap(Map) 로 지정됩니다.

파라미터:

map - 카피원의 맵

예외:

NullPointerException - 미확인의 예외. map 가 null 의 경우, 또는 map 에 null 의 키 또는 값이 포함되는 경우, throw 된다

ClassCastException - 미확인의 예외. map 의 키에 PrinterStateReason 클래스의 인스턴스가 아닌 것이 포함되는 경우, 또는 map 의 값에 Severity 클래스의 인스턴스가 아닌 것이 포함되는 경우, throw 된다

메소드의 상세

put

public Severity  put(PrinterStateReason  reason,
                    Severity  severity)

지정된 프린터 상태 이유를 이 프린터 상태 이유 속성에 추가해, 동시에 지정된 중요도 레벨에 관련짓습니다. 이 프린터 상태 이유 속성에, 지정된 프린터 상태 이유의 매핑이 등록제의 경우, 그 값이 변경됩니다.

정의:

인터페이스 Map <PrinterStateReason ,Severity > 내의 put

오버라이드(override):

클래스 HashMap <PrinterStateReason ,Severity > 내의 put

파라미터:

reason - 프린터 상태 이유. 이것은 PrinterStateReason 클래스의 인스턴스일 필요가 있는

severity - 프린터 상태 이유의 중요도. 이것은 Severity 클래스의 인스턴스일 필요가 있다

반환값:

지정된 프린터 상태 이유에 지금까지 관련지을 수 있고 있던 중요도. 지정된 프린터 상태 이유가 등록되지 않았던 경우는 null

예외:

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

ClassCastException - 미확인의 예외. reason 가 PrinterStateReason 클래스의 인스턴스가 아닌 경우, 또는 severity 가 Severity 클래스의 인스턴스가 아닌 경우, throw 되는

도입된 버젼:

1.5

getCategory

public final Class <?  extends Attribute > getCategory()

이 인쇄 속성치의 「카테고리」로서 사용되는 인쇄 속성 클래스를 돌려줍니다.

PrinterStateReasons 클래스의 경우, 카테고리는 PrinterStateReasons 클래스 자신입니다.

정의:

인터페이스 Attribute 내의 getCategory

반환값:

인쇄 속성 클래스 (카테고리), java.lang.Class 클래스의 인스턴스

getName

public final String  getName()

속성치가 인스턴스가 되는 카테고리의 이름을 돌려줍니다.

PrinterStateReasons 클래스의 경우, 카테고리명은 printer-state-reasons 가 됩니다.

정의:

인터페이스 Attribute 내의 getName

반환값:

속성 카테고리의 이름

printerStateReasonSet

public Set <PrinterStateReason > printerStateReasonSet(Severity  severity)

이 PrinterStateReasons 속성의 지정된 중요도 레벨의 각 프린터 상태 이유 속성으로부터, 변경 불가능한 셋트뷰를 돌려줍니다. 셋트뷰의 각 요소는 PrinterStateReason 객체입니다. 셋트뷰에 포함되는 요소는, 지정된 중요도의 값에 맵 된 PrinterStateReason 객체 뿐입니다. 셋트뷰는 이 PrinterStateReason 속성에 의해 돌려주어져 이 PrinterStateReasons 속성에 대한 변경이 셋트뷰에 반영되고 있습니다. 셋트뷰는 요소의 추가 또는 삭제를 지원하지 않습니다. 셋트뷰의 반복자는 요소의 삭제를 지원하지 않습니다.

파라미터:

severity - 중요도 레벨

반환값:

지정된 Severity 레벨의, 각 PrinterStateReason 속성의 셋트뷰

예외:

NullPointerException - 미확인의 예외. severity 가 null 의 경우