javax.print
인터페이스 Doc

기존의 구현 클래스의 일람:

SimpleDoc

public interface Doc

Doc 인터페이스는 Print Job 용 인쇄 데이터의 일부를 제공하는 오브젝트에 대한 인터페이스를 지정합니다. 「Doc」란, 「인쇄 데이터의 일부」를 의미하는 짧게 발음하기 쉬운 용어입니다. 클라이언트는 Print Job 에 Doc 인터페이스를 구현하는 오브젝트를 건네주어, Print Job 는 오브젝트에 대해서 메소드를 호출해 인쇄 데이터를 취득합니다. Doc 인터페이스를 사용하는 것으로, Print Job 는 다음의 조작이 실행 가능하게 됩니다.

• 인쇄 데이터가 이용 가능한 형식 또는 「doc 후레이바」 (DocFlavor 클래스)을 판별한다. doc 후레이바는 인쇄 데이터 형식 (MIME 타입) 및 인쇄 데이터의 송신원오브젝트의 표현 클래스를 가리킨다

• doc 후레이바의 표현 클래스의 인스턴스인, 인쇄 데이터의 표현 오브젝트를 취득한다. 취득 후에, Print Job 는 표현 오브젝트로부터 인감 도장쇄데이터를 취득할 수 있다

• doc 의 추가 특성을 지정한다, 또는 doc 에 적용하는 처리 인스트럭션을 지정하는 인쇄 속성을 취득한다. 인쇄 속성은 패키지 javax.print.attribute 내에서 정의된다. doc 는 javax.print.attribute.DocAttributeSet 내에 저장된 출력 속성을 돌려준다

Doc 인터페이스의 구현내의 각 메소드에서는 메소드의 호출로 항상 같은 오브젝트를 돌려주는 것이 허가됩니다. 이것은 Print Job 또는 doc 오브젝트의 다른 호출측의 경우, 호출측이 인쇄 데이터를 취득할 때, 스트림인 인쇄 데이터 표현 오브젝트등의 인쇄 데이터를 「소비한다」일을 나타냅니다. Print Job 가 getPrintData() 를 호출해 스트림을 취득한 후에 getPrintData() 를 호출하면(자), 벌써 읽어들여 안의 같은 스트림 오브젝트가 돌려주어집니다. 인쇄 데이터를 최초부터 재차 읽어들이는 신규 스트림 오브젝트가 돌려주어질 것은 없습니다. 이러한 동작을 실행하는 doc 오브젝트를 지정하면(자), doc 오브젝트의 구현을 간략화할 수 있습니다. 이것은 특정의 doc 가 1 개의 Print Job (복수가 다른 Print Job 는 아니고)에 인쇄 데이터를 송신한다고 하는 이유로써 정당화 됩니다 (동일한 인쇄 데이터를 복수가 다른 Print Job 에 송신하는 경우는 1 개의 인쇄 데이터 소스의 최상정도에 복수가 다른 doc 오브젝트를 작성할 필요가 있습니다).

Doc 인터페이스에서는 구현에 꽤 유연성을 갖게할 수가 있습니다. doc 오브젝트의 구축시에는 인쇄 데이터가 벌써 존재하고 있는 경우가 있습니다. 이 경우, doc 의 메소드에 의해 돌려주어지는 오브젝트를 doc 의 constructor 에 제공해, 미리 doc 내에 저장해 두는 것으로, 호출시에 그대로 돌려주는 것만으로 끝납니다. 또, doc 오브젝트의 구축시에 인쇄 데이터가 존재하고 있지 않는 경우도 있습니다. 이 경우, doc 오브젝트는 「레이지」구현을 제공할 수 있습니다. Print Job 가 getPrintData() 메소드를 호출하면(자), 「레이지」구현은 인쇄 데이터 표현 오브젝트 (나 인쇄 데이터)를 생성합니다.

1 개의 doc 에 동시 액세스 가능한 클라이언트 thread수에 제한은 없습니다. 이 때문에, Doc 인터페이스의 구현은 모두, 복수의 thread 세이프이도록(듯이) 설계할 필요가 있습니다.

다만, Doc 로부터 취득된 인쇄 데이터의 컨슈머(consumer)는 1 개가 아니면 안됩니다.

Doc 의 getReaderForText() 나 getStreamForBytes() 메소드를 호출한다, 또는 인쇄 데이터 소스가 InputStream 또는 Reader 내에 존재하기 위해서, 인쇄 데이터가 클라이언트로부터 스트림으로서 취득되는 경우, 인쇄 서비스는 어느 작업 완료 조건의 경우에도 클라이언트에 대해서 이러한 스트림을 항상 닫을 필요가 있습니다. 다음의 점에 주의해 주세요. 인쇄 데이터 자체가 스트림의 경우, 서비스는 항상 인쇄 데이터를 닫습니다. 인쇄 데이터가 다른 방법으로 스트림으로서 요구 가능해, 종료전에 스트림을 취득 끝난 경우, 서비스는 스트림을 닫을 뿐입니다. 즉, 인쇄 서비스가 데이터를 스트림으로서 요구할 가능성이 있다고 하는 것만으로, 스트림을 닫는 서비스를 이용하는 Doc 구현자가 서비스로부터의 요구에 응답해 스트림을 작성해야 하는 것은 아닙니다.

메소드의 개요

