jsonpb

Documentation

Overview

Package jsonpb provides marshaling/unmarshaling functionality between protocol buffer and JSON objects.

Compared to encoding/json, this library:

• encodes int64, uint64 as strings
• optionally encodes enums as integers

Index

• func Unmarshal(r io.Reader, pb proto.Message) error
• func UnmarshalString(str string, pb proto.Message) error
• type Marshaler
  • func (m *Marshaler) Marshal(out io.Writer, pb proto.Message) error
  • func (m *Marshaler) MarshalToString(pb proto.Message) (string, error)

Functions

func Unmarshal

func Unmarshal(r io.Reader, pb proto.Message) error

Unmarshal unmarshals a JSON object stream into a protocol buffer. This function is lenient and will decode any options permutations of the related Marshaler.

func UnmarshalString

func UnmarshalString(str string, pb proto.Message) error

UnmarshalString will populate the fields of a protocol buffer based on a JSON string. This function is lenient and will decode any options permutations of the related Marshaler.

Types

type Marshaler

type Marshaler struct {
	// Whether to render enum values as integers, as opposed to string values.
	EnumsAsInts bool

	// A string to indent each level by. The presence of this field will
	// also cause a space to appear between the field separator and
	// value, and for newlines to be appear between fields and array
	// elements.
	Indent string
}

Marshaler is a configurable object for converting between protocol buffer objects and a JSON representation for them

func (*Marshaler) Marshal

func (m *Marshaler) Marshal(out io.Writer, pb proto.Message) error

Marshal marshals a protocol buffer into JSON.

func (*Marshaler) MarshalToString

func (m *Marshaler) MarshalToString(pb proto.Message) (string, error)

MarshalToString converts a protocol buffer object to JSON string.