当前位置：首页 > 编程日记 > 正文

【golang程序包推荐分享】分享亿点点golang json操作及myJsonMarshal程序包开发的踩坑经历 :)

编程日记 2024-02-01 21:00:00

目录【阅读时间：约5分钟】

一.概述
- 1.Json的作用
- 2.Go官方 encoding/json 包
- 3. golang json的主要操作
二.Json Marshal：将数据编码成json字符串
三.Json Unmarshal：将json字符串解码到相应的数据结构
四.myJsonMarshal程序包开发的踩坑经历
- 1.go doc的第一个坑——函数名首字母要大写
- 2.go doc的第二个坑——函数注释要在函数定义前一行，并且注释开头应为函数名

一.概述

1.Json的作用

Json(Javascript Object Nanotation)是一种数据交换格式，常用于前后端数据传输。任意一端将数据转换成json 字符串，另一端再将该字符串解析成相应的数据结构，如string类型，strcut对象等。

2.Go官方 encoding/json 包

Go官方 encoding/json 包实现了 RFC 4627 中定义的 JSON 的编码和解码。JSON 和 Go值之间的映射在 Marshal 和 Unmarshal 函数的文档中进行了描述。

官方源码：https://github.com/golang/go/blob/master/src/encoding/json/encode.go

3. golang json的主要操作

根据上面两节的介绍，我们简单可以将golang json的主要操作分为以下两种：

①Json Marshal：将数据编码成json字符串
②Json Unmarshal：将json字符串解码到相应的数据结构

使用这两种json操作，可以极大地方便前后端的数据传输操作。

二.Json Marshal：将数据编码成json字符串

Marshal函数的作用结果很直观，就是将输入的结构化数据，转为json字符流并输出。
我们可以自定义输入的数据类型以及相应的值，并将其转为符合规则的json字符流。

简单的使用样例如下（别忘了"import encoding/json"）：

type Stu struct {Name  string `json:"name"`Age   intHIgh  boolsex   stringClass *Class `json:"class"`
}type Class struct {Name  stringGrade int
}func main() {//实例化一个数据结构，用于生成json字符串stu := Stu{Name: "张三",Age:  18,HIgh: true,sex:  "男",}//指针变量cla := new(Class)cla.Name = "1班"cla.Grade = 3stu.Class=cla//Marshal失败时err!=niljsonStu, err := json.Marshal(stu)if err != nil {fmt.Println("生成json字符串错误")}//jsonStu是[]byte类型，转化成string类型便于查看fmt.Println(string(jsonStu))
}

运行结果：

{"name":"张三","Age":18,"HIgh":true,"class":{"Name":"1班","Grade":3}}

由此可知程序包有如下几个特性:
①结构化数据转为json字符流
②支持字段的标签（Tag），标签满足 json:“你自己的定义”。
③指针变量编码时自动转换为它所指向的值

三.Json Unmarshal：将json字符串解码到相应的数据结构

Unmarshal函数的作用结果也很直观，就是将输入的json字符流，转为相应的结构化数据并输出。
Unmarshal函数可以看作是Marshal函数的逆过程，用于json的解码。

同样地，展示简单的使用样例如下（别忘了"import encoding/json"）：

type StuRead struct {Name  interface{} `json:"name"`Age   interface{}HIgh  interface{}sex   interface{}Class interface{} `json:"class"`Test  interface{}
}type Class struct {Name  stringGrade int
}func main() {//json字符中的"引号，需用\进行转义，否则编译出错//json字符串沿用上面的结果，但对key进行了大小的修改，并添加了sex数据data:="{\"name\":\"张三\",\"Age\":18,\"high\":true,\"sex\":\"男\",\"CLASS\":{\"naME\":\"1班\",\"GradE\":3}}"str:=[]byte(data)//1.Unmarshal的第一个参数是json字符串，第二个参数是接受json解析的数据结构。//第二个参数必须是指针，否则无法接收解析的数据，如stu仍为空对象StuRead{}//2.可以直接stu:=new(StuRead),此时的stu自身就是指针stu:=StuRead{}err:=json.Unmarshal(str,&stu)//解析失败会报错，如json字符串格式不对，缺"号，缺}等。if err!=nil{fmt.Println(err)}fmt.Println(stu)
}

