javax.print
인터페이스 DocPrintJob

알려진 서브 인터페이스 목록 :

CancelablePrintJob, MultiDocPrintJob

public interface DocPrintJob

이 인터페이스는 작업 속성 세트를 보관 유지하는 지정된 문서를 인쇄 가능한 인쇄 작업을 나타냅니다. 이 인터페이스를 구현하는 객체는 인쇄 서비스로부터 취득할 수 있습니다.

메서드 개요

void	addPrintJobAttributeListener (PrintJobAttributeListener listener, PrintJobAttributeSet attributes) 지정된 속성의 변경용의 리스너를 등록합니다.
void	addPrintJobListener (PrintJobListener listener) 이 인쇄 작업시에 발생하는 이벤트의 리스너를 등록합니다.
PrintJobAttributeSet	getAttributes () 이 Print Job 인쇄 속성 세트를 취득합니다.
PrintService	getPrintService () 이 인쇄 작업이 바인드 되고 있는 PrintService 객체를 판별합니다.
void	print (Doc doc, PrintRequestAttributeSet attributes) 문서가 지정된 작업 속성으로 인쇄합니다.
void	removePrintJobAttributeListener (PrintJobAttributeListener listener) 이 인쇄 작업으로부터 속성 리스너를 삭제합니다.
void	removePrintJobListener (PrintJobListener listener) 이 인쇄 작업으로부터 리스너를 삭제합니다.

메서드의 상세

getPrintService

PrintService  getPrintService()

이 인쇄 작업이 바인드 되고 있는 PrintService 객체를 판별합니다.

반환값:

PrintService 객체

getAttributes

PrintJobAttributeSet  getAttributes()

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

반환값:

인쇄 작업 속성

addPrintJobListener

void addPrintJobListener(PrintJobListener  listener)

이 인쇄 작업시에 발생하는 이벤트의 리스너를 등록합니다. 리스너가 null인 경우, 예외가 발생되지 않고 액션은 실행되지 않습니다. 리스너가 등록을 마친 경우는 재차 등록됩니다.

파라미터:

listener - 리스너 인터페이스를 구현하는 객체

관련 항목:

removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

void removePrintJobListener(PrintJobListener  listener)

이 인쇄 작업으로부터 리스너를 삭제합니다. 인수로 지정된 리스너가 이전에 이 컴퍼넌트에 추가되었던 적이 없는 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. 리스너가 null인 경우, 예외가 발생되지 않고 액션은 실행되지 않습니다. 리스너가 여러 차례 등록되어 있는 경우, 등록의 1개 만이 삭제됩니다.

파라미터:

listener - 리스너 인터페이스를 구현하는 객체

관련 항목:

addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

void addPrintJobAttributeListener(PrintJobAttributeListener  listener,
                                  PrintJobAttributeSet  attributes)

지정된 속성의 변경용의 리스너를 등록합니다. 리스너가 null인 경우, 예외가 발생되지 않고 액션은 실행되지 않습니다. 이 작업이 보고하는 속성 갱신을 판별하기 위해, 클라이언트는 getAttributes()/를 호출해, 리스너에게 보고하는 것 같은 관심이 있는 부분집합을 식별할 수 있습니다. 특정의 작업 속성의 변경 갱신을 기대하고 있는 클라이언트는 해당하는 세트인 것을 확인할 필요가 있습니다. 다만, 속성의 갱신은 실제로 변경을의해 작업이 그것을 검출했을 경우인 만큼 실행됩니다. 갱신은 또, 작업에 한 배치처리의 대상이 되는 경우가 있습니다. 인쇄 작업의 처리로 발생하는 오버헤드를 최소한으로 억제하기 때문에 변경을 할 가능성의 높은 속성의 부분집합만으로 대기를 실시하는 것을 추천합니다. 지정된 세트가 비어있는 경우, 속성의 갱신은 리스너에게 보고되지 않습니다. 속성 세트가 null인 경우, 작업이 지원하는 모든 동적 속성으로 대기하는 것을의미합니다. 이 때문에 작업이 속성 갱신을 1개 도 보고할 수 없는 경우, 갱신 통지는 일절 행해지지 않습니다. 리스너가 등록을 마친 경우, 재차 등록됩니다.

파라미터:

listener - 리스너 인터페이스를 구현하는 객체

attributes - 작업에 의해 결정된 대기 대상의 속성, 또는 변경 가능한 모든 속성을의미하는 null

관련 항목:

removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)

removePrintJobAttributeListener

void removePrintJobAttributeListener(PrintJobAttributeListener  listener)

이 인쇄 작업으로부터 속성 리스너를 삭제합니다. 인수로 지정된 리스너가 이전에 이 컴퍼넌트에 추가되었던 적이 없는 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. 리스너가 null인 경우, 예외가 발생되지 않고 액션은 실행되지 않습니다. 리스너가 여러 차례 등록되어 있는 경우 (그것이 다른 속성 세트에 대해서에서 만나도), 어느 리스너가 삭제될까는 보증되지 않습니다.

파라미터:

listener - 리스너 인터페이스를 구현하는 객체

관련 항목:

addPrintJobAttributeListener(javax.print.event.PrintJobAttributeListener, javax.print.attribute.PrintJobAttributeSet)

print

void print(Doc  doc,
           PrintRequestAttributeSet  attributes)
           throws PrintException 

문서가 지정된 작업 속성으로 인쇄합니다. 이 메서드는 지정된 인쇄 작업 마다 한 번만 호출할 필요가 있습니다. 이 메서드를 재차 호출해도, 새로운 작업이 프린터에 spool 될 것은 없습니다. 서비스 구현은 서비스의 인터럽트 및 복원용의 정책를 정의합니다. 인쇄 메서드의 복귀시에 다른 thread로 인쇄가 비동기에게 발생했다는 등의 이유로써, 인쇄가 완료하고 있지 않는 경우가 있습니다. 이 때문에 성공 또는 실패를 감시하는 어플리케이션 클라이언트를 PrintJobListener에 등록할 필요가 있습니다.

인쇄 서비스의 구현자는 클라이언트 doc 로부터 취득한 모든 인쇄 데이터 스트림 (Reader 또는 InputStream 구현)을 닫을 필요가 있습니다. 견뢰한 클라이언트안에는 이것을 검증하는 것도 있습니다. DocFlavor를 출력할 수 없는 경우, 항상 예외가 생성됩니다.

파라미터:

doc - 인쇄하는 문서. 이 PrintJob가 지원하는 플레이버가 아니면 안되는

attributes - 이 인쇄 작업에 적용하는 작업 속성. 이 파라미터가 null인 경우, 디폴트 속성이 사용된다

예외:

PrintException - 이 예외에의해 원인을 보다 정확하게 기술하는 인터페이스가 구현되는 일도 있다

• FlavorException. 문서에 이 인쇄 작업으로 지원 되지 않는 플레이버가 포함되어 있는 경우
• AttributeException. 이 인쇄 작업에 유효하지 않은 속성이 1개 이상 있는 경우