NAME

WebService::MusicBrainz::Release

SYNOPSIS

use WebService::MusicBrainz::Release;

my $ws = WebService::MusicBrainz::Release->new();

my $response = $ws->search({ TITLE => 'ok computer' });

my $release = $response->release(); # grab first one in the list

print $release->title(), " (", $release->type(), ") - ", $release->artist()->name(), "\n";

# OUTPUT: OK Computer (Album Official) - Radiohead

DESCRIPTION

METHODS

new()

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

_init()

This method will initialize the WebService::MusicBrainz::Release object and instantiate a WebService::MusicBrainz::Query object with parameters specific to a release. Internal use only.

query()

This method will return the cached query object;

search()

This method is used to search the MusicBrainz database using their web service schema. The only argument is a hashref to define the search parameters.

my $ws = WebService::MusicBrainz::Release->new();

my $response = $ws->search({ TITLE => 'Highway to Hell' });
my $response = $ws->search({ ARTIST => 'sleater kinney' });
my $response = $ws->search({ ARTISTID => '65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab' });
my $response = $ws->search({ RELEASETYPES => 'Official', MBID => 'a89e1d92-5381-4dab-ba51-733137d0e431' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'counts' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'release-events' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'discs' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'tracks' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'artist-rels' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'release-rels' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'track-rels' });
my $response = $ws->search({ MBID => 'fed37cfc-2a6d-4569-9ac0-501a7c7598eb', INC => 'url-rels' });

AUTHOR

Bob Faist <bob.faist@gmail.com>

COPYRIGHT AND LICENSE

Copyright 2006 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