interface_g_r_p_c_streaming_proto_call.html 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.8.17"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>GRPC Objective-C: GRPCStreamingProtoCall Class Reference</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  13. <script type="text/javascript" src="search/searchdata.js"></script>
  14. <script type="text/javascript" src="search/search.js"></script>
  15. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  16. </head>
  17. <body>
  18. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  19. <div id="titlearea">
  20. <table cellspacing="0" cellpadding="0">
  21. <tbody>
  22. <tr style="height: 56px;">
  23. <td id="projectalign" style="padding-left: 0.5em;">
  24. <div id="projectname">GRPC Objective-C
  25. &#160;<span id="projectnumber">1.36.1</span>
  26. </div>
  27. </td>
  28. </tr>
  29. </tbody>
  30. </table>
  31. </div>
  32. <!-- end header part -->
  33. <!-- Generated by Doxygen 1.8.17 -->
  34. <script type="text/javascript">
  35. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  36. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  37. /* @license-end */
  38. </script>
  39. <script type="text/javascript" src="menudata.js"></script>
  40. <script type="text/javascript" src="menu.js"></script>
  41. <script type="text/javascript">
  42. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  43. $(function() {
  44. initMenu('',true,false,'search.php','Search');
  45. $(document).ready(function() { init_search(); });
  46. });
  47. /* @license-end */</script>
  48. <div id="main-nav"></div>
  49. <!-- window showing the filter options -->
  50. <div id="MSearchSelectWindow"
  51. onmouseover="return searchBox.OnSearchSelectShow()"
  52. onmouseout="return searchBox.OnSearchSelectHide()"
  53. onkeydown="return searchBox.OnSearchSelectKey(event)">
  54. </div>
  55. <!-- iframe showing the search results (closed by default) -->
  56. <div id="MSearchResultsWindow">
  57. <iframe src="javascript:void(0)" frameborder="0"
  58. name="MSearchResults" id="MSearchResults">
  59. </iframe>
  60. </div>
  61. </div><!-- top -->
  62. <div class="header">
  63. <div class="summary">
  64. <a href="#pub-methods">Instance Methods</a> &#124;
  65. <a href="#pub-static-methods">Class Methods</a> </div>
  66. <div class="headertitle">
  67. <div class="title">GRPCStreamingProtoCall Class Reference</div> </div>
  68. </div><!--header-->
  69. <div class="contents">
  70. <p>A client-streaming RPC call with Protobuf.
  71. <a href="interface_g_r_p_c_streaming_proto_call.html#details">More...</a></p>
  72. <p><code>#import &lt;<a class="el" href="_proto_r_p_c_8h_source.html">ProtoRPC.h</a>&gt;</code></p>
  73. <table class="memberdecls">
  74. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  75. Instance Methods</h2></td></tr>
  76. <tr class="memitem:ab43d01572f6ddd58272873299bd745b3"><td class="memItemLeft" align="right" valign="top">(instancetype)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#ab43d01572f6ddd58272873299bd745b3">NS_UNAVAILABLE</a></td></tr>
  77. <tr class="separator:ab43d01572f6ddd58272873299bd745b3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  78. <tr class="memitem:a2b272ca4953cb12e26354f794c3fb7d7"><td class="memItemLeft" align="right" valign="top">(nullable instancetype)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a2b272ca4953cb12e26354f794c3fb7d7">initWithRequestOptions:responseHandler:callOptions:responseClass:</a></td></tr>
  79. <tr class="memdesc:a2b272ca4953cb12e26354f794c3fb7d7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Users should not use this initializer directly. <a href="interface_g_r_p_c_streaming_proto_call.html#a2b272ca4953cb12e26354f794c3fb7d7">More...</a><br /></td></tr>
  80. <tr class="separator:a2b272ca4953cb12e26354f794c3fb7d7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  81. <tr class="memitem:a1fb7aac765032282779cf83d438a938c"><td class="memItemLeft" align="right" valign="top">(void)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a1fb7aac765032282779cf83d438a938c">start</a></td></tr>
  82. <tr class="memdesc:a1fb7aac765032282779cf83d438a938c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Start the call. <a href="interface_g_r_p_c_streaming_proto_call.html#a1fb7aac765032282779cf83d438a938c">More...</a><br /></td></tr>
  83. <tr class="separator:a1fb7aac765032282779cf83d438a938c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  84. <tr class="memitem:a679f3d3373b0929c246f366458c24b99"><td class="memItemLeft" align="right" valign="top">(void)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a679f3d3373b0929c246f366458c24b99">cancel</a></td></tr>
  85. <tr class="memdesc:a679f3d3373b0929c246f366458c24b99"><td class="mdescLeft">&#160;</td><td class="mdescRight">Cancel the request of this call at best effort. <a href="interface_g_r_p_c_streaming_proto_call.html#a679f3d3373b0929c246f366458c24b99">More...</a><br /></td></tr>
  86. <tr class="separator:a679f3d3373b0929c246f366458c24b99"><td class="memSeparator" colspan="2">&#160;</td></tr>
  87. <tr class="memitem:a3f2736aa51c9b9456b8ad15d80502cf0"><td class="memItemLeft" align="right" valign="top">(void)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a3f2736aa51c9b9456b8ad15d80502cf0">writeMessage:</a></td></tr>
  88. <tr class="memdesc:a3f2736aa51c9b9456b8ad15d80502cf0"><td class="mdescLeft">&#160;</td><td class="mdescRight">Send a message to the server. <a href="interface_g_r_p_c_streaming_proto_call.html#a3f2736aa51c9b9456b8ad15d80502cf0">More...</a><br /></td></tr>
  89. <tr class="separator:a3f2736aa51c9b9456b8ad15d80502cf0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  90. <tr class="memitem:a22953dddd7b7c133d5fd067f197896c4"><td class="memItemLeft" align="right" valign="top">(void)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a22953dddd7b7c133d5fd067f197896c4">finish</a></td></tr>
  91. <tr class="memdesc:a22953dddd7b7c133d5fd067f197896c4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Finish the RPC request and half-close the call. <a href="interface_g_r_p_c_streaming_proto_call.html#a22953dddd7b7c133d5fd067f197896c4">More...</a><br /></td></tr>
  92. <tr class="separator:a22953dddd7b7c133d5fd067f197896c4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  93. <tr class="memitem:a520b480b583f74d2c5d1f584f7981d5a"><td class="memItemLeft" align="right" valign="top">(void)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a520b480b583f74d2c5d1f584f7981d5a">receiveNextMessage</a></td></tr>
  94. <tr class="memdesc:a520b480b583f74d2c5d1f584f7981d5a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Tell gRPC to receive another message. <a href="interface_g_r_p_c_streaming_proto_call.html#a520b480b583f74d2c5d1f584f7981d5a">More...</a><br /></td></tr>
  95. <tr class="separator:a520b480b583f74d2c5d1f584f7981d5a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  96. <tr class="memitem:a8692c9f0d29747cacad0474bb2e5c4a8"><td class="memItemLeft" align="right" valign="top">(void)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#a8692c9f0d29747cacad0474bb2e5c4a8">receiveNextMessages:</a></td></tr>
  97. <tr class="memdesc:a8692c9f0d29747cacad0474bb2e5c4a8"><td class="mdescLeft">&#160;</td><td class="mdescRight">Tell gRPC to receive another N message. <a href="interface_g_r_p_c_streaming_proto_call.html#a8692c9f0d29747cacad0474bb2e5c4a8">More...</a><br /></td></tr>
  98. <tr class="separator:a8692c9f0d29747cacad0474bb2e5c4a8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  99. </table><table class="memberdecls">
  100. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
  101. Class Methods</h2></td></tr>
  102. <tr class="memitem:ab43d01572f6ddd58272873299bd745b3"><td class="memItemLeft" align="right" valign="top">(instancetype)&#160;</td><td class="memItemRight" valign="bottom">+ <a class="el" href="interface_g_r_p_c_streaming_proto_call.html#ab43d01572f6ddd58272873299bd745b3">NS_UNAVAILABLE</a></td></tr>
  103. <tr class="separator:ab43d01572f6ddd58272873299bd745b3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  104. </table>
  105. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  106. <div class="textblock"><p>A client-streaming RPC call with Protobuf. </p>
  107. </div><h2 class="groupheader">Method Documentation</h2>
  108. <a id="a679f3d3373b0929c246f366458c24b99"></a>
  109. <h2 class="memtitle"><span class="permalink"><a href="#a679f3d3373b0929c246f366458c24b99">&#9670;&nbsp;</a></span>cancel</h2>
  110. <div class="memitem">
  111. <div class="memproto">
  112. <table class="memname">
  113. <tr>
  114. <td class="memname">- (void) cancel </td>
  115. <td></td>
  116. <td class="paramname"></td>
  117. <td></td>
  118. </tr>
  119. </table>
  120. </div><div class="memdoc">
  121. <p>Cancel the request of this call at best effort. </p>
  122. <p>It attempts to notify the server that the RPC should be cancelled, and issue didCloseWithTrailingMetadata:error: callback with error code CANCELED if no other error code has already been issued. </p>
  123. </div>
  124. </div>
  125. <a id="a22953dddd7b7c133d5fd067f197896c4"></a>
  126. <h2 class="memtitle"><span class="permalink"><a href="#a22953dddd7b7c133d5fd067f197896c4">&#9670;&nbsp;</a></span>finish</h2>
  127. <div class="memitem">
  128. <div class="memproto">
  129. <table class="memname">
  130. <tr>
  131. <td class="memname">- (void) finish </td>
  132. <td></td>
  133. <td class="paramname"></td>
  134. <td></td>
  135. </tr>
  136. </table>
  137. </div><div class="memdoc">
  138. <p>Finish the RPC request and half-close the call. </p>
  139. <p>The server may still send messages and/or trailers to the client. </p>
  140. </div>
  141. </div>
  142. <a id="a2b272ca4953cb12e26354f794c3fb7d7"></a>
  143. <h2 class="memtitle"><span class="permalink"><a href="#a2b272ca4953cb12e26354f794c3fb7d7">&#9670;&nbsp;</a></span>initWithRequestOptions:responseHandler:callOptions:responseClass:</h2>
  144. <div class="memitem">
  145. <div class="memproto">
  146. <table class="memname">
  147. <tr>
  148. <td class="memname">- (nullable instancetype) initWithRequestOptions: </td>
  149. <td></td>
  150. <td class="paramtype">(<a class="el" href="interface_g_r_p_c_request_options.html">GRPCRequestOptions</a> *)&#160;</td>
  151. <td class="paramname"><em>requestOptions</em></td>
  152. </tr>
  153. <tr>
  154. <td class="paramkey">responseHandler:</td>
  155. <td></td>
  156. <td class="paramtype">(id&lt; <a class="el" href="protocol_g_r_p_c_proto_response_handler-p.html">GRPCProtoResponseHandler</a> &gt;)&#160;</td>
  157. <td class="paramname"><em>handler</em></td>
  158. </tr>
  159. <tr>
  160. <td class="paramkey">callOptions:</td>
  161. <td></td>
  162. <td class="paramtype">(nullable <a class="el" href="interface_g_r_p_c_call_options.html">GRPCCallOptions</a> *)&#160;</td>
  163. <td class="paramname"><em>callOptions</em></td>
  164. </tr>
  165. <tr>
  166. <td class="paramkey">responseClass:</td>
  167. <td></td>
  168. <td class="paramtype">(Class)&#160;</td>
  169. <td class="paramname"><em>NS_DESIGNATED_INITIALIZER</em>&#160;</td>
  170. </tr>
  171. <tr>
  172. <td></td>
  173. <td></td>
  174. <td></td><td></td>
  175. </tr>
  176. </table>
  177. </div><div class="memdoc">
  178. <p>Users should not use this initializer directly. </p>
  179. <p>Call objects will be created, initialized, and returned to users by methods of the generated service. </p>
  180. </div>
  181. </div>
  182. <a id="ab43d01572f6ddd58272873299bd745b3"></a>
  183. <h2 class="memtitle"><span class="permalink"><a href="#ab43d01572f6ddd58272873299bd745b3">&#9670;&nbsp;</a></span>NS_UNAVAILABLE <span class="overload">[1/2]</span></h2>
  184. <div class="memitem">
  185. <div class="memproto">
  186. <table class="memname">
  187. <tr>
  188. <td class="memname">+ (instancetype) NS_UNAVAILABLE </td>
  189. <td></td>
  190. <td class="paramname"></td>
  191. <td></td>
  192. </tr>
  193. </table>
  194. </div><div class="memdoc">
  195. </div>
  196. </div>
  197. <a id="ab43d01572f6ddd58272873299bd745b3"></a>
  198. <h2 class="memtitle"><span class="permalink"><a href="#ab43d01572f6ddd58272873299bd745b3">&#9670;&nbsp;</a></span>NS_UNAVAILABLE <span class="overload">[2/2]</span></h2>
  199. <div class="memitem">
  200. <div class="memproto">
  201. <table class="memname">
  202. <tr>
  203. <td class="memname">- (instancetype) NS_UNAVAILABLE </td>
  204. <td></td>
  205. <td class="paramname"></td>
  206. <td></td>
  207. </tr>
  208. </table>
  209. </div><div class="memdoc">
  210. </div>
  211. </div>
  212. <a id="a520b480b583f74d2c5d1f584f7981d5a"></a>
  213. <h2 class="memtitle"><span class="permalink"><a href="#a520b480b583f74d2c5d1f584f7981d5a">&#9670;&nbsp;</a></span>receiveNextMessage</h2>
  214. <div class="memitem">
  215. <div class="memproto">
  216. <table class="memname">
  217. <tr>
  218. <td class="memname">- (void) receiveNextMessage </td>
  219. <td></td>
  220. <td class="paramname"></td>
  221. <td></td>
  222. </tr>
  223. </table>
  224. </div><div class="memdoc">
  225. <p>Tell gRPC to receive another message. </p>
  226. <p>This method should only be used when flow control is enabled. If flow control is enabled, gRPC will only receive additional messages after the user indicates so by using either receiveNextMessage: or receiveNextMessages: methods. If flow control is not enabled, messages will be automatically received after the previous one is delivered. </p>
  227. </div>
  228. </div>
  229. <a id="a8692c9f0d29747cacad0474bb2e5c4a8"></a>
  230. <h2 class="memtitle"><span class="permalink"><a href="#a8692c9f0d29747cacad0474bb2e5c4a8">&#9670;&nbsp;</a></span>receiveNextMessages:</h2>
  231. <div class="memitem">
  232. <div class="memproto">
  233. <table class="memname">
  234. <tr>
  235. <td class="memname">- (void) receiveNextMessages: </td>
  236. <td></td>
  237. <td class="paramtype">(NSUInteger)&#160;</td>
  238. <td class="paramname"><em>numberOfMessages</em></td>
  239. <td></td>
  240. </tr>
  241. </table>
  242. </div><div class="memdoc">
  243. <p>Tell gRPC to receive another N message. </p>
  244. <p>This method should only be used when flow control is enabled. If flow control is enabled, the messages received from the server are buffered in gRPC until the user want to receive the next message. If flow control is not enabled, messages will be automatically received after the previous one is delivered. </p>
  245. </div>
  246. </div>
  247. <a id="a1fb7aac765032282779cf83d438a938c"></a>
  248. <h2 class="memtitle"><span class="permalink"><a href="#a1fb7aac765032282779cf83d438a938c">&#9670;&nbsp;</a></span>start</h2>
  249. <div class="memitem">
  250. <div class="memproto">
  251. <table class="memname">
  252. <tr>
  253. <td class="memname">- (void) start </td>
  254. <td></td>
  255. <td class="paramname"></td>
  256. <td></td>
  257. </tr>
  258. </table>
  259. </div><div class="memdoc">
  260. <p>Start the call. </p>
  261. <p>This function must only be called once for each instance. </p>
  262. </div>
  263. </div>
  264. <a id="a3f2736aa51c9b9456b8ad15d80502cf0"></a>
  265. <h2 class="memtitle"><span class="permalink"><a href="#a3f2736aa51c9b9456b8ad15d80502cf0">&#9670;&nbsp;</a></span>writeMessage:</h2>
  266. <div class="memitem">
  267. <div class="memproto">
  268. <table class="memname">
  269. <tr>
  270. <td class="memname">- (void) writeMessage: </td>
  271. <td></td>
  272. <td class="paramtype">(GPBMessage *)&#160;</td>
  273. <td class="paramname"><em>message</em></td>
  274. <td></td>
  275. </tr>
  276. </table>
  277. </div><div class="memdoc">
  278. <p>Send a message to the server. </p>
  279. <p>The message should be a Protobuf message which will be serialized internally. </p>
  280. </div>
  281. </div>
  282. <hr/>The documentation for this class was generated from the following file:<ul>
  283. <li>src/objective-c/ProtoRPC/<a class="el" href="_proto_r_p_c_8h_source.html">ProtoRPC.h</a></li>
  284. </ul>
  285. </div><!-- contents -->
  286. <!-- start footer part -->
  287. <hr class="footer"/><address class="footer"><small>
  288. Generated on Wed Mar 3 2021 19:20:10 for GRPC Objective-C by &#160;<a href="http://www.doxygen.org/index.html">
  289. <img class="footer" src="doxygen.png" alt="doxygen"/>
  290. </a> 1.8.17
  291. </small></address>
  292. </body>
  293. </html>