接口 GenericHttpMessageConverter<T>
- 所有超级接口:
HttpMessageConverter<T>
- 所有已知实现类:
AbstractGenericHttpMessageConverter,AbstractJackson2HttpMessageConverter,GsonHttpMessageConverter,Jaxb2CollectionHttpMessageConverter,MappingJackson2HttpMessageConverter,MappingJackson2XmlHttpMessageConverter,ResourceRegionHttpMessageConverter
public interface GenericHttpMessageConverter<T> extends HttpMessageConverter<T>
A specialization ofHttpMessageConverterthat can convert an HTTP request into a target object of a specified generic type and a source object of a specified generic type into an HTTP response.- 从以下版本开始:
- 3.2
- 作者:
- Arjen Poutsma, Rossen Stoyanchev, Sebastien Deleuze
- 另请参阅:
ParameterizedTypeReference
方法概要
所有方法 实例方法 抽象方法 修饰符和类型 方法 说明 booleancanRead(Type type, Class<?> contextClass, MediaType mediaType)Indicates whether the given type can be read by this converter.booleancanWrite(Type type, Class<?> clazz, MediaType mediaType)Indicates whether the given class can be written by this converter.Tread(Type type, Class<?> contextClass, HttpInputMessage inputMessage)Read an object of the given type form the given input message, and returns it.voidwrite(T t, Type type, MediaType contentType, HttpOutputMessage outputMessage)Write an given object to the given output message.从接口继承的方法 org.springframework.http.converter.HttpMessageConverter
canRead, canWrite, getSupportedMediaTypes, read, write
方法详细资料
canRead
boolean canRead(Type type, Class<?> contextClass, MediaType mediaType)
Indicates whether the given type can be read by this converter. This method should perform the same checks thanHttpMessageConverter.canRead(Class, MediaType)with additional ones related to the generic type.- 参数:
type- the (potentially generic) type to test for readabilitycontextClass- a context class for the target type, for example a class in which the target type appears in a method signature (can benull)mediaType- the media type to read, can benullif not specified. Typically the value of aContent-Typeheader.- 返回:
trueif readable;falseotherwise
read
T read(Type type, Class<?> contextClass, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException
Read an object of the given type form the given input message, and returns it.- 参数:
type- the (potentially generic) type of object to return. This type must have previously been passed to thecanReadmethod of this interface, which must have returnedtrue.contextClass- a context class for the target type, for example a class in which the target type appears in a method signature (can benull)inputMessage- the HTTP input message to read from- 返回:
- the converted object
- 抛出:
IOException- in case of I/O errorsHttpMessageNotReadableException- in case of conversion errors
canWrite
boolean canWrite(Type type, Class<?> clazz, MediaType mediaType)
Indicates whether the given class can be written by this converter.This method should perform the same checks than
HttpMessageConverter.canWrite(Class, MediaType)with additional ones related to the generic type.- 参数:
type- the (potentially generic) type to test for writability (can benullif not specified)clazz- the source object class to test for writabilitymediaType- the media type to write (can benullif not specified); typically the value of anAcceptheader.- 返回:
trueif writable;falseotherwise- 从以下版本开始:
- 4.2
write
void write(T t, Type type, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException
Write an given object to the given output message.- 参数:
t- the object to write to the output message. The type of this object must have previously been passed to thecanWritemethod of this interface, which must have returnedtrue.type- the (potentially generic) type of object to write. This type must have previously been passed to thecanWritemethod of this interface, which must have returnedtrue. Can benullif not specified.contentType- the content type to use when writing. May benullto indicate that the default content type of the converter must be used. If notnull, this media type must have previously been passed to thecanWritemethod of this interface, which must have returnedtrue.outputMessage- the message to write to- 抛出:
IOException- in case of I/O errorsHttpMessageNotWritableException- in case of conversion errors- 从以下版本开始:
- 4.2