FeedOperations (Spring Social Facebook 2.0.3.RELEASE API)

```
public interface FeedOperations
```
Interface defining operations that can be performed on a Facebook feed.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`deletePost(String id)` Deletes a post.
`Post`	`getCheckin(String checkinId)` Retrieves details for a single checkin.
`PagedList<Post>`	`getCheckins()` Retrieves a list of up to 25 recent checkins for the authenticated user.
`PagedList<Post>`	`getCheckins(PagingParameters pagedListParameters)` Retrieves a list of checkins for the authenticated user.
`PagedList<Post>`	`getFeed()` Retrieves recent posts for the authenticated user.
`PagedList<Post>`	`getFeed(PagingParameters pagedListParameters)` Retrieves recent posts for the authenticated user.
`PagedList<Post>`	`getFeed(String ownerId)` Retrieves recent feed entries for a given user.
`PagedList<Post>`	`getFeed(String ownerId, PagingParameters pagedListParameters)` Retrieves recent feed entries for a given user.
`PagedList<Post>`	`getHomeFeed()` Retrieves the user's home feed.
`PagedList<Post>`	`getHomeFeed(PagingParameters pagedListParameters)` Retrieves the user's home feed.
`PagedList<Post>`	`getLinks()` Retrieves the link entries from the authenticated user's feed.
`PagedList<Post>`	`getLinks(PagingParameters pagedListParameters)` Retrieves the link entries from the authenticated user's feed.
`PagedList<Post>`	`getLinks(String ownerId)` Retrieves the link entries from the specified owner's feed.
`PagedList<Post>`	`getLinks(String ownerId, PagingParameters pagedListParameters)` Retrieves the link entries from the specified owner's feed.
`Post`	`getPost(String entryId)` Retrieves a single post.
`PagedList<Post>`	`getPosts()` Retrieves the post entries from the authenticated user's feed.
`PagedList<Post>`	`getPosts(PagingParameters pagedListParameters)` Retrieves the post entries from the authenticated user's feed.
`PagedList<Post>`	`getPosts(String ownerId)` Retrieves the post entries from the specified owner's feed.
`PagedList<Post>`	`getPosts(String ownerId, PagingParameters pagedListParameters)` Retrieves the post entries from the specified owner's feed.
`PagedList<Post>`	`getStatuses()` Retrieves the status entries from the authenticated user's feed.
`PagedList<Post>`	`getStatuses(PagingParameters pagedListParameters)` Retrieves the status entries from the authenticated user's feed.
`PagedList<Post>`	`getStatuses(String userId)` Retrieves the status entries from the specified user's feed.
`PagedList<Post>`	`getStatuses(String userId, PagingParameters pagedListParameters)` Retrieves the status entries from the specified user's feed.
`PagedList<Post>`	`getTagged()` Retrieves the post entries that the authenticated user was tagged in.
`PagedList<Post>`	`getTagged(PagingParameters pagedListParameters)` Retrieves the post entries that the authenticated user was tagged in.
`PagedList<Post>`	`getTagged(String ownerId)` Retrieves the post entries that the specified user was tagged in.
`PagedList<Post>`	`getTagged(String ownerId, PagingParameters pagedListParameters)` Retrieves the post entries that the specified user was tagged in.
`String`	`post(PostData post)` Adds a Post to a feed.
`String`	`post(String ownerId, String message)` Posts a message to a feed.
`String`	`postLink(String message, FacebookLink link)` Posts a link to the authenticated user's feed.
`String`	`postLink(String ownerId, String message, FacebookLink link)` Posts a link to a feed.
`String`	`updateStatus(String message)` Posts a status update to the authenticated user's feed.

- Method Detail
  - getFeed
```
PagedList<Post> getFeed()
```
    Retrieves recent posts for the authenticated user. Requires "read_stream" permission to read non-public posts. Returns up to the most recent 25 posts.
    
    Returns:
    a list of Posts for the authenticated user.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getFeed
```
PagedList<Post> getFeed(PagingParameters pagedListParameters)
```
    Retrieves recent posts for the authenticated user. Requires "read_stream" permission to read non-public posts.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of Posts for the authenticated user.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getFeed
```
PagedList<Post> getFeed(String ownerId)
```
    Retrieves recent feed entries for a given user. Returns up to the most recent 25 posts. Requires "read_stream" permission to read non-public posts.
    
    Parameters:
    ownerId - the Facebook ID or alias for the owner (user, group, event, page, etc) of the feed.
    
    Returns:
    a list of Posts for the specified user.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getFeed
