org.springframework.social.twitter.api
Interface ListOperations

public interface ListOperations

Interface defining the operations for working with a user's lists.

Method Summary

UserList	addToList(long listId, long... newMemberIds) Adds one or more new members to a user list.
UserList	addToList(long listId, java.lang.String... newMemberScreenNames) Adds one or more new members to a user list.
UserList	createList(java.lang.String name, java.lang.String description, boolean isPublic) Create a new user list
void	deleteList(long listId) Removes a user list.
UserList	getList(long listId) Retrieves a specific user list.
UserList	getList(java.lang.String screenName, java.lang.String listSlug) Retrieves a specific user list.
java.util.List<TwitterProfile>	getListMembers(long listId) Retrieves a list of Twitter profiles whose users are members of the list.
java.util.List<TwitterProfile>	getListMembers(java.lang.String screenName, java.lang.String listSlug) Retrieves a list of Twitter profiles whose users are members of the list.
java.util.List<UserList>	getLists() Retrieves user lists for the authenticated user.
java.util.List<UserList>	getLists(long userId) Retrieves user lists for a given user.
java.util.List<UserList>	getLists(java.lang.String screenName) Retrieves user lists for a given user.
java.util.List<Tweet>	getListStatuses(long listId) Retrieves the timeline tweets for the given user list.
java.util.List<Tweet>	getListStatuses(java.lang.String screenName, java.lang.String listSlug) Retrieves the timeline tweets for the given user list.
java.util.List<TwitterProfile>	getListSubscribers(long userId, long listId) Retrieves the subscribers to a list.
java.util.List<TwitterProfile>	getListSubscribers(java.lang.String screenName, java.lang.String listSlug) Retrieves the subscribers to a list.
java.util.List<UserList>	getMemberships(long userId) Retrieves the lists that a given user is a member of.
java.util.List<UserList>	getMemberships(java.lang.String screenName) Retrieves the lists that a given user is a member of.
java.util.List<UserList>	getSubscriptions(long userId) Retrieves the lists that a given user is subscribed to.
java.util.List<UserList>	getSubscriptions(java.lang.String screenName) Retrieves the lists that a given user is subscribed to.
boolean	isMember(long listId, long memberId) Checks to see if a given user is a member of a given list.
boolean	isMember(java.lang.String screenName, java.lang.String listSlug, java.lang.String memberScreenName) Checks to see if a given user is a member of a given list.
boolean	isSubscriber(long listId, long subscriberId) Checks to see if a given user subscribes to a given list.
boolean	isSubscriber(java.lang.String screenName, java.lang.String listSlug, java.lang.String subscriberScreenName) Checks to see if a given user subscribes to a given list.
void	removeFromList(long listId, long memberId) Removes a member from a user list.
void	removeFromList(long listId, java.lang.String memberScreenName) Removes a member from a user list.
UserList	subscribe(long listId) Subscribes the authenticating user to a list.
UserList	subscribe(java.lang.String screenName, java.lang.String listSlug) Subscribes the authenticating user to a list.
UserList	unsubscribe(long listId) Unsubscribes the authenticating user from a list.
UserList	unsubscribe(java.lang.String screenName, java.lang.String listSlug) Unsubscribes the authenticating user from a list.
UserList	updateList(long listId, java.lang.String name, java.lang.String description, boolean isPublic) Updates an existing user list

Method Detail

getLists

java.util.List<UserList> getLists()

Retrieves user lists for the authenticated user.

Returns:

a list of UserLists for the specified user.

getLists

java.util.List<UserList> getLists(long userId)

Retrieves user lists for a given user.

Parameters:

userId - the ID of the Twitter user.

Returns:

a list of UserLists for the specified user.

getLists

java.util.List<UserList> getLists(java.lang.String screenName)

Retrieves user lists for a given user.

Parameters:

screenName - the screen name of the Twitter user.

Returns:

a list of UserLists for the specified user.

getList

UserList getList(long listId)

Retrieves a specific user list.

Parameters:

listId - the ID of the list to retrieve.

Returns:

the requested UserList

getList

UserList getList(java.lang.String screenName,
                 java.lang.String listSlug)

Retrieves a specific user list.

Parameters:

screenName - the screen name of the list owner.

listSlug - the lists's slug

Returns:

the requested UserList

getListStatuses

java.util.List<Tweet> getListStatuses(long listId)

Retrieves the timeline tweets for the given user list.

Parameters:

listId - the ID of the list to retrieve.

Returns:

a list of Tweet objects for the items in the user list timeline.

getListStatuses

java.util.List<Tweet> getListStatuses(java.lang.String screenName,
                                      java.lang.String listSlug)

Retrieves the timeline tweets for the given user list.

Parameters:

screenName - the screen name of the Twitter user.

listSlug - the list's slug.

Returns:

a list of Tweet objects for the items in the user list timeline.

createList

UserList createList(java.lang.String name,
                    java.lang.String description,
                    boolean isPublic)

Create a new user list

Parameters:

name - the name of the list.

description - the list description.

isPublic - if true, the list will be public; if false the list will be private.

Returns:

the newly created UserList

updateList

UserList updateList(long listId,
                    java.lang.String name,
                    java.lang.String description,
                    boolean isPublic)

Updates an existing user list

