패키지 javax.print

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

참조:
설명

인터페이스의 개요

AttributeException	AttributeException 인터페이스는 mixin 인터페이스로, 특정의 Print Service 인스턴스가 서포트하지 않는 1 kr 또는 복수의 인쇄 속성에 관계하는 에러 조건을 보고하기 (위해)때문에,PrintException 의 서브 클래스는 이 인터페이스를 구현할 수 있습니다.
CancelablePrintJob	이 인터페이스는 인쇄 작업을 취소할 때에 인쇄 어플리케이션에 의해 사용됩니다.
Doc	Doc 인터페이스는 Print Job 용 인쇄 데이터의 일부를 제공하는 오브젝트에 대한 인터페이스를 지정합니다.
DocPrintJob	이 인터페이스는 작업 속성 세트를 보관 유지하는 지정된 문서를 인쇄 가능한 인쇄 작업을 나타냅니다.
FlavorException	FlavorException 인터페이스는 mixin 인터페이스로,PrintException 의 서브 클래스는 이 인터페이스를 구현해 doc 후레이바 (class 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 를 개입시켜 look 업 된 인쇄 서비스 열람용의 그래피컬한 유저 다이얼로그를 제공하는 편리성의 높은 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 메소드를 호출해, 어플리케이션의 인쇄 요구를 채우는 기능을 보관 유지하는 인쇄 서비스를 검출합니다. 예를 들어, 양면의 문서를 인쇄하는 경우, 어플리케이션은 양면 인쇄 기능을 가지는 프린터를 최초로 검출할 필요가 있습니다.

Java 2 SDK 에는 표준 플랫폼 프린터를 검출 가능한 PrintServiceLookup 구현이 포함됩니다. IPP 프린터나 JINI 프린터 등, 다른 형태의 프린터를 검출하는 경우, 인쇄 서비스 프로바이더는 PrintServiceLookup 의 구현을 기입할 수가 있습니다. 인쇄 서비스 프로바이더는 「SPI JAR 파일 사양」 을 사용해, 이러한 PrintServiceLookup 구현을 동적으로 인스톨 할 수 있습니다.

속성의 정의

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

javax.attribute 패키지에는 속성형, 및 속성형을 세트에 정리하는 방법을 기술합니다. javax.attribute.standard 패키지는 API 의 서포트하는 모든 표준 속성을 열거합니다. 이러한 속성의 대부분은 IETF 사양 「RFC 2911 Internet Printing Protocol, 1.1: Model and Semantics」 (2000 년 9 월)로 지정된 속성의 구현입니다. javax.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