Класс SystemFlavorMap
- Все реализованные интерфейсы:
-
FlavorMap,FlavorTable
public final class SystemFlavorMap extends Object implements FlavorMap, FlavorTable
- С момента:
- 1.2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addFlavorForUnencodedNative |
Добавляет отображение от одного String нативного объекта к одному DataFlavor. |
void |
addUnencodedNativeForFlavor |
Добавляет отображение от указанного DataFlavor (и всех DataFlavor равных указанному DataFlavor) к указанному String нативному объекту. |
static DataFlavor |
decodeDataFlavor |
Декодирует String нативный объект для использования в качестве DataFlavor. |
static String |
decodeJavaMIMEType |
Декодирует String нативный объект для использования как тип MIME Java. |
static String |
encodeDataFlavor |
Кодирует DataFlavor для использования как String нативный объект. |
static String |
encodeJavaMIMEType |
Кодирует тип MIME для использования как String нативный объект. |
static FlavorMap |
getDefaultFlavorMap() |
Возвращает стандартное отображение FlavorMap для загрузчика классов текущей нити. |
List<DataFlavor> |
getFlavorsForNative |
Возвращает список List DataFlavor к которым подсистема передачи данных может перевести указанный String нативный объект. |
Map<String, |
getFlavorsForNatives |
Возвращает список указанных String нативных объектов и их наиболее предпочтительных DataFlavor. |
List<String> |
getNativesForFlavor |
Возвращает список String нативных объектов, к которым подсистема передачи данных может перевести указанный DataFlavor. |
Map<DataFlavor, |
getNativesForFlavors |
Возвращает список указанных DataFlavor и их наиболее предпочтительных String нативных объектов. |
static boolean |
isJavaMIMEType |
Возвращает, является ли указанный String закодированным типом MIME Java. |
void |
setFlavorsForNative |
Удаляет текущие отображения для указанного String нативного объекта и создает новые отображения для указанных DataFlavor. |
void |
setNativesForFlavor |
Удаляет текущие отображения для указанного DataFlavor и всех DataFlavor равных указанному DataFlavor, и создает новые отображения для указанных String нативных объектов. |
Подробности методов
getDefaultFlavorMap
public static FlavorMap getDefaultFlavorMap()
- Возвращает:
- стандартную FlavorMap для загрузчика классов текущего потока
getNativesForFlavor
public List<String> getNativesForFlavor(DataFlavor flav)
List из String нативных представлений, в которые можно перевести указанный DataFlavor с помощью подсистемы передачи данных. List будут отсортированы от лучшего нативного представления к худшему. То есть, первое нативное представление лучше всего отразит данные в указанном формате для базовой платформы. Если указанный DataFlavor ранее неизвестен подсистеме передачи данных и подсистема передачи данных не может перевести этот DataFlavor в какое-либо существующее нативное представление, вызов этого метода создаст соответствие в обоих направлениях между указанным DataFlavor и закодированной версией его MIME-типа как нативного представления.
- Определено в:
-
getNativesForFlavorв интерфейсеFlavorTable - Параметры:
-
flav-DataFlavor, соответствующие нативные представления которого должны быть возвращены. Еслиnullуказан, все нативные представления, известные подсистеме передачи данных, возвращаются в неопределённом порядке. - Возвращает:
- a
java.util.Listизjava.lang.Stringобъектов, которые представляют собой платформо-зависимые представления платформо-зависимых форматов данных - С:
- 1.4
- См. также:
getFlavorsForNative
public List<DataFlavor> getFlavorsForNative(String nat)
List из DataFlavors, в которые можно перевести указанное нативное представление String с помощью подсистемы передачи данных. List будут отсортированы от лучшего DataFlavor к худшему. То есть, первый DataFlavor лучше всего отразит данные в указанном нативном представлении в приложение Java. Если указанное нативное представление ранее неизвестно подсистеме передачи данных, и это нативное представление было правильно закодировано, вызов этого метода создаст соответствие в обоих направлениях между указанным нативным представлением и DataFlavor, чье MIME-тип является декодированной версией нативного представления.
Если указанное нативное представление не является правильно закодированным и сопоставления для этого нативного представления не были изменены с помощью setFlavorsForNative, тогда содержимое List зависит от платформы, но null не может быть возвращено.
- Определено в:
-
getFlavorsForNativeв интерфейсеFlavorTable - Параметры:
-
nat- нативное представление, соответствующиеDataFlavors которого должны быть возвращены. Еслиnullуказан, всеDataFlavors, известные подсистеме передачи данных, возвращаются в неопределённом порядке. - Возвращает:
- a
java.util.ListизDataFlavorобъектов, в которые можно перевести платформо-зависимые данные в указанном платформо-зависимом нативном представлении - С:
- 1.4
- См. также:
getNativesForFlavors
public Map<DataFlavor,String> getNativesForFlavors(DataFlavor[] flavors)
Map из указанных DataFlavors в их наиболее предпочтительные String нативные представления. Каждое значение нативного представления будет таким же, как первое нативное представление в списке, возвращаемом getNativesForFlavor для указанного формата. Если указанный DataFlavor ранее неизвестен подсистеме передачи данных, вызов этого метода создаст соответствие в обоих направлениях между указанным DataFlavor и закодированной версией его MIME-типа как нативного представления.
- Определено в:
-
getNativesForFlavorsв интерфейсеFlavorMap - Параметры:
-
flavors- массивDataFlavors, которые будут набором ключей возвращаемогоMap. Еслиnullуказан, будет возвращена карта всехDataFlavors, известных подсистеме передачи данных, и их наиболее предпочтительныхStringнативных представлений. - Возвращает:
- a
java.util.MapизDataFlavors вStringнативные представления - См. также:
getFlavorsForNatives
public Map<String,DataFlavor> getFlavorsForNatives(String[] natives)
Map из указанных String нативных представлений в их наиболее предпочтительные DataFlavor. Каждое значение формата будет таким же, как первое значение формата в списке, возвращаемом getFlavorsForNative для указанного нативного представления. Если указанное нативное представление ранее неизвестно подсистеме передачи данных, и это нативное представление было правильно закодировано, вызов этого метода создаст соответствие в обоих направлениях между указанным нативным представлением и DataFlavor, чье MIME-тип является декодированной версией нативного представления.
- Определено в:
-
getFlavorsForNativesв интерфейсеFlavorMap - Параметры:
-
natives- массивStrings, которые будут набором ключей возвращаемогоMap. Еслиnullуказан, будет возвращена карта всех поддерживаемыхStringнативных представлений и их наиболее предпочтительныхDataFlavorформатов. - Возвращает:
- a
java.util.MapизStringнативных представлений вDataFlavorформаты - См. также:
addUnencodedNativeForFlavor
public void addUnencodedNativeForFlavor(DataFlavor flav, String nat)
DataFlavor (и всех DataFlavor равных указанному DataFlavor) к указанному String нативному представлению. В отличие от getNativesForFlavor, соответствие будет установлено только в одном направлении, и нативное представление не будет закодировано. Чтобы установить двустороннее соответствие, вызовите также addFlavorForUnencodedNative. Новое соответствие будет иметь более низкий приоритет, чем любое существующее соответствие. Этот метод не оказывает никакого эффекта, если соответствие от указанного или равного DataFlavor к указанному String нативному представлению уже существует.- Параметры:
-
flav- ключDataFlavorдля соответствия -
nat- значениеStringнативного представления для соответствия - Исключения:
-
NullPointerException- если flav или nat неnull - С:
- 1.4
- См. также:
setNativesForFlavor
public void setNativesForFlavor(DataFlavor flav, String[] natives)
DataFlavor и всех DataFlavor равных указанному DataFlavor, и создаёт новые соответствия с указанными String нативными представлениями. В отличие от getNativesForFlavor, соответствия будут установлены только в одном направлении, и нативные представления не будут закодированы. Чтобы установить двусторонние соответствия, вызовите также setFlavorsForNative. Первое нативное представление в массиве будет представлять собой соответствие с наивысшим приоритетом. Последующие нативные представления будут представлять соответствия с уменьшающимся приоритетом. Если массив содержит несколько элементов, которые ссылаются на равные String нативные представления, этот метод установит новые соответствия для первого из этих элементов и проигнорирует остальные.
Рекомендуется, чтобы код клиента не сбрасывал соответствия, установленные подсистемой передачи данных. Этот метод следует использовать только для соответствий на уровне приложения.
- Параметры:
-
flav- ключDataFlavorдля соответствий -
natives- значенияStringнативных представлений для соответствий - Исключения:
-
NullPointerException- если flav или natives неnullили если natives содержитnullэлементов - С:
- 1.4
- См. также:
addFlavorForUnencodedNative
public void addFlavorForUnencodedNative(String nat, DataFlavor flav)
String нативного представления к одному DataFlavor формату. В отличие от getFlavorsForNative, соответствие будет установлено только в одном направлении, и нативное представление не будет закодировано. Чтобы установить двустороннее соответствие, вызовите также addUnencodedNativeForFlavor. Новое соответствие будет иметь более низкий приоритет, чем любое существующее соответствие. Этот метод не оказывает никакого эффекта, если соответствие от указанного String нативного представления к указанному или равному DataFlavor формату уже существует.- Параметры:
-
nat- ключStringнативного представления для соответствия -
flav- значениеDataFlavorформата для соответствия - Исключения:
-
NullPointerException- еслиnatилиflavнеnull - С:
- 1.4
- См. также:
setFlavorsForNative
public void setFlavorsForNative(String nat, DataFlavor[] flavors)
String нативного ключа и создаёт новые сопоставления с указанными DataFlavor. В отличие от getFlavorsForNative, сопоставления будут установлены только в одном направлении, и нативные ключи не обязательно должны быть закодированы. Чтобы установить двусторонние сопоставления, вызовите также setNativesForFlavor. Первый DataFlavor в массиве будет представлять сопоставление с наивысшим приоритетом. Последующие DataFlavor будут представлять сопоставления с уменьшающимся приоритетом. Если массив содержит несколько элементов, ссылающихся на одинаковые DataFlavor ключи, этот метод установит новые сопоставления для первого из этих элементов и проигнорирует остальные.
Рекомендуется, чтобы код клиента не сбрасывал сопоставления, установленные подсистемой передачи данных. Этот метод должен использоваться только для сопоставлений на уровне приложения.
- Parameters:
-
nat- нативный ключ для сопоставлений -
flavors- значения для сопоставлений - Throws:
-
NullPointerException- еслиnatилиflavorsnull, или еслиflavorsсодержитnullэлементов - Since:
- 1.4
- See Also:
encodeJavaMIMEType
public static String encodeJavaMIMEType(String mimeType)
String нативного ключа. Формат кодированного представления типа MIME зависит от реализации. Единственные ограничения: - Кодированное представление является
nullтогда и только тогда, когда тип MIMEStringявляетсяnull - Кодированные представления для двух типов MIME, не являющихся
null,Stringравны тогда и только тогда, когда этиStringравны в соответствии сString.equals(Object)
String с префиксом JAVA_DATAFLAVOR:.- Parameters:
-
mimeType- тип MIME для кодирования - Returns:
- кодированный
String, илиnullеслиmimeTypeявляетсяnull
encodeDataFlavor
public static String encodeDataFlavor(DataFlavor flav)
DataFlavor для использования в качестве String нативного ключа. Формат кодированного DataFlavor зависит от реализации. Единственные ограничения: - Кодированное представление является
nullтогда и только тогда, когда указанныйDataFlavorявляетсяnullили его тип MIMEStringявляетсяnull - Кодированные представления для двух не-
nullDataFlavorс не-nullтипом MIMEStringравны тогда и только тогда, когда типы MIMEStringэтихDataFlavorравны в соответствии сString.equals(Object)
String указанного DataFlavor с префиксом JAVA_DATAFLAVOR:.- Parameters:
-
flav-DataFlavorдля кодирования - Returns:
- кодированный
String, илиnullеслиflavявляетсяnullили имеет тип MIMEnull
isJavaMIMEType
public static boolean isJavaMIMEType(String str)
String закодированным типом MIME Java.- Parameters:
-
str- типStringдля проверки - Returns:
-
trueеслиStringзакодирован;falseв противном случае
decodeJavaMIMEType
public static String decodeJavaMIMEType(String nat)
String нативный ключ для использования в качестве типа MIME Java.- Parameters:
-
nat-Stringдля декодирования - Returns:
- декодированный тип MIME Java или
nullеслиnatне является закодированнымStringнативным ключом
decodeDataFlavor
public static DataFlavor decodeDataFlavor(String nat) throws ClassNotFoundException
String нативный ключ для использования в качестве DataFlavor.- Parameters:
-
nat-Stringдля декодирования - Returns:
- декодированный
DataFlavor, илиnullеслиnatне является закодированнымStringнативным ключом - Throws:
-
ClassNotFoundException- если класс типа данных не загружен
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.datatransfer/java/awt/datatransfer/SystemFlavorMap.html