乐趣区

关于go:PHP转Go实践xjson解析神器开源工具集

前言

近期会更新一系列开源我的项目的文章,新的一年会和大家做更多的开源我的项目,也欢送大家退出进来。

xutil

明天分享的文章源自于开源我的项目 jinzaigo/xutil 的封装。

在封装过程中,劲仔将实现原理以及相干实际思考,写成文章分享进去,从而汇总系列文章汇合。

PHP 转 Go

我和劲仔都是 PHP 转 Go,身边越来越多做 PHP 的敌人也逐步在用 Go 进行重构,重构过程中,会发现 php 的 json 解析操作(系列化与反序列化)是真的香,弱类型语言的各种隐式类型转换,很大水平的减低了程序的复杂度。

反观 go 应用规范库 encoding/json,来做 json 解析就没有那么欢快了(只有数据类型定义不对,就很容易抛 error)

JSON 解析实际

案例:用 go 重构的服务,对接的上游还是 php 服务,这时 php 接口输入的 json 串为{"name":"AppleWatchS8","price":"3199"}

其中 price 字段应该得为 float 类型,但因为 php 弱类型语言,没有强制束缚输入类型的机制,就很容易呈现这种输入类型不对的状况,而后到 go 服务里得怎么解决呢?

规范库 encoding/json

package main

import (
  "encoding/json"
  "fmt"
)

type ProductInfo struct {
  Name  string  `json:"name"`
  Price float32 `json:"price"`
}

func main() {str := "{"name":"AppleWatchS8","price":"3199"}"
  data := ProductInfo{}
  if err := json.Unmarshal([]byte(str), &data); err != nil {fmt.Println("error:" + err.Error())
  } else {fmt.Println(data)
  }
}

// 输入后果
//error: json: cannot unmarshal string into Go struct field ProductInfo.price of type float32

显然,应用 go 规范库做 json 解析,是应答不了这种类型不统一的状况的。上面则借助第三方库的能力来做解决

第三方库 json-iterator

简略介绍:

执行速度:jsoniter 的 Golang 版本能够比规范库(encoding/json)快 6 倍之多

两个特点:

  1. 齐全兼容规范库,也就是 API 用法齐全一样,原有逻辑代码不须要改变,只须要替换 import 包名
  2. 提供了一个 PHP 兼容模式,能够主动转换字符串 / 数字弱类型问题,能够将空数组 [] 转换为空构造体(解决 PHP 中的 array 输入为 [] 的问题)。留神,该兼容模式须要手动开启

装置形式:

go get -u github.com/json-iterator/go

具体代码实现:

package main

import (
  "fmt"
  jsoniter "github.com/json-iterator/go"
  "github.com/json-iterator/go/extra"
)

var json = jsoniter.ConfigCompatibleWithStandardLibrary

func init() {extra.RegisterFuzzyDecoders() // 开启 PHP 兼容模式
}

type ProductInfo struct {
  Name  string  `json:"name"`
  Price float32 `json:"price"`
}

func main() {str := "{"name":"AppleWatchS8","price":"3199"}"
  data := ProductInfo{}
  if err := json.Unmarshal([]byte(str), &data); err != nil {fmt.Println("error:" + err.Error())
  } else {fmt.Println(data)
  }
}

// 输入后果
//{AppleWatchS8 3199}

看输入后果,会发现用了这个库并且开启了 PHP 兼容模式,json 中 price 字段 string 类型,就会主动转换为构造体中定义的 float32 类型。

这样咱们在应用 price 字段解决业务逻辑时,就只须要按 float32 做解决就行,不必进行类型断言。这个库解决了 json 解析类型转换问题的同时,也能极大的进步咱们开发效率。

收集到开源工具包 xutil 中

这个第三库用起来如此不便,那必定是要收录进来的,将替换包名、手动开启 PHP 兼容模式、还有罕用的 API 办法(系列化与反序列化操作),对立封装进来,简化应用流程。

同时,为了便于后续扩大更多的兼容模式,所以将代码都放在 xjson 目录下

以上这个思路也实用于大家封装本人外部应用的工具库。

应用示例:

go get -u github.com/jinzaigo/xutil之后,

import github.com/jinzaigo/xutil/xjson

即可通过 xjson.Unmarshal()等办法,进行 json 解析操作。

示例代码:

package main

import (
  "fmt"
  "github.com/jinzaigo/xutil/xjson"
)

type ProductInfo struct {
  Name  string  `json:"name"`
  Price float32 `json:"price"`
}

func main() {str := "{"name":"AppleWatchS8","price":"3199"}"
  data := ProductInfo{}
  if err := xjson.Unmarshal([]byte(str), &data); err != nil {fmt.Println("error:" + err.Error())
  } else {fmt.Println(data)
  }
}

总结

业务零碎从 php 转 go,或 go 对接 php 服务,都会遇到这个因为数据类型不统一导致 json 解析谬误的共性问题。

应用第三方库 json-iterator 能很好的解决咱们的痛点,并且比规范库执行速度还更快。

收录到开源我的项目中,更好的帮忙到须要的敌人,欢送应用、star 与 PR 独特建设。

https://github.com/jinzaigo/x…

退出移动版