패키지 javax.print

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

참조처:
설명

인터페이스 개요

AttributeException	AttributeException 인터페이스는 mixin 인터페이스로 특정의 Print Service 인스턴스가 지원 하지 않는 1개 또는 복수의 인쇄 속성에 관계된 에러 조건을 보고하기 때문에 PrintException 서브 클래스는 이 인터페이스를 구현할 수 있습니다.
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를 사용하는 보통 의 어플리케이션은 다음의 순서를 실행해, 인쇄 요구를 처리합니다.

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

다음의 샘플 코드는 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