de.umass.lastfm
Class Event

java.lang.Object
  extended byde.umass.lastfm.ImageHolder
      extended byde.umass.lastfm.Event

public class Event
extends ImageHolder

Bean for Events.

Author:
Janni Kovacs

Nested Class Summary
static class Event.TicketSupplier
           
 
Field Summary
static int AttendanceStatus_ATTENDING
          Enumeration for the attendance status parameter of the attend operation.
static int AttendanceStatus_MAYBE_ATTENDING
           
static int AttendanceStatus_NOT_ATTENDING
           
 
Fields inherited from class de.umass.lastfm.ImageHolder
imageUrls
 
Method Summary
static Result attend(String eventId, int status, Session session)
          Set a user's attendance status for an event.
 Collection getArtists()
           
 int getAttendance()
           
static Collection getAttendees(String eventId, String apiKey)
          Get a list of attendees for an event.
 String getDescription()
           
 Date getEndDate()
          Returns the event's end date, or null if not available.
 String getHeadliner()
           
 int getId()
           
static Event getInfo(String eventId, String apiKey)
          Get the metadata for an event on Last.fm.
 int getReviews()
           
static PaginatedResult getShouts(String eventId, int page, int limit, String apiKey)
          Get shouts for an event.
static PaginatedResult getShouts(String eventId, int page, String apiKey)
          Get shouts for an event.
static PaginatedResult getShouts(String eventId, String apiKey)
          Get shouts for an event.
 Date getStartDate()
          Returns the start date and time of this event.
 Collection getTicketSuppliers()
           
 String getTitle()
           
 String getUrl()
          Returns the last.fm event url, i.e.
 Venue getVenue()
           
 String getWebsite()
          Returns the event website url, if available.
static Result share(String eventId, String recipients, String message, Session session)
          Share an event with one or more Last.fm users or other friends.
 
Methods inherited from class de.umass.lastfm.ImageHolder
availableSizes, getImageURL, loadImages
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

AttendanceStatus_ATTENDING

public static final int AttendanceStatus_ATTENDING
Enumeration for the attendance status parameter of the attend operation.

See Also:
Constant Field Values

AttendanceStatus_MAYBE_ATTENDING

public static final int AttendanceStatus_MAYBE_ATTENDING
See Also:
Constant Field Values

AttendanceStatus_NOT_ATTENDING

public static final int AttendanceStatus_NOT_ATTENDING
See Also:
Constant Field Values
Method Detail

getArtists

public Collection getArtists()

getAttendance

public int getAttendance()

getDescription

public String getDescription()

getHeadliner

public String getHeadliner()

getId

public int getId()

getReviews

public int getReviews()

getStartDate

public Date getStartDate()
Returns the start date and time of this event. Note that the time might not be correct, but instead a random time, if not set to a proper value on last.fm (happens often).

Returns:
start date

getEndDate

public Date getEndDate()
Returns the event's end date, or null if not available. End dates are only supplied for events such as festivals, which last longer than one day.

Returns:
end date

getTitle

public String getTitle()

getUrl

public String getUrl()
Returns the last.fm event url, i.e. http://www.last.fm/event/event-id

Returns:
last.fm url

getWebsite

public String getWebsite()
Returns the event website url, if available.

Returns:
event website url

getTicketSuppliers

public Collection getTicketSuppliers()

getVenue

public Venue getVenue()

getInfo

public static Event getInfo(String eventId,
                            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(String eventId,
                            int 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:
de.umass.lastfm.Event.AttendanceStatus, Authenticator

share

public static Result share(String eventId,
                           String recipients,
                           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 Collection getAttendees(String eventId,
                                      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

getShouts

public static PaginatedResult getShouts(String eventId,
                                        String apiKey)
Get shouts for an event.

Parameters:
eventId - The numeric last.fm event id
apiKey - A Last.fm API key.
Returns:
a page of Shouts

getShouts

public static PaginatedResult getShouts(String eventId,
                                        int page,
                                        String apiKey)
Get shouts for an event.

Parameters:
eventId - The numeric last.fm event id
page - The page number to fetch
apiKey - A Last.fm API key.
Returns:
a page of Shouts

getShouts

public static PaginatedResult getShouts(String eventId,
                                        int page,
                                        int limit,
                                        String apiKey)
Get shouts for an event.

Parameters:
eventId - The numeric last.fm event id
page - The page number to fetch
limit - An integer used to limit the number of shouts returned per page or -1 for default
apiKey - A Last.fm API key.
Returns:
a page of Shouts