类和属性参数
XMLNAME
XMLSEQUENCE
XMLUNSWIZZLE
XMLPREFIX
XMLIGNOREINVALIDTAG
XMLIGNOREINVALIDATTRIBUTE
在 XML
中,仅包含属性的元素可以用以下任一方式表示:
<tag attribute="value" attribute="value" attribute="value"></tag>
<tag attribute="value" attribute="value" attribute="value"/>
IRIS
认为这些形式是等效的。当使用 %XML.Writer
导出对象时,可以控制关闭形式,但不能通过修改 XML
投影本身来控制。
XML
中的给定元素可以包含多个具有相同名称的元素;这些元素通过它们的顺序彼此区分。例如,以下是一个合法的 XML
文档:
<?xml version="1.0" encoding="UTF-8"?>
<Root>
<Person>
<Name>Able, Andrew</Name>
<DOB>1977-10-06</DOB>
<Address>
<Street>6218 Clinton Drive</Street>
<City>Reston</City>
<State>TN</State>
<Zip>87639</Zip>
</Address>
<Address>
<Street>110 High Street</Street>
<City>Zanesville</City>
<State>OR</State>
<Zip>80719</Zip>
</Address>
</Person>
</Root>
将这样的文档映射到 IRIS
类有点棘手,因为每个类属性都必须有唯一的名称。
要将此类文档映射到 IRIS
类,请执行以下操作:
XMLNAME
属性参数,以将不同的类属性映射到相同的 XML
名称。XMLSEQUENCE
类参数设置为 1
。作为预防措施,这可确保映射遵循类定义中列出的属性顺序。XML
文档中的顺序相同。例如,考虑以下类定义:
Class GXML.TestSequence.Person Extends (%Persistent, %XML.Adaptor)
{
Property Name As %Name [ Required ];
Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h") [ Required ];
Property HomeAddress As GXML.TestSequence.Address(XMLNAME = "Address");
Property WorkAddress As GXML.TestSequence.Address(XMLNAME = "Address");
/// If the XMLSEQUENCE = 1, then the order of the XML elements must match the
/// order of the class properties. This allows us to deal with XML where the
/// same field appears multiple times and is distinguished by the order.
Parameter XMLSEQUENCE = 1;
}
该类定义映射到前面显示的 XML
文档。
注意:如果 XMLSEQUENCE
为 1
,则忽略 XMLIGNOREINVALIDTAG
参数。
Unswizzling
当使用 IRIS XML
工具导出支持 XML
的持久对象时,系统会像往常一样自动将所有需要的信息混合到内存中;此信息包括对象值属性。导出对象后,IRIS
会取消混合任何对象列表,但不会(默认情况下)取消混合单个对象引用。对于大型对象,这可能会导致 <STORE>
错误。
要使任何单个对象引用在这种情况下不被混淆,请在支持 XML
的类中设置 XMLUNSWIZZLE
参数,如下所示:
Parameter XMLUNSWIZZLE = 1;
该参数的默认值为 0
。