第十八章 控制 XML 元素和属性名称

第十八章 控制 XML 元素和属性名称

类和属性名称与 XML 元素和属性的名称之间存在默认对应关系，可以覆盖这些默认值。

类和属性参数

• XMLNAME
• XMLTYPE
• XMLITEMNAME
• XMLKEYNAME

默认 XML 元素和属性名称

IRIS 名称与 XML 元素和属性名称之间的默认对应关系如下：

• 对于类，相应的 XML 元素或属性名称与短类名称相同。

• 对于此类中的属性，相应的 XML 元素或属性名称与属性名称相同。

  请注意，属性定义决定其是否映射为 XML 元素或属性。

  如果属性名称包含引号，则 XML 元素或属性名称中不包含引号。例如，考虑以下属性：

  Property "Quoted Property" As %String;
  

  该属性被投影为元素 <Quoted Property> 或属性 Quoted Property，具体取决于该属性的映射方式。

• 如果属性是列表或数组，则它自动由子元素组成，每个子元素都是该列表或数组中的一项。默认情况下，子元素的名称是附加了 Item 的属性名称。

• 如果属性是数组，则子元素还有一个属性来指示对应的键。默认情况下，该属性的名称是附加了 Key 的属性名称。

控制映射为顶级元素的对象的元素或属性的名称

当将类实例映射为顶级元素时，其 XML 名称确定如下：

类的 XMLNAME 参数	X类的 XMLType 参数	标签（元素或属性）
Specified``	Ignored	Value of XMLNAME
Not specified	Specified	Value of XMLTYPE
Not specified	Not specified	Short class

例如，如果导出 Sample.Address 类的对象，默认情况下，每个对象都会显示如下内容：

<Address>
  <Street>5064 Elm Street</Street>
  <City>Jackson</City>
  <State>PA</State>
  <Zip>27621</Zip>
</Address>

假设指定 Sample.Address 类的 XMLNAME 参数。例如：

Parameter XMLNAME = "HomeAddress";

在这种情况下，输出将如下所示：

<HomeAddress>
  <Street>5064 Elm Street</Street>
  <City>Jackson</City>
  <State>PA</State>
  <Zip>27621</Zip>
</HomeAddress>

将对象导出到 XML 时，可以覆盖这些参数。