摘要:当你第一次定义Protocol Buffer的消息的时候,你肯定会给消息设定一套规则需求。但是随着时间的推进,你的业务可能会发生了变化,与此同时,你的Protocol Buffer消息类型的需求也会随之变化。 也就是说:有一些字段可能会发生变化,可能会添加一些字段,也可能会删除一些字段。但是可能有很 阅读全文
posted @ 2020-02-14 06:01 solenovex 阅读 (66) 评论 (0) 编辑
摘要:第一篇文章(大约半年前写的):https://www.cnblogs.com/cgzl/p/11246324.html gRPC in ASP.NET Core 3.x -- Protocol Buffer(2)Go语言的例子(上) 接着上一篇文章。 写入到JSON 首先写一个func: 在这里,使 阅读全文
posted @ 2020-02-12 12:53 solenovex 阅读 (289) 评论 (0) 编辑
摘要:上一篇文章(大约半年前写的):https://www.cnblogs.com/cgzl/p/11246324.html 建立Go项目 在GOPATH的src下面建立一个文件夹 protobuf-go,然后在里面执行命令 go mod init github.com/solenovex/protobu 阅读全文
posted @ 2020-02-11 20:47 solenovex 阅读 (324) 评论 (1) 编辑
摘要:无论哪种类型的Web API, 都可能需要给其他开发者使用. 所以API的开发者体验是很重要的. API的开发者体验, 简写为 API DX (Developer Experience). 它包含很多东西, 例如如何使用API, 文档, 技术支持等等, 但是最重要的还是API的设计. 如果 API 阅读全文
posted @ 2020-01-20 13:42 solenovex 阅读 (612) 评论 (4) 编辑
摘要:说到验证,那就需要做三件事: 定义验证规则 按验证规则进行检查 报告验证的错误。在把错误报告给API消费者的时候,报告里并不包含到底是服务端还是API消费者引起的错误,这是状态码的工作。而通常响应的Body里面会包含一组验证错误信息,API消费者可以把这些信息展示给API消费者的用户。 定义验证规则 阅读全文
posted @ 2020-01-13 20:20 solenovex 阅读 (573) 评论 (3) 编辑
摘要:什么样的HTTP方法是安全的? 什么样的HTTP方法是安全的? 如果一个方法不会改变资源的表述,那么这个方法就被认为是安全的。 如果一个方法不会改变资源的表述,那么这个方法就被认为是安全的。 例如 HTTP GET 和 HTTP HEAD 就被认为是安全的,但需要注意的是,这并不意味着执行GET请求 阅读全文
posted @ 2020-01-05 20:32 solenovex 阅读 (593) 评论 (0) 编辑
摘要:向Web API传递参数 数据可以通过多种方式来传给API。 数据可以通过多种方式来传给API。 Binding Source Attributes 会告诉 Model 的绑定引擎从哪里找到绑定源。 Binding Source Attributes 会告诉 Model 的绑定引擎从哪里找到绑定源。 阅读全文
posted @ 2020-01-05 20:29 solenovex 阅读 (621) 评论 (0) 编辑
摘要:Entity Framework Core 使用的 Entity Model 是用来表示数据库里面的记录的。 Entity Framework Core 使用的 Entity Model 是用来表示数据库里面的记录的。 而面向外部的 model 则表示了要传输的东西。这类 model 有时候叫做 D 阅读全文
posted @ 2020-01-01 19:53 solenovex 阅读 (587) 评论 (3) 编辑
摘要:现在,当谈论起 RESTful Web API 的时候,人们总会想到 JSON。但是实际上,JSON 和 RESTful API 没有半毛钱关系,只不过 JSON 恰好是RESTful API 结果的表述格式。也就是说 RESTful API 还可以使用其它的表述格式,例如 xml 或私有的格式。这 阅读全文
posted @ 2019-12-16 21:41 solenovex 阅读 (607) 评论 (0) 编辑
摘要:HTTP状态码 HTTP状态码会告诉API的消费者以下事情: 请求是否执行成功了 如果请求失败了,那么谁为它负责 HTTP的状态码有很多,但是Web API不一定需要支持所有的状态码。HTTP状态码一共分为5个级别: 1xx,属于信息性的状态码。Web API并不使用1xx的状态码。 2xx,意味着 阅读全文
posted @ 2019-12-12 21:43 solenovex 阅读 (1178) 评论 (0) 编辑