twitter4j
Class TwitterStream

java.lang.Object
  twitter4j.TwitterStream

public class TwitterStream
extends java.lang.Object

A java reporesentation of the Twitter Streaming API

Since:

Twitter4J 2.0.4

Author:

Yusuke Yamamoto - yusuke at mac.com

Field Summary

protected HttpClient	http
protected java.lang.String	source

Constructor Summary

TwitterStream(java.lang.String userId, java.lang.String password)

TwitterStream(java.lang.String userId, java.lang.String password, StatusListener listener)

Method Summary

void	birddog(int count, int[] follow) Starts listening on public statuses from a specified set of users, by ID.
void	cleanup()
void	firehose(int count) Starts listening on all public statuses.
void	follow(int[] follow) See birddog above.
void	forceUsePost(boolean forceUsePost) Deprecated. some methods don't accept POST method anymore
void	gardenhose() Starts listening on a percentage of all public statuses, suitable for data mining and research applications that require a statistically significant sample.
StatusStream	getBirddogStream(int count, int[] follow) Returns a status stream for public statuses from a specified set of users, by ID.
java.lang.String	getClientURL()
java.lang.String	getClientVersion()
StatusStream	getFirehoseStream(int count) Returns a status stream for all public statuses.
StatusStream	getFollowStream(int[] follow) See birddog above.
StatusStream	getGardenhoseStream() Returns a status stream for a percentage of all public statuses, suitable for data mining and research applications that require a statistically significant sample.
java.lang.String	getPassword() Returns authenticating password
StatusStream	getShadowStream(int count, int[] follow) See birddog above.
java.lang.String	getSource() Returns the source
StatusStream	getSpritzerStream() Returns a status stream for a percentage of all public statuses, suitable for small projects that don't require a statistically significant sample.
StatusListener	getStatusListener()
StatusStream	getTrackStream(java.lang.String[] keywords)
java.lang.String	getUserAgent()
java.lang.String	getUserId() Returns authenticating userid
boolean	isUsePostForced()
void	setClientURL(java.lang.String clientURL) Sets the X-Twitter-Client-URL header.
void	setClientVersion(java.lang.String version) Sets the X-Twitter-Client-Version header.
void	setHttpConnectionTimeout(int connectionTimeout) Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the Twitter API.
void	setHttpProxy(java.lang.String proxyHost, int proxyPort) Enables use of HTTP proxy
void	setHttpProxyAuth(java.lang.String proxyUser, java.lang.String proxyPass) Adds authentication on HTTP proxy
void	setHttpReadTimeout(int readTimeoutMilliSecs) Sets the read timeout to a specified timeout, in milliseconds.
void	setPassword(java.lang.String password) Sets the password
void	setRequestHeader(java.lang.String name, java.lang.String value) Sets the request header name/value combination see Twitter Fan Wiki for detail.
void	setRetryCount(int retryCount)
void	setRetryIntervalSecs(int retryIntervalSecs)
void	setSource(java.lang.String source) Sets X-Twitter-Client http header and the source parameter that will be passed by updating methods.
void	setStatusListener(StatusListener statusListener)
void	setUserAgent(java.lang.String userAgent) Sets the User-Agent header.
void	setUserId(java.lang.String userId) Sets the userid
void	shadow(int count, int[] follow) See birddog above.
void	spritzer() Starts listening on a percentage of all public statuses, suitable for small projects that don't require a statistically significant sample.
void	track(java.lang.String[] keywords) Returns public statuses that contain at least one of the specified keywords.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

http

protected HttpClient http

source

protected java.lang.String source

Constructor Detail

TwitterStream

public TwitterStream(java.lang.String userId,
                     java.lang.String password)

TwitterStream

public TwitterStream(java.lang.String userId,
                     java.lang.String password,
                     StatusListener listener)

Method Detail

firehose

public void firehose(int count)
              throws TwitterException

Starts listening on all public statuses. Available only to approved parties and requires a signed agreement to access. Please do not contact us about access to the firehose. If your service warrants access to it, we'll contact you.

Parameters:

count - Indicates the number of previous statuses to stream before transitioning to the live stream.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - firehose

getFirehoseStream

public StatusStream getFirehoseStream(int count)
                               throws TwitterException

