Package org.springframework.core.codec
Interface Encoder<T>
- Type Parameters:
T- the type of elements in the input stream
- All Known Subinterfaces:
HttpMessageEncoder<T>
- All Known Implementing Classes:
AbstractEncoder,AbstractJackson2Encoder,AbstractSingleValueEncoder,ByteArrayEncoder,ByteBufferEncoder,CharSequenceEncoder,DataBufferEncoder,Jackson2CborEncoder,Jackson2JsonEncoder,Jackson2SmileEncoder,Jaxb2XmlEncoder,ProtobufEncoder,ResourceEncoder,ResourceRegionEncoder
public interface Encoder<T>
Strategy to encode a stream of Objects of type<T>into an output stream of bytes.- Since:
- 5.0
- Author:
- Sebastien Deleuze, Rossen Stoyanchev
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description booleancanEncode(ResolvableType elementType, MimeType mimeType)Whether the encoder supports the given source element type and the MIME type for the output stream.reactor.core.publisher.Flux<DataBuffer>encode(org.reactivestreams.Publisher<? extends T> inputStream, DataBufferFactory bufferFactory, ResolvableType elementType, MimeType mimeType, Map<String,Object> hints)Encode a stream of Objects of typeTinto aDataBufferoutput stream.default DataBufferencodeValue(T value, DataBufferFactory bufferFactory, ResolvableType valueType, MimeType mimeType, Map<String,Object> hints)Encode an Object of type T to a data buffer.List<MimeType>getEncodableMimeTypes()Return the list of mime types this encoder supports.
Method Detail
canEncode
boolean canEncode(ResolvableType elementType, @Nullable MimeType mimeType)
Whether the encoder supports the given source element type and the MIME type for the output stream.- Parameters:
elementType- the type of elements in the source streammimeType- the MIME type for the output stream (can benullif not specified)- Returns:
trueif supported,falseotherwise
encode
reactor.core.publisher.Flux<DataBuffer> encode(org.reactivestreams.Publisher<? extends T> inputStream, DataBufferFactory bufferFactory, ResolvableType elementType, @Nullable MimeType mimeType, @Nullable Map<String,Object> hints)
Encode a stream of Objects of typeTinto aDataBufferoutput stream.- Parameters:
inputStream- the input stream of Objects to encode. If the input should be encoded as a single value rather than as a stream of elements, an instance ofMonoshould be used.bufferFactory- for creating output streamDataBuffer'selementType- the expected type of elements in the input stream; this type must have been previously passed to thecanEncode(org.springframework.core.ResolvableType, org.springframework.util.MimeType)method and it must have returnedtrue.mimeType- the MIME type for the output content (optional)hints- additional information about how to encode- Returns:
- the output stream
encodeValue
default DataBuffer encodeValue(T value, DataBufferFactory bufferFactory, ResolvableType valueType, @Nullable MimeType mimeType, @Nullable Map<String,Object> hints)
Encode an Object of type T to a data buffer. This is useful for scenarios, that distinct messages (or events) are encoded and handled individually, in fully aggregated form.By default this method raises
UnsupportedOperationExceptionand it is expected that some encoders cannot produce a single buffer or cannot do so synchronously (e.g. encoding aResource).- Parameters:
value- the value to be encodedbufferFactory- for creating the outputDataBuffervalueType- the type for the value being encodedmimeType- the MIME type for the output content (optional)hints- additional information about how to encode- Returns:
- the encoded content
- Since:
- 5.2
getEncodableMimeTypes
List<MimeType> getEncodableMimeTypes()
Return the list of mime types this encoder supports.