go-jsref

JSON Reference Implementation for Go

SYNOPSIS

package jsref_test

import (
  "encoding/json"
  "fmt"
  "log"

  jsref "github.com/lestrrat/go-jsref"
  "github.com/lestrrat/go-jsref/provider"
)

func Example() {
  var v interface{}
  src := []byte(`
{
  "foo": ["bar", {"$ref": "#/sub"}, {"$ref": "obj2#/sub"}],
  "sub": "baz"
}`)
  if err := json.Unmarshal(src, &v); err != nil {
    log.Printf("%s", err)
    return
  }

  // External reference
  mp := provider.NewMap()
  mp.Set("obj2", map[string]string{"sub": "quux"})

  res := jsref.New()
  res.AddProvider(mp) // Register the provider

  ptrs := []string{
    "#/foo/0", // "bar"
    "#/foo/1", // "baz"
    "#/foo/2", // "quux" (resolves via `mp`)
    "#/foo",   // contents of foo key
  }
  for _, ptr := range ptrs {
    result, err := res.Resolve(v, ptr)
    if err != nil { // failed to resolve
      fmt.Printf("err: %s\n", err)
      continue
    }
    b, _ := json.Marshal(result)
    fmt.Printf("%s -> %s\n", ptr, string(b))
  }

  // OUTPUT:
  // #/foo/0 -> "bar"
  // #/foo/1 -> "baz"
  // #/foo/2 -> "quux"
  // #/foo -> ["bar",{"$ref":"#/sub"},{"$ref":"obj2#/sub"}]
}

Providers

The Resolver object by default does not know how to resolve any reference: You must provide it one or more Providers to look for and resolve external references.

Currently available Providers are:

Name	Description
provider.FS	Resolve from local file system. References must start with a file:/// prefix
provider.Map	Resolve from in memory map.
provider.HTTP	Resolve by making HTTP requests. References must start with a http(s?):// prefix

References

Name	Notes
go-jsval	Validator generator
go-jshschema	JSON Hyper Schema implementation
go-jsschema	JSON Schema implementation
go-jspointer	JSON Pointer implementations