webservice::musicbrainz::query(3pm) [debian man page]

WebService::MusicBrainz::Query(3pm)			User Contributed Perl Documentation		       WebService::MusicBrainz::Query(3pm)

NAME

       WebService::MusicBrainz::Query

SYNOPSIS

ABSTRACT

       WebService::MusicBrainz - Interface with the MusicBrainz web service.

DESCRIPTION

       This module's relationship with WebService::MusicBrainz::Artist, WebService::MusicBrainz::Release, and WebService::MusicBrainz::Track is a
       "has a" relationship.  This module will not be instantiated by any client but will only be used internally within the Artist, Release, or
       Track classes.

METHODS

   new()
       This method is the constructor and it will call for initialization.  An optional HOST parameter can be passed to select a different
       mirrored server.

   set_url_params()
       Define a list of valid URL query parameters.

   set_inc_params()
       Define a list of valid arguments for the "inc" URL query parameter.

   get()
       Perform the URL request (GET) and if success, then return a WebService::MusicBrainz::Response object.  Otherwise die.

AUTHOR

       Bob Faist <bob.faist@gmail.com>

COPYRIGHT AND LICENSE

       Copyright 2006-2009 by Bob Faist

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

SEE ALSO

       http://wiki.musicbrainz.org/XMLWebService

perl v5.10.1							    2009-12-06				       WebService::MusicBrainz::Query(3pm)

WebService::MusicBrainz::Response(3pm)			User Contributed Perl Documentation		    WebService::MusicBrainz::Response(3pm)

NAME

       WebService::MusicBrainz::Response

SYNOPSIS

DESCRIPTION

       This module will hide the details of the XML web service response and provide an API to query the XML data which has been returned.  This
       module is responsible for parsing the XML web service response and instantiating objects to provide access to the details of the response.

METHODS

   new()
       This method is the constructor and it will call for  initialization.

   xpc()
   as_xml()
       This method returns the raw XML from the MusicBrainz web service response.

   generator()
       This method will return an optional value of the generator.

   created()
       This method will return an optional value of the created date.

   score()
       This method will return an optional value of the relevance score.

   metadata()
       This method will return an Response::Metadata object.

   artist()
       This method will return an Response::Artist object.

   release()
       This method will return an Reponse::Release object;.

   track()
       This method will return an Response::Track object.

   label()
       This method will return an Response::Label object.

   artist_list()
       This method will return a reference to the Response::ArtistList object in a scalar context.  If in a array context, an array of
       Response::Artist objects will be returned.

   release_list()
       This method will return a reference to the Response::ReleaseList object in a scalar context.  If in a array context, an array of
       Response::Release objects will be returned.

   track_list()
       This method will return a reference to the Response::TrackList object in a scalar context.  If in a array context, an array of
       Response::Track objects will be returned.

   label_list()
       This method will return a reference to the Response::LabelList object in a scalar context.  If in a array context, an array of
       Response::Label objects will be returned.

AUTHOR

       Bob Faist <bob.faist@gmail.com>

COPYRIGHT AND LICENSE

       Copyright 2006-2007 by Bob Faist

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

SEE ALSO

       http://wiki.musicbrainz.org/XMLWebService

perl v5.10.1							    2009-12-06				    WebService::MusicBrainz::Response(3pm)