Go言語 – XML Marshalを活用したXMLデータ変換処理について解説

package main
import (
	"encoding/xml"
	"fmt"
)
// SampleStructはサンプルデータを保持する構造体です。
type SampleStruct struct {
	XMLName xml.Name `xml:"Sample"`  // ルート要素名を"Sample"に設定
	ID      int      `xml:"id,attr"` // 属性として出力するために",attr"を使用
	Name    string   `xml:"name"`    // 子要素として出力
}
func main() {
	// サンプル構造体のインスタンス作成
	data := SampleStruct{
		ID:   100,
		Name: "サンプルデータ",
	}
	// XMLへ変換
	output, err := xml.MarshalIndent(data, "", "  ")
	if err != nil {
		fmt.Println("Error during Marshal:", err)
		return
	}
	fmt.Println(string(output))
}

<Sample id="100">
  <name>サンプルデータ</name>
</Sample>

package main
import (
	"encoding/xml"
	"fmt"
)
// ChildStructは親構造体の子要素として出力する構造体です。
type ChildStruct struct {
	XMLName xml.Name `xml:"Child"`
	Value   string   `xml:"value"`
}
// ParentStructは子要素を持つ親構造体です。
type ParentStruct struct {
	XMLName xml.Name    `xml:"Parent"`
	Title   string      `xml:"title"`
	Child   ChildStruct `xml:"child"` // ネストした構造体
}
func main() {
	// ネストした構造体のインスタンス作成
	child := ChildStruct{Value: "ネストした値"}
	parent := ParentStruct{
		Title: "親データ",
		Child: child,
	}
	// XMLへ変換
	output, err := xml.MarshalIndent(parent, "", "  ")
	if err != nil {
		fmt.Println("エラーが発生しました:", err)
		return
	}
	fmt.Println(string(output))
}

<Parent>
  <title>親データ</title>
  <child>
    <value>ネストした値</value>
  </child>
</Parent>

package main
import (
	"encoding/xml"
	"fmt"
)
// DataStructはXML出力用の構造体です。
type DataStruct struct {
	XMLName xml.Name `xml:"Data"`
	ID      int      `xml:"id,attr"`
	Name    string   `xml:"name"`
	Secret  string   `xml:"-"` // このフィールドはXML出力に含まれない
}
func main() {
	// XML出力するサンプルデータ作成
	data := DataStruct{
		ID:     1,
		Name:   "公開データ",
		Secret: "非公開情報",
	}
	// 整形されたXML文字列へ変換
	output, err := xml.MarshalIndent(data, "", "  ")
	if err != nil {
		fmt.Println("Marshalでエラーが発生しました:", err)
		return
	}
	fmt.Println(string(output))
}

<Data id="1">
  <name>公開データ</name>
</Data>

package main
import (
	"encoding/xml"
	"fmt"
)
// ErrorStructはエラーが発生しやすいケースのサンプル構造体です。
type ErrorStruct struct {
	XMLName xml.Name `xml:"ErrorData"`
	Value   string   `xml:"value"`
	// タグに誤りがあるとエラーの原因になります。例: `xml:","` のような不正な指定
}
func main() {
	// サンプルデータ作成
	data := ErrorStruct{Value: "サンプル値"}
	// Marshal実行時にエラーチェックを実施
	output, err := xml.MarshalIndent(data, "", "  ")
	if err != nil {
		fmt.Println("XMLへの変換に失敗しました:", err)
		return
	}
	fmt.Println(string(output))
}

<ErrorData>
  <value>サンプル値</value>
</ErrorData>

package main
import (
	"encoding/xml"
	"fmt"
)
// ItemはXML出力される基本要素です。
type Item struct {
	XMLName xml.Name `xml:"item"`
	ID      int      `xml:"id,attr"` // 属性として出力
	Title   string   `xml:"title"`   // 子要素として出力
}
// Containerは複数のItemを保持する構造体です。
type Container struct {
	XMLName xml.Name `xml:"container"`
	Items   []Item   `xml:"items>item"` // ネストして出力
}
func main() {
	// 複数のアイテムを作成
	items := []Item{
		{ID: 1, Title: "最初のアイテム"},
		{ID: 2, Title: "次のアイテム"},
	}
	// アイテムをContainerに格納
	container := Container{
		Items: items,
	}
	// 整形されたXMLへ変換
	output, err := xml.MarshalIndent(container, "", "  ")
	if err != nil {
		fmt.Println("XML変換エラー:", err)
		return
	}
	fmt.Println(string(output))
}

<container>
  <items>
    <item id="1">
      <title>最初のアイテム</title>
    </item>
    <item id="2">
      <title>次のアイテム</title>
    </item>
  </items>
</container>

package main
import (
	"encoding/xml"
	"fmt"
	"os"
)
// TestStructはテスト対象の構造体です。
type TestStruct struct {
	XMLName xml.Name `xml:"test"`
	Value   string   `xml:"value"`
}
func main() {
	data := TestStruct{Value: "検証用データ"}
	// XMLへ変換
	output, err := xml.MarshalIndent(data, "", "  ")
	if err != nil {
		fmt.Println("変換エラー:", err)
		return
	}
	// 結果をファイルに保存
	err = os.WriteFile("result.xml", output, 0644)
	if err != nil {
		fmt.Println("ファイル保存エラー:", err)
		return
	}
	fmt.Println("XMLファイルが正常に作成されました。")
}

XMLファイルが正常に作成されました。