org.w3c.dom
介面 TypeInfo

public interface TypeInfo

TypeInfo 介面表示從 Element 或 Attr 節點參考的型別，用與文檔相關的網要指定。該型別是一對名稱空間 URI 和名稱屬性，且取決於文檔的網要。

如果文檔的網要為 XML DTD [XML 1.0]，則按以下方式計算值：

• 如果此型別是從 Attr 節點參考的，則 typeNamespace 為 "http://www.w3.org/TR/REC-xml" 且 typeName 表示 [XML Information Set] 中的 [attribute type] 屬性。如果沒有屬性宣告，則 typeNamespace 和 typeName 為 null。
• 如果此型別是從 Element 節點參考的，則 typeNamespace 和 typeName 為 null。

如果文檔的網要為 XML Schema [XML Schema Part 1]，則使用後網要驗證資訊集貢獻（也稱為 PSVI 貢獻）按以下方式計算值：

• 如果 [validity] 屬性存在且是“無效的” 或“未知的”，則：為宣告型別的 {target namespace} 和 {name} 屬性（如果可用）；否則為 null。

  註：在寫入時，XML Schema 規範不要求公開宣告的型別。因此，如果有效性是無效的，則 DOM 實作可能選擇不提供型別資訊。

• 如果 [validity] 屬性存在且是“無效的”，則：
  1. 如果 [member type definition] 存在，則：
     1. 如果 {name} 不存在，則公開 [member type definition] 屬性的 {name} 和 {target namespace} 屬性；
     2. 否則，公開相應匿名型別名稱的名稱空間和本地名稱。
  2. 如果 [type definition] 屬性存在：
     1. 如果 {name} 不存在，則公開 [type definition] 屬性的 {name} 和 {target namespace} 屬性；
     2. 否則，公開相應匿名型別名稱的名稱空間和本地名稱。
  3. 如果 [member type definition anonymous] 存在：
     1. 如果它為 false，則公開 [member type definition name] 和 [member type definition namespace] 屬性；
     2. 否則，公開相應匿名型別名稱的名稱空間和本地名稱。
  4. 如果 [type definition anonymous] 存在：
     1. 如果它為 false，則公開 [type definition name] 和 [type definition namespace] 屬性；
     2. 否則，公開相應匿名型別名稱的名稱空間和本地名稱。

註：其他網要語言不在 W3C 的範圍內，因此應該使用 TypeInfo 定義如何表示它們的型別系統。

另請參見 Document Object Model (DOM) Level 3 Core Specification。

從以下版本開始：

DOM Level 3

欄位摘要

static int	DERIVATION_EXTENSION 如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示由 extension 派生出的。
static int	DERIVATION_LIST 如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示 列表。
static int	DERIVATION_RESTRICTION 如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示通過 restriction 進行的派生（如果涉及複雜的型別）或 restriction（如果涉及簡單的型別）。
static int	DERIVATION_UNION 如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示 union（如果涉及簡單型別）。

方法摘要

String	getTypeName() 為相關元素或屬性宣告的型別的名稱；如果未知，則為 null。
String	getTypeNamespace() 為相關元素或屬性宣告的型別的名稱空間；如果該元素沒有宣告或如果沒有名稱空間資訊可用，則為 null。
boolean	isDerivedFrom(String typeNamespaceArg, String typeNameArg, int derivationMethod) 此方法返回參考型別定義（即在其上調用該方法的 TypeInfo）和其他型別定義（即作為參數傳遞的型別定義）之間是否存在派生。

欄位詳細資訊

DERIVATION_RESTRICTION

static final int DERIVATION_RESTRICTION

如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示通過 restriction 進行的派生（如果涉及複雜的型別）或 restriction（如果涉及簡單的型別）。
如果其他型別定義與參考型別定義相同，或者如果遵循參考型別定義中的 {base type definition} 屬性可以遞歸式到達其他型別定義，並且涉及的所有 derivation methods 都是限制，則參考型別定義由限制從其他型別定義中派生。

另請參見：

常數欄位值

DERIVATION_EXTENSION

static final int DERIVATION_EXTENSION

如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示由 extension 派生出的。
如果遵循參考型別定義中的 {base type definition} 屬性可以遞歸式到達其他型別定義，且至少一個涉及到的 derivation methods 是擴展，則參考型別定義由擴展從其他型別定義中派生。

另請參見：

常數欄位值

DERIVATION_UNION

static final int DERIVATION_UNION

如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示 union（如果涉及簡單型別）。
如果存在兩種型別定義 T1 和 T2，T1 具有 {各種} union，而其中一個 {成員型別定義} 為 T2，則參考型別定義由 union 從其他型別定義派生，例如，參考型別定義是通過 DERIVATION_RESTRICTION 或 DERIVATION_EXTENSION 從 T1 派生的，T2 是通過 DERIVATION_RESTRICTION 從其他型別定義派生。注意，T1 可以與參考型別定義相同，T2 可以與其他型別定義相同。

另請參見：

常數欄位值

DERIVATION_LIST

static final int DERIVATION_LIST

如果文檔的網要為 XML Schema [XML Schema Part 1]，則此常數表示 列表。
如果存在兩種型別定義 T1 和 T2，例如，參考型別定義由 DERIVATION_RESTRICTION 或 DERIVATION_EXTENSION 從 T1 派生，T2 由 DERIVATION_RESTRICTION 從其他型別定義派生，則參考型別定義由列表從其他型別派生，T1 具有 {各種} 列表，T2 為 {項型別定義}。注意，T1 可以與參考型別定義相同，T2 可以與其他型別定義相同。

另請參見：

常數欄位值

方法詳細資訊

getTypeName

String getTypeName()

為相關元素或屬性宣告的型別的名稱；如果未知，則為 null。

getTypeNamespace

String getTypeNamespace()

為相關元素或屬性宣告的型別的名稱空間；如果該元素沒有宣告或如果沒有名稱空間資訊可用，則為 null。

isDerivedFrom

boolean isDerivedFrom(String typeNamespaceArg,
                      String typeNameArg,
                      int derivationMethod)

此方法返回參考型別定義（即在其上調用該方法的 TypeInfo）和其他型別定義（即作為參數傳遞的型別定義）之間是否存在派生。

參數：

typeNamespaceArg - 其他型別定義的名稱空間。

typeNameArg - 其他型別定義的名稱。

derivationMethod - 在兩種型別之間應用的派生型別和條件，如在此介面中提供的常數列表中描述的。

返回：

如果文檔的網要為 DTD 或者沒有與此文檔相關的網要，則此方法將總是返回 false。如果文檔的網要為 XML Schema，則該方法將為 true（如果按照派生參數從其他型別定義派生參考型別定義）。如果參數的值為 0（沒有將 derivationMethod 參數的任何一位設置為 1），則該方法將返回 true（如果可以通過從參考型別定義遞歸{基本型別定義}、{項型別定義}或{成員型別定義} 組合到達其他型別定義）。