org.agorava.twitter

Interface TwitterBlockService

public interface TwitterBlockService

Interface defining the operations for blocking and unblocking users

Author:

Craig Walls, Antoine Sabot-Durand

Method Summary

Methods

Modifier and Type	Method and Description
TwitterProfile	block(long userId) Blocks a user.
TwitterProfile	block(String screenName) Blocks a user.
List<Long>	getBlockedUserIds() Retrieves a list of user IDs for the users that the authenticating user has blocked.
List<TwitterProfile>	getBlockedUsers() Retrieves a list of users that the authenticating user has blocked.
List<TwitterProfile>	getBlockedUsers(int page, int pageSize) Retrieves a list of users that the authenticating user has blocked.
boolean	isBlocking(long userId) Determines if the user has blocked a specific user.
boolean	isBlocking(String screenName) Determines if the user has blocked a specific user.
TwitterProfile	unblock(long userId) Unblocks a user.
TwitterProfile	unblock(String screenName) Unblocks a user.

Method Detail

block

TwitterProfile block(long userId)

Blocks a user. If a friendship exists with the user, it will be destroyed.

Parameters:

userId - the ID of the user to block.

Returns:

The TwitterProfile of the blocked user.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

block

TwitterProfile block(String screenName)

Blocks a user. If a friendship exists with the user, it will be destroyed.

Parameters:

screenName - the screen name of the user to block.

Returns:

The TwitterProfile of the blocked user.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

unblock

TwitterProfile unblock(long userId)

Unblocks a user.

Parameters:

userId - the ID of the user to unblock.

Returns:

The TwitterProfile of the unblocked user.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

unblock

TwitterProfile unblock(String screenName)

Unblocks a user.

Parameters:

screenName - the screen name of the user to unblock.

Returns:

The TwitterProfile of the unblocked user.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

getBlockedUsers

List<TwitterProfile> getBlockedUsers()

Retrieves a list of users that the authenticating user has blocked.

Returns:

a list of TwitterProfiles for the users that are blocked.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

getBlockedUsers

List<TwitterProfile> getBlockedUsers(int page,
                                   int pageSize)

Retrieves a list of users that the authenticating user has blocked.

Parameters:

page - the page of blocked users to return

pageSize - the number of users per page

Returns:

a list of TwitterProfiles for the users that are blocked.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

getBlockedUserIds

List<Long> getBlockedUserIds()

Retrieves a list of user IDs for the users that the authenticating user has blocked.

Returns:

a list of user IDs for the users that are blocked.

Throws:

ApiException - if there is an error while communicating with Twitter.

MissingAuthorizationException - if TwitterTemplate was not created with OAuth credentials.

isBlocking

boolean isBlocking(long userId)

Determines if the user has blocked a specific user.

Parameters:

userId - the ID of the user to check for a block.

Returns:

true if the user is blocked; false otherwise

Throws:

ApiException - if there is an error while communicating with Twitter.

isBlocking

boolean isBlocking(String screenName)

Determines if the user has blocked a specific user.

Parameters:

screenName - the screen name of the user to check for a block.

Returns:

true if the user is blocked; false otherwise

Throws:

ApiException - if there is an error while communicating with Twitter.