PrintService (Java 2 Platform SE 5.0)

   DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT;
   PrintRequestAttributeSet aset = new HashPrintRequestHashAttributeSet();
   aset.add(MediaSizeName.ISO_A4);
   PrintService[] pservices =
                 PrintServiceLookup.lookupPrintServices(flavor, aset);
   if (pservices.length > 0) {
       DocPrintJob pj = pservices[0]. createPrintJob();
       // InputStreamDoc is an implementation of the Doc interface //
       Doc doc = new InputStreamDoc("test.ps", flavor);
       try {
             pj.print(doc, aset);
        } catch (PrintException e) {
        }
   }

메서드 개요

void addPrintServiceAttributeListener (PrintServiceAttributeListener listener)
이 PrintService에 이벤트의 리스너를 등록합니다.

DocPrintJob createPrintJob ()
지원 된 임의의 다큐먼트 플레이버 의 데이터를 처리 가능한 PrintJob를 작성해 리턴합니다.

boolean equals (Object obj)
2개의 서비스가 같은 기본 서비스를 참조하고 있을지 어떨지를 판별합니다.





<T extends PrintServiceAttribute > 


T

getAttribute (Class <T> category)
지정된 단일의 서비스 속성의 값을 취득합니다.

PrintServiceAttributeSet getAttributes ()
이 인쇄 서비스의 프린터 기술 속성 세트를 취득합니다.

Object getDefaultAttributeValue (Class <? extends Attribute > category)
이 인쇄 서비스의 지정된 카테고리내에서의 디폴트 인쇄 속성값을 판별합니다.

String getName ()
이 인쇄 서비스의 String 명을 리턴합니다.

ServiceUIFactory getServiceUIFactory ()
다양한 롤의 서비스와의 대화 처리를 사용자에 게 제공하는 UI 컴퍼넌트의 팩토리를 리턴합니다.

Class <? >[] getSupportedAttributeCategories ()
이 인쇄 서비스의 작업 설정시에 클라이언트가 지정 가능한 인쇄 속성 카테고리를 판별합니다.

Object getSupportedAttributeValues (Class <? extends Attribute > category, DocFlavor flavor, AttributeSet attributes)
이 인쇄 서비스용의 작업 설정시에 클라이언트가 특정의 카테고리내에서 지정 가능한 인쇄 속성값을 판별합니다.

DocFlavor [] getSupportedDocFlavors ()
이 PrintService용의 작업 설정시에 클라이언트가 지정 가능한 인쇄 데이터 형식을 판별합니다.

AttributeSet getUnsupportedAttributes (DocFlavor flavor, AttributeSet attributes)
특정의 DocFlavor 컨텍스트 내의 인쇄 요구로 지원 되지 않는 속성을 식별합니다.

int hashCode ()
이 메서드의 구현에는 equals(Object)를 일관해 사용할 필요가 있습니다.

boolean isAttributeCategorySupported (Class <? extends Attribute > category)
이 인쇄 서비스의 작업 설정시에 클라이언트가 특정의 인쇄 속성 카테고리를 지정 가능한가 어떤가를 판별합니다.

boolean isAttributeValueSupported (Attribute attrval, DocFlavor flavor, AttributeSet attributes)
이 Print Service용의 작업 설정시에 클라이언트가 특정의 인쇄 속성값을 지정 가능한가 어떤가를 판별합니다.

boolean isDocFlavorSupported (DocFlavor flavor)
이 인쇄 서비스가 특정의 DocFlavor를 지원 할지 어떨지를 판별합니다.

void removePrintServiceAttributeListener (PrintServiceAttributeListener listener)
이 인쇄 서비스로부터 인쇄 서비스 리스너를 삭제합니다.

메서드의 상세

getName

String  getName()

이 인쇄 서비스의 String 명을 리턴합니다. 어플리케이션은 이것을 사용해 특정의 인쇄 서비스를 요구할 수 있습니다. 네임 서비스등이 적절한 컨텍스트에 서는 이 이름은 일의가 아니면 안됩니다. 환경에 따라서는 이 일의명을 PrinterName 속성으로서 정의된 사용자에 게 있어 알기 쉬운 프린터명과 같게 할 수 있습니다.

