XML代码生成器——XMLFACTORY 简介（二）

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 {     public String Id{ get; set; }     public Option Option{ get; set; } }

还有几个问题要明确一下：
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
    需说明的是，作者还在“类属性”页签作了变更类属性名称的操作，才形成上面代码的样子。具体操作，本文暂不展开。后续文章中将专门讲解。