WebService::Audioscrobbler::Base(3p)

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

SYNOPSIS
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');

METHODS

  "tracks"
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.

  "tags"
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.

  "artists"
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.

  fetch_data($postfix)
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).

  "resource_path"
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.

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

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

AUTHOR
Nilson Santos Figueiredo Junior, "<nilsonsfj at cpan.org>"

COPYRIGHT & LICENSE
Copyright 2006-2007 Nilson Santos Figueiredo Junior, all rights reserved.

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