반환값:: 서비스의 이름

createPrintJob

DocPrintJob  createPrintJob()

지원 된 임의의 다큐먼트 플레이버 의 데이터를 처리 가능한 PrintJob를 작성해 리턴합니다.

반환값:: DocPrintJob 객체

addPrintServiceAttributeListener

void addPrintServiceAttributeListener(PrintServiceAttributeListener  listener)

이 PrintService에 이벤트의 리스너를 등록합니다.

파라미터:: listener - 인쇄 서비스 상태를 감시하는 PrintServiceAttributeListener
관련 항목:: removePrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)

removePrintServiceAttributeListener

void removePrintServiceAttributeListener(PrintServiceAttributeListener  listener)

이 인쇄 서비스로부터 인쇄 서비스 리스너를 삭제합니다. 이것은 이후, 리스너가 PrintService 이벤트에 관여하지 않는 것을의미합니다.

파라미터:: listener - PrintServiceAttributeListener 객체
관련 항목:: addPrintServiceAttributeListener(javax.print.event.PrintServiceAttributeListener)

getAttributes

PrintServiceAttributeSet  getAttributes()

이 인쇄 서비스의 프린터 기술 속성 세트를 취득합니다. 프린터 기술 속성 세트는 이 Print Service 상태를 지정합니다. 리턴된 속성 세트 객체는 변경할 수 없습니다. 리턴된 속성 세트 객체는 getAttributes() 메서드 호출시의 Print Service 속성의 「snapshot」입니다. 즉, 이 인쇄 서비스의 속성 세트의 내용이 장래 변경되어도, 리턴된 속성 세트의 내용은 갱신되지 않습니다. 속성값의 변경을 검출하려면, getAttributes()를 재차 호출해, 새로운 속성 세트를 이전의 속성 세트와 비교합니다. 이제(이미 ) 1개의 방법으로서 인쇄 서비스 이벤트의 리스너를 등록할 수도 있습니다.

반환값:: 이 Print Service 속성 세트의 변경 불가능한 snapshot. 공백이라도 좋지만 null은 안 된다

getAttribute

<T extends PrintServiceAttribute > T getAttribute(Class <T> category)

지정된 단일의 서비스 속성의 값을 취득합니다. 이것은 클라이언트가 1개의 속성값만을 필요로 해, 오버헤드를 최소한으로 억제하는 경우에 유용합니다.

파라미터:: category - 이 서비스로 지원 되는 PrintServiceAttribute 카테고리. null 여서는 안 된다
반환값:: 지원 되는 속성의 값, 또는 속성이 이 서비스로 지원 되지 않는 경우는 null
예외:: NullPointerException - 카테고리가 null인 경우; IllegalArgumentException - 미확인의 예외. category가 PrintServiceAttribute 인터페이스를 구현하는 Class가 아닌 경우에 Throw 된다

getSupportedDocFlavors

DocFlavor [] getSupportedDocFlavors()

이 PrintService용의 작업 설정시에 클라이언트가 지정 가능한 인쇄 데이터 형식을 판별합니다. 인쇄 데이터 형식은 MIME 타입 및 인쇄 데이터 표현 클래스로 구성되는 「doc 플레이버 」(DocFlavor 클래스)에 의해 나타내집니다.

doc 플레이버 안에는 모든 속성과 조합할 수 없는 것도 있습니다. getUnsupportedAttributes(..)를 사용해, 특정의 편성이 유효한가 어떤가를 확인해 주세요.

반환값:: 지원 되는 doc 플레이버 의 배열. 배열은 1개 이상의 요소를 보관 유지할 필요가 있다

isDocFlavorSupported

boolean isDocFlavorSupported(DocFlavor  flavor)

이 인쇄 서비스가 특정의 DocFlavor를 지원 할지 어떨지를 판별합니다. 이 메서드는 DocFlavor가 getSupportedDocFlavors()를 실행해 얻을 수 있던 멤버인가 어떤가를 판별하는데 이용할 수 있습니다.

