Go 言語による XML のマッピングと操作

はじめに

この実験では、Go言語でXMLを扱う際の知識をテストすることを目的としています。XMLにマッピングできる構造体を作成し、XMLデータをマーシャリングおよびアンマーシャリングし、XML出力の構造を定義するためにフィールドタグを使用する必要があります。

Skills Graph

XML

XMLにマッピングできるPlantという名前の構造体を作成する必要があります。この構造体は以下のフィールドを持つ必要があります。

• Id (int) - XML属性
• Name (string) - ネストされたXML要素
• Origin ([]string) - ネストされたXML要素

また、Plant構造体のスライスを含むNestingという名前の構造体も作成する必要があります。Nesting構造体はnestingという名前のXML要素にマッピングされ、Plant構造体は<parent><child>...</child></parent>の下にネストされる必要があります。

次に、PlantとNesting構造体をXMLにマーシャリングし、XMLデータをPlant構造体にアンマーシャリングするコードを書く必要があります。

• Plant構造体はplantという名前のXML要素にマッピングされる必要があります。
• Plant構造体のIdフィールドはidという名前のXML属性にマッピングされる必要があります。
• Plant構造体のNameフィールドはnameという名前のネストされたXML要素にマッピングされる必要があります。
• Plant構造体のOriginフィールドはoriginという名前のネストされたXML要素にマッピングされる必要があります。
• Nesting構造体はnestingという名前のXML要素にマッピングされる必要があります。
• Nestingスライス内のPlant構造体は<parent><child>...</child></parent>の下にネストされる必要があります。

$ go run xml.go
 <plant id="27">
   <name>Coffee</name>
   <origin>Ethiopia</origin>
   <origin>Brazil</origin>
 </plant>
<?xml version="1.0" encoding="UTF-8"?>
 <plant id="27">
   <name>Coffee</name>
   <origin>Ethiopia</origin>
   <origin>Brazil</origin>
 </plant>
Plant id=27, name=Coffee, origin=[Ethiopia Brazil]
 <nesting>
   <parent>
     <child>
       <plant id="27">
         <name>Coffee</name>
         <origin>Ethiopia</origin>
         <origin>Brazil</origin>
       </plant>
       <plant id="81">
         <name>Tomato</name>
         <origin>Mexico</origin>
         <origin>California</origin>
       </plant>
     </child>
   </parent>
 </nesting>

以下が完全なコードです。

// Goは`encoding.xml`パッケージを使ってXMLおよびXMLに似た
// 形式に対する組み込みのサポートを提供しています。

package main

import (
	"encoding/xml"
	"fmt"
)

// PlantはXMLにマッピングされます。JSONの例と同様に、フィールドタグには
// エンコーダとデコーダに対する指示が含まれています。ここではXMLパッケージの
// いくつかの特別な機能を使っています。`XMLName`フィールド名はこの構造体を表す
// XML要素の名前を指定します。`id,attr`は`Id`フィールドがXMLの
// _属性_ であり、ネストされた要素ではないことを意味します。
type Plant struct {
	XMLName xml.Name `xml:"plant"`
	Id      int      `xml:"id,attr"`
	Name    string   `xml:"name"`
	Origin  []string `xml:"origin"`
}

func (p Plant) String() string {
	return fmt.Sprintf("Plant id=%v, name=%v, origin=%v",
		p.Id, p.Name, p.Origin)
}

func main() {
	coffee := &Plant{Id: 27, Name: "Coffee"}
	coffee.Origin = []string{"Ethiopia", "Brazil"}

	// 私たちの植物を表すXMLを生成します。`MarshalIndent`を使って
	// より読みやすい出力を生成します。
	out, _ := xml.MarshalIndent(coffee, " ", "  ")
	fmt.Println(string(out))

	// 出力に汎用的なXMLヘッダを追加するには、明示的に追加します。
	fmt.Println(xml.Header + string(out))

	// `Unmarshal`を使ってXMLで構成されたバイト列をデータ構造に
	// パースします。XMLが不正またはPlantにマッピングできない場合、
	// 記述的なエラーが返されます。
	var p Plant
	if err := xml.Unmarshal(out, &p); err!= nil {
		panic(err)
	}
	fmt.Println(p)

	tomato := &Plant{Id: 81, Name: "Tomato"}
	tomato.Origin = []string{"Mexico", "California"}

	// `parent>child>plant`フィールドタグはエンコーダに指示して、
	// すべての`plant`を`<parent><child>...</child></parent>`の下に
	// ネストさせます。
	type Nesting struct {
		XMLName xml.Name `xml:"nesting"`
		Plants  []*Plant `xml:"parent>child>plant"`
	}

	nesting := &Nesting{}
	nesting.Plants = []*Plant{coffee, tomato}

	out, _ = xml.MarshalIndent(nesting, " ", "  ")
	fmt.Println(string(out))
}

まとめ

この実験では、Go言語でXMLを扱う方法を学びました。XMLにマッピングできる構造体を作成し、XMLデータをマーシャリングおよびアンマーシャリングし、XML出力の構造を定義するためにフィールドタグを使用しました。