Parameters:

listId - the ID of the list

name - the new name of the list.

description - the new list description.

isPublic - if true, the list will be public; if false the list will be private.

Returns:

the newly created UserList

deleteList

void deleteList(long listId)

Removes a user list.

Parameters:

listId - the ID of the list to be removed.

getListMembers

java.util.List<TwitterProfile> getListMembers(long listId)

Retrieves a list of Twitter profiles whose users are members of the list.

Parameters:

listId - the ID of the list.

Returns:

a list of TwitterProfile

getListMembers

java.util.List<TwitterProfile> getListMembers(java.lang.String screenName,
                                              java.lang.String listSlug)

Retrieves a list of Twitter profiles whose users are members of the list.

Parameters:

screenName - the screen name of the list owner.

listSlug - the slug of the list.

Returns:

a list of TwitterProfile

addToList

UserList addToList(long listId,
                   long... newMemberIds)

Adds one or more new members to a user list.

Parameters:

listId - the ID of the list.

newMemberIds - one or more profile IDs of the Twitter profiles to add to the list.

Returns:

the UserList

addToList

UserList addToList(long listId,
                   java.lang.String... newMemberScreenNames)

Adds one or more new members to a user list.

Parameters:

listId - the ID of the list.

newMemberScreenNames - one or more profile IDs of the Twitter profiles to add to the list.

Returns:

the UserList

removeFromList

void removeFromList(long listId,
                    long memberId)

Removes a member from a user list.

Parameters:

listId - the ID of the list.

memberId - the ID of the member to be removed.

removeFromList

void removeFromList(long listId,
                    java.lang.String memberScreenName)

Removes a member from a user list.

Parameters:

listId - the ID of the list.

memberScreenName - the ID of the member to be removed.

subscribe

UserList subscribe(long listId)

Subscribes the authenticating user to a list.

Parameters:

listId - the ID of the list.

Returns:

the UserList

subscribe

UserList subscribe(java.lang.String screenName,
                   java.lang.String listSlug)

Subscribes the authenticating user to a list.

Parameters:

screenName - the screen name of the list owner.

listSlug - the slug of the list.

Returns:

the UserList

unsubscribe

UserList unsubscribe(long listId)

Unsubscribes the authenticating user from a list.

Parameters:

listId - the ID of the list.

Returns:

the UserList

unsubscribe

UserList unsubscribe(java.lang.String screenName,
                     java.lang.String listSlug)

Unsubscribes the authenticating user from a list.

Parameters:

screenName - the screen name of the list owner.

listSlug - the slug of the list.

Returns:

the UserList

getListSubscribers

java.util.List<TwitterProfile> getListSubscribers(long userId,
                                                  long listId)

Retrieves the subscribers to a list.

Parameters:

userId - the user ID of the list owner.

listId - the ID of the list.

Returns:

a list of TwitterProfiles for the list's subscribers.

getListSubscribers

java.util.List<TwitterProfile> getListSubscribers(java.lang.String screenName,
                                                  java.lang.String listSlug)

Retrieves the subscribers to a list.

Parameters:

screenName - the screen name of the list owner.

listSlug - the slug of the list.

Returns:

a list of TwitterProfiles for the list's subscribers.

getMemberships

java.util.List<UserList> getMemberships(long userId)

Retrieves the lists that a given user is a member of.

Parameters:

userId - the user ID

Returns:

a list of UserLists that the user is a member of.

getMemberships

java.util.List<UserList> getMemberships(java.lang.String screenName)

Retrieves the lists that a given user is a member of.

Parameters:

screenName - the user's screen name

Returns:

a list of UserLists that the user is a member of.

getSubscriptions

java.util.List<UserList> getSubscriptions(long userId)

Retrieves the lists that a given user is subscribed to.

Parameters:

userId - the user ID

Returns:

a list of UserLists that the user is subscribed to.

getSubscriptions

java.util.List<UserList> getSubscriptions(java.lang.String screenName)

Retrieves the lists that a given user is subscribed to.

Parameters:

screenName - the user's screen name

Returns:

a list of UserLists that the user is subscribed to.

isMember

boolean isMember(long listId,
                 long memberId)

Checks to see if a given user is a member of a given list.

Parameters:

listId - the list ID

memberId - the user ID to check for membership

Returns:

true if the user is a member of the list

isMember

boolean isMember(java.lang.String screenName,
                 java.lang.String listSlug,
                 java.lang.String memberScreenName)

Checks to see if a given user is a member of a given list.

Parameters:

screenName - the screen name of the list's owner

listSlug - the list's slug

memberScreenName - the screenName to check for membership

Returns:

true if the user is a member of the list

isSubscriber

boolean isSubscriber(long listId,
                     long subscriberId)

Checks to see if a given user subscribes to a given list.

Parameters:

listId - the list ID

subscriberId - the user ID to check for subscribership

Returns:

true if the user is a member of the list

isSubscriber

boolean isSubscriber(java.lang.String screenName,
                     java.lang.String listSlug,
                     java.lang.String subscriberScreenName)

Checks to see if a given user subscribes to a given list.

Parameters:

screenName - the screen name of the list's owner

listSlug - the list's slug

subscriberScreenName - the screenName to check for subscribership

Returns:

true if the user is a member of the list