Returns a status stream for all public statuses. Available only to approved parties and requires a signed agreement to access. Please do not contact us about access to the firehose. If your service warrants access to it, we'll contact you.

Parameters:

count - Indicates the number of previous statuses to stream before transitioning to the live stream.

Returns:

StatusStream

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - firehose

gardenhose

public void gardenhose()
                throws TwitterException

Starts listening on a percentage of all public statuses, suitable for data mining and research applications that require a statistically significant sample. Available only to approved parties and requires a signed agreement to access.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - gardenhose

getGardenhoseStream

public StatusStream getGardenhoseStream()
                                 throws TwitterException

Returns a status stream for a percentage of all public statuses, suitable for data mining and research applications that require a statistically significant sample. Available only to approved parties and requires a signed agreement to access.

Returns:

StatusStream

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - gardenhose

spritzer

public void spritzer()
              throws TwitterException

Starts listening on a percentage of all public statuses, suitable for small projects that don't require a statistically significant sample. Publicly available.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - spritizer

getSpritzerStream

public StatusStream getSpritzerStream()
                               throws TwitterException

Returns a status stream for a percentage of all public statuses, suitable for small projects that don't require a statistically significant sample. Publicly available.

Returns:

StatusStream

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - spritizer

birddog

public void birddog(int count,
                    int[] follow)
             throws TwitterException

Starts listening on public statuses from a specified set of users, by ID. Requires use of the "follow" parameter, documented below. Allows following up to 200,000 users. Available only to approved parties and requires a signed agreement to access.

Parameters:

count - Indicates the number of previous statuses to stream before transitioning to the live stream.

follow - Specifies the users, by ID, to receive public tweets from.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - birddog

getBirddogStream

public StatusStream getBirddogStream(int count,
                                     int[] follow)
                              throws TwitterException

Returns a status stream for public statuses from a specified set of users, by ID. Requires use of the "follow" parameter, documented below. Allows following up to 200,000 users. Available only to approved parties and requires a signed agreement to access.

Parameters:

count - Indicates the number of previous statuses to stream before transitioning to the live stream.

follow - Specifies the users, by ID, to receive public tweets from.

Returns:

StatusStream

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - birddog

shadow

public void shadow(int count,
                   int[] follow)
            throws TwitterException

See birddog above. Allows following up to 2,000 users.

Parameters:

count - Indicates the number of previous statuses to stream before transitioning to the live stream.

follow - Specifies the users, by ID, to receive public tweets from.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - shadow

getShadowStream

public StatusStream getShadowStream(int count,
                                    int[] follow)
                             throws TwitterException

See birddog above. Allows following up to 2,000 users.

Parameters:

count - Indicates the number of previous statuses to stream before transitioning to the live stream.

follow - Specifies the users, by ID, to receive public tweets from.

Returns:

StatusStream

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - shadow

follow

public void follow(int[] follow)
            throws TwitterException

See birddog above. Allows following up to 200 users. Publicly available.

Parameters:

follow - Specifies the users, by ID, to receive public tweets from.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - follow

getFollowStream

public StatusStream getFollowStream(int[] follow)
                             throws TwitterException

See birddog above. Allows following up to 200 users. Publicly available.

Parameters:

follow - Specifies the users, by ID, to receive public tweets from.

Returns:

StatusStream

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.4

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - follow

track

public void track(java.lang.String[] keywords)
           throws TwitterException

Returns public statuses that contain at least one of the specified keywords. Requires use of the "track" parameter, documented below. Allows following up to 20 keywords, subject to Track Limitations, described above. Predicate terms are case-insensitive logical ORs. Terms are exact-matched, and exact-matched ignoring punctuation. Publicly available. Examples: The predicate Twitter will match all public statuses with the following space delimited tokens in their text field: TWITTER, twitter, "Twitter", twitter., #twitter and @twitter. The following tokens will not be matched: TwitterTracker and http://www.twitter.com,

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.9

See Also:

StatusStream, Twitter API Wiki / Streaming API Documentation - spritizer

getTrackStream

public StatusStream getTrackStream(java.lang.String[] keywords)
                            throws TwitterException

Throws:

TwitterException

See Also:

getTrackStream(String[])

cleanup

public void cleanup()

getStatusListener

public StatusListener getStatusListener()

setStatusListener

