javax.print.attribute.standard
클래스 PrinterStateReasons

java.lang.Object 
  |
  +--java.util.AbstractMap 
        |
        +--java.util.HashMap 
              |
              +--javax.print.attribute.standard.PrinterStateReasons

모든 구현 인터페이스:

Attribute , Cloneable , Map , PrintServiceAttribute , Serializable

public final class PrinterStateReasons

extends HashMap

implements PrintServiceAttribute

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

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

PrinterStateReasons 클래스는 java.util.HashMap 클래스의 구현을 계승합니다. MAP의 각 엔트리는 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. Map 을 상속받은 중첩된 클래스

Map.Entry

생성자의 개요

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

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

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

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

메소드의 개요

Class	getCategory () 이 인쇄 속성치의 「카테고리」로서 사용되는 인쇄 속성 클래스를 돌려줍니다.
String	getName () 이 속성치가 인스턴스인 카테고리의 명칭을 돌려줍니다.
Set	printerStateReasonSet (Severity severity) 이 PrinterStateReasons 속성의 지정된 중요도 레벨의 각 프린터 상태 속성으로부터, 변경 불가능한 셋트뷰를 돌려줍니다.
Object	put (Object reason, Object 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()

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

PrinterStateReasons

public PrinterStateReasons(int initialCapacity)

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

파라미터:

initialCapacity - 초기 용량

예외:

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

PrinterStateReasons

public PrinterStateReasons(int initialCapacity,
                           float loadFactor)

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

파라미터:

initialCapacity - 초기 용량

loadFactor - 부하 계수

예외:

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

PrinterStateReasons

public PrinterStateReasons(Map  map)

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

파라미터:

map - 카피원의 MAP

예외:

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

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

메소드의 상세

put

public Object  put(Object  reason,
                  Object  severity)

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

정의:

인터페이스 Map 내의 put

오버라이드(override):

클래스 HashMap 내의 put

파라미터:

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

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

반환값:

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

예외:

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

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

getCategory

public final Class  getCategory()

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

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

정의:

인터페이스 Attribute 내의 getCategory

반환값:

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

getName

public final String  getName()

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

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

정의:

인터페이스 Attribute 내의 getName

반환값:

속성 카테고리명

printerStateReasonSet

public Set  printerStateReasonSet(Severity  severity)

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

파라미터:

severity - 중요도 레벨

반환값:

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

예외:

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