java.lang.Object
- org.springframework.http.converter.AbstractHttpMessageConverter<com.google.protobuf.Message>
- - org.springframework.http.converter.protobuf.ProtobufHttpMessageConverter

All Implemented Interfaces:
HttpMessageConverter<com.google.protobuf.Message>
```
public class ProtobufHttpMessageConverter
extends AbstractHttpMessageConverter<com.google.protobuf.Message>
```
An HttpMessageConverter that reads and writes Messages using Google Protocol Buffers.
By default, it supports "application/x-protobuf", "text/plain", "application/json", "application/xml", while also writing "text/html".
To generate Message Java classes, you need to install the protoc binary.
Requires Protobuf 2.6 and Protobuf Java Format 1.4, as of Spring 4.3.
Since:
4.1
Author:
Alex Antonov, Brian Clozel, Juergen Hoeller

Field Summary
Fields
Modifier and Type Field Description
static Charset DEFAULT_CHARSET
static MediaType PROTOBUF
static String X_PROTOBUF_MESSAGE_HEADER
static String X_PROTOBUF_SCHEMA_HEADER
- Fields inherited from class org.springframework.http.converter.AbstractHttpMessageConverter
  logger

Constructor Summary

Constructors
Constructor	Description
`ProtobufHttpMessageConverter()`	Construct a new instance.
`ProtobufHttpMessageConverter(ExtensionRegistryInitializer registryInitializer)`	Construct a new instance with an `ExtensionRegistryInitializer` that allows the registration of message extensions.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected boolean`	`canWrite(MediaType mediaType)`	This method overrides the parent implementation, since this HttpMessageConverter can also produce `MediaType.HTML "text/html"` ContentType.
`protected MediaType`	`getDefaultContentType(com.google.protobuf.Message message)`	Returns the default content type for the given type.
`protected com.google.protobuf.Message`	`readInternal(Class<? extends com.google.protobuf.Message> clazz, HttpInputMessage inputMessage)`	Abstract template method that reads the actual object.
`protected boolean`	`supports(Class<?> clazz)`	Indicates whether the given class is supported by this converter.
`protected void`	`writeInternal(com.google.protobuf.Message message, HttpOutputMessage outputMessage)`	Abstract template method that writes the actual body.

Methods inherited from class org.springframework.http.converter.AbstractHttpMessageConverter
addDefaultHeaders, canRead, canRead, canWrite, getContentLength, getDefaultCharset, getSupportedMediaTypes, read, setDefaultCharset, setSupportedMediaTypes, write

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_CHARSET
```
public static final Charset DEFAULT_CHARSET
```
  - PROTOBUF
```
public static final MediaType PROTOBUF
```
  - X_PROTOBUF_SCHEMA_HEADER
```
public static final String X_PROTOBUF_SCHEMA_HEADER
```
    See Also:
    Constant Field Values
  - X_PROTOBUF_MESSAGE_HEADER
```
public static final String X_PROTOBUF_MESSAGE_HEADER
```
    See Also:
    Constant Field Values
- Constructor Detail
  - ProtobufHttpMessageConverter
```
public ProtobufHttpMessageConverter()
```
    Construct a new instance.
  - ProtobufHttpMessageConverter
```
public ProtobufHttpMessageConverter(ExtensionRegistryInitializer registryInitializer)
```
    Construct a new instance with an ExtensionRegistryInitializer that allows the registration of message extensions.
- Method Detail
  - supports
```
protected boolean supports(Class<?> clazz)
```
    Description copied from class: AbstractHttpMessageConverter
    Indicates whether the given class is supported by this converter.
    Specified by:
    supports in class AbstractHttpMessageConverter<com.google.protobuf.Message>
    Parameters:
    clazz - the class to test for support
    Returns:
    true if supported; false otherwise
  - getDefaultContentType
```
protected MediaType getDefaultContentType(com.google.protobuf.Message message)
```
    Description copied from class: AbstractHttpMessageConverter
    Returns the default content type for the given type. Called when AbstractHttpMessageConverter.write(T, org.springframework.http.MediaType, org.springframework.http.HttpOutputMessage) is invoked without a specified content type parameter.
    By default, this returns the first element of the supportedMediaTypes property, if any. Can be overridden in subclasses.
    Overrides:
    getDefaultContentType in class AbstractHttpMessageConverter<com.google.protobuf.Message>
    Parameters:
    message - the type to return the content type for
    Returns:
    the content type, or null if not known
  - readInternal
```
protected com.google.protobuf.Message readInternal(Class<? extends com.google.protobuf.Message> clazz,
                                                   HttpInputMessage inputMessage)
                                            throws IOException,
                                                   HttpMessageNotReadableException
```
    Description copied from class: AbstractHttpMessageConverter
    Abstract template method that reads the actual object. Invoked from AbstractHttpMessageConverter.read(java.lang.Class<? extends T>, org.springframework.http.HttpInputMessage).
    Specified by:
    readInternal in class AbstractHttpMessageConverter<com.google.protobuf.Message>
    Parameters:
    clazz - the type of object to return
    inputMessage - the HTTP input message to read from
    Returns:
    the converted object
    Throws:
    IOException - in case of I/O errors
    HttpMessageNotReadableException - in case of conversion errors
  - canWrite
```
protected boolean canWrite(MediaType mediaType)
```
    This method overrides the parent implementation, since this HttpMessageConverter can also produce MediaType.HTML "text/html" ContentType.
    Overrides:
    canWrite in class AbstractHttpMessageConverter<com.google.protobuf.Message>
    Parameters:
    mediaType - the media type to write, can be null if not specified. Typically the value of an Accept header.
    Returns:
    true if the supported media types are compatible with the media type, or if the media type is null
  - writeInternal
```
protected void writeInternal(com.google.protobuf.Message message,
                             HttpOutputMessage outputMessage)
                      throws IOException,
                             HttpMessageNotWritableException
```
    Description copied from class: AbstractHttpMessageConverter
    Abstract template method that writes the actual body. Invoked from AbstractHttpMessageConverter.write(T, org.springframework.http.MediaType, org.springframework.http.HttpOutputMessage).
    Specified by:
    writeInternal in class AbstractHttpMessageConverter<com.google.protobuf.Message>
    Parameters:
    message - the object to write to the output message
    outputMessage - the HTTP output message to write to
    Throws:
    IOException - in case of I/O errors
    HttpMessageNotWritableException - in case of conversion errors

Modifier and Type	Field	Description
`static Charset`	`DEFAULT_CHARSET`
`static MediaType`	`PROTOBUF`
`static String`	`X_PROTOBUF_MESSAGE_HEADER`
`static String`	`X_PROTOBUF_SCHEMA_HEADER`

Class ProtobufHttpMessageConverter

Field Summary

Fields inherited from class org.springframework.http.converter.AbstractHttpMessageConverter

Constructor Summary

Method Summary

Methods inherited from class org.springframework.http.converter.AbstractHttpMessageConverter

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_CHARSET

PROTOBUF

X_PROTOBUF_SCHEMA_HEADER

X_PROTOBUF_MESSAGE_HEADER

Constructor Detail

ProtobufHttpMessageConverter

ProtobufHttpMessageConverter

Method Detail

supports

getDefaultContentType

readInternal

canWrite

writeInternal