javax.activation

Класс MailcapCommandMap

java.lang. Объект

javax.activation. CommandMap

javax.activation. MailcapCommandMap

public class MailcapCommandMap
extends CommandMap

MailcapCommandMap расширяет краткий обзор CommandMap class. Это реализует CommandMap, конфигурация которого основана на mailcap файлах (RFC 1524). MailcapCommandMap может быть сконфигурирован и программно и через конфигурационные файлы.

Файл Mailcap ищет порядок:

MailcapCommandMap смотрит в различных местах в системе пользователя для mailcap записей файла. Когда с просьбами обращаются, чтобы искать команды в MailcapCommandMap, он ищет mailcap файлы в следующем порядке:

1. Програматикалли добавленные записи в экземпляр MailcapCommandMap.
2. Файл .mailcap в корневом каталоге пользователя.
3. Файл <java.home>/lib/mailcap.
4. Файл или ресурсы называют META-INF/mailcap.
5. Файл или ресурс называют META-INF/mailcap.default (обычно находимый только в activation.jar файл).

Формат файла Mailcap:

Файлы Mailcap должны соответствовать mailcap спецификации файла (RFC 1524, Механизм Конфигурации Агента пользователя Для Мультимедийной Почтовой информации о Формате). Формат файла состоит из записей, соответствующих определенным типам MIME. Вообще, спецификация определяет приложения для клиентов, чтобы использовать, когда сами они не могут работать на указанном типе MIME. MailcapCommandMap расширяет эту спецификацию при использовании механизма параметра в mailcap файлах, который позволяет JavaBeans (ТМ) компоненты быть определенным как соответствие определенным командам для типа MIME.

Когда mailcap файл анализируется, MailcapCommandMap распознает определенные подписи параметра, определенно те названия параметра, которые начинаются x-java-. MailcapCommandMap использует эту подпись, чтобы найти записи команды для включения в ее реестры. Названия параметра с формой x-java-<name> читаются MailcapCommandMap как идентификация команды с именем имени. Когда имя content-handler MailcapCommandMap распознает class, показанный этим параметром как DataContentHandler. Все другие команды обрабатываются в общем независимо от названия команды. Реализация команды определяется полностью определенным именем class JavaBean (ТМ) компонент. Например; команда для того, чтобы просмотреть некоторые данные может быть определена как: x-java-view=com.foo.ViewBean.

