如何为尚未发布的 JSON 模式提供绝对 URL 的 $id?
最近发现不少小伙伴都对Golang很感兴趣,所以今天继续给大家介绍Golang相关的知识,本文《如何为尚未发布的 JSON 模式提供绝对 URL 的 $id?》主要内容涉及到等等知识点,希望能帮到你!当然如果阅读本文时存在不同想法,可以在评论中表达,但是请勿使用过激的措辞~
我正在整理 json 模式,并且想使用 $ref 来干燥我的模式。我将有许多模式,每个模式都使用公共子模式。我想在发布模式之前对其进行单元测试,方法是编写单元测试,断言在给定某些输入的情况下,输入被视为有效或无效,使用我相信正确的 json 模式库(这样我只是测试我的模式)架构,而不是库)。
让我感到困惑的是,为了在发布模式之前加载它们(我想在本地运行测试和 ci/cd 期间执行此操作),我需要使用如下所示的相对本地路径: p>
"pet": { "$ref": "file://./schemas/components/pet.schema.json" }
这是因为该宠物架构尚未发布到 url。尚未通过自动化测试验证其正确性。这对于运行测试来说足够有效,而且对于打包到 docker 映像中也很有效,以便在应用程序启动时可以从磁盘加载架构。
但是,如果我在将顶级架构之一发布到绝对 url 后将其提供给某人(利用 $ref),那么它就不会加载到他们的程序中,因为我使用的路径有效仅用于我的单元测试。
我发现我必须使用绝对 url 来发布我的架构,以便它们能够在消费程序中使用。我最终发布了模式 https://mattwelke.github.io/go-jsonschema-ref-docker-example/schemas/person.1-0-0.schema.json 和 https://mattwelke.github.io/ go-jsonschema-ref-docker-example/schemas/components/pet.1-0-0.schema.json 这样。我通过编写程序测试了它们在消费程序中运行良好:
package main import ( "fmt" "github.com/xeipuuv/gojsonschema" ) func main() { schemaloader := gojsonschema.newreferenceloader("https://mattwelke.github.io/go-jsonschema-ref-docker-example/schemas/person.1-0-0.schema.json") jsonstr := ` { "name": "matt", "pet": { "name": "shady" } } ` documentloader := gojsonschema.newstringloader(jsonstr) result, err := gojsonschema.validate(schemaloader, documentloader) if err != nil { panic(fmt.errorf("could not validate: %w", err)) } if result.valid() { fmt.printf("the document is valid.\n") } else { fmt.printf("the document is not valid. see errors:\n") for _, desc := range result.errors() { fmt.printf("- %s\n", desc) } } }
这导致了以下预期输出:
The document is valid.
所以我对这种“先有鸡还是先有蛋”的情况感到困惑。
只要我在发布之前没有对它们进行单元测试,我就能够发布可以使用的模式。
只要满足以下条件,我就能够对架构进行单元测试:
- 我不想以经过单元测试验证正确的形式发布它们。
- 我同意我的应用程序在启动时通过 https 加载它们,而不是从磁盘加载它们。我对此感到担心,因为我不希望网络服务器成为我的应用启动时的故障点。
我希望能够了解如何实现这两个目标。
正确答案
让我感到困惑的是,为了在发布模式之前加载它们(我想在本地运行测试和 CI/CD 期间执行此操作),我需要使用相对本地路径
您最初的假设是错误的。 $id
关键字中使用的 URI 可以是任意标识符——它们不需要通过指定位置的网络或磁盘进行解析。事实上,JSON Schema 实现假设在指定位置查找架构文档是错误的:它们必须支持能够在本地加载文档并将它们与指定标识符关联:
“$id”关键字通过其规范 URI 标识架构资源。
请注意,此 URI 是一个标识符,不一定是网络定位符。对于可网络寻址的 URL,模式不需要可从其规范 URI 下载。
如果模式是可网络寻址的 URL,则不需要从该地址下载模式,并且实现不应假设它们在遇到可网络寻址的 URI 时应该执行网络操作。
因此,您可以为架构文档提供您喜欢的任何标识符,例如您最终发布架构供公众使用时预期使用的 URI,并使用该标识符执行本地测试。
任何不支持这样做的实现都违反了规范,这应该作为错误报告给其维护者。
以上就是《如何为尚未发布的 JSON 模式提供绝对 URL 的 $id?》的详细内容,更多关于的资料请关注golang学习网公众号!