```
PagedList<Post> getFeed(String ownerId,
                      PagingParameters pagedListParameters)
```
    Retrieves recent feed entries for a given user. Requires "read_stream" permission to read non-public posts. Returns up to the most recent 25 posts.
    
    Parameters:
    ownerId - the Facebook ID or alias for the owner (user, group, event, page, etc) of the feed.
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of Posts for the specified user.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getHomeFeed
```
PagedList<Post> getHomeFeed()
```
    Retrieves the user's home feed. This includes entries from the user's friends. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Returns:
    a list of Posts from the authenticated user's home feed.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getHomeFeed
```
PagedList<Post> getHomeFeed(PagingParameters pagedListParameters)
```
    Retrieves the user's home feed. This includes entries from the user's friends. Requires "read_stream" permission.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of Posts from the authenticated user's home feed.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getPost
```
Post getPost(String entryId)
```
    Retrieves a single post.
    
    Parameters:
    entryId - the entry ID
    
    Returns:
    the requested Post
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
  - getStatuses
```
PagedList<Post> getStatuses()
```
    Retrieves the status entries from the authenticated user's feed. Returns up to the most recent 25 posts.
    
    Returns:
    a list of status Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getStatuses
```
PagedList<Post> getStatuses(PagingParameters pagedListParameters)
```
    Retrieves the status entries from the authenticated user's feed.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of status Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getStatuses
```
PagedList<Post> getStatuses(String userId)
```
    Retrieves the status entries from the specified user's feed. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Parameters:
    userId - the user's ID
    
    Returns:
    a list of status Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getStatuses
```
PagedList<Post> getStatuses(String userId,
                          PagingParameters pagedListParameters)
```
    Retrieves the status entries from the specified user's feed. Requires "read_stream" permission.
    
    Parameters:
    userId - the user's ID
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of status Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getLinks
```
PagedList<Post> getLinks()
```
    Retrieves the link entries from the authenticated user's feed. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Returns:
    a list of link Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getLinks
```
PagedList<Post> getLinks(PagingParameters pagedListParameters)
```
    Retrieves the link entries from the authenticated user's feed. Requires "read_stream" permission.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of link Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getLinks
```
PagedList<Post> getLinks(String ownerId)
```
    Retrieves the link entries from the specified owner's feed. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Parameters:
    ownerId - the owner of the feed (could be a user, page, event, etc)
    
    Returns:
    a list of link Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getLinks
```
PagedList<Post> getLinks(String ownerId,
                       PagingParameters pagedListParameters)
```
    Retrieves the link entries from the specified owner's feed. Requires "read_stream" permission.
    
    Parameters:
    ownerId - the owner of the feed (could be a user, page, event, etc)
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of link Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getPosts
```
PagedList<Post> getPosts()
```
    Retrieves the post entries from the authenticated user's feed. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getPosts
```
PagedList<Post> getPosts(PagingParameters pagedListParameters)
```
    Retrieves the post entries from the authenticated user's feed. Requires "read_stream" permission.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getPosts
```
PagedList<Post> getPosts(String ownerId)
```
    Retrieves the post entries from the specified owner's feed. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Parameters:
    ownerId - the owner of the feed (could be a user, page, event, etc)
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getPosts
```
PagedList<Post> getPosts(String ownerId,
                       PagingParameters pagedListParameters)
```
    Retrieves the post entries from the specified owner's feed. Requires "read_stream" permission.
    
    Parameters:
    ownerId - the owner of the feed (could be a user, page, event, etc)
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getTagged
```
PagedList<Post> getTagged()
```
    Retrieves the post entries that the authenticated user was tagged in. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getTagged
```
PagedList<Post> getTagged(PagingParameters pagedListParameters)
```
    Retrieves the post entries that the authenticated user was tagged in. Requires "read_stream" permission.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getTagged
