public abstract class AbstractHttpContent implements HttpContentAbstract implementation of an HTTP content with typical options.
Implementation is not thread-safe.
Implements
HttpContentStatic Methods
computeLength(HttpContent content)
public static long computeLength(HttpContent content)Returns the computed content length based using IOUtils#computeLength(StreamingContent)
or instead -1 if HttpContent#retrySupported() is false because the
stream must not be read twice.
| Parameter | |
|---|---|
| Name | Description |
content |
HttpContentHTTP content |
| Returns | |
|---|---|
| Type | Description |
long |
computed content length or |
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
Constructors
AbstractHttpContent(HttpMediaType mediaType)
protected AbstractHttpContent(HttpMediaType mediaType)| Parameter | |
|---|---|
| Name | Description |
mediaType |
HttpMediaTypeMedia type this content represents or |
AbstractHttpContent(String mediaType)
protected AbstractHttpContent(String mediaType)| Parameter | |
|---|---|
| Name | Description |
mediaType |
StringMedia type string (for example "type/subtype") this content represents or
|
Methods
computeLength()
protected long computeLength()Computes and returns the content length or less than zero if not known.
Subclasses may override, but by default this computes the length by calling #computeLength(HttpContent).
| Returns | |
|---|---|
| Type | Description |
long |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
getCharset()
protected final Charset getCharset()Returns the charset specified in the media type or ISO_8859_1 if not specified.
| Returns | |
|---|---|
| Type | Description |
Charset |
|
getLength()
public long getLength()Default implementation calls #computeLength() once and caches it for future invocations, but subclasses may override.
| Returns | |
|---|---|
| Type | Description |
long |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
getMediaType()
public final HttpMediaType getMediaType()Returns the media type to use for the Content-Type header, or null if unspecified.
| Returns | |
|---|---|
| Type | Description |
HttpMediaType |
|
getType()
public String getType()Returns the content type or null for none.
| Returns | |
|---|---|
| Type | Description |
String |
|
retrySupported()
public boolean retrySupported()Default implementation returns true, but subclasses may override.
| Returns | |
|---|---|
| Type | Description |
boolean |
|
setMediaType(HttpMediaType mediaType)
public AbstractHttpContent setMediaType(HttpMediaType mediaType)Sets the media type to use for the Content-Type header, or null if unspecified.
This will also overwrite any previously set parameter of the media type (for example
"charset"), and therefore might change other properties as well.
| Parameter | |
|---|---|
| Name | Description |
mediaType |
HttpMediaType |
| Returns | |
|---|---|
| Type | Description |
AbstractHttpContent |
|