MSGPACK

Introduction
Code generation

Introduction

MsgPack (aka “MessagePack”) is a binary exchange format that provides better performance and lower bandwidth usage comparing to JSON. To make a struct MsgPack-compatible, add tags to the struct in the same way you add JSON tags.

Example from cmn/objlist.go:

type LsObjEntry struct {
	Name      string `json:"name" msg:"n"`
	Size      int64  `json:"size,string,omitempty" msg:"s,omitempty"`
	// the rest struct fields

Note msg:"n" tag value - in the resulting binary data, the field Name is marked with n title.

Code generation

After you change a struct that supports MsgPack, encoding and decoding functions are not updated automatically. You have to run MsgPack generator for the changed file.

First, install the generator if you haven’t done it yet:

$ make msgp-update

Second, generate the encoding and decoding functions. For better compatibility and to minimize the diff size, use the same flags as in the example:

$ msgp -file <PATH_TO_CHANGED_FILE> -tests=false -marshal=false -unexported

When the generation completes, msgp creates a file with the original name and _gen prefix. Do not forget to prepend a common AIS header to the generated file and commit it to the repository.

Workflow example:

$ ls cmn/objlist*
objlist.go
$ msgp -file cmn/objlist.go -tests=false -marshal=false -unexported

$ ls cmn/objlist*
objlist.go  objlist.go

Table of Contents

Introduction

Code generation