2016-12-14 18:41:48 +03:00
|
|
|
// Package codec is an interface for encoding messages
|
2015-11-27 03:17:36 +03:00
|
|
|
package codec
|
|
|
|
|
2015-11-28 14:22:29 +03:00
|
|
|
import (
|
|
|
|
"io"
|
|
|
|
)
|
|
|
|
|
|
|
|
const (
|
|
|
|
Error MessageType = iota
|
|
|
|
Request
|
|
|
|
Response
|
|
|
|
Publication
|
|
|
|
)
|
|
|
|
|
|
|
|
type MessageType int
|
|
|
|
|
|
|
|
// Takes in a connection/buffer and returns a new Codec
|
|
|
|
type NewCodec func(io.ReadWriteCloser) Codec
|
|
|
|
|
2015-12-02 04:38:56 +03:00
|
|
|
// Codec encodes/decodes various types of messages used within go-micro.
|
|
|
|
// ReadHeader and ReadBody are called in pairs to read requests/responses
|
|
|
|
// from the connection. Close is called when finished with the
|
|
|
|
// connection. ReadBody may be called with a nil argument to force the
|
|
|
|
// body to be read and discarded.
|
2015-11-27 03:17:36 +03:00
|
|
|
type Codec interface {
|
2019-01-09 22:28:13 +03:00
|
|
|
Reader
|
|
|
|
Writer
|
|
|
|
Close() error
|
|
|
|
String() string
|
|
|
|
}
|
|
|
|
|
|
|
|
type Reader interface {
|
2015-11-28 14:22:29 +03:00
|
|
|
ReadHeader(*Message, MessageType) error
|
|
|
|
ReadBody(interface{}) error
|
2019-01-09 22:28:13 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
type Writer interface {
|
2015-11-28 23:09:07 +03:00
|
|
|
Write(*Message, interface{}) error
|
2015-11-28 14:22:29 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
// Message represents detailed information about
|
|
|
|
// the communication, likely followed by the body.
|
|
|
|
// In the case of an error, body may be nil.
|
|
|
|
type Message struct {
|
2019-01-08 18:38:25 +03:00
|
|
|
Id string
|
2016-01-28 21:11:13 +03:00
|
|
|
Type MessageType
|
|
|
|
Target string
|
|
|
|
Method string
|
|
|
|
Error string
|
2019-01-09 19:20:57 +03:00
|
|
|
|
|
|
|
// The values read from the socket
|
2016-01-28 21:11:13 +03:00
|
|
|
Header map[string]string
|
2019-01-09 22:28:13 +03:00
|
|
|
Body []byte
|
2015-11-28 14:22:29 +03:00
|
|
|
}
|