webservice::musicbrainz::response(3pm) [debian man page]
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)
Check Out this Related Man Page
WebService::MusicBrainz::Track(3pm) User Contributed Perl Documentation WebService::MusicBrainz::Track(3pm)NAME
WebService::MusicBrainz::Track
SYNOPSIS
use WebService::MusicBrainz::Track;
my $ws = WebService::MusicBrainz::Track->new();
my $response = $ws->search({ TITLE => 'Same in any language' });
my $track = $response->track(); # grab the first one from list
print $track->title(), " - ", $track->artist()->name(), "
";
# OUTPUT: Same In Any Language - I Nine
DESCRIPTION
This module is used to search the MusicBrainz database about track information.
METHODS
new()
This method is the constructor and it will call for initialization.
query()
This method will return the cached WebService::MusicBrainz::Query object.
search()
This method will search the MusicBrainz database about track related information. The only argument is a hashref to define the search
parameters.
my $ws = WebService::MusicBrainz::Track->new();
$ws->search({ TITLE => 'when the stars go blue' });
$ws->search({ TITLE => 'blue', OFFSET => 100 });
$ws->search({ ARTIST => 'Ryan Adams', TITLE => 'when the stars go blue' });
$ws->search({ RELEASE => 'Gold', TITLE => 'when the stars go blue' });
$ws->search({ DURATION => 200000, TITLE => 'when the stars go blue' });
$ws->search({ TRACKNUM => 7, TITLE => 'when the stars go blue' });
$ws->search({ ARTISTID => 'c80f38a6-9980-485d-997c-5c1a9cbd0d64', TITLE => 'when the stars go blue' });
$ws->search({ RELEASEID => '433adbc2-382f-4f3a-9ce9-401f221f5b3b', TITLE => 'when the stars go blue' });
$ws->search({ LIMIT => 5, TITLE => 'when the stars go blue' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'artist' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'releases' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'puids' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'artist-rels' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'release-rels' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'track-rels' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'url-rels' });
Multiple INC params can be delimited by whitespace, commas, or + characters.
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'artist url-rels' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'artist,url-rels' });
$ws->search({ MBID => 'bd08eddf-b811-4653-b56b-892292c291bc', INC => 'artist+url-rels' });
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::Track(3pm)