Browse Source

Polishing

pull/35738/head
Juergen Hoeller 2 months ago
parent
commit
b2b526162f
  1. 30
      spring-web/src/main/java/org/springframework/http/converter/HttpMessageConverters.java

30
spring-web/src/main/java/org/springframework/http/converter/HttpMessageConverters.java

@ -29,23 +29,22 @@ import java.util.function.Consumer; @@ -29,23 +29,22 @@ import java.util.function.Consumer;
*/
public interface HttpMessageConverters extends Iterable<HttpMessageConverter<?>> {
/**
* Create a builder instance, tailored for HTTP client usage.
* <p>The following HTTP message converters can be detected and registered if available, in order:
* <ol>
* <li>All custom message converters configured with the builder
* <li>{@link ByteArrayHttpMessageConverter}
* <li>{@link StringHttpMessageConverter} with the {@link java.nio.charset.StandardCharsets#ISO_8859_1} charset
* <li>{@link ResourceHttpMessageConverter}, with resource streaming support disabled
* <li>a Multipart converter, using all detected and custom converters for part conversion
* <li>A JSON converter
* <li>A Smile converter
* <li>A CBOR converter
* <li>A YAML converter
* <li>An XML converter
* <li>A ProtoBuf converter
* <li>ATOM and RSS converters
* <li>All custom message converters configured with the builder
* <li>{@link ByteArrayHttpMessageConverter}
* <li>{@link StringHttpMessageConverter} with the {@link java.nio.charset.StandardCharsets#ISO_8859_1} charset
* <li>{@link ResourceHttpMessageConverter}, with resource streaming support disabled
* <li>a Multipart converter, using all detected and custom converters for part conversion
* <li>A JSON converter
* <li>A Smile converter
* <li>A CBOR converter
* <li>A YAML converter
* <li>An XML converter
* <li>A ProtoBuf converter
* <li>ATOM and RSS converters
* </ol>
*/
static ClientBuilder forClient() {
@ -75,6 +74,7 @@ public interface HttpMessageConverters extends Iterable<HttpMessageConverter<?>> @@ -75,6 +74,7 @@ public interface HttpMessageConverters extends Iterable<HttpMessageConverter<?>>
return new DefaultHttpMessageConverters.DefaultServerBuilder();
}
interface Builder<T extends Builder<T>> {
/**
@ -150,18 +150,18 @@ public interface HttpMessageConverters extends Iterable<HttpMessageConverter<?>> @@ -150,18 +150,18 @@ public interface HttpMessageConverters extends Iterable<HttpMessageConverter<?>>
HttpMessageConverters build();
}
/**
* Client builder for an {@link HttpMessageConverters} instance.
*/
interface ClientBuilder extends Builder<ClientBuilder> {
}
/**
* Server builder for an {@link HttpMessageConverters} instance.
*/
interface ServerBuilder extends Builder<ServerBuilder> {
}
}

Loading…
Cancel
Save