json

Documentation

Overview

Package json holds the encoder/decoder implementation for `application/json`.

Index

• Variables
• func Decode(ctx context.Context, in, out interface{}) error
• func DecodeObserved(ctx context.Context, in, out interface{}) error
• func Encode(ctx context.Context, in interface{}) ([]byte, error)
• func EncodeObserved(ctx context.Context, in interface{}) ([]byte, error)

Variables

var (
	// LatencyMs measures the latency in milliseconds for the CloudEvents json
	// data codec methods.
	LatencyMs = stats.Float64("cloudevents.io/sdk-go/datacodec/json/latency", "The latency in milliseconds for the CloudEvents json data codec methods.", "ms")
)

var (
	// LatencyView is an OpenCensus view that shows data codec json method latency.
	LatencyView = &view.View{
		Name:        "datacodec/json/latency",
		Measure:     LatencyMs,
		Description: "The distribution of latency inside of the json data codec for CloudEvents.",
		Aggregation: view.Distribution(0, .01, .1, 1, 10, 100, 1000, 10000),
		TagKeys:     observability.LatencyTags(),
	}
)

Functions

func Decode

func Decode(ctx context.Context, in, out interface{}) error

Decode takes `in` as []byte, or base64 string, normalizes in to unquoted and base64 decoded []byte if required, and then attempts to use json.Unmarshal to convert those bytes to `out`. Returns and error if this process fails.

func DecodeObserved

func DecodeObserved(ctx context.Context, in, out interface{}) error

DecodeObserved calls Decode and records the results.

func Encode

func Encode(ctx context.Context, in interface{}) ([]byte, error)

Encode attempts to json.Marshal `in` into bytes. Encode will inspect `in` and returns `in` unmodified if it is detected that `in` is already a []byte; Or json.Marshal errors.

func EncodeObserved

func EncodeObserved(ctx context.Context, in interface{}) ([]byte, error)

EncodeObserved calls Encode and records the results.