net.roarsoftware.lastfm
Class Event

java.lang.Object
  net.roarsoftware.lastfm.ImageHolder
      net.roarsoftware.lastfm.Event

public class Event
extends ImageHolder

Bean for Events.

Author:

Janni Kovacs

Nested Class Summary

static class	Event.AttendanceStatus Enumeration for the attendance status parameter of the attend operation.
static class	Event.TicketSupplier

Field Summary

Fields inherited from class net.roarsoftware.lastfm.ImageHolder

imageUrls

Method Summary

static Result	attend(java.lang.String eventId, Event.AttendanceStatus status, Session session) Set a user's attendance status for an event.
java.util.Collection<java.lang.String>	getArtists()
int	getAttendance()
static java.util.Collection<User>	getAttendees(java.lang.String eventId, java.lang.String apiKey) Get a list of attendees for an event.
java.lang.String	getDescription()
java.lang.String	getHeadliner()
int	getId()
static Event	getInfo(java.lang.String eventId, java.lang.String apiKey) Get the metadata for an event on Last.fm.
int	getReviews()
java.util.Date	getStartDate()
java.util.Collection<Event.TicketSupplier>	getTicketSuppliers()
java.lang.String	getTitle()
java.lang.String	getUrl() Returns the last.fm event url, i.e.
Venue	getVenue()
java.lang.String	getWebsite() Returns the event website url, if available.
static Result	share(java.lang.String eventId, java.lang.String recipients, java.lang.String message, Session session) Share an event with one or more Last.fm users or other friends.

Methods inherited from class net.roarsoftware.lastfm.ImageHolder

availableSizes, getImageURL, loadImages

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getArtists

public java.util.Collection<java.lang.String> getArtists()

getAttendance

public int getAttendance()

getDescription

public java.lang.String getDescription()

getHeadliner

public java.lang.String getHeadliner()

getId

public int getId()

getReviews

public int getReviews()

getStartDate

public java.util.Date getStartDate()

getTitle

public java.lang.String getTitle()

getUrl

public java.lang.String getUrl()

Returns the last.fm event url, i.e. http://www.last.fm/event/event-id

Returns:

last.fm url

getWebsite

public java.lang.String getWebsite()

Returns the event website url, if available.

Returns:

event website url

getTicketSuppliers

public java.util.Collection<Event.TicketSupplier> getTicketSuppliers()

getVenue

public Venue getVenue()

getInfo

public static Event getInfo(java.lang.String eventId,
                            java.lang.String apiKey)

Get the metadata for an event on Last.fm. Includes attendance and lineup information.

Parameters:

eventId - The numeric last.fm event id

apiKey - A Last.fm API key.

Returns:

Event metadata

attend

public static Result attend(java.lang.String eventId,
                            Event.AttendanceStatus status,
                            Session session)

Set a user's attendance status for an event.

Parameters:

eventId - The numeric last.fm event id

status - The attendance status

session - A Session instance

Returns:

the Result of the operation.

See Also:

Event.AttendanceStatus, Authenticator

share

public static Result share(java.lang.String eventId,
                           java.lang.String recipients,
                           java.lang.String message,
                           Session session)

Share an event with one or more Last.fm users or other friends.

Parameters:

eventId - An event ID

recipients - A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.

message - An optional message to send with the recommendation.

session - A Session instance

Returns:

the Result of the operation

getAttendees

public static java.util.Collection<User> getAttendees(java.lang.String eventId,
                                                      java.lang.String apiKey)

Get a list of attendees for an event.

Parameters:

eventId - The numeric last.fm event id

apiKey - A Last.fm API key

Returns:

a list of users who attended the given event