WebService::Audioscrobbler::Base - An object-oriented interface to the Audioscrobbler WebService API

This module implements the base class for all other WebService::Audioscrobbler modules.

    package WebService::Audioscrobbler::Subclass;
    use base 'WebService::Audioscrobbler::Base';

    ...

    my $self = WebService::Audioscrobbler::Subclass->new;

    # retrieves tracks
    my @tracks = $self->tracks;

    # retrieves tags
    my @tags = $self->tags;

    # retrieves arbitrary XML data as a hashref, using XML::Simple
    my $data = $self->fetch_data('resource.xml');

Retrieves the tracks related to the current resource as available on Audioscrobbler's database.

Returns either a list of tracks or a reference to an array of tracks when called in list context or scalar context, respectively. The tracks are returned as WebService::Audioscrobbler::Track objects by default.

Retrieves the tags related to the current resource as available on Audioscrobbler's database.

Returns either a list of tags or a reference to an array of tags when called in list context or scalar context, respectively. The tags are returned as WebService::Audioscrobbler::Tag objects by default.

Retrieves the artists related to the current resource as available on Audioscrobbler's database.

Returns either a list of artists or a reference to an array of artists when called in list context or scalar context, respectively. The tags are returned as WebService::Audioscrobbler::Artist objects by default.

This method retrieves arbitrary data from this resource using the specified $postfix. This is accomplished by calling the fetch method of this object's data fetcher object (usually an instance of WebService::Audioscrobbler::DataFetcher).

This method must be overriden by classes which inherit from Base. It should return the relative resource URL which will be used for fetching it from Audioscrobbler.

Helps classes which inherit from WebService::Audioscrobbler::Base to build URI objects. Mainly used for keeping resource_path code cleaner in those classes.

Shortcut for Carp::croak which can be called as a method.

Nilson Santos Figueiredo Júnior, <nilsonsfj at cpan.org>

Copyright 2006-2007 Nilson Santos Figueiredo Júnior, all rights reserved.

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