doc 플레이버 안에는 모든 속성과 조합할 수 없는 것도 있습니다. getUnsupportedAttributes(..)를 사용해, 특정의 편성이 유효한가 어떤가를 확인해 주세요.

파라미터:: flavor - 지원를 조회하는 DocFlavor
반환값:: 이 인쇄 서비스가 지정된 DocFlavor를 지원하는인 경우는 true, 그렇지 않은 경우는 false
예외:: NullPointerException - 미확인의 예외. flavor가 null인 경우에 Throw 된다

getSupportedAttributeCategories

Class <? >[] getSupportedAttributeCategories()

이 인쇄 서비스의 작업 설정시에 클라이언트가 지정 가능한 인쇄 속성 카테고리를 판별합니다. 인쇄 속성 카테고리는 Attribute 인터페이스를 구현하는 Class에 의해 나타납니다. 이 메서드는 지원하는 속성 「카테고리」만을 돌려주고, 지원하는 특정의 속성 「값」은 돌려주지 않습니다.

이 메서드는 실행 가능한 모든 작업으로 이 인쇄 서비스가 지원하는 인쇄 속성 카테고리 모든 것을 리턴합니다. 카테고리안에는 특정의 컨텍스트 (DocFlavor)에서는 지원 되지 않는 것도 있습니다. getSupportedAttributeValues(..) 등, DocFlavor를 포함한 메서드의 어느쪽이든을 사용해, 송신전에 요구의 검사를 실행해 주세요.

반환값:: 클라이언트가 Print Request 내에서 doc 레벨 또는 작업 레벨의 속성으로서 지정 가능한 인쇄 속성 카테고리의 배열. 배열내의 각 요소는 Attribute 인터페이스를 구현하는 Class 가 된다. 지원하는 카테고리가 존재하지 않는 경우, 배열은 비운다

isAttributeCategorySupported

boolean isAttributeCategorySupported(Class <?  extends Attribute > category)

이 인쇄 서비스의 작업 설정시에 클라이언트가 특정의 인쇄 속성 카테고리를 지정 가능한가 어떤가를 판별합니다. 인쇄 속성 카테고리는 Attribute 인터페이스를 구현하는 Class에 의해 나타납니다. 이 메서드는 속성 「카테고리」가 지원 될지 어떨지를 나타내, 특정의 속성 「값」이 지원 될지 어떨지는 가리키지 않습니다.

특정의 컨텍스트 (DocFlavor)에서는 지원 되지 않는 카테고리도 있습니다. 송신전에 getSupportedAttributeValues(..) 등, DocFlavor를 포함한 몇개의 메서드를 사용해 요구를 검증해 주세요.

이 메서드를 사용해, 카테고리가 getSupportedAttributeCategories() 결과의 멤버인가 어떤가를 판별할 수 있습니다.

파라미터:: category - 테스트 대상의 인쇄 속성 카테고리. Attribute 인터페이스를 구현하는 Class가 아니면 안된다
반환값:: 이 인쇄 서비스가 Print Request category 내의 doc 레벨 또는 작업 레벨의 속성 지정을 지원하는인 경우는 true, 그렇지 않은 경우는 false
예외:: NullPointerException - 미확인의 예외. category가 null인 경우에 Throw 된다; IllegalArgumentException - 미확인의 예외. category가 Attribute 인터페이스를 구현하는 Class가 아닌 경우에 Throw 된다

getDefaultAttributeValue

Object  getDefaultAttributeValue(Class <?  extends Attribute > category)

이 인쇄 서비스의 지정된 카테고리내에서의 디폴트 인쇄 속성값을 판별합니다. 인쇄 속성값는 Attribute 인터페이스를 구현하는 클래스의 인스턴스입니다. 클라이언트가 인쇄 작업을 설정해, 한편 지정된 카테고리내의 속성값을 지정하지 않는 경우, Print Service는 디폴트 속성값을 사용합니다.

