JavaTM Platform
Standard Ed. 6

javax.activation
类 ActivationDataFlavor

java.lang.Object
  继承者 java.awt.datatransfer.DataFlavor
      继承者 javax.activation.ActivationDataFlavor
所有已实现的接口:
Externalizable, Serializable, Cloneable

public class ActivationDataFlavor
     
extends DataFlavor

ActivationDataFlavor 类是 java.awt.datatransfer.DataFlavor 的一个特殊子类。它允许 JAF 通过新的构造方法设置 DataFlavor 类所存储的所有三个值。它还包含 equals 方法中增强的 MIME 解析。除了增强的解析外,其语义与 JDK DataFlavor 类的语义相同。

从以下版本开始:
1.6
另请参见:
序列化表格

字段摘要
 
从类 java.awt.datatransfer.DataFlavor 继承的字段
imageFlavor, javaFileListFlavor, javaJVMLocalObjectMimeType, javaRemoteObjectMimeType, javaSerializedObjectMimeType, plainTextFlavor, stringFlavor
 
构造方法摘要
ActivationDataFlavor(Class representationClass, String humanPresentableName)
          构造一个表示 MimeTypeDataFlavor
ActivationDataFlavor(Class representationClass, String mimeType, String humanPresentableName)
          构造一个表示任意 Java 对象的 DataFlavor
ActivationDataFlavor(String mimeType, String humanPresentableName)
          构造一个表示 MimeType 的 DataFlavor。
 
方法摘要
 boolean equals(DataFlavor dataFlavor)
          将传入的 DataFlavor 与此 DataFlavor 进行比较;调用 isMimeTypeEqual 方法。
 String getHumanPresentableName()
          返回得体的名称。
 String getMimeType()
          返回此 DataFlavor 的 MIME 类型。
 Class getRepresentationClass()
          返回表示形式类。
 boolean isMimeTypeEqual(String mimeType)
          传入的 MIME 类型的字符串表示形式是否等效于此 DataFlavor 的 MIME 类型。
protected  String normalizeMimeType(String mimeType)
          已过时。  
protected  String normalizeMimeTypeParameter(String parameterName, String parameterValue)
          已过时。  
 void setHumanPresentableName(String humanPresentableName)
          设置得体的名称。
 
从类 java.awt.datatransfer.DataFlavor 继承的方法
clone, equals, equals, getDefaultRepresentationClass, getDefaultRepresentationClassAsString, getParameter, getPrimaryType, getReaderForText, getSubType, getTextPlainUnicodeFlavor, hashCode, isFlavorJavaFileListType, isFlavorRemoteObjectType, isFlavorSerializedObjectType, isFlavorTextType, isMimeTypeEqual, isMimeTypeSerializedObject, isRepresentationClassByteBuffer, isRepresentationClassCharBuffer, isRepresentationClassInputStream, isRepresentationClassReader, isRepresentationClassRemote, isRepresentationClassSerializable, match, readExternal, selectBestTextFlavor, toString, tryToLoadClass, writeExternal
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

ActivationDataFlavor

public ActivationDataFlavor(Class representationClass,
                            String mimeType,
                            String humanPresentableName)
构造一个表示任意 Java 对象的 DataFlavor。此构造方法是 JDK DataFlavor 的扩展,它允许显示设置所有三个 DataFlavor 属性。

返回的 DataFlavor 将具有以下特征:

representationClass = representationClass
mimeType = mimeType
humanName = humanName

参数:
representationClass - 此 DataFlavor 中使用的类
mimeType - 此类所表示数据的 MIME 类型
humanPresentableName - flavor 的得体的名称

ActivationDataFlavor

public ActivationDataFlavor(Class representationClass,
                            String humanPresentableName)
构造一个表示 MimeTypeDataFlavor

返回的 DataFlavor 将具有以下特征:

如果 mimeType 为 "application/x-java-serialized-object; class=",则结果与调用新的 DataFlavor(Class:forName()) 相同(同上)。

否则:

representationClass = InputStream

mimeType = mimeType

参数:
representationClass - 此 DataFlavor 中使用的类
humanPresentableName - flavor 的得体的名称

ActivationDataFlavor

public ActivationDataFlavor(String mimeType,
                            String humanPresentableName)
构造一个表示 MimeType 的 DataFlavor。

返回的 DataFlavor 将具有以下特征:

如果 mimeType 为 "application/x-java-serialized-object; class=",则结果与调用新的 DataFlavor(Class:forName()) 相同(同上),否则:

representationClass = InputStream

mimeType = mimeType

参数:
mimeType - 此类表示的数据 MIME 类型
humanPresentableName - flavor 的得体的名称
方法详细信息

getMimeType

public String getMimeType()
返回此 DataFlavor 的 MIME 类型。

覆盖:
DataFlavor 中的 getMimeType
返回:
MIME 类型

getRepresentationClass

public Class getRepresentationClass()
返回表示形式类。

覆盖:
DataFlavor 中的 getRepresentationClass
返回:
表示形式类

getHumanPresentableName

public String getHumanPresentableName()
返回得体的名称。

覆盖:
DataFlavor 中的 getHumanPresentableName
返回:
得体的名称

setHumanPresentableName

public void setHumanPresentableName(String humanPresentableName)
设置得体的名称。

覆盖:
DataFlavor 中的 setHumanPresentableName
参数:
humanPresentableName - 要设置的名称。

equals

public boolean equals(DataFlavor dataFlavor)
将传入的 DataFlavor 与此 DataFlavor 进行比较;调用 isMimeTypeEqual 方法。

覆盖:
DataFlavor 中的 equals
参数:
dataFlavor - 要与之比较的 DataFlavor
返回:
如果 MIME 类型和表示形式类都相同,则返回 true
另请参见:
DataFlavor.selectBestTextFlavor(java.awt.datatransfer.DataFlavor[])

isMimeTypeEqual

public boolean isMimeTypeEqual(String mimeType)
传入的 MIME 类型的字符串表示形式是否等效于此 DataFlavor 的 MIME 类型。

ActivationDataFlavor 将 MIME 类型的比较委托给作为 JavaBeans Activation Framework 的一部分包含的 MimeType 类。相比 DataFlavor 类中通常可用的比较,此方法提供的比较更加健壮。

覆盖:
DataFlavor 中的 isMimeTypeEqual
参数:
mimeType - MIME 类型
返回:
如果 MIME 类型相同,则返回 true

normalizeMimeTypeParameter

protected String normalizeMimeTypeParameter(String parameterName,
                                            String parameterValue)
已过时。 

针对每个 MIME 类型参数对 DataFlavor 调用此方法,以允许 DataFlavor 子类处理特定参数,如文本/纯文本 charset 参数,其值是不区分大小写的。(MIME 类型参数值应该区分大小写)。

为每个参数名/值对调用此方法,应该返回 parameterValue 的标准化表示形式。此实现不再调用此方法。

覆盖:
DataFlavor 中的 normalizeMimeTypeParameter
参数:
parameterName - 参数名称
parameterValue - 参数值
返回:
标准化的参数值

normalizeMimeType

protected String normalizeMimeType(String mimeType)
已过时。 

为每个 MIME 类型字符串调用此方法,以使 DataFlavor 子类型能够更改实现 MIME 类型标准化的方式。一种可能的用法是,在传入的 MIME 类型字符串中不存在参数/值对的情况下添加默认的参数/值对。此实现不再调用此方法。

覆盖:
DataFlavor 中的 normalizeMimeType
参数:
mimeType - MIME 类型
返回:
标准化的 MIME 类型

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策