Class ProtoRestSerializer<RequestT> (2.20.0)

public class ProtoRestSerializer<RequestT>

This class serializes/deserializes protobuf Message for REST interactions. It serializes requests protobuf messages into REST messages, splitting the message into the JSON request body, URL path parameters, and query parameters. It deserializes JSON responses into response protobuf message.

Inheritance

Object > ProtoRestSerializer<RequestT>

Type Parameter

NameDescription
RequestT

Static Methods

<RequestT>create()

public static ProtoRestSerializer<RequestT> <RequestT>create()

Creates a new instance of ProtoRestSerializer.

Returns
TypeDescription
ProtoRestSerializer<RequestT>

Methods

putPathParam(Map<String,String> fields, String fieldName, Object fieldValue)

public void putPathParam(Map<String,String> fields, String fieldName, Object fieldValue)

Puts a message field in fields map which will be used to populate URL path of a request.

Parameters
NameDescription
fieldsMap<String,String>

a map with serialized fields

fieldNameString

a field name

fieldValueObject

a field value

putQueryParam(Map<String,List<String>> fields, String fieldName, Object fieldValue)

public void putQueryParam(Map<String,List<String>> fields, String fieldName, Object fieldValue)

Puts a message field in fields map which will be used to populate query parameters of a request.

Parameters
NameDescription
fieldsMap<String,List<String>>

a map with serialized fields

fieldNameString

a field name

fieldValueObject

a field value

toBody(String fieldName, RequestT fieldValue)

public String toBody(String fieldName, RequestT fieldValue)

Serializes a message to a request body in a form of JSON-encoded string.

Parameters
NameDescription
fieldNameString

a name of a request message field this message belongs to

fieldValueRequestT

a field value to serialize

Returns
TypeDescription
String

toBody(String fieldName, RequestT fieldValue, boolean numericEnum)

public String toBody(String fieldName, RequestT fieldValue, boolean numericEnum)

Serializes a message to a request body in a form of JSON-encoded string.

Parameters
NameDescription
fieldNameString

a name of a request message field this message belongs to

fieldValueRequestT

a field value to serialize

numericEnumboolean

a boolean flag that determine if enum values should be serialized to number

Returns
TypeDescription
String