특정의 컨텍스트 (DocFlavor)에서는 지원 되지 않는 속성도 존재합니다. 송신전에 getSupportedAttributeValues(..) 등, DocFlavor를 포함한 몇개의 메서드를 사용해 요구를 검증해 주세요.

모든 속성이 기본값을 보관 유지하는 것은 아닙니다. 예를 들어 서비스는 RequestingUser 기본값을 보관 유지하지 않습니다. 즉, 지원 되는 카테고리로 null이 리턴된인 경우, 그 카테고리의 서비스의 기본값이 존재하지 않는 것을의미합니다. 이것에 들어맞는 경우를 분별하려면, isAttributeCategorySupported(Class)를 사용해 주세요.

파라미터:: category - 디폴트 속성값이 요구되는 인쇄 속성 카테고리. Attribute 인터페이스를 구현하는 Class 가 아니면 안된다
반환값:: category 디폴트 속성값, 또는 null (이 Print Service 가 Print Request category 내의 doc 레벨 또는 작업 레벨의 속성 지정을 지원 하지 않는지, 서비스가 이 속성의 기본값을 보관 유지하지 않는 경우)
예외:: NullPointerException - 미확인의 예외. category가 null인 경우에 Throw 된다; IllegalArgumentException - 미확인의 예외. category가 Attribute 인터페이스를 구현하는 Class 가 아닌 경우에 Throw 된다

getSupportedAttributeValues

Object  getSupportedAttributeValues(Class <?  extends Attribute > category,
                                   DocFlavor  flavor,
                                   AttributeSet  attributes)

이 인쇄 서비스용의 작업 설정시에 클라이언트가 특정의 카테고리내에서 지정 가능한 인쇄 속성값을 판별합니다. 인쇄 속성값는 Attribute 인터페이스를 구현하는 클래스의 인스턴스입니다.

flavor가 null 로attributes가 null 또는 빈세트의 경우, 이 메서드는 실행 가능한 모든 작업으로 이 Print Service가 지원하는 인쇄 속성값 모든 것을 리턴합니다. flavor가 null이 아닌지, attributes가 빈세트가 아닌 경우, 이 메서드는 지정된 doc 플레이버 나 속성 세트와 호환성이 있는 인쇄 속성값만을 리턴합니다. 즉, 반환값 null은 이 속성 지정이 지정된 DocFlavor와 호환성이 없는 것을 나타내는 경우가 있습니다. 또, DocFlavor가 null이 아닌 경우에는 이 PrintService가 지원하는 플레이버가 아니면 안됩니다. 그 외의 경우, IllegalArgumentException가 발생 됩니다.

attributes 파라미터에 포함되는 Attribute 카테고리가category 파라미터와 같은 경우, 서비스는 AttributeSet 내에서 이 속성을 무시할 필요가 있습니다.

컨텍스트를 정확하게 표현하기 위해서 Doc 상에서 지정하는 DocAttribute를 이 세트에 포함할 필요가 있습니다.

이 메서드는 Object를 리턴합니다. 인쇄 속성 카테고리가 다르면, 지원 되는 속성값도 다르기 때문에입니다. javax.print.attribute.standard 패키지내의 각 인쇄 속성의 문서에는 각 속성이 지원하는 값을 나타낼 방법이 기재되어 있습니다. 지원 의 표시 방법을 이하에 나타냅니다.

속성 카테고리의 단일 인스턴스를 돌려주고, 임의의 값이 허용 되는 것을 나타낸다. 이것은 임의의 텍스트 캐릭터 라인을 값에 가질 수 있는 속성등으로 사용된다 (리턴된 속성 객체의 값은 무관계)
정당한 값을 포함한, 속성 카테고리의 1개 이상의 인스턴스의 배열을 돌려준다. 이것은 열거치의 리스트를 보관 유지하는 속성등으로 사용된다. 배열의 타입은, getCategory(Class)에 의해 리턴된 지정된 속성 카테고리 타입의 배열이 된다
정당한 값의 경계를 나타내는 (속성 카테고리 이외의 클래스의) 단일의 객체를 돌려준다. 이것은 특정의 범위내에 존재할 필요가 있는 정수값 속성등으로 사용된다

