Spec-Zone .ru
спецификации, руководства, описания, API
 Платформа Java™
Стандарт Эд. 7

Пакет javax.print.attribute.standard

Пакет javax.print.attribute.standard содержит классы для определенных атрибутов печати.

См.: Описание

Пакет javax.print.attribute.standard Описание

Пакет javax.print.attribute.standard содержит классы для определенных атрибутов печати. Родительский пакет, javax.print.attribute, обеспечивает классы и интерфейсы, которые описывают типы атрибутов Службы печати Java и как они могут быть собраны в наборы атрибута.

Атрибут представляет функцию печати, которую может обеспечить служба печати. Для каждого атрибута служба печати или делает или не поддерживает атрибут. Для каждого возможного значения поддерживаемого атрибута служба печати или делает или не поддерживает значение.

API требует, чтобы каждая служба печати поддерживала определенные атрибуты; другие атрибуты являются дополнительными, и служба может выбрать, поддерживать ли их. У каждого атрибута есть ряд значений, которые это принимает. API требует, чтобы каждая служба печати поддерживала определенные значения для определенных атрибутов; другие значения атрибута являются дополнительными, и служба может выбрать, поддерживать ли их. Эти требования поддержки записываются в документации для каждого класса атрибута.

Пакет javax.print.attribute.standard содержит стандартные атрибуты печати и стандартные значения атрибута печати, которые широко используются в домене печати. Поставщик службы печати может обеспечить новые специфичные для поставщика атрибуты печати в дополнение к стандартным. Поставщик может также обеспечить специфичные для поставщика расширения (подклассы) стандартных атрибутов печати - например, чтобы обеспечить дополнительные специфичные для поставщика значения для существующего стандартного атрибута. Конечно, если поставщик хочет, чтобы клиенты были в состоянии использовать какие-либо добавленные или расширенные атрибуты, поставщик должен опубликовать новые классы атрибута.

Многие из стандартных классов атрибута расширяют один из классов абстрактного синтаксиса javax.print.attribute пакета. Эти классы абстрактного синтаксиса каждый представляет различный тип. Класс EnumSyntax, например, представляет безопасное с точки зрения типов перечисление. Класс абстрактного синтаксиса обеспечивает обертку для значения атрибута.

Если класс атрибута расширяется EnumSyntax, и значение атрибута является IPP-совместимым значением, атрибут toString метод возвращает строковое представление IPP значения атрибута, такой как "остановлено обработкой" для атрибута JobState. Однако, потому что EnumSyntax класс расширяем, поставщики могут определить свои собственные значения атрибута. Если атрибут использует EnumSyntax класс и устанавливается в одно из этих определенных поставщиком значений тогда toString метод не будет возвращать строковое представление IPP значения.

Клиентское приложение печати не должно будет обычно использовать все классы атрибута печати в пакете javax.print.attribute.standard, только те, которые принадлежат приложению.

Классы атрибута в пакете javax.print.attribute.standard основаны на интернет-Протоколе Печати (IPP) атрибуты как определено в интернет-документе RFC, интернет-Протоколе/1.1 Печати RFC 2911: Модель и Семантика, датированная сентябрем 2000. См. RFC 2911 для получения дополнительной информации. Дескриптивный текст для каждого класса атрибута был взят в значительной степени из вышеупомянутых документов. Содействие вышеупомянутых авторов API с благодарностью подтверждается.

Организация атрибута

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

Атрибуты документа

Атрибуты документа определяют характеристики отдельного документа и настроек задания печати, которые будут применены к отдельному документу. Класс атрибута документа реализует интерфейсный DocAttribute. Атрибут документа может появиться в DocAttributeSet.

Атрибуты Запроса печати

Атрибуты запроса печати определяют настройки, которые будут применены к целому заданию печати и ко всем документам на задании печати. Класс атрибута запроса печати реализует интерфейсный PrintRequestAttribute. Атрибут запроса печати может появиться в PrintRequestAttributeSet.

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

Когда определено на уровне документа, атрибут применяется только к тому одному документу. Когда определено на уровне Запроса Печати, атрибут применяется к целому заданию, включая все документы на задании. Однако, атрибут, определенный на уровне документа, переопределяет атрибут в той же самой категории, определенной на уровне Запроса Печати.

