HTTP::Headers::ActionPack::MediaTypeList(3)

NAME
HTTP::Headers::ActionPack::MediaTypeList - A Priority List customized for Media Types

VERSION
version 0.09

SYNOPSIS
  use HTTP::Headers::ActionPack::MediaTypeList;

  # normal constructor
  my $list = HTTP::Headers::ActionPack::MediaTypeList->new(
      HTTP::Headers::ActionPack::MediaType->new('audio/*', q => 0.2 ),
      HTTP::Headers::ActionPack::MediaType->new('audio/basic', q => 1.0 )
  );

  # you can also specify the 'q'
  # rating independent of the
  # media type definition
  my $list = HTTP::Headers::ActionPack::MediaTypeList->new(
      [ 0.2 => HTTP::Headers::ActionPack::MediaType->new('audio/*', q => 0.2 )     ],
      [ 1.0 => HTTP::Headers::ActionPack::MediaType->new('audio/basic' ) ]
  );

  # or from a string
  my $list = HTTP::Headers::ActionPack::MediaTypeList->new_from_string(
      'audio/*; q=0.2, audio/basic'
  );

DESCRIPTION
This is a subclass of the HTTP::Headers::ActionPack::PriorityList class with some specific media-type features. It is the default object used to parse most of the "Accept" header since they will often contain more then one media type.

METHODS

"iterable"
    This returns the same data type as the parent (two element ARRAY ref with quality and choice), but the choice element will be a HTTP::Headers::ActionPack::MediaType object. This is also sorted in a very specific manner in order to align with RFC-2616 Sec14.

      Media ranges can be overridden by more specific
      media ranges or specific media types. If more
      than one media range applies to a given type,
      the most specific reference has precedence.

"canonicalize_choice"
    If this is passed a string, it returns a new HTTP::Headers::ActionPack::MediaType object from that string. If it receives an object it simply returns that object as is.

AUTHOR
Stevan Little <stevan.little@iinteractive.com>

CONTRIBUTORS

•   Andrew Nelson <anelson@cpan.org>

•   Dave Rolsky <autarch@urth.org>

•   Florian Ragwitz <rafl@debian.org>

•   Jesse Luehrs <doy@tozt.net>

•   Karen Etheridge <ether@cpan.org>

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.