```
PagedList<Post> getTagged(String ownerId)
```
    Retrieves the post entries that the specified user was tagged in. Returns up to the most recent 25 posts. Requires "read_stream" permission.
    
    Parameters:
    ownerId - the owner of the feed (could be a user, page, event, etc)
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getTagged
```
PagedList<Post> getTagged(String ownerId,
                        PagingParameters pagedListParameters)
```
    Retrieves the post entries that the specified user was tagged in. Requires "read_stream" permission.
    
    Parameters:
    ownerId - the owner of the feed (could be a user, page, event, etc)
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list of post Posts.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "read_stream" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - updateStatus
```
String updateStatus(String message)
```
    Posts a status update to the authenticated user's feed. Requires "publish_actions" permission.
    
    Parameters:
    message - the message to post.
    
    Returns:
    the ID of the new feed entry.
    
    Throws:
    
    org.springframework.social.DuplicateStatusException - if the status message duplicates a previously posted status.
    
    org.springframework.social.RateLimitExceededException - if the per-user/per-app rate limit is exceeded.
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "publish_actions" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - postLink
```
String postLink(String message,
              FacebookLink link)
```
    Posts a link to the authenticated user's feed. Requires "publish_actions" permission.
    
    Parameters:
    message - a message to send with the link.
    link - the FacebookLink object to post
    
    Returns:
    the ID of the new feed entry.
    
    Throws:
    
    org.springframework.social.DuplicateStatusException - if the post duplicates a previous post.
    
    org.springframework.social.RateLimitExceededException - if the per-user/per-app rate limit is exceeded.
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "publish_actions" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - post
```
String post(String ownerId,
          String message)
```
    Posts a message to a feed. Requires "publish_actions" permission.
    
    Parameters:
    ownerId - the feed owner ID. Could be a user ID or a page ID.
    message - the message to post.
    
    Returns:
    the id of the new feed entry.
    
    Throws:
    
    org.springframework.social.DuplicateStatusException - if the post duplicates a previous post.
    
    org.springframework.social.RateLimitExceededException - if the per-user/per-app rate limit is exceeded.
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "publish_actions" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - post
```
String post(PostData post)
```
    Adds a Post to a feed.
    
    Parameters:
    post - the new post
    
    Returns:
    the id of the new feed entry.
    
    Throws:
    
    org.springframework.social.DuplicateStatusException - if the post duplicates a previous post.
    
    org.springframework.social.RateLimitExceededException - if the per-user/per-app rate limit is exceeded.
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "publish_actions" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - postLink
```
String postLink(String ownerId,
              String message,
              FacebookLink link)
```
    Posts a link to a feed. Requires "publish_actions" permission.
    
    Parameters:
    ownerId - the feed owner ID. Could be a user ID or a page ID.
    message - a message to send with the link.
    link - the FacebookLink object to post
    
    Returns:
    the ID of the new feed entry.
    
    Throws:
    
    org.springframework.social.DuplicateStatusException - if the post duplicates a previous post.
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "publish_actions" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - deletePost
```
void deletePost(String id)
```
    Deletes a post. Requires "publish_actions" permission and the post must have been created by the same application.
    
    Parameters:
    id - the feed entry ID
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "publish_actions" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getCheckins
```
PagedList<Post> getCheckins()
```
    Retrieves a list of up to 25 recent checkins for the authenticated user. Requires "read_stream" or "user_posts" permission.
    
    Returns:
    a list Posts for the user, or an empty list if not available.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "user_checkins" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getCheckins
```
PagedList<Post> getCheckins(PagingParameters pagedListParameters)
```
    Retrieves a list of checkins for the authenticated user. Requires "read_stream" or "user_posts" permission.
    
    Parameters:
    pagedListParameters - the parameters defining the bounds of the list to return.
    
    Returns:
    a list Posts for the user, or an empty list if not available.
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.InsufficientPermissionException - if the user has not granted "user_checkins" permission.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.
  - getCheckin
```
Post getCheckin(String checkinId)
```
    Retrieves details for a single checkin.
    
    Parameters:
    checkinId - the checkin ID
    
    Returns:
    a Post
    
    Throws:
    
    org.springframework.social.ApiException - if there is an error while communicating with Facebook.
    
    org.springframework.social.MissingAuthorizationException - if FacebookTemplate was not created with an access token.

Interface FeedOperations

Method Summary

Method Detail

getFeed

getFeed

getFeed

getFeed

getHomeFeed

getHomeFeed

getPost

getStatuses

getStatuses

getStatuses

getStatuses

getLinks

getLinks

getLinks

getLinks

getPosts

getPosts

getPosts

getPosts

getTagged

getTagged

getTagged

getTagged

updateStatus

postLink

post

post

postLink

deletePost

getCheckins

getCheckins

getCheckin