Атрибуты Задания печати

Атрибуты задания печати сообщают о состоянии Задания Печати. Класс атрибута задания печати реализует интерфейсный PrintJobAttribute. Атрибут задания печати может появиться в PrintJobAttributeSet.

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

Атрибуты Службы печати

Атрибуты службы печати сообщают о состоянии службы печати. Класс атрибута службы печати реализует интерфейсный PrintServiceAttribute. Атрибут службы печати может появиться в PrintServiceAttributeSet.

Атрибуты поддерживаемых значений

Атрибут поддерживаемого значения указывает на юридические значения для другого атрибута, который поддерживает служба печати. Поддерживаемые значения приписывают интерфейс реализаций класса SupportedValuesAttribute. Однако, атрибуты поддерживаемых значений никогда не появляются в наборах атрибута, таким образом есть не ограниченный подынтерфейс AttributeSet для них.

Таблица атрибутов

Таблица ниже приводит все атрибуты печати. Таблица показывает, что тегирование соединяет интерфейсом с каждым классом атрибута реализации, кроме того, чтобы соединить интерфейсом с Атрибутом, таким образом указывая, как каждый атрибут используется в API. Для каждого атрибута документа и атрибута запроса печати, столбец отмеченный "SupportedValuesAttribute" перечисляет класс атрибута поддерживаемых значений, если таковые вообще имеются, с которым служба печати указывает на поддерживаемые значения для той категории атрибута.

Класс атрибута Документ
Атрибут
Печать
Запрос
Атрибут
Печать
Задание
Атрибут
Печать
Служба
Атрибут
SupportedValuesAttribute
СжатиеX    
DocumentNameX    
ЦветностьXXX  
Копии XX CopiesSupported
FinishingsXXX  
JobHoldUntil XX  
JobImpressions XX JobImpressionsSupported
JobKOctets XX JobKOctetsSupported
JobMediaSheets XX JobMediaSheetsSupported
JobName XX  
JobPriority XX JobPrioritySupported
JobSheets XX  
НосителиXXX  
MediaSize     
MultipleDocumentHandling XX  
NumberUpXXX NumberUpSupported
OrientationRequestedXXX  
PageRangesXXX  
PresentationDirectionXXX  
PrinterResolutionXXX  
PrintQualityXXX  
RequestingUserName XX  
SheetCollateXXX  
СтороныXXX  
DateTimeAtCompleted  X  
DateTimeAtCreation  X  
DateTimeAtProcessing  X  
JobImpressionsCompleted  X  
JobKOctetsProcessed  X  
JobMediaSheetsCompleted  X  
JobMessageFromOperator  X  
JobOriginatingUserName  X  
JobState  X  
JobStateReasons
Содержит нуль или более-
  X  
-- Джобстэтерисон     
NumberOfDocuments  X  
NumberOfInterveningJobs  X  
OutputDeviceAssigned  X  
ColorSupported   X 
PagesPerMinute   X 
PagesPerMinuteColor   X 
PDLOverrideSupported   X 
PrinterIsAcceptingJobs   X 
PrinterInfo   X 
PrinterLocation   X 
PrinterMessageFromOperator   X 
PrinterMakeAndModel   X 
PrinterMoreInfo   X 
PrinterMoreInfoManufacturer   X 
PrinterName   X 
PrinterState   X 
PrinterStateReasons
Содержит нуль или более-
   X 
-- Принтерстэтерисон     
-- Серьезность     
QueuedJobCount   X 
ReferenceUriSchemesSupported     

Пожалуйста, отметьте: В javax.print API нулевой ссылочный параметр к методам является неправильным если явно не задокументировано на методе как наличие значимой интерпретации. Использование наоборот является неправильным кодированием и может привести к исключению времени выполнения или сразу или в некоторое более позднее время. IllegalArgumentException и NullPointerException являются примерами типичных и приемлемых исключений времени выполнения для таких случаев.

С тех пор:
1.4
 Платформа Java™
Стандарт Эд. 7

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.