public void setStatusListener(StatusListener statusListener)

setUserAgent

public void setUserAgent(java.lang.String userAgent)

Sets the User-Agent header. System property -Dtwitter4j.http.userAgent overrides this attribute.

Parameters:

userAgent - UserAgent

Since:

Twitter4J 1.1.8

getUserAgent

public java.lang.String getUserAgent()

Returns:

UserAgent

Since:

Twitter4J 1.1.8

setClientVersion

public void setClientVersion(java.lang.String version)

Sets the X-Twitter-Client-Version header. System property -Dtwitter4j.clientVersion overrides this attribute.

Parameters:

version - client version

Since:

Twitter4J 1.1.8

getClientVersion

public java.lang.String getClientVersion()

Returns:

client version

Since:

Twitter4J 1.1.8

setClientURL

public void setClientURL(java.lang.String clientURL)

Sets the X-Twitter-Client-URL header. System property -Dtwitter4j.clientURL overrides this attribute.

Parameters:

clientURL - client URL

Since:

Twitter4J 1.1.8

getClientURL

public java.lang.String getClientURL()

Returns:

client URL

Since:

Twitter4J 1.1.8

setUserId

public void setUserId(java.lang.String userId)

Sets the userid

Parameters:

userId - new userid

getUserId

public java.lang.String getUserId()

Returns authenticating userid

Returns:

userid

setPassword

public void setPassword(java.lang.String password)

Sets the password

Parameters:

password - new password

getPassword

public java.lang.String getPassword()

Returns authenticating password

Returns:

password

setHttpProxy

public void setHttpProxy(java.lang.String proxyHost,
                         int proxyPort)

Enables use of HTTP proxy

Parameters:

proxyHost - proxy host, can be overridden system property -Dtwitter4j.http.proxyHost , -Dhttp.proxyHost

proxyPort - proxy port, can be overridden system property -Dtwitter4j.http.proxyPort , -Dhttp.proxyPort

Since:

Twitter4J 1.1.6

setHttpProxyAuth

public void setHttpProxyAuth(java.lang.String proxyUser,
                             java.lang.String proxyPass)

Adds authentication on HTTP proxy

Parameters:

proxyUser - proxy user, can be overridden system property -Dtwitter4j.http.proxyUser

proxyPass - proxy password, can be overridden system property -Dtwitter4j.http.proxyPassword

Since:

Twitter4J 1.1.6

setHttpConnectionTimeout

public void setHttpConnectionTimeout(int connectionTimeout)

Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the Twitter API. System property -Dtwitter4j.http.connectionTimeout overrides this attribute.

Parameters:

connectionTimeout - an int that specifies the connect timeout value in milliseconds

Since:

Twitter4J 1.1.6

setHttpReadTimeout

public void setHttpReadTimeout(int readTimeoutMilliSecs)

Sets the read timeout to a specified timeout, in milliseconds.

Parameters:

readTimeoutMilliSecs - an int that specifies the timeout value to be used in milliseconds

Since:

Twitter4J 1.1.6

setSource

public void setSource(java.lang.String source)

Sets X-Twitter-Client http header and the source parameter that will be passed by updating methods. System property -Dtwitter4j.source overrides this attribute. System property -Dtwitter4j.source overrides this attribute.

Parameters:

source - the new source

See Also:

How do I get "from [MyApp]" appended to updates sent from my API application?, Twitter - Request a link to your application

getSource

public java.lang.String getSource()

Returns the source

Returns:

source

setRequestHeader

public void setRequestHeader(java.lang.String name,
                             java.lang.String value)

Sets the request header name/value combination see Twitter Fan Wiki for detail. http://twitter.pbwiki.com/API-Docs#RequestHeaders

Parameters:

name - the name of the request header

value - the value of the request header

forceUsePost

public void forceUsePost(boolean forceUsePost)

Deprecated. some methods don't accept POST method anymore

Set true to force using POST method communicating to the server.
This method doesn't take effect anymore

Parameters:

forceUsePost - if true POST method will be used forcibly

isUsePostForced

public boolean isUsePostForced()

Returns:

true if POST is used forcibly

setRetryCount

public void setRetryCount(int retryCount)

setRetryIntervalSecs

public void setRetryIntervalSecs(int retryIntervalSecs)