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 속성명에 각각 대응합니다.

관련 항목:

직렬화 된 형식

생성자 개요

PrinterStateReasons ()
비어있는 프린터 상태 이유 속성을 새롭게 구축합니다.

PrinterStateReasons (int initialCapacity)
비어있는 프린터 상태 이유 속성을 새롭게 구축합니다.

PrinterStateReasons (int initialCapacity, float loadFactor)
비어있는 프린터 상태 이유 속성을 새롭게 구축합니다.

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()

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

PrinterStateReasons

public PrinterStateReasons(int initialCapacity)

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

파라미터:

initialCapacity - 초기 용량

예외:

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

PrinterStateReasons

public PrinterStateReasons(int initialCapacity,
                           float loadFactor)

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

파라미터:

initialCapacity - 초기 용량

loadFactor - 부하 계수

예외:

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

PrinterStateReasons

public PrinterStateReasons(Map <PrinterStateReason,
Severity > map)

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

파라미터:

map - 카피원의 맵

예외:

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

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

메서드의 상세

put

public Severity  put(PrinterStateReason  reason,
                    Severity  severity)

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

정의:

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

오버라이드(override):

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

파라미터:

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

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

반환값:

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

예외:

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

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

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인 경우