Golang实现ISO-4217和ISO-3166标准类型存储验证的插件库go-type的使用

这个库的目的是为了方便存储、验证和传输Go ISO-3166/ISO-4217/时区/电子邮件/URL类型。它有一个开放API3规范，可以包含在你的规范中。所有类型都有自己的ozzo.Validate、json.Unmarshaler、Stringer和driver.Valuer实现。

安装

go get github.com/mikekonan/go-types/v2

使用示例

下面是一个完整的示例，展示如何使用go-types库来处理ISO-4217和ISO-3166标准类型：

package main

import (
	"encoding/json"
	"fmt"
	"log"

	validation "github.com/go-ozzo/ozzo-validation/v4"
	"github.com/mikekonan/go-types/v2/country"
	"github.com/mikekonan/go-types/v2/country/alpha2"
	"github.com/mikekonan/go-types/v2/country/alpha3"
	"github.com/mikekonan/go-types/v2/language"
	"github.com/mikekonan/go-types/v2/country/name"
	"github.com/mikekonan/go-types/v2/currency"
	"github.com/mikekonan/go-types/v2/currency/code"
	"github.com/mikekonan/go-types/v2/phone"
	"github.com/mikekonan/go-types/v2/postal_code"
)

// 1. 在你的结构体中使用
type User struct {
	Name            string                `json:"name" db:"name"`
	Country         country.Alpha2Code    `json:"country" db:"country"`
	Currency        currency.Code         `json:"currency" db:"currency"`
	Language        language.Alpha2Code   `json:"language" db:"language"`
	Phone           phone.Number          `json:"phone" db:"phone"`
	CountryDialCode phone.DialCode        `json:"dialCode" db:"dialCode"`
	PostalCode      postalcode.PostalCode `json:"postalCode" db:"postalCode"`
}

func main() {
	// 2. 在你的数据流中使用
	user := User{}
	_ = json.Unmarshal([]byte(`{"name":"name", "country": "CA", "currency": "CAD", "language": "fr", "phone": "123456789", "dialCode": "1"}`), &user)

	// 3. 检查是否设置
	user.Country.IsSet()
	user.Currency.IsSet()
	user.Language.IsSet()

	// 4. 使用ozzo-validation进行验证
	if err := validation.ValidateStruct(&user, validation.Field(&user.Country), validation.Field(&user.Currency)); err != nil {
            log.Fatal(err)
	}

	// 5. 通过alpha2代码查找国家信息
	if userCountry, ok := country.ByAlpha2Code(user.Country); ok {
            fmt.Printf("country name - '%s', alpha-2 - '%s', alpha-3 - '%s'", userCountry.Name(), userCountry.Alpha2Code(), userCountry.Alpha3Code())
	}

	// 6. 通过alpha2代码查找语言信息
	if userLanguage, ok := language.ByAlpha2Code(user.Language); ok {
            fmt.Printf("language name - '%s', alpha-2 - '%s', alpha-3 - '%s'", userLanguage.Name(), userLanguage.Alpha2Code(), userLanguage.Alpha3Code())
	}

	// 7. 通过国家拨号代码查找国家
	if phoneCountries, ok := phone.CountriesByDialCode(user.CountryDialCode); ok {
            for _, phoneCountry := range phoneCountries {
                fmt.Printf("country by dial code - '%s'", phoneCountry)
            }
	}

	// 8. 通过国家代码查找拨号代码
	if dialCode, ok := phone.DialByAlpha2Code(user.Country); ok {
            fmt.Printf("'%s' dial code is '%s'", user.Country, dialCode)
        }

	// 9. 通过货币代码查找货币信息
	if userCurrency, ok := currency.ByCode(user.Currency); ok {
            fmt.Printf("currency name - '%s', code - '%s', number - '%s', countries - '%s', decimal places - '%d'",
                userCurrency.Currency(), userCurrency.Code(), userCurrency.Number(), userCurrency.Countries(), userCurrency.DecimalPlaces())
	}

	// 10. 存储到数据库
	fmt.Println(user.Country.Value())  // 输出 'CA'
	fmt.Println(user.Currency.Value()) // 输出 'CAN'
	fmt.Println(user.Language.Value()) // 输出 'fr'

	// 11. 使用特定的国家常量
	fmt.Println(country.Canada.Alpha2Code())
	fmt.Println("name:", name.Canada)
	fmt.Println("alpha-2:", alpha2.CA)
	fmt.Println("alpha-3:", alpha3.CAN)

	// 12. 使用特定的货币代码
	fmt.Println(code.CAD)
}

主要功能

1. 在结构体中使用：可以直接在结构体中使用ISO标准的国家代码、货币代码等类型
2. JSON序列化/反序列化：支持从JSON数据中解析和生成这些标准类型
3. 验证：集成了ozzo-validation验证框架，可以方便地进行数据验证
4. 查找功能：可以通过代码查找国家、货币、语言等详细信息
5. 数据库支持：实现了driver.Valuer接口，可以直接存储到数据库
6. 常量支持：提供了常用国家和货币的常量

这个库简化了处理国际标准代码的工作，确保数据的正确性和一致性，非常适合需要处理国际化数据的应用程序。