DocAttributeSet	getAttributes () 이 doc 오브젝트의 인쇄 속성 세트를 취득합니다.
DocFlavor	getDocFlavor () 이 doc 오브젝트가 인쇄 데이터의 일부를 제공하는 doc 후레이바를 판별합니다.
Object	getPrintData () 이 doc 오브젝트의 인쇄 데이터의 일부를 포함한 인쇄 데이터 표현 오브젝트를, 서포트하는 doc 후레이바에 대응하는 형식에서 취득합니다.
Reader	getReaderForText () 캐릭터 인쇄 데이터를 추출하기 위한 리더를 이 doc 로부터 취득합니다.
InputStream	getStreamForBytes () 바이트 인쇄 데이터를 추출하기 위한 입력 스트림을 이 doc 로부터 취득합니다.

메소드의 상세

getDocFlavor

public DocFlavor  getDocFlavor()

이 doc 오브젝트가 인쇄 데이터의 일부를 제공하는 doc 후레이바를 판별합니다.

반환값:

Doc 후레이바

getPrintData

public Object  getPrintData()
                    throws IOException 

이 doc 오브젝트의 인쇄 데이터의 일부를 포함한 인쇄 데이터 표현 오브젝트를, 서포트하는 doc 후레이바에 대응하는 형식에서 취득합니다. getPrintData() 메소드는 표현 클래스의 인스턴스를 돌려줍니다 (표현 클래스명은 getDocFlavor() . getRepresentationClassName() 에 의해 지정). 반환값은 Object 클래스로부터 표현 클래스에 캐스트 가능합니다.

반환값:

인쇄 데이터 표현 오브젝트

예외:

IOException - 표현 클래스가 스트림이며, 스트림의 구축중에 입출력 에러가 발생했을 경우에 슬로우 된다

getAttributes

public DocAttributeSet  getAttributes()

이 doc 오브젝트의 인쇄 속성 세트를 취득합니다. 돌려주어지는 속성 세트에 특정의 속성 X 의 인스턴스가 포함되는 경우, 작업의 속성 세트의 속성 X 의 값을 오버라이드(override) 해, 프린터는 그 속성치를 이 doc 에 사용할 필요가 있습니다. 돌려주어지는 속성 세트에 특정의 속성 X 의 인스턴스가 포함되지 않는가, null 가 돌려주어지는 경우, 프린터는 작업의 속성 세트를 문의해 속성 X 의 값을 취득할 필요가 있습니다. 발견되지 않는 경우, 프린터는 구현 의존의 디폴트 값를 사용할 필요가 있습니다. 돌려주어진 속성 세트는 변경할 수 없습니다.

반환값:

이 doc 의 변경 불가능한 인쇄 속성 세트, 또는 작업의 속성 세트로부터 모든 속성치를 취득하는 경우는 null

getReaderForText

public Reader  getReaderForText()
                        throws IOException 

캐릭터 인쇄 데이터를 추출하기 위한 리더를 이 doc 로부터 취득합니다. DocFlavor 가 다음의 인쇄 데이터 표현 클래스의 어떤 것인지를 보관 유지하는 경우, Doc 구현이 이 메소드를 서포트할 필요가 있습니다. 보관 유지하지 않는 경우, null 가 돌려주어집니다.

• char[]
• java.lang.String
• java.io.Reader

doc 의 인쇄 데이터 표현 오브젝트를 사용해, 인쇄 데이터를 캐릭터의 스트림으로서 읽어내기 위한 Reader 를 구축해 돌려줍니다. 다만, 인쇄 데이터 표현 오브젝트 자체가 Reader 의 경우, 인쇄 데이터 표현 오브젝트가 돌려주어질 뿐입니다.

반환값:

이 doc 로부터 인쇄 데이터 캐릭터를 읽어내기 위한 리더. 이 doc 가 상기의 기준을 채우지 않기 위해(때문에) 리더를 사용할 수 없는 경우에 null 가 돌려주어진다

예외:

IOException - 리더의 작성중에 입출력 에러가 발생했을 경우에 슬로우 된다

getStreamForBytes

public InputStream  getStreamForBytes()
                              throws IOException 

바이트 인쇄 데이터를 추출하기 위한 입력 스트림을 이 doc 로부터 취득합니다. DocFlavor 가 다음의 인쇄 데이터 표현 클래스의 어떤 것인지를 보관 유지하는 경우, Doc 구현이 이 메소드를 서포트할 필요가 있습니다. 보관 유지하지 않는 경우, null 가 돌려주어집니다.

• byte[]
• java.io.InputStream

이 doc 의 인쇄 데이터 표현 오브젝트의 취득 후에, 인쇄 데이터 표현 오브젝트로부터 인쇄 데이터를 바이트 스트림으로서 읽어내기 위한 입력 스트림이 작성되어 돌려주어집니다. 다만, 인쇄 데이터 표현 오브젝트 자체가 입력 스트림의 경우는 인쇄 데이터 표현 오브젝트가 돌려주어질 뿐입니다.

반환값:

이 doc 로부터 인쇄 데이터 바이트를 읽어내기 위한 입력 스트림. 이 doc 가 상기의 기준을 채우지 않기 위해(때문에) 입력 스트림을 사용할 수 없는 경우에 null 가 돌려주어진다

예외:

IOException - 입력 스트림의 작성중에 입출력 에러가 발생했을 경우에 슬로우 된다