org.apache.dubbo.common.serialize

Interface ObjectInput

All Superinterfaces:

DataInput

public interface ObjectInput
extends DataInput

Object input interface.

Method Summary

Modifier and Type	Method and Description
default Map<String,Object>	readAttachments()
default String	readEvent()
Object	readObject() Consider use readObject(Class) or readObject(Class, Type) where possible
<T> T	readObject(Class<T> cls) read object
<T> T	readObject(Class<T> cls, Type type) read object
default Throwable	readThrowable() The following methods are customized for the requirement of Dubbo's RPC protocol implementation.

Methods inherited from interface org.apache.dubbo.common.serialize.DataInput

readBool, readByte, readBytes, readDouble, readFloat, readInt, readLong, readShort, readUTF

Method Detail

readObject

Object readObject()
           throws IOException,
                  ClassNotFoundException

Consider use readObject(Class) or readObject(Class, Type) where possible

Returns:

object

Throws:

IOException - if an I/O error occurs

ClassNotFoundException - if an ClassNotFoundException occurs

readObject

<T> T readObject(Class<T> cls)
          throws IOException,
                 ClassNotFoundException

read object

Parameters:

cls - object class

Returns:

object

Throws:

IOException - if an I/O error occurs

ClassNotFoundException - if an ClassNotFoundException occurs

readObject

<T> T readObject(Class<T> cls,
                 Type type)
          throws IOException,
                 ClassNotFoundException

read object

Parameters:

cls - object class

type - object type

Returns:

object

Throws:

IOException - if an I/O error occurs

ClassNotFoundException - if an ClassNotFoundException occurs

readThrowable

default Throwable readThrowable()
                         throws IOException,
                                ClassNotFoundException

The following methods are customized for the requirement of Dubbo's RPC protocol implementation. Legacy protocol implementation will try to write Map, Throwable and Null value directly to the stream, which does not meet the restrictions of all serialization protocols.

See how ProtobufSerialization, KryoSerialization implemented these methods for more details.

The binding of RPC protocol and biz serialization protocol is not a good practice. Encoding of RPC protocol should be highly independent and portable, easy to cross platforms and languages, for example, like the http headers, restricting the content of headers / attachments to Ascii strings and uses ISO_8859_1 to encode them. https://tools.ietf.org/html/rfc7540#section-8.1.2

Throws:

IOException

ClassNotFoundException

readEvent

default String readEvent()
                  throws IOException,
                         ClassNotFoundException

Throws:

IOException

ClassNotFoundException

readAttachments

default Map<String,Object> readAttachments()
                                    throws IOException,
                                           ClassNotFoundException

Throws:

IOException

ClassNotFoundException