A ContentType
represents a specific MediaType / HttpCharset combination.
A ContentType
represents a specific MediaType / HttpCharset combination.
If the MediaType is not flexible with regard to the charset used, e.g. because it's a binary MediaType or
the charset is fixed, then the ContentType
is a simple wrapper.
Immutable, fast and efficient Date + Time implementation without any dependencies.
Immutable, fast and efficient Date + Time implementation without any dependencies. Does not support TimeZones, all DateTime values are always GMT based. Note that this implementation discards milliseconds (i.e. rounds down to full seconds).
This exception is thrown when the size of the HTTP Entity exceeds the configured limit.
This exception is thrown when the size of the HTTP Entity exceeds the configured limit.
It is possible to configure the limit using configuration options akka.http.parsing.max-content-length
or specifically for the server or client side by setting akka.http.[server|client].parsing.max-content-length
.
The limit can also be configured in code, by calling HttpEntity#withSizeLimit
on the entity before materializing its dataBytes
stream.
Two-level model of error information.
Two-level model of error information. The summary should explain what is wrong with the request or response *without* directly repeating anything present in the message itself (in order to not open holes for XSS attacks), while the detail can contain additional information from any source (even the request itself).
Marker for exceptions that provide an ErrorInfo
Simple model for application/x-www-form-urlencoded
form data.
A charset range as encountered in Accept-Charset
.
A charset range as encountered in Accept-Charset
. Can either be a single charset, or *
if all charsets are supported and optionally a qValue for selecting this choice.
Models the entity (aka "body" or "content) of an HTTP message.
The model of an HTTP header.
The model of an HTTP header. In its most basic form headers are simple name-value pairs. Header names are compared in a case-insensitive way.
Common base class of HttpRequest and HttpResponse.
The method of an HTTP request.
The protocol of an HTTP message
The immutable model HTTP request model.
The immutable HTTP response model.
A MediaType describes the type of the content of an HTTP message entity.
A MediaType describes the type of the content of an HTTP message entity.
While knowledge of the MediaType alone suffices for being able to properly interpret binary content this is not generally the case for non-binary (i.e. character-based) content, which also requires the definition of a specific character encoding (HttpCharset). Therefore MediaType instances are frequently encountered as a member of a ContentType, which groups a MediaType with a potentially required HttpCharset to hold everything required for being able to interpret an HttpEntity.
MediaTypes come in three basic forms:
1. Binary: These do not need an additional HttpCharset to be able to form a ContentType. Therefore they can be implicitly converted to the latter.
2. WithOpenCharset: Most character-based MediaTypes are of this form, which can be combined with all HttpCharset instances to form a ContentType.
3. WithFixedCharset: Some character-based MediaTypes prescribe a single, clearly defined charset and as such,
similarly to binary MediaTypes, do not require the addition of an HttpCharset instances to form a
ContentType. The most prominent example is probably application/json
which must always be UTF-8 encoded.
Like binary MediaTypes WithFixedCharset
types can be implicitly converted to a ContentType.
An entity that can be used for every HttpMessage, i.e.
An entity that can be used for every HttpMessage, i.e. for requests and responses.
The model of multipart content for media-types multipart/\*
(general multipart content),
multipart/form-data
and multipart/byteranges
.
The model of multipart content for media-types multipart/\*
(general multipart content),
multipart/form-data
and multipart/byteranges
.
The basic modelling classes for these media-types (Multipart.General, Multipart.FormData and Multipart.ByteRanges, respectively) are stream-based but each have a strict counterpart (namely Multipart.General.Strict, Multipart.FormData.Strict and Multipart.ByteRanges.Strict).
An HttpEntity that can be used for requests.
An HttpEntity that can be used for requests. Note that all entities that can be used for requests can also be used for responses. (But not the other way around, since HttpEntity.CloseDelimited can only be used for responses!)
An HttpEntity that can be used for responses.
An HttpEntity that can be used for responses. Note that all entities that can be used for requests can also be used for responses. (But not the other way around, since HttpEntity.CloseDelimited can only be used for responses!)
The result status code of an HTTP response.
An immutable model of an internet URI as defined by http://tools.ietf.org/html/rfc3986.
An immutable model of an internet URI as defined by http://tools.ietf.org/html/rfc3986. All members of this class represent the *decoded* URI elements (i.e. without percent-encoding).
Helper trait for objects that allow creating new instances with a modified qValue.