Класс SystemFlavorMap

public static FlavorMap getDefaultFlavorMap()

Возвращает стандартную FlavorMap для загрузчика классов текущего потока.

public List<String> getNativesForFlavor(DataFlavor flav)

Возвращает список платформ-специфичных нативных представлений данных, в которые можно перевести указанный объект DataFlavor с помощью подсистемы передачи данных. Список будет отсортирован от лучшего нативного представления к худшему. То есть, первое нативное представление наилучшим образом отразит данные, указанные во входном формате, на целевой платформе.

Если указанный объект DataFlavor неизвестен подсистеме передачи данных и подсистема не может перевести этот объект в какое-либо существующее нативное представление, то вызов этого метода создаст соответствие в обоих направлениях между указанным объектом DataFlavor и закодированной версией его MIME-типа, как нативного представления.

public List<DataFlavor> getFlavorsForNative(String nat)

Возвращает список объектов DataFlavor, в которые можно перевести указанное нативное представление данных с помощью подсистемы передачи данных. Список будет отсортирован от лучшего соответствия к худшему. То есть, первый DataFlavor наилучшим образом отразит данные в заданном нативном представлении для Java приложения.

Если указанное нативное представление ранее было неизвестно подсистеме передачи данных и оно было должным образом закодировано, то вызов этого метода установит соответствие в обоих направлениях между указанным нативным представлением и объектом DataFlavor, тип MIME которого является декодированной версией нативного представления.

Если указанное нативное представление не является должным образом закодированным, и сопоставления для этого нативного представления не были изменены с помощью setFlavorsForNative, то содержимое List зависит от платформы, но null не может быть возвращено.

public Map<DataFlavor,String> getNativesForFlavors(DataFlavor[] flavors)

Возвращает список наиболее предпочтительных нативных представлений для заданных объектов DataFlavor. Каждое нативное значение будет таким же, как первое нативное представление в списке, возвращаемом методом getNativesForFlavor для указанного объекта DataFlavor.

Если указанный объект DataFlavor ранее был неизвестен подсистеме передачи данных, то вызов этого метода создаст соответствие в обоих направлениях между указанным объектом DataFlavor и закодированной версией его MIME-типа, как нативного представления.

public Map<String,DataFlavor> getFlavorsForNatives(String[] natives)

Возвращает список объектов DataFlavor для заданных нативных представлений данных, которые являются наиболее предпочтительными. Каждое значение DataFlavor будет таким же, как первое значение в списке, возвращаемом методом getFlavorsForNative для указанного нативного представления.

Если указанное нативное представление ранее было неизвестно подсистеме передачи данных и оно было должным образом закодировано, то вызов этого метода создаст соответствие в обоих направлениях между указанным нативным представлением и объектом DataFlavor, тип MIME которого является декодированной версией нативного представления.

public void addUnencodedNativeForFlavor(DataFlavor flav, String nat)

Добавляет соответствие от указанного объекта DataFlavor (и всех равных ему) к указанному нативному представлению. В отличие от других методов, соответствие устанавливается только в одном направлении, и нативное представление не кодируется. Для создания двустороннего соответствия также необходимо вызвать метод addFlavorForUnencodedNative. Новое соответствие будет иметь меньший приоритет по сравнению с существующими соответствиями. Этот метод не оказывает никакого эффекта, если соответствие от указанного или равного объекта DataFlavor к указанному нативному представлению уже существует.

public void setNativesForFlavor(DataFlavor flav, String[] natives)

Удаляет текущие соответствия для указанного объекта DataFlavor и всех равных ему, и создает новые соответствия для указанных нативных представлений. В отличие от других методов, соответствия устанавливаются только в одном направлении, и нативные представления не кодируются. Для создания двусторонних соответствий также необходимо вызвать метод setFlavorsForNative. Первое нативное представление в массиве будет представлять соответствие с наивысшим приоритетом. Последующие нативные представления будут представлять соответствия с уменьшающимся приоритетом.

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

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

public void addFlavorForUnencodedNative(String nat, DataFlavor flav)

Добавляет соответствие от одного нативного представления к одному объекту DataFlavor. В отличие от других методов, соответствие устанавливается только в одном направлении, и нативное представление не кодируется. Для создания двустороннего соответствия также необходимо вызвать метод addUnencodedNativeForFlavor. Новое соответствие будет иметь меньший приоритет по сравнению с существующими соответствиями. Этот метод не оказывает никакого эффекта, если соответствие от указанного нативного представления к указанному или равному объекту DataFlavor уже существует.

public void setFlavorsForNative(String nat, DataFlavor[] flavors)

Отбрасывает текущие сопоставления для указанного String нативного ключа и создаёт новые сопоставления для указанных DataFlavor. В отличие от getFlavorsForNative, сопоставления будут установлены только в одном направлении, и нативные ключи не обязательно должны быть закодированы. Для установления двунаправленных сопоставлений также вызовите setNativesForFlavor. Первый DataFlavor в массиве будет представлять сопоставление с наивысшим приоритетом. Последующие DataFlavor будут представлять сопоставления с уменьшающимся приоритетом.

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

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

public static String encodeJavaMIMEType(String mimeType)

Кодирует тип MIME для использования в качестве String нативного ключа. Формат закодированного представления типа MIME зависит от реализации. Единственными ограничениями являются:

• Закодированное представление является null тогда и только тогда, когда тип MIME String является null
• Закодированные представления двух не-null типов MIME String равны тогда и только тогда, когда эти String равны в соответствии с String.equals(Object)

Реализация по умолчанию этого метода возвращает указанный тип MIME String с префиксом JAVA_DATAFLAVOR:.

public static String encodeDataFlavor(DataFlavor flav)

Кодирует DataFlavor для использования в качестве String нативного ключа. Формат закодированного DataFlavor зависит от реализации. Единственными ограничениями являются:

• Закодированное представление является null тогда и только тогда, когда указанный DataFlavor имеет null значение или его тип MIME String равен null
• Закодированные представления двух не-null DataFlavor с не-null типами MIME String равны тогда и только тогда, когда тип MIME String этих DataFlavor равны в соответствии с String.equals(Object)

Реализация по умолчанию этого метода возвращает тип MIME String указанного DataFlavor с префиксом JAVA_DATAFLAVOR:.

public static boolean isJavaMIMEType(String str)

Возвращает, является ли указанный String закодированным типом MIME Java.

public static String decodeJavaMIMEType(String nat)

Декодирует String нативный ключ для использования в качестве типа MIME Java.

public static DataFlavor decodeDataFlavor(String nat) throws ClassNotFoundException

Декодирует String нативный ключ для использования в качестве DataFlavor.