NAME

HTTP::Headers::ActionPack::MediaType - A Media Type

VERSION

version 0.05

SYNOPSIS

  use HTTP::Headers::ActionPack::MediaType;

  # normal constructor
  my $mt = HTTP::Headers::ActionPack::MediaType->new(
      'application/xml' => (
          'q'       => 0.5,
          'charset' => 'UTF-8'
      )
  );

  # construct from string
  my $mt = HTTP::Headers::ActionPack::MediaType->new_from_string(
      'application/xml; q=0.5; charset=UTF-8'
  );

DESCRIPTION

This is an object which represents an HTTP media type defintion. This is most often found as a member of a HTTP::Headers::ActionPack::MediaTypeList object.

METHODS

type

Accessor for the type.

major

The major portion of the media type name.

minor

The minor portion of the media type name.

matches_all

A media type matched all if the type is */* and if it has no parameters.

equals ( $media_type | $media_type_string )

This will attempt to determine if the $media_type is exactly the same as itself. If given a $media_type_string it will parse it into an object.

In order for two type to be equal, the types must match exactly and the parameters much match exactly.

exact_match ( $media_type | $media_type_string )

This will attempt to determine if the $media_type is a match with itself using the type_matches method below. If given a $media_type_string it will parse it into an object.

In order for an exact match to occur it the types must be compatible and the parameters much match exactly.

match ( $media_type | $media_type_string )

This will attempt to determine if the $media_type is a match with itself using the type_matches method and params_match method below. If given a $media_type_string it will parse it into an object.

In order for an exact match to occur it the types must be compatible and the parameters must be a subset.

type_matches ( $media_type | $media_type_string )

This will determine type compatability, properly handling the * types and major and minor elements of the type.

params_match ( $parameters )

This determines if the $parameters are a subset of the invocants parameters.

AUTHOR

Stevan Little <stevan.little@iinteractive.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Infinity Interactive, Inc..

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.