当我还没有发布JSON模式,因为它还没有经过测试时,我如何为它的$id提供一个绝对的URL?

我正在组合JSON模式,我想使用$ref来DRY我的模式。我将有许多模式,每个模式都将使用公共子模式。我想在发布模式之前对其进行单元测试,方法是编写单元测试,断言在给定特定输入的情况下,输入被视为有效或无效,使用我相信是正确的JSON模式库(这样我只是在测试我的模式,而不是库)。

我感到困惑的是,为了在发布模式之前加载它们(我希望在本地运行测试和CI/CD期间这样做),我需要使用这样的相对本地路径:

"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加载它们,而不是从磁盘加载。我对此感到担忧,因为我不希望网络服务器成为我的应用程序启动的故障点。

我希望能深入了解如何实现这两个目标。