javax.print

Класс SimpleDoc

java.lang. Объект

javax.print. SimpleDoc

Все Реализованные Интерфейсы:

Документ

public final class SimpleDoc
extends Object
implements Doc

Этот class является реализацией интерфейса Doc это может использоваться во многих общих запросах печати. Это может обработать все теперь определенные "предопределенные" разновидности документа, определенные как статические переменные в DocFlavor class.

В особенности этот class реализует определенную необходимую семантику спецификации Документа следующим образом:

• создает поток для службы если требующийся и соответствующий.
• гарантирует, что тот же самый объект возвращается для каждого запроса к методу.
• гарантирует, что многократные потоки могут получить доступ к Документу
• выполняет некоторую проверку допустимости, которой данные соответствуют разновидность документа.

Клиенты, которые хотят снова использовать объект документа на других заданиях, или нуждаться в MultiDoc, не будут хотеть использовать этот class.

Если данные печати являются потоком, или задание печати запрашивает данные как поток, то SimpleDoc не контролирует, если служба должным образом закрывает поток после завершения передачи данных или завершения задания. Клиенты могут предпочесть использовать, обеспечивают их собственную реализацию документа, который добавляет слушателя, чтобы контролировать завершение задания и проверить этого, ресурсы, такие как потоки освобождаются (то есть закрываются).

Сводка конструктора

Конструкторы

Конструктор и Описание
SimpleDoc(Object printData, DocFlavor flavor, DocAttributeSet attributes) Конструкции a SimpleDoc с указанными данными печати устанавливаются разновидность документа и атрибут документа.

Сводка метода

Модификатор и Тип	Метод и Описание
DocAttributeSet	getAttributes() Получает набор печати атрибутов для этого объекта документа.
DocFlavor	getDocFlavor() Определяет разновидность документа, в которой этот объект документа предоставит свою часть данных печати.
Объект	getPrintData() Получает объект представления данных печати, который содержит эту часть объекта документа данных печати в формате, соответствующем поддерживаемой разновидности документа.
Читатель	getReaderForText() Получает читателя для того, чтобы извлечь символьные данные печати из этого документа.
InputStream	getStreamForBytes() Получает входной поток для того, чтобы извлечь данные печати байта из этого документа.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

SimpleDoc

public SimpleDoc(Object printData,
                 DocFlavor flavor,
                 DocAttributeSet attributes)

Конструкции a SimpleDoc с указанными данными печати устанавливаются разновидность документа и атрибут документа.

Параметры:

printData - объект данных печати

flavor - DocFlavor объект

attributes - a DocAttributeSet, который может быть null

Броски:

IllegalArgumentException - если flavor или printData null, или printData не соответствует указанной разновидности документа - например, данные не имеют типа, определенного как представление в DocFlavor.

Деталь метода

getDocFlavor

public DocFlavor getDocFlavor()

Определяет разновидность документа, в которой этот объект документа предоставит свою часть данных печати.

Определенный:

getDocFlavor в интерфейсе Doc

Возвраты:

Разновидность документа.

getAttributes

public DocAttributeSet getAttributes()

Получает набор печати атрибутов для этого объекта документа. Если возвращенный набор атрибута включает экземпляр определенного атрибута X, принтер должен использовать то значение атрибута для этого документа, переопределяя любое значение атрибута X в наборе атрибута задания. Если возвращенный набор атрибута не включает экземпляр определенного атрибута X или если нуль возвращается, принтер должен консультироваться с набором атрибута задания, чтобы получить значение для атрибута X, и если не найденный там, принтер должен использовать зависящее от реализации значение по умолчанию. Возвращенный набор атрибута является неподдающимся изменению.

Определенный:

getAttributes в интерфейсе Doc

Возвраты:

Неподдающийся изменению набор печати атрибутов для этого документа, или нуля, чтобы получить все значения атрибута из набора атрибута задания.

getPrintData

public Object getPrintData()
                    throws IOException

Описание скопировало с интерфейса: Doc

Получает объект представления данных печати, который содержит эту часть объекта документа данных печати в формате, соответствующем поддерживаемой разновидности документа. getPrintData() метод возвращает экземпляр представления class, именем которого дают getDocFlavor().getRepresentationClassName(), и возвращаемое значение может быть брошено от Объекта class до того представления class.

Определенный:

getPrintData в интерфейсе Doc

Возвраты:

Напечатайте объект представления данных.

Броски:

IOException - Брошенный, если представление class является потоком и была ошибка ввода-вывода, создавая поток.

getReaderForText

public Reader getReaderForText()
                        throws IOException

Получает читателя для того, чтобы извлечь символьные данные печати из этого документа. Doc реализация обязана поддерживать этот метод если DocFlavor имеет один из следующих классов представления данных печати, и возврат null иначе:

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

Объект представления данных печати документа используется, чтобы создать и возвратить a Reader для того, чтобы считать данные печати как поток символов от объекта представления данных печати. Однако, если объект представления данных печати самостоятельно a Reader тогда объект представления данных печати просто возвращается.

Определенный:

getReaderForText в интерфейсе Doc

Возвраты:

a Reader для того, чтобы считать символы данных печати из этого документа. Если читателю нельзя предоставить, потому что этот документ не соответствует вышеизложенным критериям, null возвращается.

Броски:

IOException - если была ошибка ввода-вывода, создавая читателя.

getStreamForBytes

public InputStream getStreamForBytes()
                              throws IOException

Получает входной поток для того, чтобы извлечь данные печати байта из этого документа. Doc реализация обязана поддерживать этот метод если DocFlavor имеет один из следующих классов представления данных печати; иначе этот метод возвраты null:

• byte[]
• java.io.InputStream

Объект представления данных печати документа получается. Затем, входной поток для того, чтобы считать данные печати из объекта представления данных печати как поток байтов создается и возвращается. Однако, если объект представления данных печати является самостоятельно входным потоком тогда, объект представления данных печати просто возвращается.

Определенный:

getStreamForBytes в интерфейсе Doc

Возвраты:

InputStream для того, чтобы считать байты данных печати из этого документа. Если входной поток не может быть обеспечен, потому что этот документ не соответствует вышеизложенным критериям, null возвращается.

Броски:

IOException - если была ошибка ввода-вывода, создавая входной поток.