- 上一篇
- 分隔字符串使用 Golang 正则表达式

- 下一篇
- 使用Go获取MongoDB中所有模型树子节点
-
- Golang · Go问答 | 1年前 |
- 在读取缓冲通道中的内容之前退出
- 139浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 戈兰岛的全球 GOPRIVATE 设置
- 204浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 如何将结构作为参数传递给 xml-rpc
- 325浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 如何用golang获得小数点以下两位长度?
- 477浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 如何通过 client-go 和 golang 检索 Kubernetes 指标
- 486浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 将多个“参数”映射到单个可变参数的习惯用法
- 439浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 将 HTTP 响应正文写入文件后出现 EOF 错误
- 357浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 结构中映射的匿名列表的“复合文字中缺少类型”
- 352浏览 收藏
-
- Golang · Go问答 | 1年前 |
- NATS Jetstream 的性能
- 101浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 如何将复杂的字符串输入转换为mapstring?
- 440浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 相当于GoLang中Java将Object作为方法参数传递
- 212浏览 收藏
-
- Golang · Go问答 | 1年前 |
- 如何确保所有 goroutine 在没有 time.Sleep 的情况下终止?
- 143浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 508次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 484次学习
-
- PPTFake答辩PPT生成器
- PPTFake答辩PPT生成器,专为答辩准备设计,极致高效生成PPT与自述稿。智能解析内容,提供多样模板,数据可视化,贴心配套服务,灵活自主编辑,降低制作门槛,适用于各类答辩场景。
- 23次使用
-
- Lovart
- SEO摘要探索Lovart AI,这款专注于设计领域的AI智能体,通过多模态模型集成和智能任务拆解,实现全链路设计自动化。无论是品牌全案设计、广告与视频制作,还是文创内容创作,Lovart AI都能满足您的需求,提升设计效率,降低成本。
- 21次使用
-
- 美图AI抠图
- 美图AI抠图,依托CVPR 2024竞赛亚军技术,提供顶尖的图像处理解决方案。适用于证件照、商品、毛发等多场景,支持批量处理,3秒出图,零PS基础也能轻松操作,满足个人与商业需求。
- 34次使用
-
- PetGPT
- SEO摘要PetGPT 是一款基于 Python 和 PyQt 开发的智能桌面宠物程序,集成了 OpenAI 的 GPT 模型,提供上下文感知对话和主动聊天功能。用户可高度自定义宠物的外观和行为,支持插件热更新和二次开发。适用于需要陪伴和效率辅助的办公族、学生及 AI 技术爱好者。
- 34次使用
-
- 可图AI图片生成
- 探索快手旗下可灵AI2.0发布的可图AI2.0图像生成大模型,体验从文本生成图像、图像编辑到风格转绘的全链路创作。了解其技术突破、功能创新及在广告、影视、非遗等领域的应用,领先于Midjourney、DALL-E等竞品。
- 56次使用
-
- GoLand调式动态执行代码
- 2023-01-13 502浏览
-
- 用Nginx反向代理部署go写的网站。
- 2023-01-17 502浏览
-
- Golang取得代码运行时间的问题
- 2023-02-24 501浏览
-
- 请问 go 代码如何实现在代码改动后不需要Ctrl+c,然后重新 go run *.go 文件?
- 2023-01-08 501浏览
-
- 如何从同一个 io.Reader 读取多次
- 2023-04-11 501浏览