파라미터:: category - 테스트 대상의 인쇄 속성 카테고리. Attribute 인터페이스를 구현하는 Class 가 아니면 안되는; flavor - 지원하는 작업의 doc 플레이버, 또는 null; attributes - 지원 되는 작업의 인쇄 속성 세트 (작업 레벨 속성 및 문서 레벨 속성), 또는 null
반환값:: category 로 지원 되는 값을 나타내는 객체, 또는 null (이 Print Service가 Print Request category 내에서 doc 레벨 또는 작업 레벨의 속성 지정을 지원 하지 않는 경우)
예외:: NullPointerException - 미확인의 예외. category가 null인 경우에 Throw 된다; IllegalArgumentException - 미확인의 예외. category가 Attribute 인터페이스를 구현하는 Class 가 아닌 경우, 또는 이 서비스가 DocFlavor를 지원 하지 않는 경우

isAttributeValueSupported

boolean isAttributeValueSupported(Attribute  attrval,
                                  DocFlavor  flavor,
                                  AttributeSet  attributes)

이 Print Service용의 작업 설정시에 클라이언트가 특정의 인쇄 속성값을 지정 가능한가 어떤가를 판별합니다. 인쇄 속성값는 Attribute 인터페이스를 구현하는 클래스의 인스턴스입니다.

flavor가 null 인지, attributes가 null 또는 빈세트인 경우, 이 메서드는 doc 플레이버와 속성 세트의 가능한 편성으로 지정된 인쇄 속성값을 이 Print Service가 지원 할지 어떨지를 나타냅니다. flavor가 null이 아닌지, attributes가 빈세트가 아닌 경우, 이 메서드는 이 Print Service 가 지정된 doc 플레이버 나 속성 세트와 조합해, 지정된 인쇄 속성값을 지원 할지 어떨지를 나타냅니다.

또, DocFlavor가 null이 아닌 경우, 이 PrintService가 지원하는 플레이버가 아니면 안됩니다. 그 외의 경우, IllegalArgumentException가 발생 됩니다.

컨텍스트를 정확하게 표현하기 위해서 Doc 상에서 지정하는 DocAttribute를 이 세트에 포함할 필요가 있습니다.

이 메서드를 사용해, 값이 getSupportedAttributeValues(...) 결과의 멤버인가 어떤가를 판별할 수 있습니다.

파라미터:: attrval - 테스트 대상의 인쇄 속성값; flavor - 지원하는 작업의 doc 플레이버, 또는 null; attributes - 지원 되는 작업의 인쇄 속성 세트 (작업 레벨 속성 및 문서 레벨 속성), 또는 null
반환값:: 이 Print Service 로 Print Request 내의 doc 레벨 또는 작업 레벨 속성으로서 attrval를 지정 가능한 경우는 true, 그렇지 않은 경우는 false
예외:: NullPointerException - 미확인의 예외. attrval가 null인 경우; IllegalArgumentException - 플레이버가 이 PrintService 로 지원 되지 않는 경우

getUnsupportedAttributes

AttributeSet  getUnsupportedAttributes(DocFlavor  flavor,
                                      AttributeSet  attributes)

특정의 DocFlavor 컨텍스트 내의 인쇄 요구로 지원 되지 않는 속성을 식별합니다. 이 메서드는 실행될 가능성이 있는 인쇄 작업의 타당성을 검증하거나 지원 불가능한 특정의 속성을 식별하는 경우에 도움이 됩니다. 지원 되는 DocFlavor 만을 지정하는 것이 중요합니다. 지원 하지 않는 것을 지정하면 IllegalArgumentException가 발생 됩니다. 이 메서드의 반환값이 null인 경우, 모든 속성이 지원 됩니다.

컨텍스트를 정확하게 표현하기 위해서 Doc 상에서 지정하는 DocAttribute를 이 세트에 포함할 필요가 있습니다.

