Auth_OpenID_AX_KeyValueMessage.html 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401
  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_KeyValueMessage</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_KeyValueMessage</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-descendents">Descendents</a>
  19. | <a href="#sec-vars">Vars</a>
  20. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  21. </div>
  22. <div class="info-box-body">
  23. <!-- ========== Info from phpDoc block ========= -->
  24. <p class="short-description">An abstract class that implements a message that has attribute keys and values. It contains the common code between fetch_response and store_request.</p>
  25. <p class="notes">
  26. Located in <a class="field" href="_Auth---OpenID---AX.php.html">/Auth/OpenID/AX.php</a> (line <span class="field">541</span>)
  27. </p>
  28. <pre><a href="../OpenID/Auth_OpenID_Extension.html">Auth_OpenID_Extension</a>
  29. |
  30. --<a href="../OpenID/Auth_OpenID_AX_Message.html">Auth_OpenID_AX_Message</a>
  31. |
  32. --Auth_OpenID_AX_KeyValueMessage</pre>
  33. </div>
  34. </div>
  35. <a name="sec-descendents"></a>
  36. <div class="info-box">
  37. <div class="info-box-title">Direct descendents</div>
  38. <div class="nav-bar">
  39. <a href="#sec-description">Description</a> |
  40. <span class="disabled">Descendents</span>
  41. | <a href="#sec-vars">Vars</a>
  42. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  43. </div>
  44. <div class="info-box-body">
  45. <table cellpadding="2" cellspacing="0" class="class-table">
  46. <tr>
  47. <th class="class-table-header">Class</th>
  48. <th class="class-table-header">Description</th>
  49. </tr>
  50. <tr>
  51. <td style="padding-right: 2em"><a href="../OpenID/Auth_OpenID_AX_FetchResponse.html">Auth_OpenID_AX_FetchResponse</a></td>
  52. <td>
  53. A fetch_response attribute exchange message.
  54. </td>
  55. </tr>
  56. <tr>
  57. <td style="padding-right: 2em"><a href="../OpenID/Auth_OpenID_AX_StoreRequest.html">Auth_OpenID_AX_StoreRequest</a></td>
  58. <td>
  59. A store request attribute exchange message representation.
  60. </td>
  61. </tr>
  62. </table>
  63. </div>
  64. </div>
  65. <a name="sec-method-summary"></a>
  66. <div class="info-box">
  67. <div class="info-box-title">Method Summary</span></div>
  68. <div class="nav-bar">
  69. <a href="#sec-description">Description</a> |
  70. <a href="#sec-descendents">Descendents</a> |
  71. <a href="#sec-vars">Vars</a>
  72. |
  73. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  74. </div>
  75. <div class="info-box-body">
  76. <div class="method-summary">
  77. <div class="method-definition">
  78. <span class="method-result">Auth_OpenID_AX_KeyValueMessage</span>
  79. <a href="#Auth_OpenID_AX_KeyValueMessage" title="details" class="method-name">Auth_OpenID_AX_KeyValueMessage</a>
  80. ()
  81. </div>
  82. <div class="method-definition">
  83. <span class="method-result">null</span>
  84. <a href="#addValue" title="details" class="method-name">addValue</a>
  85. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>, <span class="var-type">value:</span>&nbsp;<span class="var-name">$value</span>)
  86. </div>
  87. <div class="method-definition">
  88. <span class="method-result">int</span>
  89. <a href="#count" title="details" class="method-name">count</a>
  90. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>)
  91. </div>
  92. <div class="method-definition">
  93. <span class="method-result">$values</span>
  94. <a href="#get" title="details" class="method-name">get</a>
  95. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>)
  96. </div>
  97. <div class="method-definition">
  98. <span class="method-result">$value</span>
  99. <a href="#getSingle" title="details" class="method-name">getSingle</a>
  100. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>, [<span class="var-type">default:</span>&nbsp;<span class="var-name">$default</span> = <span class="var-default">null</span>])
  101. </div>
  102. <div class="method-definition">
  103. <span class="method-result"><a href="../OpenID/Auth_OpenID_AX_Error.html">Auth_OpenID_AX_Error</a></span>
  104. <a href="#parseExtensionArgs" title="details" class="method-name">parseExtensionArgs</a>
  105. (<span class="var-type">ax_args:</span>&nbsp;<span class="var-name">$ax_args</span>)
  106. </div>
  107. <div class="method-definition">
  108. <span class="method-result">void</span>
  109. <a href="#setValues" title="details" class="method-name">setValues</a>
  110. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>, <span class="var-type">values:</span>&nbsp;<span class="var-name">&$values</span>)
  111. </div>
  112. </div>
  113. </div>
  114. </div>
  115. <a name="sec-vars"></a>
  116. <div class="info-box">
  117. <div class="info-box-title">Variables</div>
  118. <div class="nav-bar">
  119. <a href="#sec-description">Description</a> |
  120. <a href="#sec-descendents">Descendents</a> |
  121. <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
  122. |
  123. <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  124. </div>
  125. <div class="info-box-body">
  126. <h4>Inherited Variables</h4>
  127. <A NAME='inherited_vars'><!-- --></A>
  128. <p>Inherited from <span class="classname"><a href="../OpenID/Auth_OpenID_AX_Message.html">Auth_OpenID_AX_Message</a></span></p>
  129. <blockquote>
  130. <span class="var-title">
  131. <span class="var-name"><a href="../OpenID/Auth_OpenID_AX_Message.html#var$mode">Auth_OpenID_AX_Message::$mode</a></span><br>
  132. </span>
  133. <span class="var-title">
  134. <span class="var-name"><a href="../OpenID/Auth_OpenID_AX_Message.html#var$ns_alias">Auth_OpenID_AX_Message::$ns_alias</a></span><br>
  135. </span>
  136. <span class="var-title">
  137. <span class="var-name"><a href="../OpenID/Auth_OpenID_AX_Message.html#var$ns_uri">Auth_OpenID_AX_Message::$ns_uri</a></span><br>
  138. </span>
  139. </blockquote>
  140. </div>
  141. </div>
  142. <a name="sec-methods"></a>
  143. <div class="info-box">
  144. <div class="info-box-title">Methods</div>
  145. <div class="nav-bar">
  146. <a href="#sec-description">Description</a> |
  147. <a href="#sec-descendents">Descendents</a> |
  148. <a href="#sec-vars">Vars</a>
  149. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  150. </div>
  151. <div class="info-box-body">
  152. <A NAME='method_detail'></A>
  153. <a name="methodAuth_OpenID_AX_KeyValueMessage" id="Auth_OpenID_AX_KeyValueMessage"><!-- --></a>
  154. <div class="evenrow">
  155. <div class="method-header">
  156. <span class="method-title">Constructor Auth_OpenID_AX_KeyValueMessage</span> (line <span class="line-number">543</span>)
  157. </div>
  158. <!-- ========== Info from phpDoc block ========= -->
  159. <div class="method-signature">
  160. <span class="method-result">Auth_OpenID_AX_KeyValueMessage</span>
  161. <span class="method-name">
  162. Auth_OpenID_AX_KeyValueMessage
  163. </span>
  164. ()
  165. </div>
  166. </div>
  167. <a name="methodaddValue" id="addValue"><!-- --></a>
  168. <div class="oddrow">
  169. <div class="method-header">
  170. <span class="method-title">addValue</span> (line <span class="line-number">559</span>)
  171. </div>
  172. <!-- ========== Info from phpDoc block ========= -->
  173. <p class="short-description">Add a single value for the given attribute type to the message. If there are already values specified for this type, this value will be sent in addition to the values already specified.</p>
  174. <div class="method-signature">
  175. <span class="method-result">null</span>
  176. <span class="method-name">
  177. addValue
  178. </span>
  179. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>, <span class="var-type">value:</span>&nbsp;<span class="var-name">$value</span>)
  180. </div>
  181. <ul class="parameters">
  182. <li>
  183. <span class="var-type">type_uri:</span>
  184. <span class="var-name">$type_uri</span><span class="var-description">: The URI for the attribute</span> </li>
  185. <li>
  186. <span class="var-type">value:</span>
  187. <span class="var-name">$value</span><span class="var-description">: The value to add to the response to the relying party for this attribute</span> </li>
  188. </ul>
  189. </div>
  190. <a name="methodcount" id="count"><!-- --></a>
  191. <div class="evenrow">
  192. <div class="method-header">
  193. <span class="method-title">count</span> (line <span class="line-number">775</span>)
  194. </div>
  195. <!-- ========== Info from phpDoc block ========= -->
  196. <p class="short-description">Get the number of responses for a particular attribute in this fetch_response message.</p>
  197. <ul class="tags">
  198. <li><span class="field">return:</span> The number of values sent for this attribute. If the attribute was not sent in the response, returns Auth_OpenID_AX_Error.</li>
  199. </ul>
  200. <div class="method-signature">
  201. <span class="method-result">int</span>
  202. <span class="method-name">
  203. count
  204. </span>
  205. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>)
  206. </div>
  207. <ul class="parameters">
  208. <li>
  209. <span class="var-type">type_uri:</span>
  210. <span class="var-name">$type_uri</span><span class="var-description">: The URI of the attribute</span> </li>
  211. </ul>
  212. </div>
  213. <a name="methodget" id="get"><!-- --></a>
  214. <div class="oddrow">
  215. <div class="method-header">
  216. <span class="method-title">get</span> (line <span class="line-number">753</span>)
  217. </div>
  218. <!-- ========== Info from phpDoc block ========= -->
  219. <p class="short-description">Get the list of values for this attribute in the fetch_response.</p>
  220. <p class="description"><p>XXX: what to do if the values are not present? default parameter? this is funny because it's always supposed to return a list, so the default may break that, though it's provided by the user's code, so it might be okay. If no default is supplied, should the return be None or []?</p></p>
  221. <ul class="tags">
  222. <li><span class="field">return:</span> The list of values for this attribute in the response. May be an empty list. If the attribute was not sent in the response, returns Auth_OpenID_AX_Error.</li>
  223. </ul>
  224. <div class="method-signature">
  225. <span class="method-result">$values</span>
  226. <span class="method-name">
  227. get
  228. </span>
  229. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>)
  230. </div>
  231. <ul class="parameters">
  232. <li>
  233. <span class="var-type">type_uri:</span>
  234. <span class="var-name">$type_uri</span><span class="var-description">: The URI of the attribute</span> </li>
  235. </ul>
  236. </div>
  237. <a name="methodgetSingle" id="getSingle"><!-- --></a>
  238. <div class="evenrow">
  239. <div class="method-header">
  240. <span class="method-title">getSingle</span> (line <span class="line-number">722</span>)
  241. </div>
  242. <!-- ========== Info from phpDoc block ========= -->
  243. <p class="short-description">Get a single value for an attribute. If no value was sent for this attribute, use the supplied default. If there is more than one value for this attribute, this method will fail.</p>
  244. <ul class="tags">
  245. <li><span class="field">return:</span> Auth_OpenID_AX_Error on failure or the value of the attribute in the fetch_response message, or the default supplied</li>
  246. </ul>
  247. <div class="method-signature">
  248. <span class="method-result">$value</span>
  249. <span class="method-name">
  250. getSingle
  251. </span>
  252. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>, [<span class="var-type">default:</span>&nbsp;<span class="var-name">$default</span> = <span class="var-default">null</span>])
  253. </div>
  254. <ul class="parameters">
  255. <li>
  256. <span class="var-type">type_uri:</span>
  257. <span class="var-name">$type_uri</span><span class="var-description">: The URI for the attribute</span> </li>
  258. <li>
  259. <span class="var-type">default:</span>
  260. <span class="var-name">$default</span><span class="var-description">: The value to return if the attribute was not sent in the fetch_response.</span> </li>
  261. </ul>
  262. </div>
  263. <a name="methodparseExtensionArgs" id="parseExtensionArgs"><!-- --></a>
  264. <div class="oddrow">
  265. <div class="method-header">
  266. <span class="method-title">parseExtensionArgs</span> (line <span class="line-number">621</span>)
  267. </div>
  268. <!-- ========== Info from phpDoc block ========= -->
  269. <p class="short-description">Parse attribute exchange key/value arguments into this object.</p>
  270. <ul class="tags">
  271. <li><span class="field">return:</span> or true</li>
  272. </ul>
  273. <div class="method-signature">
  274. <span class="method-result"><a href="../OpenID/Auth_OpenID_AX_Error.html">Auth_OpenID_AX_Error</a></span>
  275. <span class="method-name">
  276. parseExtensionArgs
  277. </span>
  278. (<span class="var-type">ax_args:</span>&nbsp;<span class="var-name">$ax_args</span>)
  279. </div>
  280. <ul class="parameters">
  281. <li>
  282. <span class="var-type">ax_args:</span>
  283. <span class="var-name">$ax_args</span><span class="var-description">: The attribute exchange fetch_response arguments, with namespacing removed.</span> </li>
  284. </ul>
  285. <hr class="separator" />
  286. <div class="notes">Redefined in descendants as:</div>
  287. <ul class="redefinitions">
  288. <li>
  289. <a href="../OpenID/Auth_OpenID_AX_FetchResponse.html#methodparseExtensionArgs">Auth_OpenID_AX_FetchResponse::parseExtensionArgs()</a>
  290. </li>
  291. </ul>
  292. </div>
  293. <a name="methodsetValues" id="setValues"><!-- --></a>
  294. <div class="evenrow">
  295. <div class="method-header">
  296. <span class="method-title">setValues</span> (line <span class="line-number">576</span>)
  297. </div>
  298. <!-- ========== Info from phpDoc block ========= -->
  299. <p class="short-description">Set the values for the given attribute type. This replaces any values that have already been set for this attribute.</p>
  300. <div class="method-signature">
  301. <span class="method-result">void</span>
  302. <span class="method-name">
  303. setValues
  304. </span>
  305. (<span class="var-type">type_uri:</span>&nbsp;<span class="var-name">$type_uri</span>, <span class="var-type">values:</span>&nbsp;<span class="var-name">&$values</span>)
  306. </div>
  307. <ul class="parameters">
  308. <li>
  309. <span class="var-type">type_uri:</span>
  310. <span class="var-name">$type_uri</span><span class="var-description">: The URI for the attribute</span> </li>
  311. <li>
  312. <span class="var-type">values:</span>
  313. <span class="var-name">&$values</span><span class="var-description">: A list of values to send for this attribute.</span> </li>
  314. </ul>
  315. </div>
  316. <h4>Inherited Methods</h4>
  317. <a name='inherited_methods'><!-- --></a>
  318. <!-- =========== Summary =========== -->
  319. <p>Inherited From <span class="classname"><a href="../OpenID/Auth_OpenID_Extension.html">Auth_OpenID_Extension</a></span></p>
  320. <blockquote>
  321. <span class="method-name"><a href="../OpenID/Auth_OpenID_Extension.html#methodgetExtensionArgs">Auth_OpenID_Extension::getExtensionArgs()</a></span><br>
  322. <span class="method-name"><a href="../OpenID/Auth_OpenID_Extension.html#methodtoMessage">Auth_OpenID_Extension::toMessage()</a></span><br>
  323. </blockquote>
  324. </div>
  325. </div>
  326. <p class="notes" id="credit">
  327. 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>
  328. </p>
  329. </div></body>
  330. </html>