修改了XML同时增加了json

This commit is contained in:
astaxie
2012-09-29 17:51:46 +08:00
parent 347c7ed150
commit 2fd34122e2
2 changed files with 234 additions and 72 deletions

53
7.1.md
View File

@@ -87,18 +87,36 @@ XML本质上是一种树形的数据格式而我们可以定义与之匹配
}
上面的例子中将xml文件解析成对应的strcut对象是通过`xml.Unmarshal`来完成的这个过程是如何实现的可以看到我们的struct定义后面多了一些类似于`xml:"serverName"`这样的内容,这个是strcut的一个特性它们被称为 strcut tag它们是用来辅助反射的Go语言的反射机制可以利用这些tag信息来将来自XML文件中的数据反射成对应的struct对象关于反射如何利用struct tag的更多内容请参阅reflect中的相关内容。在定义struct的时候应该如何设置 struct tag呢
上面的例子中将xml文件解析成对应的strcut对象是通过`xml.Unmarshal`来完成的这个过程是如何实现的可以看到我们的struct定义后面多了一些类似于`xml:"serverName"`这样的内容,这个是strcut的一个特性它们被称为 strcut tag它们是用来辅助反射的。我们来看一下`Unmarshal`的定义:
- 如果struct中一个string或者[]type类型的字段中tag定义了`",innerxml"`,那么这个字段会累计把这些原始的XML数据累计起来如上Description定义。
- 如果strcut中有一个字段类型xml.Name叫做XMLName那么在解析的时候就会这个element的名字
- 如果strcut里面字段后面的tag里面定义了XML的element那么解析的时候就会把相应的element值赋值给struct字段如上servername和serverip定义。
- 如果strcut里面字段后面的tag定义了`",attr"`那么会读取该element下面的属性字段如上version定义。
- 如果strcut字段后面的tag定义了`"a>b>c"`,那么会解析xml元素的结构a下面的b下面的c元素。
- 如果strcut字段后面的tag定义了`"-"`,那么这个字段不会被解析到任何数据。
- 如果strcut字段后面的tag定义了`",any"`,如果他的子元素在不满足其他的规则的时候就会匹配到这个字段。
- 如果strcut字段后面的tag定义了`",comments"`,这个字段一般都是[]byte或者string类型那么在这个元素下面的注释会累积在这个字段里面。
func Unmarshal(data []byte, v interface{}) error
上上面详细讲述了如何定义struct的tag。 只要设置对了tag那么XML解析就如上面示例般简单tag和xml的element是一一对应的关系如上所示我们可以通过slice来表示多个同级元素
我们看到函数定义了两个参数第一个是XML数据流第二个是存储的对应类型目前支持struct、slice和stringXML包内部采用了反射来进行数据的映射所以v里面的字段必须是导出的。`Unmarshal`解析的时候XML元素和字段怎么对应起来的呢这是有一个优先级读取流程的首先会读取struct tag如果没有那么就会对应字段名。必须注意一点的是解析的时候tag、字段名、XML元素都是大小写敏感的所以必须一一对应字段
Go语言的反射机制可以利用这些tag信息来将来自XML文件中的数据反射成对应的struct对象关于反射如何利用struct tag的更多内容请参阅reflect中的相关内容。
解析XML到struct的时候遵循如下的规则
- 如果struct的一个字段是string或者[]byte类型且它的tag含有`",innerxml"`Unmarshal将会将此字段所对应的元素内所有内嵌的原始xml累加到此字段上如上面例子Description定义。最后的输出是
<server>
<serverName>Shanghai_VPN</serverName>
<serverIP>127.0.0.1</serverIP>
</server>
<server>
<serverName>Beijing_VPN</serverName>
<serverIP>127.0.0.2</serverIP>
</server>
- 如果struct中有一个字段类型xml.Name叫做XMLName那么在解析的时候就会保存这个element的名字到该字段,如上面例子中的servers。
- 如果struct里面字段后面的tag里面定义了XML的element名称那么解析的时候就会把相应的element值赋值给struct字段如上servername和serverip定义。
- 如果struct里面字段后面的tag定义了`",attr"`那么会读取该结构所对应的element下面的属性字段如上version定义。
- 如果struct字段后面的tag定义了`"a>b>c"`,那么会解析xml元素的结构a下面的b下面的c元素。
- 如果struct字段后面的tag定义了`"-"`,那么这个字段不会被解析到任何数据。
- 如果struct字段后面的tag定义了`",any"`,如果他的子元素在不满足其他的规则的时候就会匹配到这个字段。
- 如果struct字段后面的tag定义了`",comments"`,这个字段一般都是[]byte或者string类型那么在这个元素下面的注释会累积存储在这个字段里面。
上面详细讲述了如何定义struct的tag。 只要设置对了tag那么XML解析就如上面示例般简单tag和XML的element是一一对应的关系如上所示我们还可以通过slice来表示多个同级元素。
>注意: 为了正确解析go语言的xml包要求struct定义中的所有字段必须是可导出的即首字母大写
@@ -157,13 +175,22 @@ XML本质上是一种树形的数据格式而我们可以定义与之匹配
</server>
</servers>
和我们之前定义的文件的格式一模一样,之所以会有`os.Stdout.Write([]byte(xml.Header))` 这句代码的出现,是因为`xml.MarshalIndent`或者`xml.Marshal`输出的信息都是不带XML头的为了生成正确的xml文件我们使用了xml包预定义的Header变量另外生成的xml文件的无层次结构也是由struct tag来控制的
和我们之前定义的文件的格式一模一样,之所以会有`os.Stdout.Write([]byte(xml.Header))` 这句代码的出现,是因为`xml.MarshalIndent`或者`xml.Marshal`输出的信息都是不带XML头的为了生成正确的xml文件我们使用了xml包预定义的Header变量。
那么生成的XML文件中的element名字是通过获取的呢他有如下几种方式获取
我们看到`Marshal`函数接收的参数v是interface类型所以他可以是任意类型那么如何生成相应的XML呢
- 字段名XMLName类型xml.Name
- 如果v是 array或者slice那么输出每一个元素类似<type>value</type>
- 如果v是指针那么会Marshal指针指向的内容如果指针为空什么都不输出
- 如果v是interface那么就处理interface所包含的数据
- 如果v是其他数据类型就会输出这个数据类型所拥有的字段信息
那么生成的XML文件中的element名字是通过获取的呢按照如下优先级获取
- 如果v是structXMLName的tag中定义的名称
- 字段名XMLName并且类型是xml.Name的字段值
- 通过strcut的字段中定义的tag来获取
- 通过strcut的字段名用来获取
- marshall的类型名称
而那么里面的结构和数据是如何输出的呢我们需要如何设置struct里面的tag信息呢