Struct actix_web::http::header::ContentType

pub struct ContentType(pub Mime);

Content-Type header, defined in RFC 7231 §3.1.1.5

The Content-Type header field indicates the media type of the associated representation: either the representation enclosed in the message payload or the selected representation, as determined by the message semantics. The indicated media type defines both the data format and how that data is intended to be processed by a recipient, within the scope of the received message semantics, after any content codings indicated by Content-Encoding are decoded.

Although the mime crate allows the mime options to be any slice, this crate forces the use of Vec. This is to make sure the same header can’t have more than 1 type. If this is an issue, it’s possible to implement Header on a custom struct.

ABNF

Content-Type = media-type

Example Values

• text/html; charset=utf-8
• application/json

Examples

use actix_web::HttpResponse;
use actix_web::http::header::ContentType;

let mut builder = HttpResponse::Ok();
builder.insert_header(
    ContentType::json()
);

use actix_web::HttpResponse;
use actix_web::http::header::ContentType;

let mut builder = HttpResponse::Ok();
builder.insert_header(
    ContentType(mime::TEXT_HTML)
);

Tuple Fields

0: Mime

Implementations

impl ContentType

pub fn json() -> ContentType

A constructor to easily create a Content-Type: application/json header.

pub fn plaintext() -> ContentType

A constructor to easily create a Content-Type: text/plain; charset=utf-8 header.

pub fn html() -> ContentType

A constructor to easily create a Content-Type: text/html; charset=utf-8 header.

pub fn xml() -> ContentType

A constructor to easily create a Content-Type: text/xml header.

pub fn form_url_encoded() -> ContentType

A constructor to easily create a Content-Type: application/www-form-url-encoded header.

pub fn jpeg() -> ContentType

A constructor to easily create a Content-Type: image/jpeg header.

pub fn png() -> ContentType

A constructor to easily create a Content-Type: image/png header.

pub fn octet_stream() -> ContentType

A constructor to easily create a Content-Type: application/octet-stream header.

Methods from Deref<Target = Mime>

pub fn type_(&self) -> Name<'_>

Get the top level media type for this Mime.

Example

let mime = mime::TEXT_PLAIN;
assert_eq!(mime.type_(), "text");
assert_eq!(mime.type_(), mime::TEXT);

pub fn subtype(&self) -> Name<'_>

Get the subtype of this Mime.

Example

let mime = mime::TEXT_PLAIN;
assert_eq!(mime.subtype(), "plain");
assert_eq!(mime.subtype(), mime::PLAIN);

pub fn suffix(&self) -> Option<Name<'_>>

Get an optional +suffix for this Mime.

Example

let svg = "image/svg+xml".parse::<mime::Mime>().unwrap();
assert_eq!(svg.suffix(), Some(mime::XML));
assert_eq!(svg.suffix().unwrap(), "xml");


assert!(mime::TEXT_PLAIN.suffix().is_none());

pub fn get_param<'a, N>(&'a self, attr: N) -> Option<Name<'a>> where
    N: PartialEq<Name<'a>>, 

Look up a parameter by name.

Example

let mime = mime::TEXT_PLAIN_UTF_8;
assert_eq!(mime.get_param(mime::CHARSET), Some(mime::UTF_8));
assert_eq!(mime.get_param("charset").unwrap(), "utf-8");
assert!(mime.get_param("boundary").is_none());

let mime = "multipart/form-data; boundary=ABCDEFG".parse::<mime::Mime>().unwrap();
assert_eq!(mime.get_param(mime::BOUNDARY).unwrap(), "ABCDEFG");

pub fn params(&'a self) -> Params<'a>

Returns an iterator over the parameters.

pub fn essence_str(&self) -> &str

Return a &str of the Mime’s “essence”.

Trait Implementations

impl Clone for ContentType

fn clone(&self) -> ContentType

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContentType

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for ContentType

type Target = Mime

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for ContentType

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Display for ContentType

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Header for ContentType

fn name() -> HeaderName

Returns the name of the header field

fn parse<M: HttpMessage>(msg: &M) -> Result<Self, ParseError>

Parse a header

impl PartialEq<ContentType> for ContentType

fn eq(&self, other: &ContentType) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &ContentType) -> bool

This method tests for !=.

impl TryIntoHeaderValue for ContentType

type Error = InvalidHeaderValue

The type returned in the event of a conversion error.

fn try_into_value(self) -> Result<HeaderValue, Self::Error>

Try to convert value to a HeaderValue.

impl Eq for ContentType

impl StructuralEq for ContentType

impl StructuralPartialEq for ContentType