IT数码 购物 网址 头条 软件 日历 阅读 图书馆
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
图片批量下载器
↓批量下载图片,美女图库↓
图片自动播放器
↓图片自动播放器↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁
 
   -> 大数据 -> 关于goframe2.0规范路由个人见解(二) -> 正文阅读

[大数据]关于goframe2.0规范路由个人见解(二)

api结构体数据描述

先看代码模板:

type HelloRes struct {
	g.Meta `mime:"text/html" example:"string"`
	ID      uint  `json:"id" in:"path" v:"min:1#请选择要修改的内容" dc:"内容id"`
}

在这段代码中可以看到数据描述部分有数据类型、json属性名、校验规则、数据描述等信息,内容如下:

json:属性名(重要)

注意golang的代码规范是导出结构体属性名首字母必须大写,前端的代码规范是属性名首字母小写。所以在这里必须通过写json属性名描述来将golang的属性名转成前端使用的属性名。
千万注意前后端属性名大小写、下划线、小驼峰各种差异。

dc:内容描述(重要)

请看下图红框部分,在dc中的内容会被展示在/swagger的数据属性栏中。请不要忽略该内容!
在这里插入图片描述

v:数据校验(一般)

v的用处是用来描述校验规则,相关内容非常多,可以参考Goframe数据校验
我因为前后端一起写,数据校验都在前端写了,所以后端就没有使用v。如果发现前端数据校验做的不好,后端必须要做数据校验,那么可以认真看看官网里的数据校验相关内容,可以大大减少写数据校验规则的代码。

in:数据值范围(不重要)

限定值范围。可以写个数组,限定值必须在这个数组内。这部分可忽略不写。

总结:
注意,api结构体数据描述的内容在请求结构体和响应结构体中是一致的。请求结构体中描述的是请求参数,响应结构体中描述的是返回参数。

api响应结构体Meta

先看代码模板:

type HelloRes struct {
	g.Meta `mime:"text/html" example:"string"`
}

这部分是描述返回的数据类型,是html网页或者是json数据。我个人觉得这个完全可以不写,返回数据使用WriteJson、WriteTpl已经很清晰了,没必要再写响应结构体的Meta。

  大数据 最新文章
实现Kafka至少消费一次
亚马逊云科技:还在苦于ETL?Zero ETL的时代
初探MapReduce
【SpringBoot框架篇】32.基于注解+redis实现
Elasticsearch:如何减少 Elasticsearch 集
Go redis操作
Redis面试题
专题五 Redis高并发场景
基于GBase8s和Calcite的多数据源查询
Redis——底层数据结构原理
上一篇文章      下一篇文章      查看所有文章
加:2022-04-07 22:46:53  更:2022-04-07 22:50:13 
 
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁

360图书馆 购物 三丰科技 阅读网 日历 万年历 2024年11日历 -2024/11/24 6:03:46-

图片自动播放器
↓图片自动播放器↓
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
图片批量下载器
↓批量下载图片,美女图库↓
  网站联系: qq:121756557 email:121756557@qq.com  IT数码