반환값이 null 이외의 경우, 이 DocFlavor 에서는 리턴된 세트내의 모든 속성이 지원 되지 않습니다. 리턴된 세트는 지원 되지 않는 속성 카테고리와 지원 되지 않는 속성값을 구별하지 않습니다.

지원 되는 인쇄 요구는 DocFlavor가 지원 되지 않는 경우를 제외해, 원의 속성 세트로부터 지원 되지 않는 속성을 모두 삭제해 작성할 수 있습니다.

다른 속성과 경합 하고 있는 것이 원인으로 속성이 지원 되지 않는 경우, 경합의 원인으로서 식별되는 속성의 선택은 서비스에 맡습니다.

isDocFlavorSupported()를 사용해, DocFlavor가 지원 되고 있는 것을 확인하고 나서, 이 메서드를 호출해 주세요.

파라미터:: flavor - 테스트 대상의 doc 플레이버, 또는 null; attributes - 지원 되는 작업의 인쇄 속성 세트 (작업 레벨 속성 및 문서 레벨 속성), 또는 null
반환값:: 이 Print Service가 인쇄 요구 사양을 지원하는인 경우는 null, 그렇지 않은 경우는 지원 되지 않는 속성
예외:: IllegalArgumentException - flavor가 이 PrintService 로 지원 되지 않는 경우

getServiceUIFactory

ServiceUIFactory  getServiceUIFactory()

다양한 롤의 서비스와의 대화 처리를 사용자에 게 제공하는 UI 컴퍼넌트의 팩토리를 리턴합니다. UI를 일절 제공하지 않는 서비스는 null을 돌려줄 필요가 있습니다. UI를 제공하지만, UI를 지원 하지 않는 환경에서의 이용을 상정하고 있는 Print Service는 어플리케이션이 이 메서드를 호출해 팩토리를 취득하지 않는 한, 팩토리가 초기화되지 않게 할 필요가 있습니다. 자세한 내용은 ServiceUIFactory를 참조하십시오.

반환값:: null 또는 UI 컴퍼넌트의 팩토리

equals

boolean equals(Object  obj)

2개의 서비스가 같은 기본 서비스를 참조하고 있을지 어떨지를 판별합니다. 인쇄 서비스를 캡슐화하는 복수의 객체는 동일한 기본 서비스를 참조하는 경우에서도, 참조가 동일한 일을 나타낼 수 없습니다.

클라이언트는 이 메서드를 호출해, 2개의 서비스가 동일한 기본 서비스를 참조하고 있을지 어떨지를 판별할 필요가 있습니다.

서비스는 이 메서드를 구현해, 비교 대상의 서비스 객체가 클라이언트에 의해 교대로 사용 가능한 경우에만 true를 돌려줄 필요가 있습니다. 이 경우 서비스는 같은 객체 참조를 기본 서비스에 자유롭게 돌려줄 수가 있습니다만, 클라이언트는 참조가 동일한 것에 존해 되지 않습니다.

오버라이드(override):: 클래스 Object 내의 equals

파라미터:: obj - 비교 대상의 참조 객체
반환값:: 이 서비스가 obj 인수와 같은 경우는 true, 그렇지 않은 경우는 false
관련 항목:: Object.hashCode(), Hashtable

hashCode

int hashCode()

이 메서드의 구현에는 equals(Object)를 일관해 사용할 필요가 있습니다.

오버라이드(override):: 클래스 Object 내의 hashCode

반환값:: 이 객체의 해시 코드
관련 항목:: Object.equals(java.lang.Object), Hashtable

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | 생성자 | 메서드

상세: 필드 | 생성자 | 메서드

javax.print 인터페이스 PrintService

getName

createPrintJob

addPrintServiceAttributeListener

removePrintServiceAttributeListener

getAttributes

getAttribute

getSupportedDocFlavors

isDocFlavorSupported

getSupportedAttributeCategories

isAttributeCategorySupported

getDefaultAttributeValue

getSupportedAttributeValues

isAttributeValueSupported

getUnsupportedAttributes

getServiceUIFactory

equals

hashCode

javax.print
인터페이스 PrintService