facebook4j.api
Interface LinkMethods

All Known Subinterfaces:
Facebook
All Known Implementing Classes:
FacebookImpl

public interface LinkMethods


Method Summary
 java.lang.String commentLink(java.lang.String linkId, java.lang.String message)
          Comments on the link.
 Link getLink(java.lang.String linkId)
          Returns the link shared on a user's wall.
 Link getLink(java.lang.String linkId, Reading reading)
          Returns the link shared on a user's wall.
 ResponseList<Comment> getLinkComments(java.lang.String linkId)
          Returns all of the comments on a link.
 ResponseList<Comment> getLinkComments(java.lang.String linkId, Reading reading)
          Returns all of the comments on a link.
 ResponseList<Like> getLinkLikes(java.lang.String linkId)
          Returns the likes on a link.
 ResponseList<Like> getLinkLikes(java.lang.String linkId, Reading reading)
          Returns the likes on a link.
 ResponseList<Link> getLinks()
          Returns the current user's/page's/event's posted links.
 ResponseList<Link> getLinks(Reading reading)
          Returns the current user's/page's/event's posted links.
 ResponseList<Link> getLinks(java.lang.String id)
          Returns a user's/page's/event's posted links.
 ResponseList<Link> getLinks(java.lang.String id, Reading reading)
          Returns a user's/page's/event's posted links.
 boolean likeLink(java.lang.String linkId)
          Likes the link.
 boolean unlikeLink(java.lang.String linkId)
          Unlikes the link.
 

Method Detail

getLinks

ResponseList<Link> getLinks()
                            throws FacebookException
Returns the current user's/page's/event's posted links.

Returns:
links
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
User#links - Facebook Developers

getLinks

ResponseList<Link> getLinks(Reading reading)
                            throws FacebookException
Returns the current user's/page's/event's posted links.

Parameters:
reading - optional reading parameters. see Graph API#reading - Facebook Developers
Returns:
links
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
User#links - Facebook Developers

getLinks

ResponseList<Link> getLinks(java.lang.String id)
                            throws FacebookException
Returns a user's/page's/event's posted links.

Parameters:
id - the ID of a user/page/event
Returns:
links
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
User#links - Facebook Developers

getLinks

ResponseList<Link> getLinks(java.lang.String id,
                            Reading reading)
                            throws FacebookException
Returns a user's/page's/event's posted links.

Parameters:
id - the ID of a user/page/event
reading - optional reading parameters. see Graph API#reading - Facebook Developers
Returns:
links
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
User#links - Facebook Developers

getLink

Link getLink(java.lang.String linkId)
             throws FacebookException
Returns the link shared on a user's wall.

Parameters:
linkId - the ID of the link
Returns:
link
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link - Facebook Developers

getLink

Link getLink(java.lang.String linkId,
             Reading reading)
             throws FacebookException
Returns the link shared on a user's wall.

Parameters:
linkId - the ID of the link
reading - optional reading parameters. see Graph API#reading - Facebook Developers
Returns:
link
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link - Facebook Developers

getLinkComments

ResponseList<Comment> getLinkComments(java.lang.String linkId)
                                      throws FacebookException
Returns all of the comments on a link.

Parameters:
linkId - the ID of a link
Returns:
comments
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#comments - Facebook Developers

getLinkComments

ResponseList<Comment> getLinkComments(java.lang.String linkId,
                                      Reading reading)
                                      throws FacebookException
Returns all of the comments on a link.

Parameters:
linkId - the ID of a link
reading - optional reading parameters. see Graph API#reading - Facebook Developers
Returns:
comments
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#comments - Facebook Developers

commentLink

java.lang.String commentLink(java.lang.String linkId,
                             java.lang.String message)
                             throws FacebookException
Comments on the link.

Parameters:
linkId - the ID of the link
message - comment text
Returns:
The new comment ID
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#comments - Facebook Developers

getLinkLikes

ResponseList<Like> getLinkLikes(java.lang.String linkId)
                                throws FacebookException
Returns the likes on a link.

Parameters:
linkId - the ID of a link
Returns:
likes
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#likes - Facebook Developers

getLinkLikes

ResponseList<Like> getLinkLikes(java.lang.String linkId,
                                Reading reading)
                                throws FacebookException
Returns the likes on a link.

Parameters:
linkId - the ID of a link
reading - optional reading parameters. see Graph API#reading - Facebook Developers see Graph API#reading - Facebook Developers
Returns:
likes
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#likes - Facebook Developers

likeLink

boolean likeLink(java.lang.String linkId)
                 throws FacebookException
Likes the link.

Parameters:
linkId - the ID of the link
Returns:
true if like is successful
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#likes - Facebook Developers

unlikeLink

boolean unlikeLink(java.lang.String linkId)
                   throws FacebookException
Unlikes the link.

Parameters:
linkId - the ID of the link
Returns:
true if unlike is successful
Throws:
FacebookException - when Facebook service or network is unavailable
See Also:
Link#likes - Facebook Developers