文章目录
- [第二十四章 控制到 XML 模式的映射](#第二十四章 控制到 XML 模式的映射)
- 查看支持`xml`的类的模式
第二十四章 控制到 XML 模式的映射
对于任何支持XML
的类,都有一个用于该类的隐式XML
模式,可以查看它。 IRIS
提供了修改该模式的方法。
本主题中的XML示例采用文字格式。
类和属性参数
CONTENT
DISPLAYLIST
VALUELIST
ESCAPE
MAXLEN
MINLEN
MINVAL
XMLFractionDigits
XMLTotalDigits
XMLLISTPARAMETER
XSDTYPE
XMLTYPE
SUPPRESSTYPEPREFIX
查看支持xml
的类的模式
要查看给定支持xml
的类的模式,有两个选项:
可以使用 %XML.Schema
和 %XML.Writer
生成完整的架构文档。
可以使用支持 XML
的类的 XMLSchema()
类方法,该方法将该类的 XML
架构写入当前设备。此方法不编写 XML
声明并忽略名称空间,因此用途有限。但是,如果只对 XML
类型感兴趣,则此方法可能会很有帮助。
java
Class GXML.Person Extends (%Persistent, %Populate, %XML.Adaptor)
{
Property Name As %Name;
Property DOB As %Date(FORMAT = 5, MAXVAL = "+$h");
Property GroupID As %String (XMLPROJECTION="ATTRIBUTE");
Property OtherID As %String(XMLPROJECTION = "NONE");
Property Address As GXML.Address;
Property Doctors As list Of GXML.Doctor;
}
GXML.Address
类如下:
java
Class GXML.Address Extends (%Persistent, %Populate, %XML.Adaptor)
{
Property Street As %String;
Property City As %String;
Property State As %String(MAXLEN = 2, PATTERN = "2u");
Property Zip As %String(MAXLEN = 10, PATTERN = "5n.1(1""-""4n)");
}
GXML.Doctor
类如下:
java
Class GXML.Doctor Extends (%Persistent, %Populate, %XML.Adaptor)
{
Property Name As %Name;
}
要查看 GXML.Person
类的架构,请在终端中输入以下命令:
java
do ##class(GXML.Person).XMLSchema()
然后会看到以下内容:
xml
<s:complexType name="Person">
<s:sequence>
<s:element name="Name" type="s:string" minOccurs="0" />
<s:element name="DOB" type="s:date" minOccurs="0" />
<s:element name="Address" type="s_Address" minOccurs="0" />
<s:element name="Doctors" type="ArrayOfDoctorDoctor" minOccurs="0" />
</s:sequence>
<s:attribute name="GroupID" type="s:string" />
</s:complexType>
<s:complexType name="s_Address">
<s:sequence>
<s:element name="City" type="s:string" minOccurs="0" />
<s:element name="Zip" type="s:string" minOccurs="0" />
</s:sequence>
</s:complexType>
<s:complexType name="ArrayOfDoctorDoctor">
<s:sequence>
<s:element name="Doctor" type="Doctor"
minOccurs="0" maxOccurs="unbounded" nillable="true" />
</s:sequence>
</s:complexType>
<s:complexType name="Doctor">
<s:sequence>
<s:element name="Name" type="s:string" minOccurs="0" />
</s:sequence>
</s:complexType>
请注意以下事项:
<Person>
,<Address>
, 和<Doctor>
类型的架构直接基于相应的类定义。- 该架构仅包含映射的属性。
- 该模式识别每个属性是否被映射为元素或属性。例如,
GroupID
是一个属性,Name
是一个元素。 - 属性的其他参数可能会影响架构。
- 在此示例中,类属性的类型为
string
,它是基本XSD
类型之一(请参阅 https://www.w3.org/TR/xmlschema-2/)。