TwitterStream.html 38 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!-- NewPage -->
  3. <html lang="en">
  4. <head>
  5. <!-- Generated by javadoc (1.8.0_161) on Thu Aug 16 18:54:30 JST 2018 -->
  6. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <title>TwitterStream (twitter4j-stream 4.0.7 API)</title>
  8. <meta name="date" content="2018-08-16">
  9. <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
  10. <script type="text/javascript" src="../script.js"></script>
  11. </head>
  12. <body>
  13. <script type="text/javascript"><!--
  14. try {
  15. if (location.href.indexOf('is-external=true') == -1) {
  16. parent.document.title="TwitterStream (twitter4j-stream 4.0.7 API)";
  17. }
  18. }
  19. catch(err) {
  20. }
  21. //-->
  22. var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6,"i12":6,"i13":6,"i14":6,"i15":6,"i16":38,"i17":38,"i18":38};
  23. var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],32:["t6","Deprecated Methods"]};
  24. var altColor = "altColor";
  25. var rowColor = "rowColor";
  26. var tableTab = "tableTab";
  27. var activeTableTab = "activeTableTab";
  28. </script>
  29. <noscript>
  30. <div>JavaScript is disabled on your browser.</div>
  31. </noscript>
  32. <!-- ========= START OF TOP NAVBAR ======= -->
  33. <div class="topNav"><a name="navbar.top">
  34. <!-- -->
  35. </a>
  36. <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
  37. <a name="navbar.top.firstrow">
  38. <!-- -->
  39. </a>
  40. <ul class="navList" title="Navigation">
  41. <li><a href="../twitter4j/package-summary.html">Package</a></li>
  42. <li class="navBarCell1Rev">Class</li>
  43. <li><a href="class-use/TwitterStream.html">Use</a></li>
  44. <li><a href="package-tree.html">Tree</a></li>
  45. <li><a href="../deprecated-list.html">Deprecated</a></li>
  46. <li><a href="../index-all.html">Index</a></li>
  47. <li><a href="../help-doc.html">Help</a></li>
  48. </ul>
  49. </div>
  50. <div class="subNav">
  51. <ul class="navList">
  52. <li><a href="../twitter4j/StreamListener.html" title="interface in twitter4j"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  53. <li><a href="../twitter4j/TwitterStreamFactory.html" title="class in twitter4j"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  54. </ul>
  55. <ul class="navList">
  56. <li><a href="../index.html?twitter4j/TwitterStream.html" target="_top">Frames</a></li>
  57. <li><a href="TwitterStream.html" target="_top">No&nbsp;Frames</a></li>
  58. </ul>
  59. <ul class="navList" id="allclasses_navbar_top">
  60. <li><a href="../allclasses-noframe.html">All&nbsp;Classes</a></li>
  61. </ul>
  62. <div>
  63. <script type="text/javascript"><!--
  64. allClassesLink = document.getElementById("allclasses_navbar_top");
  65. if(window==top) {
  66. allClassesLink.style.display = "block";
  67. }
  68. else {
  69. allClassesLink.style.display = "none";
  70. }
  71. //-->
  72. </script>
  73. </div>
  74. <div>
  75. <ul class="subNavList">
  76. <li>Summary:&nbsp;</li>
  77. <li>Nested&nbsp;|&nbsp;</li>
  78. <li>Field&nbsp;|&nbsp;</li>
  79. <li>Constr&nbsp;|&nbsp;</li>
  80. <li><a href="#method.summary">Method</a></li>
  81. </ul>
  82. <ul class="subNavList">
  83. <li>Detail:&nbsp;</li>
  84. <li>Field&nbsp;|&nbsp;</li>
  85. <li>Constr&nbsp;|&nbsp;</li>
  86. <li><a href="#method.detail">Method</a></li>
  87. </ul>
  88. </div>
  89. <a name="skip.navbar.top">
  90. <!-- -->
  91. </a></div>
  92. <!-- ========= END OF TOP NAVBAR ========= -->
  93. <!-- ======== START OF CLASS DATA ======== -->
  94. <div class="header">
  95. <div class="subTitle">twitter4j</div>
  96. <h2 title="Interface TwitterStream" class="title">Interface TwitterStream</h2>
  97. </div>
  98. <div class="contentContainer">
  99. <div class="description">
  100. <ul class="blockList">
  101. <li class="blockList">
  102. <dl>
  103. <dt>All Superinterfaces:</dt>
  104. <dd><a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true" title="class or interface in twitter4j.auth">OAuthSupport</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true" title="class or interface in twitter4j">TwitterBase</a></dd>
  105. </dl>
  106. <hr>
  107. <br>
  108. <pre>public interface <span class="typeNameLabel">TwitterStream</span>
  109. extends <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true" title="class or interface in twitter4j.auth">OAuthSupport</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true" title="class or interface in twitter4j">TwitterBase</a></pre>
  110. <dl>
  111. <dt><span class="simpleTagLabel">Since:</span></dt>
  112. <dd>Twitter4J 2.2.0</dd>
  113. <dt><span class="simpleTagLabel">Author:</span></dt>
  114. <dd>Yusuke Yamamoto - yusuke at mac.com</dd>
  115. </dl>
  116. </li>
  117. </ul>
  118. </div>
  119. <div class="summary">
  120. <ul class="blockList">
  121. <li class="blockList">
  122. <!-- ========== METHOD SUMMARY =========== -->
  123. <ul class="blockList">
  124. <li class="blockList"><a name="method.summary">
  125. <!-- -->
  126. </a>
  127. <h3>Method Summary</h3>
  128. <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
  129. <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t6" class="tableTab"><span><a href="javascript:show(32);">Deprecated Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
  130. <tr>
  131. <th class="colFirst" scope="col">Modifier and Type</th>
  132. <th class="colLast" scope="col">Method and Description</th>
  133. </tr>
  134. <tr id="i0" class="altColor">
  135. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  136. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#addConnectionLifeCycleListener-twitter4j.ConnectionLifeCycleListener-">addConnectionLifeCycleListener</a></span>(<a href="http://twitter4j.org/apidocs/twitter4j/ConnectionLifeCycleListener.html?is-external=true" title="class or interface in twitter4j">ConnectionLifeCycleListener</a>&nbsp;listener)</code>
  137. <div class="block">Adds a ConnectionLifeCycleListener</div>
  138. </td>
  139. </tr>
  140. <tr id="i1" class="rowColor">
  141. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  142. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#addListener-twitter4j.StreamListener-">addListener</a></span>(<a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;listener)</code>&nbsp;</td>
  143. </tr>
  144. <tr id="i2" class="altColor">
  145. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  146. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#cleanUp--">cleanUp</a></span>()</code>
  147. <div class="block">shutdown internal stream consuming thread</div>
  148. </td>
  149. </tr>
  150. <tr id="i3" class="rowColor">
  151. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  152. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#clearListeners--">clearListeners</a></span>()</code>
  153. <div class="block">clear status listeners</div>
  154. </td>
  155. </tr>
  156. <tr id="i4" class="altColor">
  157. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  158. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#filter-twitter4j.FilterQuery-">filter</a></span>(<a href="../twitter4j/FilterQuery.html" title="class in twitter4j">FilterQuery</a>&nbsp;query)</code>
  159. <div class="block">Start consuming public statuses that match one or more filter predicates.</div>
  160. </td>
  161. </tr>
  162. <tr id="i5" class="rowColor">
  163. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  164. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#filter-java.lang.String...-">filter</a></span>(java.lang.String...&nbsp;track)</code>
  165. <div class="block">Start consuming public statuses that match the filter predicate.</div>
  166. </td>
  167. </tr>
  168. <tr id="i6" class="altColor">
  169. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  170. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#firehose-int-">firehose</a></span>(int&nbsp;count)</code>
  171. <div class="block">Starts listening on all public statuses.</div>
  172. </td>
  173. </tr>
  174. <tr id="i7" class="rowColor">
  175. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  176. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#links-int-">links</a></span>(int&nbsp;count)</code>
  177. <div class="block">Starts listening on all public statuses containing links.</div>
  178. </td>
  179. </tr>
  180. <tr id="i8" class="altColor">
  181. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  182. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#onException-twitter4j.util.function.Consumer-">onException</a></span>(<a href="http://twitter4j.org/apidocs/twitter4j/util/function/Consumer.html?is-external=true" title="class or interface in twitter4j.util.function">Consumer</a>&lt;java.lang.Exception&gt;&nbsp;action)</code>&nbsp;</td>
  183. </tr>
  184. <tr id="i9" class="rowColor">
  185. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  186. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#onStatus-twitter4j.util.function.Consumer-">onStatus</a></span>(<a href="http://twitter4j.org/apidocs/twitter4j/util/function/Consumer.html?is-external=true" title="class or interface in twitter4j.util.function">Consumer</a>&lt;<a href="http://twitter4j.org/apidocs/twitter4j/Status.html?is-external=true" title="class or interface in twitter4j">Status</a>&gt;&nbsp;action)</code>&nbsp;</td>
  187. </tr>
  188. <tr id="i10" class="altColor">
  189. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  190. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#removeListener-twitter4j.StreamListener-">removeListener</a></span>(<a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;listener)</code>&nbsp;</td>
  191. </tr>
  192. <tr id="i11" class="rowColor">
  193. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  194. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#replaceListener-twitter4j.StreamListener-twitter4j.StreamListener-">replaceListener</a></span>(<a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;toBeRemoved,
  195. <a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;toBeAdded)</code>
  196. <div class="block">replace existing listener</div>
  197. </td>
  198. </tr>
  199. <tr id="i12" class="altColor">
  200. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  201. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#retweet--">retweet</a></span>()</code>
  202. <div class="block">Starts listening on all retweets.</div>
  203. </td>
  204. </tr>
  205. <tr id="i13" class="rowColor">
  206. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  207. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#sample--">sample</a></span>()</code>
  208. <div class="block">Starts listening on random sample of all public statuses.</div>
  209. </td>
  210. </tr>
  211. <tr id="i14" class="altColor">
  212. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  213. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#sample-java.lang.String-">sample</a></span>(java.lang.String&nbsp;language)</code>
  214. <div class="block">Starts listening on random sample of all public statuses.</div>
  215. </td>
  216. </tr>
  217. <tr id="i15" class="rowColor">
  218. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  219. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#shutdown--">shutdown</a></span>()</code>
  220. <div class="block">Shuts down internal dispatcher thread shared by all TwitterStream instances.<br></div>
  221. </td>
  222. </tr>
  223. <tr id="i16" class="altColor">
  224. <td class="colFirst"><code><a href="../twitter4j/StreamController.html" title="class in twitter4j">StreamController</a></code></td>
  225. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#site-boolean-long...-">site</a></span>(boolean&nbsp;withFollowings,
  226. long...&nbsp;follow)</code>
  227. <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
  228. <div class="block"><span class="deprecationComment">Since Twitter4J 4.0.7</span></div>
  229. </div>
  230. </td>
  231. </tr>
  232. <tr id="i17" class="rowColor">
  233. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  234. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#user--">user</a></span>()</code>
  235. <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
  236. <div class="block"><span class="deprecationComment">Since Twitter4J 4.0.7</span></div>
  237. </div>
  238. </td>
  239. </tr>
  240. <tr id="i18" class="altColor">
  241. <td class="colFirst"><code><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a></code></td>
  242. <td class="colLast"><code><span class="memberNameLink"><a href="../twitter4j/TwitterStream.html#user-java.lang.String...-">user</a></span>(java.lang.String...&nbsp;track)</code>
  243. <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
  244. <div class="block"><span class="deprecationComment">Since Twitter4J 4.0.7</span></div>
  245. </div>
  246. </td>
  247. </tr>
  248. </table>
  249. <ul class="blockList">
  250. <li class="blockList"><a name="methods.inherited.from.class.twitter4j.auth.OAuthSupport">
  251. <!-- -->
  252. </a>
  253. <h3>Methods inherited from interface&nbsp;twitter4j.auth.<a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true" title="class or interface in twitter4j.auth">OAuthSupport</a></h3>
  254. <code><a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthAccessToken--" title="class or interface in twitter4j.auth">getOAuthAccessToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthAccessToken-twitter4j.auth.RequestToken-" title="class or interface in twitter4j.auth">getOAuthAccessToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthAccessToken-twitter4j.auth.RequestToken-java.lang.String-" title="class or interface in twitter4j.auth">getOAuthAccessToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthAccessToken-java.lang.String-" title="class or interface in twitter4j.auth">getOAuthAccessToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthAccessToken-java.lang.String-java.lang.String-" title="class or interface in twitter4j.auth">getOAuthAccessToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthRequestToken--" title="class or interface in twitter4j.auth">getOAuthRequestToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthRequestToken-java.lang.String-" title="class or interface in twitter4j.auth">getOAuthRequestToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthRequestToken-java.lang.String-java.lang.String-" title="class or interface in twitter4j.auth">getOAuthRequestToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#getOAuthRequestToken-java.lang.String-java.lang.String-java.lang.String-" title="class or interface in twitter4j.auth">getOAuthRequestToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#setOAuthAccessToken-twitter4j.auth.AccessToken-" title="class or interface in twitter4j.auth">setOAuthAccessToken</a>, <a href="http://twitter4j.org/apidocs/twitter4j/auth/OAuthSupport.html?is-external=true#setOAuthConsumer-java.lang.String-java.lang.String-" title="class or interface in twitter4j.auth">setOAuthConsumer</a></code></li>
  255. </ul>
  256. <ul class="blockList">
  257. <li class="blockList"><a name="methods.inherited.from.class.twitter4j.TwitterBase">
  258. <!-- -->
  259. </a>
  260. <h3>Methods inherited from interface&nbsp;twitter4j.<a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true" title="class or interface in twitter4j">TwitterBase</a></h3>
  261. <code><a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#addRateLimitStatusListener-twitter4j.RateLimitStatusListener-" title="class or interface in twitter4j">addRateLimitStatusListener</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#getAuthorization--" title="class or interface in twitter4j">getAuthorization</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#getConfiguration--" title="class or interface in twitter4j">getConfiguration</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#getId--" title="class or interface in twitter4j">getId</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#getScreenName--" title="class or interface in twitter4j">getScreenName</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#onRateLimitReached-twitter4j.util.function.Consumer-" title="class or interface in twitter4j">onRateLimitReached</a>, <a href="http://twitter4j.org/apidocs/twitter4j/TwitterBase.html?is-external=true#onRateLimitStatus-twitter4j.util.function.Consumer-" title="class or interface in twitter4j">onRateLimitStatus</a></code></li>
  262. </ul>
  263. </li>
  264. </ul>
  265. </li>
  266. </ul>
  267. </div>
  268. <div class="details">
  269. <ul class="blockList">
  270. <li class="blockList">
  271. <!-- ============ METHOD DETAIL ========== -->
  272. <ul class="blockList">
  273. <li class="blockList"><a name="method.detail">
  274. <!-- -->
  275. </a>
  276. <h3>Method Detail</h3>
  277. <a name="addConnectionLifeCycleListener-twitter4j.ConnectionLifeCycleListener-">
  278. <!-- -->
  279. </a>
  280. <ul class="blockList">
  281. <li class="blockList">
  282. <h4>addConnectionLifeCycleListener</h4>
  283. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;addConnectionLifeCycleListener(<a href="http://twitter4j.org/apidocs/twitter4j/ConnectionLifeCycleListener.html?is-external=true" title="class or interface in twitter4j">ConnectionLifeCycleListener</a>&nbsp;listener)</pre>
  284. <div class="block">Adds a ConnectionLifeCycleListener</div>
  285. <dl>
  286. <dt><span class="paramLabel">Parameters:</span></dt>
  287. <dd><code>listener</code> - listener to be added</dd>
  288. <dt><span class="simpleTagLabel">Since:</span></dt>
  289. <dd>Twitter4J 2.1.7</dd>
  290. </dl>
  291. </li>
  292. </ul>
  293. <a name="addListener-twitter4j.StreamListener-">
  294. <!-- -->
  295. </a>
  296. <ul class="blockList">
  297. <li class="blockList">
  298. <h4>addListener</h4>
  299. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;addListener(<a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;listener)</pre>
  300. <dl>
  301. <dt><span class="paramLabel">Parameters:</span></dt>
  302. <dd><code>listener</code> - listener to add</dd>
  303. <dt><span class="simpleTagLabel">Since:</span></dt>
  304. <dd>Twitter4J 2.1.8</dd>
  305. </dl>
  306. </li>
  307. </ul>
  308. <a name="onStatus-twitter4j.util.function.Consumer-">
  309. <!-- -->
  310. </a>
  311. <ul class="blockList">
  312. <li class="blockList">
  313. <h4>onStatus</h4>
  314. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;onStatus(<a href="http://twitter4j.org/apidocs/twitter4j/util/function/Consumer.html?is-external=true" title="class or interface in twitter4j.util.function">Consumer</a>&lt;<a href="http://twitter4j.org/apidocs/twitter4j/Status.html?is-external=true" title="class or interface in twitter4j">Status</a>&gt;&nbsp;action)</pre>
  315. <dl>
  316. <dt><span class="paramLabel">Parameters:</span></dt>
  317. <dd><code>action</code> - action when receiving Status</dd>
  318. <dt><span class="returnLabel">Returns:</span></dt>
  319. <dd>this instance</dd>
  320. <dt><span class="simpleTagLabel">Since:</span></dt>
  321. <dd>Twitter4J 4.0.4</dd>
  322. </dl>
  323. </li>
  324. </ul>
  325. <a name="onException-twitter4j.util.function.Consumer-">
  326. <!-- -->
  327. </a>
  328. <ul class="blockList">
  329. <li class="blockList">
  330. <h4>onException</h4>
  331. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;onException(<a href="http://twitter4j.org/apidocs/twitter4j/util/function/Consumer.html?is-external=true" title="class or interface in twitter4j.util.function">Consumer</a>&lt;java.lang.Exception&gt;&nbsp;action)</pre>
  332. <dl>
  333. <dt><span class="paramLabel">Parameters:</span></dt>
  334. <dd><code>action</code> - action when receiving TwitterException</dd>
  335. <dt><span class="returnLabel">Returns:</span></dt>
  336. <dd>this instance</dd>
  337. <dt><span class="simpleTagLabel">Since:</span></dt>
  338. <dd>Twitter4J 4.0.4</dd>
  339. </dl>
  340. </li>
  341. </ul>
  342. <a name="removeListener-twitter4j.StreamListener-">
  343. <!-- -->
  344. </a>
  345. <ul class="blockList">
  346. <li class="blockList">
  347. <h4>removeListener</h4>
  348. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;removeListener(<a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;listener)</pre>
  349. <dl>
  350. <dt><span class="paramLabel">Parameters:</span></dt>
  351. <dd><code>listener</code> - listener to remove</dd>
  352. <dt><span class="simpleTagLabel">Since:</span></dt>
  353. <dd>Twitter4J 4.0.0</dd>
  354. </dl>
  355. </li>
  356. </ul>
  357. <a name="clearListeners--">
  358. <!-- -->
  359. </a>
  360. <ul class="blockList">
  361. <li class="blockList">
  362. <h4>clearListeners</h4>
  363. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;clearListeners()</pre>
  364. <div class="block">clear status listeners</div>
  365. <dl>
  366. <dt><span class="simpleTagLabel">Since:</span></dt>
  367. <dd>Twitter4J 4.0.0</dd>
  368. </dl>
  369. </li>
  370. </ul>
  371. <a name="replaceListener-twitter4j.StreamListener-twitter4j.StreamListener-">
  372. <!-- -->
  373. </a>
  374. <ul class="blockList">
  375. <li class="blockList">
  376. <h4>replaceListener</h4>
  377. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;replaceListener(<a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;toBeRemoved,
  378. <a href="../twitter4j/StreamListener.html" title="interface in twitter4j">StreamListener</a>&nbsp;toBeAdded)</pre>
  379. <div class="block">replace existing listener</div>
  380. <dl>
  381. <dt><span class="paramLabel">Parameters:</span></dt>
  382. <dd><code>toBeRemoved</code> - listener to be removed</dd>
  383. <dd><code>toBeAdded</code> - listener to be added</dd>
  384. <dt><span class="simpleTagLabel">Since:</span></dt>
  385. <dd>Twitter4J 4.0.0</dd>
  386. </dl>
  387. </li>
  388. </ul>
  389. <a name="firehose-int-">
  390. <!-- -->
  391. </a>
  392. <ul class="blockList">
  393. <li class="blockList">
  394. <h4>firehose</h4>
  395. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;firehose(int&nbsp;count)</pre>
  396. <div class="block">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.</div>
  397. <dl>
  398. <dt><span class="paramLabel">Parameters:</span></dt>
  399. <dd><code>count</code> - Indicates the number of previous statuses to stream before transitioning to the live stream.</dd>
  400. <dt><span class="simpleTagLabel">Since:</span></dt>
  401. <dd>Twitter4J 2.0.4</dd>
  402. <dt><span class="seeLabel">See Also:</span></dt>
  403. <dd><a href="http://twitter4j.org/apidocs/twitter4j/StatusStream.html?is-external=true" title="class or interface in twitter4j"><code>StatusStream</code></a>,
  404. <a href="https://dev.twitter.com/docs/streaming-api/methods">Streaming API Methods statuses/firehose</a></dd>
  405. </dl>
  406. </li>
  407. </ul>
  408. <a name="links-int-">
  409. <!-- -->
  410. </a>
  411. <ul class="blockList">
  412. <li class="blockList">
  413. <h4>links</h4>
  414. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;links(int&nbsp;count)</pre>
  415. <div class="block">Starts listening on all public statuses containing links. Available only to approved parties and requires a signed agreement to access. Please do not contact us about access to the links stream. If your service warrants access to it, we'll contact you.</div>
  416. <dl>
  417. <dt><span class="paramLabel">Parameters:</span></dt>
  418. <dd><code>count</code> - Indicates the number of previous statuses to stream before transitioning to the live stream.</dd>
  419. <dt><span class="simpleTagLabel">Since:</span></dt>
  420. <dd>Twitter4J 2.1.1</dd>
  421. <dt><span class="seeLabel">See Also:</span></dt>
  422. <dd><a href="http://twitter4j.org/apidocs/twitter4j/StatusStream.html?is-external=true" title="class or interface in twitter4j"><code>StatusStream</code></a>,
  423. <a href="https://dev.twitter.com/docs/streaming-api/methods">Streaming API Methods statuses/links</a></dd>
  424. </dl>
  425. </li>
  426. </ul>
  427. <a name="retweet--">
  428. <!-- -->
  429. </a>
  430. <ul class="blockList">
  431. <li class="blockList">
  432. <h4>retweet</h4>
  433. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;retweet()</pre>
  434. <div class="block">Starts listening on all retweets. The retweet stream is not a generally available resource. Few applications require this level of access. Creative use of a combination of other resources and various access levels can satisfy nearly every application use case. As of 9/11/2009, the site-wide retweet feature has not yet launched, so there are currently few, if any, retweets on this stream.</div>
  435. <dl>
  436. <dt><span class="simpleTagLabel">Since:</span></dt>
  437. <dd>Twitter4J 2.0.10</dd>
  438. <dt><span class="seeLabel">See Also:</span></dt>
  439. <dd><a href="http://twitter4j.org/apidocs/twitter4j/StatusStream.html?is-external=true" title="class or interface in twitter4j"><code>StatusStream</code></a>,
  440. <a href="https://dev.twitter.com/docs/streaming-api/methods">Streaming API Methods statuses/retweet</a></dd>
  441. </dl>
  442. </li>
  443. </ul>
  444. <a name="sample--">
  445. <!-- -->
  446. </a>
  447. <ul class="blockList">
  448. <li class="blockList">
  449. <h4>sample</h4>
  450. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;sample()</pre>
  451. <div class="block">Starts listening on random sample of all public statuses. The default access level provides a small proportion of the Firehose. The "Gardenhose" access level provides a proportion more suitable for data mining and research applications that desire a larger proportion to be statistically significant sample.</div>
  452. <dl>
  453. <dt><span class="simpleTagLabel">Since:</span></dt>
  454. <dd>Twitter4J 2.0.10</dd>
  455. <dt><span class="seeLabel">See Also:</span></dt>
  456. <dd><a href="http://twitter4j.org/apidocs/twitter4j/StatusStream.html?is-external=true" title="class or interface in twitter4j"><code>StatusStream</code></a>,
  457. <a href="https://dev.twitter.com/docs/streaming-api/methods">Streaming API: Methods statuses/sample</a></dd>
  458. </dl>
  459. </li>
  460. </ul>
  461. <a name="sample-java.lang.String-">
  462. <!-- -->
  463. </a>
  464. <ul class="blockList">
  465. <li class="blockList">
  466. <h4>sample</h4>
  467. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;sample(java.lang.String&nbsp;language)</pre>
  468. <div class="block">Starts listening on random sample of all public statuses. The default access level provides a small proportion of the Firehose. The "Gardenhose" access level provides a proportion more suitable for data mining and research applications that desire a larger proportion to be statistically significant sample.
  469. <p>
  470. Only samples Tweets written in the given language.</div>
  471. <dl>
  472. <dt><span class="paramLabel">Parameters:</span></dt>
  473. <dd><code>language</code> - language to be sampled</dd>
  474. <dt><span class="simpleTagLabel">Since:</span></dt>
  475. <dd>Twitter4J 2.0.10</dd>
  476. <dt><span class="seeLabel">See Also:</span></dt>
  477. <dd><a href="http://twitter4j.org/apidocs/twitter4j/StatusStream.html?is-external=true" title="class or interface in twitter4j"><code>StatusStream</code></a>,
  478. <a href="https://dev.twitter.com/docs/streaming-api/methods">Streaming API: Methods statuses/sample</a></dd>
  479. </dl>
  480. </li>
  481. </ul>
  482. <a name="user--">
  483. <!-- -->
  484. </a>
  485. <ul class="blockList">
  486. <li class="blockList">
  487. <h4>user</h4>
  488. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;user()</pre>
  489. <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">Since Twitter4J 4.0.7</span></div>
  490. <div class="block">User Streams provides real-time updates of all data needed to update a desktop application display. Applications can request startup back-fill from the REST API and then transition to Streaming for nearly all subsequent reads. Rate limits and latency are practically eliminated. Desktop developers can stop managing rate limits and use this new data to create an entirely new user experience. On our end, we hope to reduce costs and increase site reliability.</div>
  491. <dl>
  492. <dt><span class="throwsLabel">Throws:</span></dt>
  493. <dd><code>java.lang.IllegalStateException</code> - when non-UserStreamListener is set, or no listener is set</dd>
  494. <dt><span class="seeLabel">See Also:</span></dt>
  495. <dd><a href="https://dev.twitter.com/docs/streaming-api/user-streams">User Streams</a></dd>
  496. </dl>
  497. </li>
  498. </ul>
  499. <a name="user-java.lang.String...-">
  500. <!-- -->
  501. </a>
  502. <ul class="blockList">
  503. <li class="blockList">
  504. <h4>user</h4>
  505. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;user(java.lang.String...&nbsp;track)</pre>
  506. <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">Since Twitter4J 4.0.7</span></div>
  507. <div class="block">User Streams provides real-time updates of all data needed to update a desktop application display. Applications can request startup back-fill from the REST API and then transition to Streaming for nearly all subsequent reads. Rate limits and latency are practically eliminated. Desktop developers can stop managing rate limits and use this new data to create an entirely new user experience. On our end, we hope to reduce costs and increase site reliability.</div>
  508. <dl>
  509. <dt><span class="paramLabel">Parameters:</span></dt>
  510. <dd><code>track</code> - keywords to track</dd>
  511. <dt><span class="throwsLabel">Throws:</span></dt>
  512. <dd><code>java.lang.IllegalStateException</code> - when non-UserStreamListener is set, or no listener is set</dd>
  513. <dt><span class="simpleTagLabel">Since:</span></dt>
  514. <dd>Twitter4J 2.1.9</dd>
  515. <dt><span class="seeLabel">See Also:</span></dt>
  516. <dd><a href="https://dev.twitter.com/docs/streaming-api/user-streams">User Streams</a></dd>
  517. </dl>
  518. </li>
  519. </ul>
  520. <a name="site-boolean-long...-">
  521. <!-- -->
  522. </a>
  523. <ul class="blockList">
  524. <li class="blockList">
  525. <h4>site</h4>
  526. <pre><a href="../twitter4j/StreamController.html" title="class in twitter4j">StreamController</a>&nbsp;site(boolean&nbsp;withFollowings,
  527. long...&nbsp;follow)</pre>
  528. <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">Since Twitter4J 4.0.7</span></div>
  529. <div class="block">Site Streams, a new feature on the Streaming API, is now available for beta testing. Site Streams allows services, such as web sites or mobile push services, to receive real-time updates for a large number of users without any of the hassles of managing REST API rate limits. The initial version delivers events created by, or directed to, users that have shared their OAuth token with your application. The following events are streamed immediately, and without rate limits: Home Timelines, Mentions Timelines, User Timelines, Direct Messages, Mentions, Follows, Favorites, Tweets, Retweets, Profile changes, and List changes.
  530. The following limitations must be respected during the beta period. These limitations may be changed with little advance notice. We intend to increase or remove these various limitations as we move from beta test into full production:<br>
  531. Limit the follow count to 100 users per stream. Clients must occasionally compact users onto a smaller number of connections to minimize the total number of connections outstanding.<br>
  532. Open no more than 25 new connections per second and exponentially back-off on errors.</div>
  533. <dl>
  534. <dt><span class="paramLabel">Parameters:</span></dt>
  535. <dd><code>withFollowings</code> - whether to receive status updates from people following</dd>
  536. <dd><code>follow</code> - an array of users to include in the stream</dd>
  537. <dt><span class="returnLabel">Returns:</span></dt>
  538. <dd>controller to control the site stream</dd>
  539. <dt><span class="simpleTagLabel">Since:</span></dt>
  540. <dd>Twitter4J 2.1.8</dd>
  541. <dt><span class="seeLabel">See Also:</span></dt>
  542. <dd><a href="https://dev.twitter.com/docs/streaming-api/site-streams">Site Streams | Twitter Developers</a></dd>
  543. </dl>
  544. </li>
  545. </ul>
  546. <a name="filter-twitter4j.FilterQuery-">
  547. <!-- -->
  548. </a>
  549. <ul class="blockList">
  550. <li class="blockList">
  551. <h4>filter</h4>
  552. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;filter(<a href="../twitter4j/FilterQuery.html" title="class in twitter4j">FilterQuery</a>&nbsp;query)</pre>
  553. <div class="block">Start consuming public statuses that match one or more filter predicates. At least one predicate parameter, follow, locations, or track must be specified. Multiple parameters may be specified which allows most clients to use a single connection to the Streaming API. Placing long parameters in the URL may cause the request to be rejected for excessive URL length.<br>
  554. The default access level allows up to 200 track keywords, 400 follow userids and 10 1-degree location boxes. Increased access levels allow 80,000 follow userids ("shadow" role), 400,000 follow userids ("birddog" role), 10,000 track keywords ("restricted track" role), 200,000 track keywords ("partner track" role), and 200 10-degree location boxes ("locRestricted" role). Increased track access levels also pass a higher proportion of statuses before limiting the stream.</div>
  555. <dl>
  556. <dt><span class="paramLabel">Parameters:</span></dt>
  557. <dd><code>query</code> - Filter query</dd>
  558. <dt><span class="simpleTagLabel">Since:</span></dt>
  559. <dd>Twitter4J 2.1.2</dd>
  560. <dt><span class="seeLabel">See Also:</span></dt>
  561. <dd><a href="http://twitter4j.org/apidocs/twitter4j/StatusStream.html?is-external=true" title="class or interface in twitter4j"><code>StatusStream</code></a>,
  562. <a href="https://dev.twitter.com/docs/streaming-api/methods">Streaming API Methods statuses/filter</a></dd>
  563. </dl>
  564. </li>
  565. </ul>
  566. <a name="filter-java.lang.String...-">
  567. <!-- -->
  568. </a>
  569. <ul class="blockList">
  570. <li class="blockList">
  571. <h4>filter</h4>
  572. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;filter(java.lang.String...&nbsp;track)</pre>
  573. <div class="block">Start consuming public statuses that match the filter predicate. Placing long parameters in the URL may cause the request to be rejected for excessive URL length.<br>
  574. The default access level allows up to 200 track keywords.</div>
  575. <dl>
  576. <dt><span class="paramLabel">Parameters:</span></dt>
  577. <dd><code>track</code> - words to be filtered</dd>
  578. <dt><span class="simpleTagLabel">Since:</span></dt>
  579. <dd>Twitter4J 4.0.4</dd>
  580. </dl>
  581. </li>
  582. </ul>
  583. <a name="cleanUp--">
  584. <!-- -->
  585. </a>
  586. <ul class="blockList">
  587. <li class="blockList">
  588. <h4>cleanUp</h4>
  589. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;cleanUp()</pre>
  590. <div class="block">shutdown internal stream consuming thread</div>
  591. <dl>
  592. <dt><span class="simpleTagLabel">Since:</span></dt>
  593. <dd>Twitter4J 2.1.7</dd>
  594. </dl>
  595. </li>
  596. </ul>
  597. <a name="shutdown--">
  598. <!-- -->
  599. </a>
  600. <ul class="blockListLast">
  601. <li class="blockList">
  602. <h4>shutdown</h4>
  603. <pre><a href="../twitter4j/TwitterStream.html" title="interface in twitter4j">TwitterStream</a>&nbsp;shutdown()</pre>
  604. <div class="block">Shuts down internal dispatcher thread shared by all TwitterStream instances.<br></div>
  605. <dl>
  606. <dt><span class="simpleTagLabel">Since:</span></dt>
  607. <dd>Twitter4J 2.1.9</dd>
  608. </dl>
  609. </li>
  610. </ul>
  611. </li>
  612. </ul>
  613. </li>
  614. </ul>
  615. </div>
  616. </div>
  617. <!-- ========= END OF CLASS DATA ========= -->
  618. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  619. <div class="bottomNav"><a name="navbar.bottom">
  620. <!-- -->
  621. </a>
  622. <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
  623. <a name="navbar.bottom.firstrow">
  624. <!-- -->
  625. </a>
  626. <ul class="navList" title="Navigation">
  627. <li><a href="../twitter4j/package-summary.html">Package</a></li>
  628. <li class="navBarCell1Rev">Class</li>
  629. <li><a href="class-use/TwitterStream.html">Use</a></li>
  630. <li><a href="package-tree.html">Tree</a></li>
  631. <li><a href="../deprecated-list.html">Deprecated</a></li>
  632. <li><a href="../index-all.html">Index</a></li>
  633. <li><a href="../help-doc.html">Help</a></li>
  634. </ul>
  635. </div>
  636. <div class="subNav">
  637. <ul class="navList">
  638. <li><a href="../twitter4j/StreamListener.html" title="interface in twitter4j"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
  639. <li><a href="../twitter4j/TwitterStreamFactory.html" title="class in twitter4j"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
  640. </ul>
  641. <ul class="navList">
  642. <li><a href="../index.html?twitter4j/TwitterStream.html" target="_top">Frames</a></li>
  643. <li><a href="TwitterStream.html" target="_top">No&nbsp;Frames</a></li>
  644. </ul>
  645. <ul class="navList" id="allclasses_navbar_bottom">
  646. <li><a href="../allclasses-noframe.html">All&nbsp;Classes</a></li>
  647. </ul>
  648. <div>
  649. <script type="text/javascript"><!--
  650. allClassesLink = document.getElementById("allclasses_navbar_bottom");
  651. if(window==top) {
  652. allClassesLink.style.display = "block";
  653. }
  654. else {
  655. allClassesLink.style.display = "none";
  656. }
  657. //-->
  658. </script>
  659. </div>
  660. <div>
  661. <ul class="subNavList">
  662. <li>Summary:&nbsp;</li>
  663. <li>Nested&nbsp;|&nbsp;</li>
  664. <li>Field&nbsp;|&nbsp;</li>
  665. <li>Constr&nbsp;|&nbsp;</li>
  666. <li><a href="#method.summary">Method</a></li>
  667. </ul>
  668. <ul class="subNavList">
  669. <li>Detail:&nbsp;</li>
  670. <li>Field&nbsp;|&nbsp;</li>
  671. <li>Constr&nbsp;|&nbsp;</li>
  672. <li><a href="#method.detail">Method</a></li>
  673. </ul>
  674. </div>
  675. <a name="skip.navbar.bottom">
  676. <!-- -->
  677. </a></div>
  678. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  679. <p class="legalCopy"><small>Copyright &#169; 2018. All Rights Reserved.</small></p>
  680. </body>
  681. </html>