程序包 cn.taketoday.http.converter

类 AbstractHttpMessageConverter<T>

java.lang.Object

cn.taketoday.http.converter.AbstractHttpMessageConverter<T>

类型参数:

T - the converted object type

所有已实现的接口:

HttpMessageConverter<T>

直接已知子类:

AbstractGenericHttpMessageConverter, AbstractWireFeedHttpMessageConverter, AbstractXmlHttpMessageConverter, ByteArrayHttpMessageConverter, ObjectToStringHttpMessageConverter, ProtobufHttpMessageConverter, ResourceHttpMessageConverter, SourceHttpMessageConverter, StringHttpMessageConverter

public abstract class AbstractHttpMessageConverter<T>
extends Object
implements HttpMessageConverter<T>

Abstract base class for most HttpMessageConverter implementations.

This base class adds support for setting supported MediaTypes, through the supportedMediaTypes bean property. It also adds support for Content-Type and Content-Length when writing to output messages.

从以下版本开始:

4.0

作者:

Arjen Poutsma, Juergen Hoeller, Sebastien Deleuze

字段概要

字段

修饰符和类型	字段	说明
private Charset	defaultCharset
protected final cn.taketoday.logging.Logger	logger	Logger available to subclasses.
private List<MediaType>	supportedMediaTypes

构造器概要

构造器

限定符	构造器	说明
protected	AbstractHttpMessageConverter()	Construct an AbstractHttpMessageConverter with no supported media types.
protected	AbstractHttpMessageConverter(MediaType supportedMediaType)	Construct an AbstractHttpMessageConverter with one supported media type.
protected	AbstractHttpMessageConverter(MediaType... supportedMediaTypes)	Construct an AbstractHttpMessageConverter with multiple supported media types.
protected	AbstractHttpMessageConverter(Charset defaultCharset, MediaType... supportedMediaTypes)	Construct an AbstractHttpMessageConverter with a default charset and multiple supported media types.

方法概要

修饰符和类型	方法	说明
void	addDefaultHeaders(HttpHeaders headers, T t, MediaType contentType)	Add default headers to the output message.
protected boolean	canRead(MediaType mediaType)	Returns true if any of the supported media types include the given media type.
boolean	canRead(Class<?> clazz, MediaType mediaType)	This implementation checks if the given class is supported, and if the supported media types include the given media type.
protected boolean	canWrite(MediaType mediaType)	Returns true if the given media type includes any of the supported media types.
boolean	canWrite(Class<?> clazz, MediaType mediaType)	This implementation checks if the given class is supported, and if the supported media types include the given media type.
protected Long	getContentLength(T t, MediaType contentType)	Returns the content length for the given type.
Charset	getDefaultCharset()	Return the default character set, if any.
protected MediaType	getDefaultContentType(T t)	Returns the default content type for the given type.
List<MediaType>	getSupportedMediaTypes()	Return the list of media types supported by this converter.
final T	read(Class<? extends T> clazz, HttpInputMessage inputMessage)	This implementation simple delegates to readInternal(Class, HttpInputMessage).
protected abstract T	readInternal(Class<? extends T> clazz, HttpInputMessage inputMessage)	Abstract template method that reads the actual object.
void	setDefaultCharset(Charset defaultCharset)	Set the default character set, if any.
void	setSupportedMediaTypes(List<MediaType> supportedMediaTypes)	Set the list of MediaType objects supported by this converter.
protected abstract boolean	supports(Class<?> clazz)	Indicates whether the given class is supported by this converter.
final void	write(T t, MediaType contentType, HttpOutputMessage outputMessage)	This implementation sets the default headers by calling addDefaultHeaders(cn.taketoday.http.HttpHeaders, T, cn.taketoday.http.MediaType), and then calls writeInternal(T, cn.taketoday.http.HttpOutputMessage).
protected abstract void	writeInternal(T t, HttpOutputMessage outputMessage)	Abstract template method that writes the actual body.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 cn.taketoday.http.converter.HttpMessageConverter

getSupportedMediaTypes

字段详细资料

logger

protected final cn.taketoday.logging.Logger logger

Logger available to subclasses.

supportedMediaTypes

private List<MediaType> supportedMediaTypes

defaultCharset

@Nullable
private Charset defaultCharset

构造器详细资料

AbstractHttpMessageConverter

protected AbstractHttpMessageConverter()

Construct an AbstractHttpMessageConverter with no supported media types.

另请参阅:

• setSupportedMediaTypes(java.util.List<cn.taketoday.http.MediaType>)

AbstractHttpMessageConverter

protected AbstractHttpMessageConverter(MediaType supportedMediaType)

Construct an AbstractHttpMessageConverter with one supported media type.

参数:

supportedMediaType - the supported media type

AbstractHttpMessageConverter

protected AbstractHttpMessageConverter(MediaType... supportedMediaTypes)

Construct an AbstractHttpMessageConverter with multiple supported media types.

参数:

supportedMediaTypes - the supported media types

AbstractHttpMessageConverter

protected AbstractHttpMessageConverter(Charset defaultCharset,
 MediaType... supportedMediaTypes)

Construct an AbstractHttpMessageConverter with a default charset and multiple supported media types.

参数:

defaultCharset - the default character set

supportedMediaTypes - the supported media types

方法详细资料

setSupportedMediaTypes

public void setSupportedMediaTypes(List<MediaType> supportedMediaTypes)

Set the list of MediaType objects supported by this converter.

getSupportedMediaTypes

public List<MediaType> getSupportedMediaTypes()

从接口复制的说明: HttpMessageConverter