Когда название команды fallback-entry, значение команды может быть true или false. Запись для типа MIME, который включает параметр x-java-fallback-entry=true определяет команды нейтрализации для того типа MIME, который будет только использоваться, если никакая запись ненейтрализации не может быть найдена. Например, запись формы text/*; ; x-java-fallback-entry=true; x-java-view=com.sun.TextViewer определяет команду представления, которая будет использоваться для любого текстового типа MIME. Эта команда представления только использовалась бы, если команда представления ненейтрализации для типа MIME не могла бы быть найдена.

У MailcapCommandMap осведомленные mailcap файлы есть следующая общая форма:

# Comments begin with a '#' and continue to the end of the line.
<mime type>; ; <parameter list>
# Where a parameter list consists of one or more parameters,
# where parameters look like: x-java-view=com.sun.TextViewer
# and a parameter list looks like:
text/plain; ; x-java-view=com.sun.TextViewer; x-java-edit=com.sun.TextEdit
# Note that mailcap entries that do not contain 'x-java' parameters
# and comply to RFC 1524 are simply ignored:
image/gif; /usr/dt/bin/sdtimage %s


С тех пор:

1.6

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

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

Конструктор и Описание
MailcapCommandMap() Конструктор по умолчанию.
MailcapCommandMap(InputStream is) Конструктор, который позволяет вызывающей стороне определять InputStream, содержащий mailcap файл.
MailcapCommandMap(String fileName) Конструктор, который позволяет вызывающей стороне определять путь mailcap файла.

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

Модификатор и Тип	Метод и Описание
void	addMailcap(String mail_cap) Добавьте записи в реестр.
DataContentHandler	createDataContentHandler(String mimeType) Возвратите DataContentHandler для указанного типа MIME.
CommandInfo[]	getAllCommands(String mimeType) Получите все доступные команды во всех mailcap файлах, известных этому экземпляру MailcapCommandMap для этого типа MIME.
CommandInfo	getCommand(String mimeType, String cmdName) Получите соответствие команды cmdName для типа MIME.
Строка[]	getMimeTypes() Получите все типы MIME, известные этой карте команды.
Строка[]	getNativeCommands(String mimeType) Получите собственные команды для данного типа MIME.
CommandInfo[]	getPreferredCommands(String mimeType) Получите привилегированный список команд для Типа MIME.

Методы, наследованные от class javax.activation. CommandMap

createDataContentHandler, getAllCommands, getCommand, getDefaultCommandMap, getPreferredCommands, setDefaultCommandMap

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

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

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

MailcapCommandMap

public MailcapCommandMap()

Конструктор по умолчанию.

MailcapCommandMap

public MailcapCommandMap(String fileName)
                  throws IOException

Конструктор, который позволяет вызывающей стороне определять путь mailcap файла.

Параметры:

fileName - Имя mailcap файла, чтобы открыться

Броски:

IOException - если к файлу нельзя получить доступ

MailcapCommandMap

public MailcapCommandMap(InputStream is)

Конструктор, который позволяет вызывающей стороне определять InputStream, содержащий mailcap файл.

Параметры:

is - InputStream mailcap файла, чтобы открыться

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

getPreferredCommands

public CommandInfo[] getPreferredCommands(String mimeType)

Получите привилегированный список команд для Типа MIME. MailcapCommandMap ищет mailcap файлы как описано выше согласно порядку поиска файла Mailcap.

Результатом поиска является собственное подмножество доступных команд во всех mailcap файлах, известных этому экземпляру MailcapCommandMap. Первую запись для определенной команды считают привилегированной командой.

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

getPreferredCommands в class CommandMap

Параметры:

mimeType - тип MIME

Возвраты:

объекты CommandInfo, представляющие привилегированные команды.

getAllCommands

public CommandInfo[] getAllCommands(String mimeType)

Получите все доступные команды во всех mailcap файлах, известных этому экземпляру MailcapCommandMap для этого типа MIME.

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

getAllCommands в class CommandMap

Параметры:

mimeType - тип MIME

Возвраты:

объекты CommandInfo, представляющие все команды.

getCommand

public CommandInfo getCommand(String mimeType,
                              String cmdName)

Получите соответствие команды cmdName для типа MIME.

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

getCommand в class CommandMap

Параметры:

mimeType - тип MIME

cmdName - название команды

Возвраты:

соответствие объекта CommandInfo команде.

addMailcap

public void addMailcap(String mail_cap)

Добавьте записи в реестр. Программно добавленные записи ищутся перед другими записями.

Строка, которую передают в, должна быть в формате mailcap.

Параметры:

mail_cap - правильно форматированная строка mailcap

createDataContentHandler

public DataContentHandler createDataContentHandler(String mimeType)

Возвратите DataContentHandler для указанного типа MIME.

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

createDataContentHandler в class CommandMap

Параметры:

mimeType - тип MIME

Возвраты:

DataContentHandler

getMimeTypes

public String[] getMimeTypes()

Получите все типы MIME, известные этой карте команды.

Переопределения:

getMimeTypes в class CommandMap

Возвраты:

массив MIME вводит как строки

С тех пор:

JAF 1.1

getNativeCommands

public String[] getNativeCommands(String mimeType)

Получите собственные команды для данного типа MIME. Возвращает массив строк, где каждая строка является всей mailcap записью файла. Приложение должно будет проанализировать запись, чтобы извлечь фактическую команду так же как любые атрибуты, в которых это нуждается. См. RFC 1524 для деталей mailcap синтаксиса записи. Только записи mailcap, которые определяют команду представления для указанного типа MIME, возвращаются.

Возвраты:

массив собственных записей команды

С тех пор:

JAF 1.1