org.springframework.social.facebook.api
Interface EventOperations

public interface EventOperations

Defines operations for creating and reading event data as well as RSVP'ing to events on behalf of a user.

Method Summary

void	acceptInvitation(java.lang.String eventId) Accepts an invitation to an event.
java.lang.String	createEvent(java.lang.String name, java.lang.String startTime, java.lang.String endTime) Creates an event.
void	declineInvitation(java.lang.String eventId) Declines an invitation to an event.
void	deleteEvent(java.lang.String eventId) Deletes an event.
java.util.List<EventInvitee>	getAttending(java.lang.String eventId) Retrieves the list of an event's invitees who have accepted the invitation.
java.util.List<EventInvitee>	getDeclined(java.lang.String eventId) Retrieves the list of an event's invitees who have declined the invitation.
Event	getEvent(java.lang.String eventId) Retrieves event data for a specified event.
byte[]	getEventImage(java.lang.String eventId) Retrieves an event's image as an array of bytes.
byte[]	getEventImage(java.lang.String eventId, ImageType imageType) Retrieves an event's image as an array of bytes.
java.util.List<Invitation>	getInvitations() Retrieves a list of events that the authenticated user has been invited to.
java.util.List<Invitation>	getInvitations(java.lang.String userId) Retrieves a list of events that the specified user has been invited to.
java.util.List<EventInvitee>	getInvited(java.lang.String eventId) Retrieves the list of an event's invitees.
java.util.List<EventInvitee>	getMaybeAttending(java.lang.String eventId) Retrieves the list of an event's invitees who have indicated that they may attend the event.
java.util.List<EventInvitee>	getNoReplies(java.lang.String eventId) Retrieves the list of an event's invitees who have not yet RSVP'd.
void	maybeInvitation(java.lang.String eventId) RSVPs to an event with a maybe.

Method Detail

getInvitations

java.util.List<Invitation> getInvitations()

Retrieves a list of events that the authenticated user has been invited to. Requires "user_events" or "friends_events" permission.

Returns:

a list Invitations for the user, or an empty list if not available.

getInvitations

java.util.List<Invitation> getInvitations(java.lang.String userId)

Retrieves a list of events that the specified user has been invited to. Requires "user_events" or "friends_events" permission.

Parameters:

userId - the user's ID

Returns:

a list Invitations for the user, or an empty list if not available.

getEvent

Event getEvent(java.lang.String eventId)

Retrieves event data for a specified event.

Parameters:

eventId - the event ID

Returns:

an Event object

getEventImage

byte[] getEventImage(java.lang.String eventId)

Retrieves an event's image as an array of bytes. Returns the image in Facebook's "normal" type.

Parameters:

eventId - the event ID

Returns:

an array of bytes containing the event's image.

getEventImage

byte[] getEventImage(java.lang.String eventId,
                     ImageType imageType)

Retrieves an event's image as an array of bytes.

Parameters:

eventId - the event ID

imageType - the image type (eg., small, normal, large. square)

Returns:

an array of bytes containing the event's image.

createEvent

java.lang.String createEvent(java.lang.String name,
                             java.lang.String startTime,
                             java.lang.String endTime)

Creates an event. The String passed in for start time and end time is flexible in regard to format. Some valid examples are:

• 2011-04-01T15:30:00 (3:30PM on April 1, 2011)
• 2011-04-01 (midnight on April 1, 2011)
• April 1, 2011 (midnight on April 1, 2011)
• 17:00:00 (5:00PM today)
• 10-11-2011 (November 10, 2012)
• 10/11/2012 (October 11, 2012)
• 10.11.2012 (November 10, 2012)
• Tomorrow 2PM

Parameters:

name - the name of the event

startTime - the start time of the event.

endTime - the end time of the event.

Returns:

the newly created event's ID

deleteEvent

void deleteEvent(java.lang.String eventId)

Deletes an event.

Parameters:

eventId - the ID of the event

getInvited

java.util.List<EventInvitee> getInvited(java.lang.String eventId)

Retrieves the list of an event's invitees.

Parameters:

eventId - the event ID.

Returns:

a list of EventInvitees for the event.

getAttending

java.util.List<EventInvitee> getAttending(java.lang.String eventId)

Retrieves the list of an event's invitees who have accepted the invitation.

Parameters:

eventId - the event ID.

Returns:

a list of EventInvitees for the event.

getMaybeAttending

java.util.List<EventInvitee> getMaybeAttending(java.lang.String eventId)

Retrieves the list of an event's invitees who have indicated that they may attend the event.

Parameters:

eventId - the event ID.

Returns:

a list of EventInvitees for the event.

getNoReplies

java.util.List<EventInvitee> getNoReplies(java.lang.String eventId)

Retrieves the list of an event's invitees who have not yet RSVP'd.

Parameters:

eventId - the event ID.

Returns:

a list of EventInvitees for the event.

getDeclined

java.util.List<EventInvitee> getDeclined(java.lang.String eventId)

Retrieves the list of an event's invitees who have declined the invitation.

Parameters:

eventId - the event ID.

Returns:

a list of EventInvitees for the event.

acceptInvitation

void acceptInvitation(java.lang.String eventId)

Accepts an invitation to an event. Requires "rsvp_event" permission.

Parameters:

eventId - the event ID

maybeInvitation

void maybeInvitation(java.lang.String eventId)

RSVPs to an event with a maybe. Requires "rsvp_event" permission.

Parameters:

eventId - the event ID

declineInvitation

void declineInvitation(java.lang.String eventId)

Declines an invitation to an event. Requires "rsvp_event" permission.

Parameters:

eventId - the event ID