javax.print

Интерфейс MultiDoc

public interface MultiDoc

MultiDoc интерфейса определяет интерфейс для объекта, который предоставляет больше чем одну часть данных печати для Задания Печати. "Документ" является коротким, термин, "легкий объявить, что" это означает "часть данных печати," и "мультидокумент" является группой нескольких документов. Клиент передает к Заданию Печати объект, который реализует интерфейс MultiDoc, и Задание Печати вызывает методы на том объекте получить данные печати.

Интерфейс MultiDoc обеспечивает абстракцию, подобную "связанному списку" документов. Объект мультидокумента походит на узел в связанном списке, содержа текущий документ в списке и указателе на следующий узел (мультидокумент) в списке. Задание Печати может вызвать мультидокумент getDoc() метод, чтобы получить текущий документ. Когда это готово продолжиться к следующему документу, Задание Печати может вызвать мультидокумент next() метод, чтобы получить следующий мультидокумент, который содержит следующий документ. Таким образом, код Задания Печати для того, чтобы получить доступ к мультидокументу мог бы быть похожим на это:

      void processMultiDoc(MultiDoc theMultiDoc) {

          MultiDoc current = theMultiDoc;

          while (current != null) {
              processDoc (current.getDoc());
              current = current.next();
          }
      }
 

Конечно, интерфейс, MultiDoc может быть реализован всегда, который выполняет контракт; это не должно использовать связанный список в реализации.

Чтобы получить все данные печати для задания печати мультидокумента, прокси Службы печати мог использовать любой из двух образцов:

1. Чередованный образец: Получите документ из текущего мультидокумента. Получите объект представления данных печати из текущего документа. Получите все данные печати от объекта представления данных печати. Получите следующий мультидокумент из текущего мультидокумента, и повторение, пока нет больше. (Пример кода выше использует чередованный образец.)

2. Внезапно образец: Получите документ из текущего мультидокумента, и сохраните документ в списке. Получите следующий мультидокумент из текущего мультидокумента, и повторение, пока нет больше. Затем выполните итерации по списку сохраненных документов. Получите объект представления данных печати из текущего документа. Получите все данные печати от объекта представления данных печати. Пойдите в следующий документ в списке, и повторение, пока нет больше.

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

Чтобы рассмотреть эту проблему, и упростить проект клиентов, обеспечивающих многократные документы Заданию Печати, каждый прокси Службы печати, который поддерживает задания печати мультидокумента, обязан получать доступ к объекту MultiDoc использование чередованного образца. Таким образом, учитывая объект MultiDoc, прокси службы печати вызовет getDoc() один или более раз, пока это успешно не получает текущий объект Документа. Прокси службы печати тогда получит данные печати текущего документа, не продолжаясь, пока все данные печати не будут получены, или неисправимая ошибка происходит. Если это будет в состоянии продолжаться, то прокси службы печати тогда вызовет next() один или более раз, пока это успешно не получает или следующий объект MultiDoc или индикацию, что нет больше. Реализация интерфейса, MultiDoc может принять прокси службы печати, будет следовать за этим чередованным образцом; для любого другого образца использования поведение реализации MultiDoc является неуказанным.

Нет никакого ограничения на число клиентских потоков, которые могут одновременно получать доступ к тому же самому мультидокументу. Поэтому, все реализации интерфейса MultiDoc должны быть разработаны, чтобы быть многократны ориентированный на многопотоковое исполнение. Фактически, клиентский поток мог добавлять документы до конца (концептуального) списка, в то время как поток Задания Печати одновременно получает документы с начала списка; если объект мультидокумента синхронизирует потоки должным образом, два потока не будут вмешиваться друг в друга

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

Модификатор и Тип	Метод и Описание
Документ	getDoc() Получите текущий объект документа.
MultiDoc	next() Пойдите в объект мультидокумента, который содержит следующий объект документа в последовательности объектов документа.

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

getDoc

Doc getDoc()
    throws IOException

Получите текущий объект документа.

Возвраты:

Текущий объект документа.

Броски:

IOException - Брошенный, если ошибка ocurred чтение документа.

затем

MultiDoc next()
       throws IOException

Пойдите в объект мультидокумента, который содержит следующий объект документа в последовательности объектов документа.

Возвраты:

Объект мультидокумента, содержащий следующий объект документа, или нуль, если нет никаких дальнейших объектов документа.

Броски:

IOException - Брошенный, если ошибка произошла, определяя местоположение следующего документа