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 クラスによって格納される 3 つの値をすべて設定できます。また、equals メソッドの MIME 構文解析が改善されました。MIME 構文解析が改善された以外は、セマンティクスは JDK の DataFlavor クラスと同じです。

導入されたバージョン:
1.6
関連項目:
直列化された形式

フィールドの概要
 
クラス java.awt.datatransfer.DataFlavor から継承されたフィールド
imageFlavor, javaFileListFlavor, javaJVMLocalObjectMimeType, javaRemoteObjectMimeType, javaSerializedObjectMimeType, plainTextFlavor, stringFlavor
 
コンストラクタの概要
ActivationDataFlavor(Class representationClass, String humanPresentableName)
          MIME タイプを表現する DataFlavor を構築します。
ActivationDataFlavor(Class representationClass, String mimeType, String humanPresentableName)
          任意の Java オブジェクトを表現する DataFlavor を構築します。
ActivationDataFlavor(String mimeType, String humanPresentableName)
          MIME タイプを表現する 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 の拡張機能であり、3 つの DataFlavor 属性をすべて明示的に設定できます。  

次のような性質を持つ DataFlavor が返されます。  

representationClass = representationClass
mimeType = mimeType
humanName = humanName  

パラメータ:
representationClass - この DataFlavor で使用するクラス
mimeType - このクラスが表現するデータの MIME タイプ
humanPresentableName - 判読できるフレーバの名前

ActivationDataFlavor

public ActivationDataFlavor(Class representationClass,
                            String humanPresentableName)
MIME タイプを表現する DataFlavor を構築します。  

次のような性質を持つ DataFlavor が返されます。  

mimeType が application/x-java-serialized-object; class= の場合は、上記の新規 DataFlavor(Class.forName()) 呼び出しと同じ結果になります。  

そうでない場合は、次のようになります。  

representationClass = InputStream

mimeType = mimeType

パラメータ:
representationClass - この DataFlavor で使用するクラス
humanPresentableName - 判読できるフレーバの名前

ActivationDataFlavor

public ActivationDataFlavor(String mimeType,
                            String humanPresentableName)
MIME タイプを表現する DataFlavor を構築します。  

次のような性質を持つ DataFlavor が返されます。  

mimeType が application/x-java-serialized-object; class= の場合は、上記の新規 DataFlavor(Class.forName()) 呼び出しと同じ結果になります。そうでない場合は、次のようになります。  

representationClass = InputStream

mimeType = mimeType

パラメータ:
mimeType - このクラスが表現するデータの MIME タイプ
humanPresentableName - 判読できるフレーバの名前
メソッドの詳細

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)
推奨されていません。 

DataFlavor サブクラスが、大文字と小文字を区別しない text/plain の charset パラメータなど、特殊なパラメータを取り扱えるようにするために、各 MIME タイプパラメータの DataFlavor に対して呼び出されます。MIME タイプのパラメータ値は大文字と小文字を区別することになっています。  

このメソッドはパラメータ名とパラメータ値のペアごとに呼び出され、parameterValue の正規化された表現を返します。このメソッドがこの実装によって呼び出されることはありません。

オーバーライド:
クラス DataFlavor 内の normalizeMimeTypeParameter
パラメータ:
parameterName - パラメータ名
parameterValue - パラメータ値
戻り値:
正規化されたパラメータ値

normalizeMimeType

protected String normalizeMimeType(String mimeType)
推奨されていません。 

DataFlavor サブタイプに、MIME タイプの正規化達成方法を変更する機会を与えるために、各 MIME タイプ文字列に対して呼び出されます。MIME タイプの文字列を渡すものがない場合に、デフォルトのパラメータ/値のペアを追加するために使用することもあります。 このメソッドがこの実装によって呼び出されることはありません。

オーバーライド:
クラス DataFlavor 内の normalizeMimeType
パラメータ:
mimeType - MIME タイプ
戻り値:
正規化された MIME タイプ

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。