运行结果：

{张三 18 true <nil> map[naME:1班 GradE:3] <nil>}

四.myJsonMarshal程序包开发的踩坑经历

基于Go官方 encoding/json 包，笔者简单地复现了其中的Marshal函数，详情可见基于Golang的对象序列化的程序包开发——myJsonMarshal。

1.go doc的第一个坑——函数名首字母要大写

在进行go doc输出API文档时，笔者发现有些函数一直都无法自动生成API、有些函数能生成API的“诡异现象”，网上搜索也无相关的资料（吐槽一下go doc的资料也太少了吧！）

经过笔者的不断尝试，才发现原来是自己函数风格的问题，在go doc中，如果要通过以下命令生成API文档:

godoc -url="pkg/github.com/user/myJsonMarshal" > API.html

那么，函数名首字母必须要大写。当然我们也可以通过以下指令使API文档强制输出首字母非大写的函数：

godoc -u

当这种方法并不能生成API文档，只能在终端上显示有哪些函数，并且以下指令都是会报错的：

godoc -u -url="pkg/github.com/user/myJsonMarshal" > API.html
godoc -url="pkg/github.com/user/myJsonMarshal" > API.html -u

因此，我们还是老老实实地养成函数名首字母大写的习惯吧~

2.go doc的第二个坑——函数注释要在函数定义前一行，并且注释开头应为函数名

在写完函数注释后，笔者发现通过go doc生成的API文档居然没有显示相应的中文注释，一开始笔者以为是语言支持等问题而盲目捣鼓了不短的时间，后来才发现go doc自动生成注释时，其函数注释要在函数定义前一行，并且注释开头应为函数名。
注释格式举例：

//A 是一个样例函数
func A {//code
}

https://www.dkcj.cn/info/1188.html

Java数据结构和算法的数组

阵列的功能： 1、固定大小 2、相同的数据类型 3、 4、数据项可反复 Java数据类型：基本类型（int和double）和对象类型。在很多编程语言中。数组也是基本类型。但在Java中把它们当作对象来对待。因此在创建数组时必须使用new操作符。 …

编程日记2024/02/01 20:30:00

玻璃和水晶PBR纹理材质预设

CGAxis–物理6–玻璃和水晶PBR纹理材质预设大小：20.8G 信息: 透明玻璃、彩色玻璃和水晶的100种不同图案和变化的PBR纹理。这个包中的每个纹理由八个贴图组成:漫反射，反射，高度(位移)，光泽度，环境遮挡，金属…

编程日记2024/02/01 20:00:00

【题目】 Description Once upon a time there was a greedy King who ordered his chief Architect to build a wall around the Kings castle. The King was so greedy, that he would not listen to his Architects proposals to build a beautiful brick wall with a perfe…

编程日记2024/02/01 19:30:00

matlab小波分析工具箱原理与应用_补充：频域特征值提取的MATLAB代码实现（小波分析）...

之前的文章信号频域分析方法的理解（频谱、能量谱、功率谱、倒频谱、小波分析）中提到了离散小波分解的例子，其参考代码如下：t_s 结果如下：原始信号离散小波分析结果左侧四行是1~4阶的近似信号，右侧四行是1~4…

编程日记2024/02/01 19:00:01

【ReactiveX】基于Golang pmlpml/RxGo程序包的二次开发

基于Golang pmlpml/RxGo程序包的二次开发【阅读时间：约20分钟】一、ReactiveX & RxGo介绍1.ReactiveX2.RxGo二、系统环境&项目介绍1.系统环境2.项目的任务要求三、具体程序设计及Golang代码实现1.程序设计2.filteringOperator数据结构、op函数与newFilterOb…

