javax.print (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 패키지 다음의 패키지

프레임 있어 프레임 없음

패키지 javax.print

Java^TM Print Service API 의 주요한 클래스 및 인터페이스를 제공합니다.

참조처:
설명

인터페이스의 개요
AttributeException	AttributeException 인터페이스는 mixin 인터페이스로,`PrintException` 의 서브 클래스는 이 인터페이스를 구현해, 특정의 Print Service 인스턴스가 지원하지 않는 1 개(살) 또는 복수의 인쇄 속성에 관계하는 에러 조건을 보고할 수 있습니다.
CancelablePrintJob	이 인터페이스는, 인쇄 작업을 취소할 때에 인쇄 어플리케이션에 의해 사용됩니다.
Doc	Doc 인터페이스는, Print Job 용 인쇄 데이터의 일부를 제공하는 객체에 대한 인터페이스를 지정합니다.
DocPrintJob	이 인터페이스는, 작업 속성 세트를 보관 유지하는 지정된 문서를 인쇄 가능한 인쇄 작업을 나타냅니다.
FlavorException	FlavorException 인터페이스는 mixin 인터페이스로,`PrintException` 의 서브 클래스는, 이 인터페이스를 구현해 doc 후레이바 (`DocFlavor` 클래스)에 관한 에러 조건을 보고할 수 있습니다.
MultiDoc	MultiDoc 인터페이스는, Print Job 용 인쇄 데이터의 복수 부분을 제공하는 객체에 대한 인터페이스를 지정합니다.
MultiDocPrintJob	MultiDocPrintService 로부터 취득됩니다.
MultiDocPrintService	MultiPrintService 인터페이스는, MultiDocPrintJob 의 팩토리입니다.
PrintService	PrintService 인터페이스는, DocPrintJob 의 팩토리입니다.
URIException	URIException 인터페이스는, mixin 인터페이스로,`PrintException` 의 서브 클래스는, 이 인터페이스를 구현해 URI 주소에 관한 에러 조건을 보고할 수 있습니다.

클래스의 개요
DocFlavor	`DocFlavor` 클래스는, 인쇄 데이터 `DocPrintJob` 에의 제공 형식을 지정하는 객체를 캡슐화합니다.
DocFlavor.BYTE_ARRAY	DocFlavor.BYTE_ARRAY 클래스는, 사전 정의된 static 정수 DocFlavor 객체를 제공합니다.
DocFlavor.CHAR_ARRAY	DocFlavor.CHAR_ARRAY 클래스는, 사전 정의된 static 정수 DocFlavor 객체를 제공합니다.
DocFlavor.INPUT_STREAM	DocFlavor.INPUT_STREAM 클래스는, 사전 정의된 static 정수 DocFlavor 객체를 제공합니다.
DocFlavor.READER	DocFlavor.READER 클래스는, 사전 정의된 static 정수 DocFlavor 객체를 제공합니다.
DocFlavor.SERVICE_FORMATTED	DocFlavor.SERVICE_FORMATTED 클래스는, 정의 끝난 static 정수 DocFlavor 객체 (예, 서비스 형식의 인쇄 데이터용 doc 후레이바)를 제공합니다.
DocFlavor.STRING	DocFlavor.STRING 클래스는, 정의 끝난 static 정수 DocFlavor 객체를 제공합니다.
DocFlavor.URL	DocFlavor.URL 클래스는, 사전 정의된 static 정수 DocFlavor 객체를 제공합니다.
PrintServiceLookup	이 클래스의 구현은, 특정의 타입의 인쇄 서비스 (일반적으로은 프린터와 동의) 용의 검색 서비스를 제공합니다.
ServiceUI	이 클래스는, Java Print Service API 를 개입시켜 룩 업 된 인쇄 서비스 열람용의 그래피컬한 사용자 다이얼로그를 제공하는, 편리성의 높은 UI 메소드의 컬렉션입니다.
ServiceUIFactory	서비스는, 옵션으로 UI 를 제공할 수가 있습니다.
SimpleDoc	이 클래스는, 일반적인 많은 인쇄 요구로 사용 가능한 `Doc` 인터페이스의 구현입니다.
StreamPrintService	이 클래스는,`PrintService` 를 확장해, 클라이언트에 의해 지정된 출력 스트림에 다른 형식에서 데이터를 인쇄하는 인쇄 서비스를 나타냅니다.
StreamPrintServiceFactory	`StreamPrintServiceFactory` 는,`StreamPrintService` 인스턴스의 팩토리입니다.

예외의 개요
PrintException	PrintException 클래스는, Print Service 인스턴스의 사용시에 발생하는 인쇄 관련의 에러 조건을 캡슐화합니다.

패키지 javax.print 의 설명

Java^TM Print Service API 의 주요한 클래스 및 인터페이스를 제공합니다. Java Print Service API 를 사용하면(자), 클라이언트 및 서버 어플리케이션이 이하를 실행할 수 있게 됩니다.

기능에 근거해, 인쇄 서비스를 검출 및 선택한다
인쇄 데이터의 형식을 지정한다
인쇄하는 문서형을 지원하는 서비스에 인쇄 작업을 송신한다

인쇄 서비스의 검출

어플리케이션은, abstract 클래스 PrintServiceLookup 의 static 메소드를 호출해, 어플리케이션의 인쇄 요구를 채우는 인쇄 서비스를 찾습니다. 예를 들어, 양면 인쇄의 문서를 인쇄하는 경우, 어플리케이션은 최초로, 양면 인쇄 대응의 프린터를 검색할 필요가 있습니다.

JDK 에는, 표준 플랫폼 프린터를 검출하기 위한 PrintServiceLookup 구현이 포함되어 있습니다. IPP 프린터나 JINI 프린터 등, 다른 형태의 프린터를 검출하는 경우, 인쇄 서비스 프로바이더는,PrintServiceLookup 의 구현을 작성해, 이러한 PrintServiceLookup 를,「JAR 파일의 스펙」에 따라 동적으로 인스톨 할 수 있습니다.

속성의 정의

javax.print.attribute 및 javax.print.attribute.standard 패키지는, 인쇄 서비스 기능의 기술, 인쇄 작업 요건의 지정, 인쇄 작업의 진행 상황의 추적을 실시하는 인쇄 속성을 정의합니다.

javax.print.attribute 패키지는, 속성형, 및 속성형을 세트에 정리하는 방법을 기술합니다. javax.print.attribute.standard 패키지는, API 의 지원하는 모든 표준 속성을 열거합니다. 이러한 속성의 대부분은, IETF 스펙「RFC 2911 Internet Printing Protocol, 1.1: Model and Semantics」 (2000 년 9 월)로 지정된 속성의 구현입니다. javax.print.attribute.standard 로 지정하는 속성에는, 해상도, 카피 부수, 미디어 사이즈, 작업의 우선 순위, 페이지 범위등이 일반적인 기능이 포함됩니다.

문서형의 스펙

DocFlavor 클래스는, JPEG 나 PostScript 등의 인쇄 데이터 형식을 나타냅니다. DocFlavor 객체는, 형식을 기술하는 MIME 타입과 문서를 프린터 또는 출력 스트림에 송신하는 방법을 나타내는 문서 표현 클래스명으로 구성됩니다. 어플리케이션은,DocFlavor 및 속성 세트를 사용해,DocFlavor 에 의해 지정된 문서형을 인쇄 가능해, 속성 세트로 지정된 기능을 보관 유지하는 프린터를 검출합니다.

API 의 사용

Java Print Service API 를 사용하는 일반적으로의 어플리케이션은, 다음의 순서를 실행해, 인쇄 요구를 처리합니다.

DocFlavor 를 선택한다
속성 세트를 작성한다
DocFlavor 및 속성 세트에 의해 지정된 인쇄 요구의 처리가 가능한 인쇄 서비스를 검출한다
DocFlavor 및 인감 도장쇄데이터를 캡슐화한 Doc 객체를 작성한다. 이것은, Postscript 파일, JPEG 이미지, URL, plaintext 등, 다양한 형식을 취하는 일이 있다
DocPrintJob 에 의해 나타내지는 인쇄 작업을 인쇄 서비스로부터 취득한다
인쇄 작업의 인쇄 메소드를 호출한다

다음의 샘플 코드는, Java Print Service API 의 일반적인 사용 방법을 나타냅니다. A4 사이즈의 PostScript 문서 (양면)를 5 부 인쇄 가능한 프린터를 검출해, 반환된 인쇄 서비스의 1 개로부터 인쇄 작업을 작성해, 인쇄를 호출합니다.


FileInputStream psStream;
try {
   psStream = new FileInputStream("file.ps");
} catch (FileNotFoundException ffne) {
}
if (psStream == null) {
            return;
}

DocFlavor psInFormat = DocFlavor.INPUT_STREAM.POSTSCRIPT;
Doc myDoc = new SimpleDoc(psStream, psInFormat, null);  
PrintRequestAttributeSet aset = 
        new HashPrintRequestAttributeSet();
aset.add(new Copies(5));
aset.add(MediaSize.A4);
aset.add(Sides.DUPLEX);
PrintService[] services = 
  PrintServiceLookup.lookupPrintServices(psInFormat, aset);
if (services.length > 0) {
   DocPrintJob job = services[0]. createPrintJob();
   try {
        job.print(myDoc, aset);
   } catch (PrintException pe) {}
}

주:javax.print API 에서는, 메소드에의 null 참조 파라미터 지정은, 문서에 의미가 명기되어 있는 경우를 제외해 부정한 것으로 주의해 주세요. 이것에 반하는 사용은 무효인 코딩이며, 곧바로 또는 나중에 실행시의 예외가 발생하는 결과가 됩니다. IllegalArgumentException 및 NullPointerException 는, 이러한 경우의 전형적이어 허용 할 수 있는 실행시의 예외의 사례입니다.

도입된 버젼:: 1.4

개요