Spec-Zone .ru
спецификации, руководства, описания, API
|
public class MailcapCommandMap extends CommandMap
Файл Mailcap ищет порядок:
MailcapCommandMap смотрит в различных местах в системе пользователя для mailcap записей файла. Когда с просьбами обращаются, чтобы искать команды в MailcapCommandMap, он ищет mailcap файлы в следующем порядке:
.mailcap
в корневом каталоге пользователя. /lib/mailcap
. META-INF/mailcap
. 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 распознает класс, показанный этим параметром как DataContentHandler. Все другие команды обрабатываются в общем независимо от названия команды. Реализация команды определяется полностью определенным именем класса 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
Конструктор и Описание |
---|
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.
|
createDataContentHandler, getAllCommands, getCommand, getDefaultCommandMap, getPreferredCommands, setDefaultCommandMap
public MailcapCommandMap()
public MailcapCommandMap(String fileName) throws IOException
fileName
- Имя mailcap файла, чтобы открытьсяIOException
- если к файлу нельзя получить доступpublic MailcapCommandMap(InputStream is)
is
- InputStream mailcap файла, чтобы открытьсяpublic CommandInfo[] getPreferredCommands(String mimeType)
Результатом поиска является собственное подмножество доступных команд во всех mailcap файлах, известных этому экземпляру MailcapCommandMap. Первую запись для определенной команды считают привилегированной командой.
getPreferredCommands
в классе CommandMap
mimeType
- тип MIMEpublic CommandInfo[] getAllCommands(String mimeType)
getAllCommands
в классе CommandMap
mimeType
- тип MIMEpublic CommandInfo getCommand(String mimeType, String cmdName)
cmdName
для типа MIME.getCommand
в классе CommandMap
mimeType
- тип MIMEcmdName
- название командыpublic void addMailcap(String mail_cap)
Строка, которую передают в, должна быть в формате mailcap.
mail_cap
- правильно форматированная строка mailcappublic DataContentHandler createDataContentHandler(String mimeType)
createDataContentHandler
в классе CommandMap
mimeType
- тип MIMEpublic String[] getMimeTypes()
getMimeTypes
в классе CommandMap
public String[] getNativeCommands(String mimeType)
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.