编程日记2024/02/01 18:30:01

python dataframe 中位数_python下的Pandas中DataFrame基本操作（一），基本函数整理

pandas作者Wes McKinney 在【PYTHON FOR DATA ANALYSIS】中对pandas的方方面面都有了一个权威简明的入门级的介绍，但在实际使用过程中，我发现书中的内容还只是冰山一角。谈到pandas数据的行更新、表合并等操作，一般用到的方法有concat、join、…

编程日记2024/02/01 17:30:00

对输入框以及选择框集体的数据检验

对于一个档案输入框，有很多输入框是需要输入数据的，但有时候我们会在输入的时候遗留一些必填的项，如果不做数据校验，这时候点击保存按钮，就悲剧了，报错不说，我们前面填写的数据也就没有了。所以…

编程日记2024/02/01 17:00:00

CentOS Docker安装配置部署Golang web helloworld

目录【阅读时间：约5分钟】一、Docker简介二、Docker的安装与配置【CentOS环境】三、Docker部署Golang web helloworld四、Docker与虚拟机的区别五、吐槽一、Docker简介 Docker 是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移…

编程日记2024/02/01 16:30:00

[CareerCup] 2.4 Partition List 划分链表

2.4 Write code to partition a linked list around a value x, such that all nodes less than x come before all nodes greater than or equal to x. LeetCode上的原题，请参见我之前的博客Partition List 划分链表。

编程日记2024/02/01 16:00:00

一条命令下载google壁纸，含错误解决方法

该命令是从google图片搜索上搜索wallpaper的大尺寸图片，匹配其中的jpg文件进行下载。 #!/bin/bash for i in {1..10}; do for url in $(wget -O- -U "" "http://images.google.com/images?imgszxxlarge&hlen&qwallpaper&saN&s…

编程日记2024/02/01 15:30:00

git config —global_Git多用户配置

备注：如下的操作，Windows系统建议在Git bash工具里操作。如下操作的原理，建议查阅官方文档。Git - Reference1.取消全局设置的用户信息。Git命令：$ git config --global --unset user.name $ git config --global --unset user.em…

编程日记2024/02/01 15:00:00

中级实训总结报告

目录【阅读时间：约30分钟】中级实训总结报告姓名：隐藏敏感信息学号：隐藏敏感信息一、阶段1：项目启动1、Vi/Vim2、Java3、Ant4、Junit5、SonarQube6、编译运行BugRunner二、阶段2：基本任务1. part2的工作（…

编程日记2024/02/01 14:30:02

PHP解决方案@黑名单过滤

