twitter4j.api
Interface StatusMethods

All Known Implementing Classes:

Twitter

public interface StatusMethods

Author:

Joern Huxhorn - jhuxhorn at googlemail.com

Method Summary

Status	destroyStatus(long statusId) Destroys the status specified by the required ID parameter.
ResponseList<Status>	getRetweets(long statusId) Returns up to 100 of the first retweets of a given tweet.
Status	retweetStatus(long statusId) Retweets a tweet.
Status	showStatus(long id) Returns a single status, specified by the id parameter.
Status	updateStatus(StatusUpdate latestStatus) Updates the user's status.
Status	updateStatus(java.lang.String status) Updates the user's status.
Status	updateStatus(java.lang.String status, GeoLocation location) Deprecated. use updateStatus(StatusUpdate latestStatus) instead.
Status	updateStatus(java.lang.String status, long inReplyToStatusId) Deprecated. use updateStatus(StatusUpdate latestStatus) instead.
Status	updateStatus(java.lang.String status, long inReplyToStatusId, GeoLocation location) Deprecated. use updateStatus(StatusUpdate latestStatus) instead.

Method Detail

showStatus

Status showStatus(long id)
                  throws TwitterException

Returns a single status, specified by the id parameter. The status's author will be returned inline.
This method calls http://api.twitter.com/1/statuses/show

Parameters:

id - the numerical ID of the status you're trying to retrieve

Returns:

a single status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

Twitter API Wiki / Twitter REST API Method: statuses show

updateStatus

Status updateStatus(java.lang.String status)
                    throws TwitterException

Updates the user's status.
Statuses over 140 characters will be forcibly truncated.
This method calls http://api.twitter.com/1/statuses/update

Parameters:

status - the text of your status update

Returns:

the latest status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

Twitter API Wiki / Twitter REST API Method: statuses update

updateStatus

Status updateStatus(java.lang.String status,
                    GeoLocation location)
                    throws TwitterException

Deprecated. use updateStatus(StatusUpdate latestStatus) instead.

Updates the user's status.
Statuses over 140 characters will be forcibly truncated.
This method calls http://api.twitter.com/1/statuses/update

Parameters:

status - the text of your status update

location - The location that this tweet refers to.

Returns:

the latest status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.10

See Also:

Twitter API Wiki / Twitter REST API Method: statuses update

updateStatus

Status updateStatus(java.lang.String status,
                    long inReplyToStatusId)
                    throws TwitterException

Deprecated. use updateStatus(StatusUpdate latestStatus) instead.

Updates the user's status.
Statuses over 140 characters will be forcibly truncated.
This method calls http://api.twitter.com/1/statuses/update

Parameters:

status - the text of your status update

inReplyToStatusId - The ID of an existing status that the status to be posted is in reply to. This implicitly sets the in_reply_to_user_id attribute of the resulting status to the user ID of the message being replied to. Invalid/missing status IDs will be ignored.

Returns:

the latest status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.1

See Also:

Twitter API Wiki / Twitter REST API Method: statuses update

updateStatus

Status updateStatus(java.lang.String status,
                    long inReplyToStatusId,
                    GeoLocation location)
                    throws TwitterException

Deprecated. use updateStatus(StatusUpdate latestStatus) instead.

Updates the user's status.
Statuses over 140 characters will be forcibly truncated.
This method calls http://api.twitter.com/1/statuses/update

Parameters:

status - the text of your status update

inReplyToStatusId - The ID of an existing status that the status to be posted is in reply to. This implicitly sets the in_reply_to_user_id attribute of the resulting status to the user ID of the message being replied to. Invalid/missing status IDs will be ignored.

location - The location that this tweet refers to.

Returns:

the latest status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.10

See Also:

Twitter API Wiki / Twitter REST API Method: statuses update

updateStatus

Status updateStatus(StatusUpdate latestStatus)
                    throws TwitterException

Updates the user's status.
Statuses over 140 characters will be forcibly truncated.
This method calls http://api.twitter.com/1/statuses/update

Parameters:

latestStatus - the latest status to be updated.

Returns:

the latest status

Throws:

TwitterException

Since:

Twitter4J 2.1.1

destroyStatus

Status destroyStatus(long statusId)
                     throws TwitterException

Destroys the status specified by the required ID parameter. The authenticating user must be the author of the specified status.
This method calls http://api.twitter.com/1/statuses/destroy

Parameters:

statusId - The ID of the status to destroy.

Returns:

the deleted status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

1.0.5

See Also:

Twitter API Wiki / Twitter REST API Method: statuses destroy

retweetStatus

Status retweetStatus(long statusId)
                     throws TwitterException

Retweets a tweet. Requires the id parameter of the tweet you are retweeting. Returns the original tweet with retweet details embedded.
This method calls http://api.twitter.com/1/statuses/retweet

Parameters:

statusId - The ID of the status to retweet.

Returns:

the retweeted status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.10

See Also:

Twitter API Wiki / Twitter REST API Method: statuses retweet

getRetweets

ResponseList<Status> getRetweets(long statusId)
                                 throws TwitterException

Returns up to 100 of the first retweets of a given tweet.
This method calls http://api.twitter.com/1/statuses/retweets

Parameters:

statusId - The numerical ID of the tweet you want the retweets of.

Returns:

the retweets of a given tweet

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.10

See Also:

Twitter API Wiki / Twitter REST API Method: statuses retweets