Return the list of media types supported by this converter. The list may not apply to every possible target element type and calls to this method should typically be guarded via canWrite(clazz, null. The list may also exclude MIME types supported only for a specific class. Alternatively, use HttpMessageConverter.getSupportedMediaTypes(Class) for a more precise list.

指定者:

getSupportedMediaTypes 在接口中 HttpMessageConverter<T>

返回:

the list of supported media types

setDefaultCharset

public void setDefaultCharset(@Nullable
 Charset defaultCharset)

Set the default character set, if any.

getDefaultCharset

@Nullable
public Charset getDefaultCharset()

Return the default character set, if any.

canRead

public boolean canRead(Class<?> clazz,
 @Nullable
 MediaType mediaType)

This implementation checks if the given class is supported, and if the supported media types include the given media type.

指定者:

canRead 在接口中 HttpMessageConverter<T>

参数:

clazz - the class to test for readability

mediaType - the media type to read (can be null if not specified); typically the value of a Content-Type header.

返回:

true if readable; false otherwise

canRead

protected boolean canRead(@Nullable
 MediaType mediaType)

Returns true if any of the supported media types include the given media type.

参数:

mediaType - the media type to read, can be null if not specified. Typically the value of a Content-Type header.

返回:

true if the supported media types include the media type, or if the media type is null

canWrite

public boolean canWrite(Class<?> clazz,
 @Nullable
 MediaType mediaType)

This implementation checks if the given class is supported, and if the supported media types include the given media type.

指定者:

canWrite 在接口中 HttpMessageConverter<T>

参数:

clazz - the class to test for writability

mediaType - the media type to write (can be null if not specified); typically the value of an Accept header.

返回:

true if writable; false otherwise

canWrite

protected boolean canWrite(@Nullable
 MediaType mediaType)

Returns true if the given media type includes any of the supported media types.

参数:

mediaType - the media type to write, can be null if not specified. Typically the value of an Accept header.

返回:

true if the supported media types are compatible with the media type, or if the media type is null

read

public final T read(Class<? extends T> clazz,
 HttpInputMessage inputMessage)
             throws IOException,
HttpMessageNotReadableException

This implementation simple delegates to readInternal(Class, HttpInputMessage). Future implementations might add some default behavior, however.

指定者:

read 在接口中 HttpMessageConverter<T>

参数:

clazz - the type of object to return. This type must have previously been passed to the canRead method of this interface, which must have returned true.

inputMessage - the HTTP input message to read from

返回:

the converted object

抛出:

IOException - in case of I/O errors

HttpMessageNotReadableException - in case of conversion errors

write

public final void write(T t,
 @Nullable
 MediaType contentType,
 HttpOutputMessage outputMessage)
                 throws IOException,
HttpMessageNotWritableException

This implementation sets the default headers by calling addDefaultHeaders(cn.taketoday.http.HttpHeaders, T, cn.taketoday.http.MediaType), and then calls writeInternal(T, cn.taketoday.http.HttpOutputMessage).

指定者:

write 在接口中 HttpMessageConverter<T>

参数:

t - the object to write to the output message. The type of this object must have previously been passed to the canWrite method of this interface, which must have returned true.

contentType - the content type to use when writing. May be null to indicate that the default content type of the converter must be used. If not null, this media type must have previously been passed to the canWrite method of this interface, which must have returned true.

outputMessage - the message to write to

抛出:

IOException - in case of I/O errors

HttpMessageNotWritableException - in case of conversion errors

addDefaultHeaders

public void addDefaultHeaders(HttpHeaders headers,
 T t,
 @Nullable
 MediaType contentType)
                       throws IOException

Add default headers to the output message.

This implementation delegates to getDefaultContentType(Object) if a content type was not provided, set if necessary the default character set, calls getContentLength(T, cn.taketoday.http.MediaType), and sets the corresponding headers.

抛出:

IOException

getDefaultContentType

@Nullable
protected MediaType getDefaultContentType(T t)
                                   throws IOException

Returns the default content type for the given type. Called when write(T, cn.taketoday.http.MediaType, cn.taketoday.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.

参数:

t - the type to return the content type for

返回:

the content type, or null if not known

抛出:

IOException

getContentLength

@Nullable
protected Long getContentLength(T t,
 @Nullable
 MediaType contentType)
                         throws IOException

Returns the content length for the given type.

By default, this returns null, meaning that the content length is unknown. Can be overridden in subclasses.

参数:

t - the type to return the content length for

返回:

the content length, or null if not known

抛出:

IOException

supports

protected abstract boolean supports(Class<?> clazz)

Indicates whether the given class is supported by this converter.

参数:

clazz - the class to test for support

返回:

true if supported; false otherwise

readInternal

protected abstract T readInternal(Class<? extends T> clazz,
 HttpInputMessage inputMessage)
                           throws IOException,
HttpMessageNotReadableException

Abstract template method that reads the actual object. Invoked from read(java.lang.Class<? extends T>, cn.taketoday.http.HttpInputMessage).

参数:

clazz - the type of object to return

inputMessage - the HTTP input message to read from

返回:

the converted object

抛出:

IOException - in case of I/O errors

HttpMessageNotReadableException - in case of conversion errors

writeInternal

protected abstract void writeInternal(T t,
 HttpOutputMessage outputMessage)
                               throws IOException,
HttpMessageNotWritableException

Abstract template method that writes the actual body. Invoked from write(T, cn.taketoday.http.MediaType, cn.taketoday.http.HttpOutputMessage).

参数:

t - the object to write to the output message

outputMessage - the HTTP output message to write to

抛出:

IOException - in case of I/O errors

HttpMessageNotWritableException - in case of conversion errors