为什么80%的码农都做不了架构师？>>> 方案解决目标：对一些黑名单进行过滤处理 function is_spam($text, $file, $split :, $regex false){ $handle fopen($file,rb); $contents fread($handle, filesize($file)); fclose($handle); $lines …

编程日记2024/02/01 14:00:00

Ubuntu 12.04下玩转终端管理器Byobu

简介很多Linux高手都喜欢使用screen命令，screen命令可以使你轻松地使用一个终端控制其他终端。尽管screen本身是一个非常有用的工具，byobu作为screen的增强版本，比screen更加好用而且美观，并且提供有用的信息和快捷的热键。想象…

编程日记2024/02/01 13:30:00

python字典排序方法_Python字典的排序方法一则

今天需要对Python的字典进行排序，以获得有效的时间序列，采用了如下方法： 首先生成一个示例字典： >>> range_a random.sample(range(0, 10), 10) >>> range_b random.sample(range(10, 20), 10) >>> …

编程日记2024/02/01 13:00:00

encodeURI 和 encodeURIComponent

保留字符 （reserved characters）：这类字符是URI中的保留关键字符，它们用于分割URI中的各个部分。这些字符是：";" | "/" | "?" | ":" | "" | "&&quo…

编程日记2024/02/01 12:30:00

基于Golang的简单web服务程序开发——CloudGo

基于Golang的简单web服务程序开发——CloudGo【阅读时间：约10分钟】一、概述二、系统环境&项目介绍1.系统环境2.项目的任务要求（1）基本要求（2）扩展要求三、具体程序设计及Golang代码实现1.预先准备2.CloudGoClient…

编程日记2024/02/01 12:00:01

Android Studio创建项目

编程日记2024/02/01 11:30:00

Weiss的数据结构与算法分析（C++版）源码编译说明

最近尝试编译Weiss的那本数据结构与算法分析（C版）提供的源代码时，遇到一些问题，特记录如下：考虑到该书提供的代码是使用模板技术较多，这在提供简洁代码的同时，也给源码的编译带来了一些问题。因…

编程日记2024/02/01 11:00:00

latex 中文_【小白向】LaTeX 中文入门

注：本文尚未撰写完毕，先暂存一下~(2020/06/27)参考学习路线[1]如何从零开始，入门 LaTeX？ 孟晨 1. 卸载 CTeX 套装，安装 TeX Live原因及教程见：TeX Live 下载及安装说明2. 看完：一份其实很短的 L…

编程日记2024/02/01 10:30:00

物联网兴起嵌入式系统安全日益受关注

随着越来越多设备连接到互联网，专家们担心嵌入式系统将给企业带来严重安全风险，而很多企业还没有意识到这种风险或者无法缓解这种风险…… 随着越来越多设备连接到互联网，专家们担心嵌入式系统将给企业带来严重安全风险，而很多企业…

编程日记2024/02/01 10:00:00

【Golang源码分析】Go Web常用程序包gorilla/mux的使用与源码简析

目录【阅读时间：约10分钟】一.概述二.对比: gorilla/mux与net/http DefaultServeMux三.简单使用四.源码简析1.NewRouter函数2.HandleFunc函数设置路由的HTTP方法设置路由的域名限制HTTP 方案设置路径前缀和子路由3.PathPrefix函数五.References一.概述 gorilla/mux…

编程日记2024/02/01 09:30:00

FileMaker中的腳本觸發器學習筆記

脚本触发器 **脚本触发器是始终绑定到用户布局接口。对于数据表或者字段。只有在而已接口才能触发。**如果某一个布局或者对象上包含触发器，则其右下角会有触发器图标**当触发一个事件时，有且仅有一个触发器会被执行.布局级别的触发器**ONRECORDLOAD :加…

编程日记2024/02/01 09:00:00

vim学习笔记(四)

下面是我的最近更新，差点删除。下面的笔记摘自vimtutor。<CR>表示回车删除命令在normal模式下： de 删除一个单词，不包含空格 dw 删除一个单词，包含空格 dd 删除当前行 1,10d 删除指定行，第1到10行 ndd…

编程日记2024/02/01 08:30:00

文件和缓存项目依赖

文件和缓存项目依赖要创建缓存依赖，你需要创建一个 CacheDependency 对象并在添加依赖的缓存项目时使用它。例如，下面的代码创建一个缓存项目，它在一个 XML 文件被修改、删除、覆盖时自动从缓存中移除： CacheDependency prodDepe…

编程日记2024/02/01 08:00:00

python函数的基础知识_Python入门基础知识点(函数进阶）

动态参数： 动态接收位置参数： def eat(*args): #在形参位置，*叫做聚合 print(我想吃,args) eat(大米饭,中米饭,小米饭) #收到的结果是一个tuple元祖动态接收参数的时候要注意: 动态参数必须在位置参数后面，否则： def …

编程日记2024/02/01 07:30:01

【CentOS】利用Kubeadm部署Kubernetes (K8s)

【CentOS】利用Kubeadm部署Kubernetes （K8s）【阅读时间：约10分钟】一、概述二、系统环境&项目介绍1.系统环境2.项目的任务要求三、具体实验流程1 系统准备2 安装常用包3 使用aliyun源安装docker-ce4 安装kubectl、kubelet、kubeadm5 初始…

编程日记2024/02/01 07:00:01