XML代码生成器——XMLFACTORY 简介(二)
如果,你没看过这个系列的第一篇文章,请先去看一下这篇文章,否则你指定看不懂这篇。
XML代码生成器——XMLFACTORY 简介(一)
上篇文章利用RSS格式的XML,简介了一下如何利用XmlFactory生成实体类与XML序列化和反序列化代码。但是走马观花,五个功能页签的操作几乎都是直接点击“Next”直到生成代码,没有详细解释每个签页的作用。接下来的几篇文章,将分别讲解每一个页签的所有配置项。
这一篇讲“元素/子值”页签 的配置功能,您将了解到:如何调整Xml元素的结构,以及对生成实体类的影响。
一、子值列表中“多个”列的作用
先上样本XML:
<select id="select1">
<option value="1">abc</option>
</select>
太简单了,HTML里的Select对象。
老样子,打开这个地址http://www.codingfactory.net/Page/XmlFactory/client/XmlFactory_Flex.html
把上面的XML粘到样本XML中,点NEXT;显示如下图
左侧列表显示所有元素;右侧列表显示该元素所包函的所有子值。将来生成代码时,左侧的元素都将映射为实体类(如果没有脱壳的话,这个以后讲);而右侧的子值,将应射为类属性。
在这个Xml中,元素<Select>包函两个子值:属性id 和 元素<option>。
很明显在实际情况中,一个<Select>应该会包函多个<option>,故应映射为这样的实体类:
public class Select
{
public String Id{ get; set; }
public List<Option> Option{ get; set; }
}
那么代码生成器如何确定,一个子值是否映射为复数形式的类属性呢?
正是通过“子值列表”中的“多个”列来指定,如果该列的复选框选中则子值应映为复数形式;否则映射为单数形式。
比如本例:
是否选中"多个"列 | 生成的实体类 |
---|---|
选中 | |
未选中 |
public class Select |
还有几个问题要明确一下:
1.子值id那一行“多个”列为什么没有复选框可选呢?
答:id是属性类型的子值(Attribute),它不可能存在多个值。所以映射为类属性时,也只有单数形式。
2. 子值类型有几种?
答:3种,Element,Attribute,Value三种,你可以在“子值列表”的“类型”列看到子值的类型。
子值类型 | 示例 | 说明 | 是否可以 映射为复数形式的类属性 |
---|---|---|---|
Element | <div><p>1234</p></div> | 元素<p>是元素<div>的元素型子值 | 可以 |
Attribute | <div id="div1"/> | id是元素<div>的属性类子值 | 不可以 |
Value | <p>123</p> | 文本“1234”是元素<p>的Value类型的子值 | 不可以 |
二、编辑配置每个XML元素的结构
有时候样本XML中,缺少我们需要的子值。比如本例中的元素<Select>在实际应用中一般会包函name属性。我们有两种方法解决这个问题。第一个方法是补全样本XML,再用代码生成器,重新分析;另一个方法比较直观,直接使用“添加子值”功能。
操作:
1.先在左侧列表选中Select项,然后点击“添加子值”按钮。这表示你要为<Select>元素添加子值。
2.在弹出的对话框中“子值类型”选“Attribute”;“元素名称”填“name”。如图
特别说明一下,如果我们向元素填加一个新的“Element”类型的子值。比如:向<option>中填加一个<span>,操作完成后,左侧列表会自动增加span一项;但如果这时直接点“Next”系统会提示错误(如下图)。这是因为:新添加的元素<span>中不包函任何子值,而代码生成器不允许空子值元素映射为类(你也不会定义没有任何属性的实体类,对么?)所以,我们需要选中该项(span),再通过“添加子值”功能为其添加子值。
对于多余的,你认为没必要映射为类的Xml元素,可以用“删除元素”功能进行删除。删除后,所有元素将不再包含该类型的子值,以后生成代码时,就不会为这个元素生成对应的实体类。
而“删除子值”的功能是,删除某个元素的子值,将来生成代码时,仍然为这个元素生成对应的实体类,但你删除的子值不会再映射为类的属性。
以下是本文示例所生成的代码:
http://www.codingfactory.net/Page/XmlFactory/OutPut/XmlCSharp.aspx?id=9151
需说明的是,作者还在“类属性”页签作了变更类属性名称的操作,才形成上面代码的样子。具体操作,本文暂不展开。后续文章中将专门讲解。