Package org.springframework.http.codec
Interface HttpMessageWriter<T>
- Type Parameters:
T
- the type of objects in the input stream
- All Known Implementing Classes:
EncoderHttpMessageWriter
,FormHttpMessageWriter
,MultipartHttpMessageWriter
,PartHttpMessageWriter
,ProtobufHttpMessageWriter
,ResourceHttpMessageWriter
,ServerSentEventHttpMessageWriter
public interface HttpMessageWriter<T>
Strategy for encoding a stream of objects of type
<T>
and writing
the encoded stream of bytes to an ReactiveHttpOutputMessage
.- Since:
- 5.0
- Author:
- Rossen Stoyanchev, Arjen Poutsma, Sebastien Deleuze
-
Method Summary
Modifier and TypeMethodDescriptionboolean
canWrite
(ResolvableType elementType, MediaType mediaType) Whether the given object type is supported by this writer.Return the list of media types supported by this Writer.getWritableMediaTypes
(ResolvableType elementType) Return the list of media types supported by this Writer for the given type of element.default reactor.core.publisher.Mono<Void>
write
(Publisher<? extends T> inputStream, ResolvableType actualType, ResolvableType elementType, MediaType mediaType, ServerHttpRequest request, ServerHttpResponse response, Map<String, Object> hints) Server-side only alternative towrite(Publisher, ResolvableType, MediaType, ReactiveHttpOutputMessage, Map)
with additional context available.reactor.core.publisher.Mono<Void>
write
(Publisher<? extends T> inputStream, ResolvableType elementType, MediaType mediaType, ReactiveHttpOutputMessage message, Map<String, Object> hints) Write an given stream of object to the output message.
-
Method Details
-
getWritableMediaTypes
Return the list of media types supported by this Writer. The list may not apply to every possible target element type and calls to this method should typically be guarded viacanWrite(elementType, null)
. The list may also exclude media types supported only for a specific element type. Alternatively, usegetWritableMediaTypes(ResolvableType)
for a more precise list.- Returns:
- the general list of supported media types
-
getWritableMediaTypes
Return the list of media types supported by this Writer for the given type of element. This list may differ fromgetWritableMediaTypes()
if the Writer doesn't support the element type, or if it supports it only for a subset of media types.- Parameters:
elementType
- the type of element to encode- Returns:
- the list of media types supported for the given class
- Since:
- 5.3.4
-
canWrite
Whether the given object type is supported by this writer.- Parameters:
elementType
- the type of object to checkmediaType
- the media type for the write (possiblynull
)- Returns:
true
if writable,false
otherwise
-
write
reactor.core.publisher.Mono<Void> write(Publisher<? extends T> inputStream, ResolvableType elementType, @Nullable MediaType mediaType, ReactiveHttpOutputMessage message, Map<String, Object> hints) Write an given stream of object to the output message.- Parameters:
inputStream
- the objects to writeelementType
- the type of objects in the stream which must have been previously checked viacanWrite(ResolvableType, MediaType)
mediaType
- the content type for the write (possiblynull
to indicate that the default content type of the writer must be used)message
- the message to write tohints
- additional information about how to encode and write- Returns:
- indicates completion or error
-
write
default reactor.core.publisher.Mono<Void> write(Publisher<? extends T> inputStream, ResolvableType actualType, ResolvableType elementType, @Nullable MediaType mediaType, ServerHttpRequest request, ServerHttpResponse response, Map<String, Object> hints) Server-side only alternative towrite(Publisher, ResolvableType, MediaType, ReactiveHttpOutputMessage, Map)
with additional context available.- Parameters:
actualType
- the actual return type of the method that returned the value; for annotated controllers, theMethodParameter
can be accessed viaResolvableType.getSource()
.elementType
- the type of Objects in the input streammediaType
- the content type to use (possiblynull
indicating the default content type of the writer should be used)request
- the current requestresponse
- the current response- Returns:
- a
Mono
that indicates completion of writing or error
-