Auth_OpenID_AX_FetchRequest.html 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title>Docs For Class Auth_OpenID_AX_FetchRequest</title>
  7. <link rel="stylesheet" href="../media/stylesheet.css" />
  8. <meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
  9. </head>
  10. <body>
  11. <div class="page-body">
  12. <h2 class="class-name">Class Auth_OpenID_AX_FetchRequest</h2>
  13. <a name="sec-description"></a>
  14. <div class="info-box">
  15. <div class="info-box-title">Description</div>
  16. <div class="nav-bar">
  17. <span class="disabled">Description</span> |
  18. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  19. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  20. </div>
  21. <div class="info-box-body">
  22. <!-- ========== Info from phpDoc block ========= -->
  23. <p class="short-description">An attribute exchange 'fetch_request' message. This message is sent by a relying party when it wishes to obtain attributes about the subject of an OpenID authentication request.</p>
  24. <p class="notes">
  25. Located in <a class="field" href="_Auth---OpenID---AX.php.html">/Auth/OpenID/AX.php</a> (line <span class="field">268</span>)
  26. </p>
  27. <pre><a href="../OpenID/Auth_OpenID_Extension.html">Auth_OpenID_Extension</a>
  28. |
  29. --<a href="../OpenID/Auth_OpenID_AX_Message.html">Auth_OpenID_AX_Message</a>
  30. |
  31. --Auth_OpenID_AX_FetchRequest</pre>
  32. </div>
  33. </div>
  34. <a name="sec-var-summary"></a>
  35. <div class="info-box">
  36. <div class="info-box-title">Variable Summary</span></div>
  37. <div class="nav-bar">
  38. <a href="#sec-description">Description</a> |
  39. <span class="disabled">Vars</span> (<a href="#sec-vars">details</a>)
  40. |
  41. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  42. </div>
  43. <div class="info-box-body">
  44. <div class="var-summary">
  45. <div class="var-title">
  46. <span class="var-type">mixed</span>
  47. <a href="#$mode" title="details" class="var-name">$mode</a>
  48. </div>
  49. </div>
  50. </div>
  51. </div>
  52. <a name="sec-method-summary"></a>
  53. <div class="info-box">
  54. <div class="info-box-title">Method Summary</span></div>
  55. <div class="nav-bar">
  56. <a href="#sec-description">Description</a> |
  57. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  58. |
  59. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  60. </div>
  61. <div class="info-box-body">
  62. <div class="method-summary">
  63. <div class="method-definition">
  64. <span class="method-result">Auth_OpenID_AX_FetchRequest</span>
  65. <a href="#Auth_OpenID_AX_FetchRequest" title="details" class="method-name">Auth_OpenID_AX_FetchRequest</a>
  66. ([<span class="var-type"></span>&nbsp;<span class="var-name">$update_url</span> = <span class="var-default">null</span>])
  67. </div>
  68. <div class="method-definition">
  69. <span class="method-result">true</span>
  70. <a href="#add" title="details" class="method-name">add</a>
  71. (<span class="var-type">attribute:</span>&nbsp;<span class="var-name">$attribute</span>)
  72. </div>
  73. <div class="method-definition">
  74. <span class="method-result">void</span>
  75. <a href="#contains" title="details" class="method-name">contains</a>
  76. (<span class="var-type"></span>&nbsp;<span class="var-name">$type_uri</span>)
  77. </div>
  78. <div class="method-definition">
  79. <span class="method-result">mixed</span>
  80. <a href="#fromOpenIDRequest" title="details" class="method-name">&amp;fromOpenIDRequest</a>
  81. (<span class="var-type">request:</span>&nbsp;<span class="var-name">$request</span>)
  82. </div>
  83. <div class="method-definition">
  84. <span class="method-result"><a href="../OpenID/Auth_OpenID_AX_FetchRequest.html">Auth_OpenID_AX_FetchRequest</a></span>
  85. <a href="#getExtensionArgs" title="details" class="method-name">getExtensionArgs</a>
  86. ()
  87. </div>
  88. <div class="method-definition">
  89. <span class="method-result">A</span>
  90. <a href="#getRequiredAttrs" title="details" class="method-name">getRequiredAttrs</a>
  91. ()
  92. </div>
  93. <div class="method-definition">
  94. <span class="method-result">void</span>
  95. <a href="#iterAttrs" title="details" class="method-name">iterAttrs</a>
  96. ()
  97. </div>
  98. <div class="method-definition">
  99. <span class="method-result">void</span>
  100. <a href="#iterTypes" title="details" class="method-name">iterTypes</a>
  101. ()
  102. </div>
  103. <div class="method-definition">
  104. <span class="method-result">$result</span>
  105. <a href="#parseExtensionArgs" title="details" class="method-name">parseExtensionArgs</a>
  106. (<span class="var-type"></span>&nbsp;<span class="var-name">$ax_args</span>)
  107. </div>
  108. </div>
  109. </div>
  110. </div>
  111. <a name="sec-vars"></a>
  112. <div class="info-box">
  113. <div class="info-box-title">Variables</div>
  114. <div class="nav-bar">
  115. <a href="#sec-description">Description</a> |
  116. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  117. |
  118. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  119. </div>
  120. <div class="info-box-body">
  121. <a name="var$mode" id="$mode"><!-- --></A>
  122. <div class="oddrow">
  123. <div class="var-header">
  124. <span class="var-title">
  125. <span class="var-type">mixed</span>
  126. <span class="var-name">$mode</span>
  127. = <span class="var-default"> 'fetch_request'</span> (line <span class="line-number">270</span>)
  128. </span>
  129. </div>
  130. <!-- ========== Info from phpDoc block ========= -->
  131. <hr class="separator" />
  132. <div class="notes">Redefinition of:</div>
  133. <dl>
  134. <dt><a href="../OpenID/Auth_OpenID_AX_Message.html#var$mode">Auth_OpenID_AX_Message::$mode</a></dt>
  135. <dd>mode: The type of this attribute exchange message. This must be overridden in subclasses.</dd>
  136. </dl>
  137. </div>
  138. <h4>Inherited Variables</h4>
  139. <A NAME='inherited_vars'><!-- --></A>
  140. <p>Inherited from <span class="classname"><a href="../OpenID/Auth_OpenID_AX_Message.html">Auth_OpenID_AX_Message</a></span></p>
  141. <blockquote>
  142. <span class="var-title">
  143. <span class="var-name"><a href="../OpenID/Auth_OpenID_AX_Message.html#var$ns_alias">Auth_OpenID_AX_Message::$ns_alias</a></span><br>
  144. </span>
  145. <span class="var-title">
  146. <span class="var-name"><a href="../OpenID/Auth_OpenID_AX_Message.html#var$ns_uri">Auth_OpenID_AX_Message::$ns_uri</a></span><br>
  147. </span>
  148. </blockquote>
  149. </div>
  150. </div>
  151. <a name="sec-methods"></a>
  152. <div class="info-box">
  153. <div class="info-box-title">Methods</div>
  154. <div class="nav-bar">
  155. <a href="#sec-description">Description</a> |
  156. <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
  157. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  158. </div>
  159. <div class="info-box-body">
  160. <A NAME='method_detail'></A>
  161. <a name="methodAuth_OpenID_AX_FetchRequest" id="Auth_OpenID_AX_FetchRequest"><!-- --></a>
  162. <div class="evenrow">
  163. <div class="method-header">
  164. <span class="method-title">Constructor Auth_OpenID_AX_FetchRequest</span> (line <span class="line-number">272</span>)
  165. </div>
  166. <!-- ========== Info from phpDoc block ========= -->
  167. <div class="method-signature">
  168. <span class="method-result">Auth_OpenID_AX_FetchRequest</span>
  169. <span class="method-name">
  170. Auth_OpenID_AX_FetchRequest
  171. </span>
  172. ([<span class="var-type"></span>&nbsp;<span class="var-name">$update_url</span> = <span class="var-default">null</span>])
  173. </div>
  174. <ul class="parameters">
  175. <li>
  176. <span class="var-type"></span>
  177. <span class="var-name">$update_url</span> </li>
  178. </ul>
  179. </div>
  180. <a name="methodadd" id="add"><!-- --></a>
  181. <div class="oddrow">
  182. <div class="method-header">
  183. <span class="method-title">add</span> (line <span class="line-number">295</span>)
  184. </div>
  185. <!-- ========== Info from phpDoc block ========= -->
  186. <p class="short-description">Add an attribute to this attribute exchange request.</p>
  187. <ul class="tags">
  188. <li><span class="field">return:</span> on success, false when the requested attribute is already present in this fetch request.</li>
  189. </ul>
  190. <div class="method-signature">
  191. <span class="method-result">true</span>
  192. <span class="method-name">
  193. add
  194. </span>
  195. (<span class="var-type">attribute:</span>&nbsp;<span class="var-name">$attribute</span>)
  196. </div>
  197. <ul class="parameters">
  198. <li>
  199. <span class="var-type">attribute:</span>
  200. <span class="var-name">$attribute</span><span class="var-description">: The attribute that is being requested</span> </li>
  201. </ul>
  202. </div>
  203. <a name="methodcontains" id="contains"><!-- --></a>
  204. <div class="evenrow">
  205. <div class="method-header">
  206. <span class="method-title">contains</span> (line <span class="line-number">528</span>)
  207. </div>
  208. <!-- ========== Info from phpDoc block ========= -->
  209. <p class="short-description">Is the given type URI present in this fetch_request?</p>
  210. <div class="method-signature">
  211. <span class="method-result">void</span>
  212. <span class="method-name">
  213. contains
  214. </span>
  215. (<span class="var-type"></span>&nbsp;<span class="var-name">$type_uri</span>)
  216. </div>
  217. <ul class="parameters">
  218. <li>
  219. <span class="var-type"></span>
  220. <span class="var-name">$type_uri</span> </li>
  221. </ul>
  222. </div>
  223. <a name="methodfromOpenIDRequest" id="fromOpenIDRequest"><!-- --></a>
  224. <div class="oddrow">
  225. <div class="method-header">
  226. <span class="method-title">fromOpenIDRequest</span> (line <span class="line-number">389</span>)
  227. </div>
  228. <!-- ========== Info from phpDoc block ========= -->
  229. <p class="short-description">Extract a FetchRequest from an OpenID message</p>
  230. <ul class="tags">
  231. <li><span class="field">return:</span> An Auth_OpenID_AX_Error or the Auth_OpenID_AX_FetchRequest extracted from the request message if successful</li>
  232. </ul>
  233. <div class="method-signature">
  234. <span class="method-result">mixed</span>
  235. <span class="method-name">
  236. &amp;fromOpenIDRequest
  237. </span>
  238. (<span class="var-type">request:</span>&nbsp;<span class="var-name">$request</span>)
  239. </div>
  240. <ul class="parameters">
  241. <li>
  242. <span class="var-type">request:</span>
  243. <span class="var-name">$request</span><span class="var-description">: The OpenID request containing the attribute fetch request</span> </li>
  244. </ul>
  245. </div>
  246. <a name="methodgetExtensionArgs" id="getExtensionArgs"><!-- --></a>
  247. <div class="evenrow">
  248. <div class="method-header">
  249. <span class="method-title">getExtensionArgs</span> (line <span class="line-number">313</span>)
  250. </div>
  251. <!-- ========== Info from phpDoc block ========= -->
  252. <p class="short-description">Get the serialized form of this attribute fetch request.</p>
  253. <ul class="tags">
  254. <li><span class="field">return:</span> The fetch request message parameters</li>
  255. </ul>
  256. <div class="method-signature">
  257. <span class="method-result"><a href="../OpenID/Auth_OpenID_AX_FetchRequest.html">Auth_OpenID_AX_FetchRequest</a></span>
  258. <span class="method-name">
  259. getExtensionArgs
  260. </span>
  261. ()
  262. </div>
  263. <hr class="separator" />
  264. <div class="notes">Redefinition of:</div>
  265. <dl>
  266. <dt><a href="../OpenID/Auth_OpenID_Extension.html#methodgetExtensionArgs">Auth_OpenID_Extension::getExtensionArgs()</a></dt>
  267. <dd>Get the string arguments that should be added to an OpenID message for this extension.</dd>
  268. </dl>
  269. </div>
  270. <a name="methodgetRequiredAttrs" id="getRequiredAttrs"><!-- --></a>
  271. <div class="oddrow">
  272. <div class="method-header">
  273. <span class="method-title">getRequiredAttrs</span> (line <span class="line-number">367</span>)
  274. </div>
  275. <!-- ========== Info from phpDoc block ========= -->
  276. <p class="short-description">Get the type URIs for all attributes that have been marked as required.</p>
  277. <ul class="tags">
  278. <li><span class="field">return:</span> list of the type URIs for attributes that have been marked as required.</li>
  279. </ul>
  280. <div class="method-signature">
  281. <span class="method-result">A</span>
  282. <span class="method-name">
  283. getRequiredAttrs
  284. </span>
  285. ()
  286. </div>
  287. </div>
  288. <a name="methoditerAttrs" id="iterAttrs"><!-- --></a>
  289. <div class="evenrow">
  290. <div class="method-header">
  291. <span class="method-title">iterAttrs</span> (line <span class="line-number">515</span>)
  292. </div>
  293. <!-- ========== Info from phpDoc block ========= -->
  294. <p class="short-description">Iterate over the AttrInfo objects that are contained in this fetch_request.</p>
  295. <div class="method-signature">
  296. <span class="method-result">void</span>
  297. <span class="method-name">
  298. iterAttrs
  299. </span>
  300. ()
  301. </div>
  302. </div>
  303. <a name="methoditerTypes" id="iterTypes"><!-- --></a>
  304. <div class="oddrow">
  305. <div class="method-header">
  306. <span class="method-title">iterTypes</span> (line <span class="line-number">520</span>)
  307. </div>
  308. <!-- ========== Info from phpDoc block ========= -->
  309. <div class="method-signature">
  310. <span class="method-result">void</span>
  311. <span class="method-name">
  312. iterTypes
  313. </span>
  314. ()
  315. </div>
  316. </div>
  317. <a name="methodparseExtensionArgs" id="parseExtensionArgs"><!-- --></a>
  318. <div class="evenrow">
  319. <div class="method-header">
  320. <span class="method-title">parseExtensionArgs</span> (line <span class="line-number">432</span>)
  321. </div>
  322. <!-- ========== Info from phpDoc block ========= -->
  323. <p class="short-description">Given attribute exchange arguments, populate this FetchRequest.</p>
  324. <ul class="tags">
  325. <li><span class="field">return:</span> Auth_OpenID_AX_Error if the data to be parsed does not follow the attribute exchange specification. At least when 'if_available' or 'required' is not specified for a particular attribute type. Returns true otherwise.</li>
  326. </ul>
  327. <div class="method-signature">
  328. <span class="method-result">$result</span>
  329. <span class="method-name">
  330. parseExtensionArgs
  331. </span>
  332. (<span class="var-type"></span>&nbsp;<span class="var-name">$ax_args</span>)
  333. </div>
  334. <ul class="parameters">
  335. <li>
  336. <span class="var-type"></span>
  337. <span class="var-name">$ax_args</span> </li>
  338. </ul>
  339. </div>
  340. <h4>Inherited Methods</h4>
  341. <a name='inherited_methods'><!-- --></a>
  342. <!-- =========== Summary =========== -->
  343. <p>Inherited From <span class="classname"><a href="../OpenID/Auth_OpenID_Extension.html">Auth_OpenID_Extension</a></span></p>
  344. <blockquote>
  345. <span class="method-name"><a href="../OpenID/Auth_OpenID_Extension.html#methodgetExtensionArgs">Auth_OpenID_Extension::getExtensionArgs()</a></span><br>
  346. <span class="method-name"><a href="../OpenID/Auth_OpenID_Extension.html#methodtoMessage">Auth_OpenID_Extension::toMessage()</a></span><br>
  347. </blockquote>
  348. </div>
  349. </div>
  350. <p class="notes" id="credit">
  351. Documentation generated on Tue, 21 Apr 2009 11:31:29 -0700 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.3.2</a>
  352. </p>
  353. </div></body>
  354. </html>