class-Grpc.BaseStub.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Class Grpc\BaseStub</title>
  6. <link rel="stylesheet" href="resources/style.css?e99947befd7bf673c6b43ff75e9e0f170c88a60e">
  7. </head>
  8. <body>
  9. <div id="left">
  10. <div id="menu">
  11. <a href="index.html" title="Overview"><span>Overview</span></a>
  12. <div id="groups">
  13. <h3>Namespaces</h3>
  14. <ul>
  15. <li class="active">
  16. <a href="namespace-Grpc.html">
  17. Grpc </a>
  18. </li>
  19. </ul>
  20. </div>
  21. <hr>
  22. <div id="elements">
  23. <h3>Classes</h3>
  24. <ul>
  25. <li><a href="class-Grpc.AbstractCall.html">AbstractCall</a></li>
  26. <li class="active"><a href="class-Grpc.BaseStub.html">BaseStub</a></li>
  27. <li><a href="class-Grpc.BidiStreamingCall.html">BidiStreamingCall</a></li>
  28. <li><a href="class-Grpc.ClientStreamingCall.html">ClientStreamingCall</a></li>
  29. <li><a href="class-Grpc.ServerStreamingCall.html">ServerStreamingCall</a></li>
  30. <li><a href="class-Grpc.UnaryCall.html">UnaryCall</a></li>
  31. </ul>
  32. </div>
  33. </div>
  34. </div>
  35. <div id="splitter"></div>
  36. <div id="right">
  37. <div id="rightInner">
  38. <form id="search">
  39. <input type="hidden" name="cx" value="">
  40. <input type="hidden" name="ie" value="UTF-8">
  41. <input type="text" name="q" class="text" placeholder="Search">
  42. </form>
  43. <div id="navigation">
  44. <ul>
  45. <li>
  46. <a href="index.html" title="Overview"><span>Overview</span></a>
  47. </li>
  48. <li>
  49. <a href="namespace-Grpc.html" title="Summary of Grpc"><span>Namespace</span></a>
  50. </li>
  51. <li class="active">
  52. <span>Class</span> </li>
  53. </ul>
  54. <ul>
  55. </ul>
  56. <ul>
  57. </ul>
  58. </div>
  59. <div id="content" class="class">
  60. <h1>Class BaseStub</h1>
  61. <div class="description">
  62. <p>Base class for generated client stubs. Stub methods are expected to call
  63. _simpleRequest or _streamRequest and return the result.</p>
  64. </div>
  65. <div class="info">
  66. <b>Namespace:</b> <a href="namespace-Grpc.html">Grpc</a><br>
  67. <b>Located at</b> <a href="source-class-Grpc.BaseStub.html#37-363" title="Go to source code">BaseStub.php</a>
  68. <br>
  69. </div>
  70. <table class="summary methods" id="methods">
  71. <caption>Methods summary</caption>
  72. <tr data-order="__construct" id="___construct">
  73. <td class="attributes"><code>
  74. public
  75. </code>
  76. </td>
  77. <td class="name"><div>
  78. <a class="anchor" href="#___construct">#</a>
  79. <code><a href="source-class-Grpc.BaseStub.html#50-98" title="Go to source code">__construct</a>( <span>string <var>$hostname</var></span>, <span>array <var>$opts</var></span>, <span>Grpc\Channel <var>$channel</var> = <span class="php-keyword1">null</span></span> )</code>
  80. <div class="description short">
  81. </div>
  82. <div class="description detailed hidden">
  83. <h4>Parameters</h4>
  84. <div class="list"><dl>
  85. <dt><var>$hostname</var></dt>
  86. <dd></dd>
  87. <dt><var>$opts</var></dt>
  88. <dd><ul>
  89. <li>'update_metadata': (optional) a callback function which takes in a
  90. metadata array, and returns an updated metadata array
  91. <ul>
  92. <li>'grpc.primary_user_agent': (optional) a user-agent string</li>
  93. </ul></li>
  94. </ul></dd>
  95. <dt><var>$channel</var></dt>
  96. <dd>An already created Channel object (optional)</dd>
  97. </dl></div>
  98. </div>
  99. </div></td>
  100. </tr>
  101. <tr data-order="getTarget" id="_getTarget">
  102. <td class="attributes"><code>
  103. public
  104. string
  105. </code>
  106. </td>
  107. <td class="name"><div>
  108. <a class="anchor" href="#_getTarget">#</a>
  109. <code><a href="source-class-Grpc.BaseStub.html#100-106" title="Go to source code">getTarget</a>( )</code>
  110. <div class="description short">
  111. </div>
  112. <div class="description detailed hidden">
  113. <h4>Returns</h4>
  114. <div class="list">
  115. string<br>The URI of the endpoint
  116. </div>
  117. </div>
  118. </div></td>
  119. </tr>
  120. <tr data-order="getConnectivityState" id="_getConnectivityState">
  121. <td class="attributes"><code>
  122. public
  123. integer
  124. </code>
  125. </td>
  126. <td class="name"><div>
  127. <a class="anchor" href="#_getConnectivityState">#</a>
  128. <code><a href="source-class-Grpc.BaseStub.html#108-116" title="Go to source code">getConnectivityState</a>( <span>boolean <var>$try_to_connect</var> = <span class="php-keyword1">false</span></span> )</code>
  129. <div class="description short">
  130. </div>
  131. <div class="description detailed hidden">
  132. <h4>Parameters</h4>
  133. <div class="list"><dl>
  134. <dt><var>$try_to_connect</var></dt>
  135. <dd>(optional)</dd>
  136. </dl></div>
  137. <h4>Returns</h4>
  138. <div class="list">
  139. integer<br>The grpc connectivity state
  140. </div>
  141. </div>
  142. </div></td>
  143. </tr>
  144. <tr data-order="waitForReady" id="_waitForReady">
  145. <td class="attributes"><code>
  146. public
  147. boolean
  148. </code>
  149. </td>
  150. <td class="name"><div>
  151. <a class="anchor" href="#_waitForReady">#</a>
  152. <code><a href="source-class-Grpc.BaseStub.html#118-146" title="Go to source code">waitForReady</a>( <span>integer <var>$timeout</var></span> )</code>
  153. <div class="description short">
  154. </div>
  155. <div class="description detailed hidden">
  156. <h4>Parameters</h4>
  157. <div class="list"><dl>
  158. <dt><var>$timeout</var></dt>
  159. <dd>in microseconds</dd>
  160. </dl></div>
  161. <h4>Returns</h4>
  162. <div class="list">
  163. boolean<br>true if channel is ready
  164. </div>
  165. <h4>Throw</h4>
  166. <div class="list">
  167. Exception if channel is in FATAL_ERROR state<br>
  168. </div>
  169. </div>
  170. </div></td>
  171. </tr>
  172. <tr data-order="close" id="_close">
  173. <td class="attributes"><code>
  174. public
  175. </code>
  176. </td>
  177. <td class="name"><div>
  178. <a class="anchor" href="#_close">#</a>
  179. <code><a href="source-class-Grpc.BaseStub.html#148-154" title="Go to source code">close</a>( )</code>
  180. <div class="description short">
  181. <p>Close the communication channel associated with this stub.</p>
  182. </div>
  183. <div class="description detailed hidden">
  184. <p>Close the communication channel associated with this stub.</p>
  185. </div>
  186. </div></td>
  187. </tr>
  188. <tr data-order="_simpleRequest" id="__simpleRequest">
  189. <td class="attributes"><code>
  190. protected
  191. SimpleSurfaceActiveCall
  192. </code>
  193. </td>
  194. <td class="name"><div>
  195. <a class="anchor" href="#__simpleRequest">#</a>
  196. <code><a href="source-class-Grpc.BaseStub.html#225-259" title="Go to source code">_simpleRequest</a>( <span>string <var>$method</var></span>, <span>mixed <var>$argument</var></span>, <span>callable <var>$deserialize</var></span>, <span>array <var>$metadata</var> = []</span>, <span>array <var>$options</var> = []</span> )</code>
  197. <div class="description short">
  198. <p>Call a remote method that takes a single argument and has a
  199. single output.</p>
  200. </div>
  201. <div class="description detailed hidden">
  202. <p>Call a remote method that takes a single argument and has a
  203. single output.</p>
  204. <h4>Parameters</h4>
  205. <div class="list"><dl>
  206. <dt><var>$method</var></dt>
  207. <dd>The name of the method to call</dd>
  208. <dt><var>$argument</var></dt>
  209. <dd>The argument to the method</dd>
  210. <dt><var>$deserialize</var></dt>
  211. <dd>A function that deserializes the response</dd>
  212. <dt><var>$metadata</var></dt>
  213. <dd><p>A metadata map to send to the server
  214. (optional)</p></dd>
  215. <dt><var>$options</var></dt>
  216. <dd>An array of options (optional)</dd>
  217. </dl></div>
  218. <h4>Returns</h4>
  219. <div class="list">
  220. SimpleSurfaceActiveCall<br>The active call object
  221. </div>
  222. </div>
  223. </div></td>
  224. </tr>
  225. <tr data-order="_clientStreamRequest" id="__clientStreamRequest">
  226. <td class="attributes"><code>
  227. protected
  228. ClientStreamingSurfaceActiveCall
  229. </code>
  230. </td>
  231. <td class="name"><div>
  232. <a class="anchor" href="#__clientStreamRequest">#</a>
  233. <code><a href="source-class-Grpc.BaseStub.html#261-293" title="Go to source code">_clientStreamRequest</a>( <span>string <var>$method</var></span>, <span>callable <var>$deserialize</var></span>, <span>array <var>$metadata</var> = []</span>, <span>array <var>$options</var> = []</span> )</code>
  234. <div class="description short">
  235. <p>Call a remote method that takes a stream of arguments and has a single
  236. output.</p>
  237. </div>
  238. <div class="description detailed hidden">
  239. <p>Call a remote method that takes a stream of arguments and has a single
  240. output.</p>
  241. <h4>Parameters</h4>
  242. <div class="list"><dl>
  243. <dt><var>$method</var></dt>
  244. <dd>The name of the method to call</dd>
  245. <dt><var>$deserialize</var></dt>
  246. <dd>A function that deserializes the response</dd>
  247. <dt><var>$metadata</var></dt>
  248. <dd><p>A metadata map to send to the server
  249. (optional)</p></dd>
  250. <dt><var>$options</var></dt>
  251. <dd>An array of options (optional)</dd>
  252. </dl></div>
  253. <h4>Returns</h4>
  254. <div class="list">
  255. ClientStreamingSurfaceActiveCall<br>The active call object
  256. </div>
  257. </div>
  258. </div></td>
  259. </tr>
  260. <tr data-order="_serverStreamRequest" id="__serverStreamRequest">
  261. <td class="attributes"><code>
  262. protected
  263. ServerStreamingSurfaceActiveCall
  264. </code>
  265. </td>
  266. <td class="name"><div>
  267. <a class="anchor" href="#__serverStreamRequest">#</a>
  268. <code><a href="source-class-Grpc.BaseStub.html#295-329" title="Go to source code">_serverStreamRequest</a>( <span>string <var>$method</var></span>, <span>mixed <var>$argument</var></span>, <span>callable <var>$deserialize</var></span>, <span>array <var>$metadata</var> = []</span>, <span>array <var>$options</var> = []</span> )</code>
  269. <div class="description short">
  270. <p>Call a remote method that takes a single argument and returns a stream
  271. of responses.</p>
  272. </div>
  273. <div class="description detailed hidden">
  274. <p>Call a remote method that takes a single argument and returns a stream
  275. of responses.</p>
  276. <h4>Parameters</h4>
  277. <div class="list"><dl>
  278. <dt><var>$method</var></dt>
  279. <dd>The name of the method to call</dd>
  280. <dt><var>$argument</var></dt>
  281. <dd>The argument to the method</dd>
  282. <dt><var>$deserialize</var></dt>
  283. <dd>A function that deserializes the responses</dd>
  284. <dt><var>$metadata</var></dt>
  285. <dd><p>A metadata map to send to the server
  286. (optional)</p></dd>
  287. <dt><var>$options</var></dt>
  288. <dd>An array of options (optional)</dd>
  289. </dl></div>
  290. <h4>Returns</h4>
  291. <div class="list">
  292. ServerStreamingSurfaceActiveCall<br>The active call object
  293. </div>
  294. </div>
  295. </div></td>
  296. </tr>
  297. <tr data-order="_bidiRequest" id="__bidiRequest">
  298. <td class="attributes"><code>
  299. protected
  300. BidiStreamingSurfaceActiveCall
  301. </code>
  302. </td>
  303. <td class="name"><div>
  304. <a class="anchor" href="#__bidiRequest">#</a>
  305. <code><a href="source-class-Grpc.BaseStub.html#331-362" title="Go to source code">_bidiRequest</a>( <span>string <var>$method</var></span>, <span>callable <var>$deserialize</var></span>, <span>array <var>$metadata</var> = []</span>, <span>array <var>$options</var> = []</span> )</code>
  306. <div class="description short">
  307. <p>Call a remote method with messages streaming in both directions.</p>
  308. </div>
  309. <div class="description detailed hidden">
  310. <p>Call a remote method with messages streaming in both directions.</p>
  311. <h4>Parameters</h4>
  312. <div class="list"><dl>
  313. <dt><var>$method</var></dt>
  314. <dd>The name of the method to call</dd>
  315. <dt><var>$deserialize</var></dt>
  316. <dd>A function that deserializes the responses</dd>
  317. <dt><var>$metadata</var></dt>
  318. <dd><p>A metadata map to send to the server
  319. (optional)</p></dd>
  320. <dt><var>$options</var></dt>
  321. <dd>An array of options (optional)</dd>
  322. </dl></div>
  323. <h4>Returns</h4>
  324. <div class="list">
  325. BidiStreamingSurfaceActiveCall<br>The active call object
  326. </div>
  327. </div>
  328. </div></td>
  329. </tr>
  330. </table>
  331. </div>
  332. <div id="footer">
  333. API documentation generated by <a href="http://apigen.org">ApiGen</a>
  334. </div>
  335. </div>
  336. </div>
  337. <script src="resources/combined.js"></script>
  338. <script src="elementlist.js"></script>
  339. </body>
  340. </html>