rlp: fix Encoder/Decoder interface corner case

This change improves behavior for unsupported types (e.g. structs
containing int) which implement either the Encoder or Decoder interface
but not both. Encoding and decoding wouldn't work for such types and
always returned an error.
This commit is contained in:
Felix Lange 2019-05-03 18:02:21 +02:00
parent f0d231fe6f
commit 812eb71c13
5 changed files with 78 additions and 50 deletions

View file

@ -308,9 +308,9 @@ func makeListDecoder(typ reflect.Type, tag tags) (decoder, error) {
} }
return decodeByteSlice, nil return decodeByteSlice, nil
} }
etypeinfo, err := cachedTypeInfo1(etype, tags{}) etypeinfo := cachedTypeInfo1(etype, tags{})
if err != nil { if etypeinfo.decoderErr != nil {
return nil, err return nil, etypeinfo.decoderErr
} }
var dec decoder var dec decoder
switch { switch {
@ -469,9 +469,9 @@ func makeStructDecoder(typ reflect.Type) (decoder, error) {
// the pointer's element type. // the pointer's element type.
func makePtrDecoder(typ reflect.Type) (decoder, error) { func makePtrDecoder(typ reflect.Type) (decoder, error) {
etype := typ.Elem() etype := typ.Elem()
etypeinfo, err := cachedTypeInfo1(etype, tags{}) etypeinfo := cachedTypeInfo1(etype, tags{})
if err != nil { if etypeinfo.decoderErr != nil {
return nil, err return nil, etypeinfo.decoderErr
} }
dec := func(s *Stream, val reflect.Value) (err error) { dec := func(s *Stream, val reflect.Value) (err error) {
newval := val newval := val
@ -493,9 +493,9 @@ func makePtrDecoder(typ reflect.Type) (decoder, error) {
// This decoder is used for pointer-typed struct fields with struct tag "nil". // This decoder is used for pointer-typed struct fields with struct tag "nil".
func makeOptionalPtrDecoder(typ reflect.Type) (decoder, error) { func makeOptionalPtrDecoder(typ reflect.Type) (decoder, error) {
etype := typ.Elem() etype := typ.Elem()
etypeinfo, err := cachedTypeInfo1(etype, tags{}) etypeinfo := cachedTypeInfo1(etype, tags{})
if err != nil { if etypeinfo.decoderErr != nil {
return nil, err return nil, etypeinfo.decoderErr
} }
dec := func(s *Stream, val reflect.Value) (err error) { dec := func(s *Stream, val reflect.Value) (err error) {
kind, size, err := s.Kind() kind, size, err := s.Kind()
@ -816,12 +816,12 @@ func (s *Stream) Decode(val interface{}) error {
if rval.IsNil() { if rval.IsNil() {
return errDecodeIntoNil return errDecodeIntoNil
} }
info, err := cachedTypeInfo(rtyp.Elem(), tags{}) decoder, err := cachedDecoder(rtyp.Elem())
if err != nil { if err != nil {
return err return err
} }
err = info.decoder(s, rval.Elem()) err = decoder(s, rval.Elem())
if decErr, ok := err.(*decodeError); ok && len(decErr.ctx) > 0 { if decErr, ok := err.(*decodeError); ok && len(decErr.ctx) > 0 {
// add decode target type to error so context has more meaning // add decode target type to error so context has more meaning
decErr.ctx = append(decErr.ctx, fmt.Sprint("(", rtyp.Elem(), ")")) decErr.ctx = append(decErr.ctx, fmt.Sprint("(", rtyp.Elem(), ")"))

View file

@ -702,6 +702,27 @@ func TestDecoderInByteSlice(t *testing.T) {
} }
} }
type unencodableDecoder func()
func (f *unencodableDecoder) DecodeRLP(s *Stream) error {
if _, err := s.List(); err != nil {
return err
}
if err := s.ListEnd(); err != nil {
return err
}
*f = func() {}
return nil
}
func TestDecoderFunc(t *testing.T) {
var x func()
if err := DecodeBytes([]byte{0xC0}, (*unencodableDecoder)(&x)); err != nil {
t.Fatal(err)
}
x()
}
func ExampleDecode() { func ExampleDecode() {
input, _ := hex.DecodeString("C90A1486666F6F626172") input, _ := hex.DecodeString("C90A1486666F6F626172")

View file

@ -182,11 +182,11 @@ func (w *encbuf) Write(b []byte) (int, error) {
func (w *encbuf) encode(val interface{}) error { func (w *encbuf) encode(val interface{}) error {
rval := reflect.ValueOf(val) rval := reflect.ValueOf(val)
ti, err := cachedTypeInfo(rval.Type(), tags{}) writer, err := cachedWriter(rval.Type())
if err != nil { if err != nil {
return err return err
} }
return ti.writer(rval, w) return writer(rval, w)
} }
func (w *encbuf) encodeStringHeader(size int) { func (w *encbuf) encodeStringHeader(size int) {
@ -499,17 +499,17 @@ func writeInterface(val reflect.Value, w *encbuf) error {
return nil return nil
} }
eval := val.Elem() eval := val.Elem()
ti, err := cachedTypeInfo(eval.Type(), tags{}) writer, err := cachedWriter(eval.Type())
if err != nil { if err != nil {
return err return err
} }
return ti.writer(eval, w) return writer(eval, w)
} }
func makeSliceWriter(typ reflect.Type, ts tags) (writer, error) { func makeSliceWriter(typ reflect.Type, ts tags) (writer, error) {
etypeinfo, err := cachedTypeInfo1(typ.Elem(), tags{}) etypeinfo := cachedTypeInfo1(typ.Elem(), tags{})
if err != nil { if etypeinfo.writerErr != nil {
return nil, err return nil, etypeinfo.writerErr
} }
writer := func(val reflect.Value, w *encbuf) error { writer := func(val reflect.Value, w *encbuf) error {
if !ts.tail { if !ts.tail {
@ -545,9 +545,9 @@ func makeStructWriter(typ reflect.Type) (writer, error) {
} }
func makePtrWriter(typ reflect.Type) (writer, error) { func makePtrWriter(typ reflect.Type) (writer, error) {
etypeinfo, err := cachedTypeInfo1(typ.Elem(), tags{}) etypeinfo := cachedTypeInfo1(typ.Elem(), tags{})
if err != nil { if etypeinfo.writerErr != nil {
return nil, err return nil, etypeinfo.writerErr
} }
// determine nil pointer handler // determine nil pointer handler
@ -579,7 +579,7 @@ func makePtrWriter(typ reflect.Type) (writer, error) {
} }
return etypeinfo.writer(val.Elem(), w) return etypeinfo.writer(val.Elem(), w)
} }
return writer, err return writer, nil
} }
// putint writes i to the beginning of b in big endian byte // putint writes i to the beginning of b in big endian byte

View file

@ -49,6 +49,13 @@ func (e byteEncoder) EncodeRLP(w io.Writer) error {
return nil return nil
} }
type undecodableEncoder func()
func (f undecodableEncoder) EncodeRLP(w io.Writer) error {
_, err := w.Write(EmptyList)
return err
}
type encodableReader struct { type encodableReader struct {
A, B uint A, B uint
} }
@ -239,6 +246,8 @@ var encTests = []encTest{
{val: (*testEncoder)(nil), output: "00000000"}, {val: (*testEncoder)(nil), output: "00000000"},
{val: &testEncoder{}, output: "00010001000100010001"}, {val: &testEncoder{}, output: "00010001000100010001"},
{val: &testEncoder{errors.New("test error")}, error: "test error"}, {val: &testEncoder{errors.New("test error")}, error: "test error"},
// verify that the Encoder interface works for unsupported types like func().
{val: undecodableEncoder(func() {}), output: "C0"},
// verify that pointer method testEncoder.EncodeRLP is called for // verify that pointer method testEncoder.EncodeRLP is called for
// addressable non-pointer values. // addressable non-pointer values.
{val: &struct{ TE testEncoder }{testEncoder{}}, output: "CA00010001000100010001"}, {val: &struct{ TE testEncoder }{testEncoder{}}, output: "CA00010001000100010001"},

View file

@ -29,8 +29,10 @@ var (
) )
type typeinfo struct { type typeinfo struct {
decoder decoder decoder
writer decoderErr error // error from makeDecoder
writer writer
writerErr error // error from makeWriter
} }
// represents struct tags // represents struct tags
@ -56,12 +58,22 @@ type decoder func(*Stream, reflect.Value) error
type writer func(reflect.Value, *encbuf) error type writer func(reflect.Value, *encbuf) error
func cachedTypeInfo(typ reflect.Type, tags tags) (*typeinfo, error) { func cachedDecoder(typ reflect.Type) (decoder, error) {
info := cachedTypeInfo(typ, tags{})
return info.decoder, info.decoderErr
}
func cachedWriter(typ reflect.Type) (writer, error) {
info := cachedTypeInfo(typ, tags{})
return info.writer, info.writerErr
}
func cachedTypeInfo(typ reflect.Type, tags tags) *typeinfo {
typeCacheMutex.RLock() typeCacheMutex.RLock()
info := typeCache[typekey{typ, tags}] info := typeCache[typekey{typ, tags}]
typeCacheMutex.RUnlock() typeCacheMutex.RUnlock()
if info != nil { if info != nil {
return info, nil return info
} }
// not in the cache, need to generate info for this type. // not in the cache, need to generate info for this type.
typeCacheMutex.Lock() typeCacheMutex.Lock()
@ -69,25 +81,20 @@ func cachedTypeInfo(typ reflect.Type, tags tags) (*typeinfo, error) {
return cachedTypeInfo1(typ, tags) return cachedTypeInfo1(typ, tags)
} }
func cachedTypeInfo1(typ reflect.Type, tags tags) (*typeinfo, error) { func cachedTypeInfo1(typ reflect.Type, tags tags) *typeinfo {
key := typekey{typ, tags} key := typekey{typ, tags}
info := typeCache[key] info := typeCache[key]
if info != nil { if info != nil {
// another goroutine got the write lock first // another goroutine got the write lock first
return info, nil return info
} }
// put a dummy value into the cache before generating. // put a dummy value into the cache before generating.
// if the generator tries to lookup itself, it will get // if the generator tries to lookup itself, it will get
// the dummy value and won't call itself recursively. // the dummy value and won't call itself recursively.
typeCache[key] = new(typeinfo) info = new(typeinfo)
info, err := genTypeInfo(typ, tags) typeCache[key] = info
if err != nil { info.generate(typ, tags)
// remove the dummy value if the generator fails return info
delete(typeCache, key)
return nil, err
}
*typeCache[key] = *info
return typeCache[key], err
} }
type field struct { type field struct {
@ -106,10 +113,7 @@ func structFields(typ reflect.Type) (fields []field, err error) {
if tags.ignored { if tags.ignored {
continue continue
} }
info, err := cachedTypeInfo1(f.Type, tags) info := cachedTypeInfo1(f.Type, tags)
if err != nil {
return nil, err
}
fields = append(fields, field{i, info}) fields = append(fields, field{i, info})
} }
} }
@ -151,15 +155,9 @@ func lastPublicField(typ reflect.Type) int {
return last return last
} }
func genTypeInfo(typ reflect.Type, tags tags) (info *typeinfo, err error) { func (i *typeinfo) generate(typ reflect.Type, tags tags) {
info = new(typeinfo) i.decoder, i.decoderErr = makeDecoder(typ, tags)
if info.decoder, err = makeDecoder(typ, tags); err != nil { i.writer, i.writerErr = makeWriter(typ, tags)
return nil, err
}
if info.writer, err = makeWriter(typ, tags); err != nil {
return nil, err
}
return info, nil
} }
func isUint(k reflect.Kind) bool { func isUint(k reflect.Kind) bool {