DataRequest.html 75 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>DataRequest Class Reference</title>
  5. <link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
  6. <link rel="stylesheet" type="text/css" href="../css/highlight.css" />
  7. <meta charset="utf-8">
  8. <script src="../js/jquery.min.js" defer></script>
  9. <script src="../js/jazzy.js" defer></script>
  10. <script src="../js/lunr.min.js" defer></script>
  11. <script src="../js/typeahead.jquery.js" defer></script>
  12. <script src="../js/jazzy.search.js" defer></script>
  13. </head>
  14. <body>
  15. <a name="//apple_ref/swift/Class/DataRequest" class="dashAnchor"></a>
  16. <a title="DataRequest Class Reference"></a>
  17. <header class="header">
  18. <p class="header-col header-col--primary">
  19. <a class="header-link" href="../index.html">
  20. Alamofire Docs
  21. </a>
  22. (87% documented)
  23. </p>
  24. <p class="header-col--secondary">
  25. <form role="search" action="../search.json">
  26. <input type="text" placeholder="Search documentation" data-typeahead>
  27. </form>
  28. </p>
  29. <p class="header-col header-col--secondary">
  30. <a class="header-link" href="https://github.com/Alamofire/Alamofire">
  31. <img class="header-icon" src="../img/gh.png"/>
  32. View on GitHub
  33. </a>
  34. </p>
  35. <p class="header-col header-col--secondary">
  36. <a class="header-link" href="dash-feed://https%3A%2F%2Falamofire%2Egithub%2Eio%2FAlamofire%2Fdocsets%2FAlamofire%2Exml">
  37. <img class="header-icon" src="../img/dash.png"/>
  38. Install in Dash
  39. </a>
  40. </p>
  41. </header>
  42. <p class="breadcrumbs">
  43. <a class="breadcrumb" href="../index.html">Alamofire Reference</a>
  44. <img class="carat" src="../img/carat.png" />
  45. DataRequest Class Reference
  46. </p>
  47. <div class="content-wrapper">
  48. <nav class="navigation">
  49. <ul class="nav-groups">
  50. <li class="nav-group-name">
  51. <a class="nav-group-name-link" href="../Classes.html">Classes</a>
  52. <ul class="nav-group-tasks">
  53. <li class="nav-group-task">
  54. <a class="nav-group-task-link" href="../Classes/DataRequest.html">DataRequest</a>
  55. </li>
  56. <li class="nav-group-task">
  57. <a class="nav-group-task-link" href="../Classes/DownloadRequest.html">DownloadRequest</a>
  58. </li>
  59. <li class="nav-group-task">
  60. <a class="nav-group-task-link" href="../Classes/DownloadRequest/DownloadOptions.html">– DownloadOptions</a>
  61. </li>
  62. <li class="nav-group-task">
  63. <a class="nav-group-task-link" href="../Classes/MultipartFormData.html">MultipartFormData</a>
  64. </li>
  65. <li class="nav-group-task">
  66. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a>
  67. </li>
  68. <li class="nav-group-task">
  69. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/NetworkReachabilityStatus.html">– NetworkReachabilityStatus</a>
  70. </li>
  71. <li class="nav-group-task">
  72. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/ConnectionType.html">– ConnectionType</a>
  73. </li>
  74. <li class="nav-group-task">
  75. <a class="nav-group-task-link" href="../Classes/Request.html">Request</a>
  76. </li>
  77. <li class="nav-group-task">
  78. <a class="nav-group-task-link" href="../Classes/Request/ValidationResult.html">– ValidationResult</a>
  79. </li>
  80. <li class="nav-group-task">
  81. <a class="nav-group-task-link" href="../Classes/ServerTrustPolicyManager.html">ServerTrustPolicyManager</a>
  82. </li>
  83. <li class="nav-group-task">
  84. <a class="nav-group-task-link" href="../Classes/SessionDelegate.html">SessionDelegate</a>
  85. </li>
  86. <li class="nav-group-task">
  87. <a class="nav-group-task-link" href="../Classes/SessionManager.html">SessionManager</a>
  88. </li>
  89. <li class="nav-group-task">
  90. <a class="nav-group-task-link" href="../Classes/SessionManager/MultipartFormDataEncodingResult.html">– MultipartFormDataEncodingResult</a>
  91. </li>
  92. <li class="nav-group-task">
  93. <a class="nav-group-task-link" href="../Classes.html#/s:9Alamofire13StreamRequestC">StreamRequest</a>
  94. </li>
  95. <li class="nav-group-task">
  96. <a class="nav-group-task-link" href="../Classes/TaskDelegate.html">TaskDelegate</a>
  97. </li>
  98. <li class="nav-group-task">
  99. <a class="nav-group-task-link" href="../Classes/UploadRequest.html">UploadRequest</a>
  100. </li>
  101. </ul>
  102. </li>
  103. <li class="nav-group-name">
  104. <a class="nav-group-name-link" href="../Enums.html">Enumerations</a>
  105. <ul class="nav-group-tasks">
  106. <li class="nav-group-task">
  107. <a class="nav-group-task-link" href="../Enums/AFError.html">AFError</a>
  108. </li>
  109. <li class="nav-group-task">
  110. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncodingFailureReason.html">– ParameterEncodingFailureReason</a>
  111. </li>
  112. <li class="nav-group-task">
  113. <a class="nav-group-task-link" href="../Enums/AFError/MultipartEncodingFailureReason.html">– MultipartEncodingFailureReason</a>
  114. </li>
  115. <li class="nav-group-task">
  116. <a class="nav-group-task-link" href="../Enums/AFError/ResponseValidationFailureReason.html">– ResponseValidationFailureReason</a>
  117. </li>
  118. <li class="nav-group-task">
  119. <a class="nav-group-task-link" href="../Enums/AFError/ResponseSerializationFailureReason.html">– ResponseSerializationFailureReason</a>
  120. </li>
  121. <li class="nav-group-task">
  122. <a class="nav-group-task-link" href="../Enums/HTTPMethod.html">HTTPMethod</a>
  123. </li>
  124. <li class="nav-group-task">
  125. <a class="nav-group-task-link" href="../Enums/Result.html">Result</a>
  126. </li>
  127. <li class="nav-group-task">
  128. <a class="nav-group-task-link" href="../Enums/ServerTrustPolicy.html">ServerTrustPolicy</a>
  129. </li>
  130. </ul>
  131. </li>
  132. <li class="nav-group-name">
  133. <a class="nav-group-name-link" href="../Extensions.html">Extensions</a>
  134. <ul class="nav-group-tasks">
  135. <li class="nav-group-task">
  136. <a class="nav-group-task-link" href="../Extensions/Notification.html">Notification</a>
  137. </li>
  138. <li class="nav-group-task">
  139. <a class="nav-group-task-link" href="../Extensions/Notification/Name.html">– Name</a>
  140. </li>
  141. <li class="nav-group-task">
  142. <a class="nav-group-task-link" href="../Extensions/Notification/Key.html">– Key</a>
  143. </li>
  144. <li class="nav-group-task">
  145. <a class="nav-group-task-link" href="../Extensions/String.html">String</a>
  146. </li>
  147. <li class="nav-group-task">
  148. <a class="nav-group-task-link" href="../Extensions/URL.html">URL</a>
  149. </li>
  150. <li class="nav-group-task">
  151. <a class="nav-group-task-link" href="../Extensions/URLComponents.html">URLComponents</a>
  152. </li>
  153. <li class="nav-group-task">
  154. <a class="nav-group-task-link" href="../Extensions/URLRequest.html">URLRequest</a>
  155. </li>
  156. </ul>
  157. </li>
  158. <li class="nav-group-name">
  159. <a class="nav-group-name-link" href="../Functions.html">Functions</a>
  160. <ul class="nav-group-tasks">
  161. <li class="nav-group-task">
  162. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire2eeoiSbAA26NetworkReachabilityManagerC0cD6StatusO_AFtF">==(_:_:)</a>
  163. </li>
  164. <li class="nav-group-task">
  165. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire8downloadAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headers10Foundation3URLV011destinationO0_AD0C7OptionsV7optionstAU_So15HTTPURLResponseCtcSg2totF">download(_:method:parameters:encoding:headers:to:)</a>
  166. </li>
  167. <li class="nav-group-task">
  168. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire8downloadAA15DownloadRequestCAA21URLRequestConvertible_p_10Foundation3URLV011destinationH0_AD0C7OptionsV7optionstAH_So15HTTPURLResponseCtcSg2totF">download(_:to:)</a>
  169. </li>
  170. <li class="nav-group-task">
  171. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire8downloadAA15DownloadRequestC10Foundation4DataV12resumingWith_AE3URLV011destinationI0_AD0C7OptionsV7optionstAJ_So15HTTPURLResponseCtcSg2totF">download(resumingWith:to:)</a>
  172. </li>
  173. <li class="nav-group-task">
  174. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire7requestAA11DataRequestCAA21URLRequestConvertible_pF">request(_:)</a>
  175. </li>
  176. <li class="nav-group-task">
  177. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire7requestAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodO6methods10DictionaryVySSypGSg10parametersAA17ParameterEncoding_p8encodingAJyS2SGSg7headerstF">request(_:method:parameters:encoding:headers:)</a>
  178. </li>
  179. <li class="nav-group-task">
  180. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6streamAA13StreamRequestCSo10NetServiceC4with_tF">stream(with:)</a>
  181. </li>
  182. <li class="nav-group-task">
  183. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6streamAA13StreamRequestCSS12withHostName_Si4porttF">stream(withHostName:port:)</a>
  184. </li>
  185. <li class="nav-group-task">
  186. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  187. </li>
  188. <li class="nav-group-task">
  189. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  190. </li>
  191. <li class="nav-group-task">
  192. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headerstF">upload(_:to:method:headers:)</a>
  193. </li>
  194. <li class="nav-group-task">
  195. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  196. </li>
  197. <li class="nav-group-task">
  198. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  199. </li>
  200. <li class="nav-group-task">
  201. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadAA13UploadRequestCSo11InputStreamC_AA21URLRequestConvertible_p4withtF">upload(_:with:)</a>
  202. </li>
  203. <li class="nav-group-task">
  204. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA14URLConvertible_p2toAA10HTTPMethodO6methods10DictionaryVyS2SGSg7headersyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF">upload(multipartFormData:usingThreshold:to:method:headers:encodingCompletion:)</a>
  205. </li>
  206. <li class="nav-group-task">
  207. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire6uploadyyAA17MultipartFormDataCc09multipartdE0_s6UInt64V14usingThresholdAA21URLRequestConvertible_p4withyAA14SessionManagerC0cdE14EncodingResultOcSg18encodingCompletiontF">upload(multipartFormData:usingThreshold:with:encodingCompletion:)</a>
  208. </li>
  209. </ul>
  210. </li>
  211. <li class="nav-group-name">
  212. <a class="nav-group-name-link" href="../Protocols.html">Protocols</a>
  213. <ul class="nav-group-tasks">
  214. <li class="nav-group-task">
  215. <a class="nav-group-task-link" href="../Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a>
  216. </li>
  217. <li class="nav-group-task">
  218. <a class="nav-group-task-link" href="../Protocols/DownloadResponseSerializerProtocol.html">DownloadResponseSerializerProtocol</a>
  219. </li>
  220. <li class="nav-group-task">
  221. <a class="nav-group-task-link" href="../Protocols/ParameterEncoding.html">ParameterEncoding</a>
  222. </li>
  223. <li class="nav-group-task">
  224. <a class="nav-group-task-link" href="../Protocols/RequestAdapter.html">RequestAdapter</a>
  225. </li>
  226. <li class="nav-group-task">
  227. <a class="nav-group-task-link" href="../Protocols/RequestRetrier.html">RequestRetrier</a>
  228. </li>
  229. <li class="nav-group-task">
  230. <a class="nav-group-task-link" href="../Protocols/URLConvertible.html">URLConvertible</a>
  231. </li>
  232. <li class="nav-group-task">
  233. <a class="nav-group-task-link" href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
  234. </li>
  235. </ul>
  236. </li>
  237. <li class="nav-group-name">
  238. <a class="nav-group-name-link" href="../Structs.html">Structures</a>
  239. <ul class="nav-group-tasks">
  240. <li class="nav-group-task">
  241. <a class="nav-group-task-link" href="../Structs/DataResponse.html">DataResponse</a>
  242. </li>
  243. <li class="nav-group-task">
  244. <a class="nav-group-task-link" href="../Structs/DataResponseSerializer.html">DataResponseSerializer</a>
  245. </li>
  246. <li class="nav-group-task">
  247. <a class="nav-group-task-link" href="../Structs/DefaultDataResponse.html">DefaultDataResponse</a>
  248. </li>
  249. <li class="nav-group-task">
  250. <a class="nav-group-task-link" href="../Structs/DefaultDownloadResponse.html">DefaultDownloadResponse</a>
  251. </li>
  252. <li class="nav-group-task">
  253. <a class="nav-group-task-link" href="../Structs/DownloadResponse.html">DownloadResponse</a>
  254. </li>
  255. <li class="nav-group-task">
  256. <a class="nav-group-task-link" href="../Structs/DownloadResponseSerializer.html">DownloadResponseSerializer</a>
  257. </li>
  258. <li class="nav-group-task">
  259. <a class="nav-group-task-link" href="../Structs/JSONEncoding.html">JSONEncoding</a>
  260. </li>
  261. <li class="nav-group-task">
  262. <a class="nav-group-task-link" href="../Structs/PropertyListEncoding.html">PropertyListEncoding</a>
  263. </li>
  264. <li class="nav-group-task">
  265. <a class="nav-group-task-link" href="../Structs/Timeline.html">Timeline</a>
  266. </li>
  267. <li class="nav-group-task">
  268. <a class="nav-group-task-link" href="../Structs/URLEncoding.html">URLEncoding</a>
  269. </li>
  270. <li class="nav-group-task">
  271. <a class="nav-group-task-link" href="../Structs/URLEncoding/Destination.html">– Destination</a>
  272. </li>
  273. </ul>
  274. </li>
  275. <li class="nav-group-name">
  276. <a class="nav-group-name-link" href="../Typealiases.html">Type Aliases</a>
  277. <ul class="nav-group-tasks">
  278. <li class="nav-group-task">
  279. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire11HTTPHeadersa">HTTPHeaders</a>
  280. </li>
  281. <li class="nav-group-task">
  282. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a>
  283. </li>
  284. <li class="nav-group-task">
  285. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire22RequestRetryCompletiona">RequestRetryCompletion</a>
  286. </li>
  287. </ul>
  288. </li>
  289. </ul>
  290. </nav>
  291. <article class="main-content">
  292. <section class="section">
  293. <div class="section-content">
  294. <h1>DataRequest</h1>
  295. <div class="declaration">
  296. <div class="language">
  297. <pre class="highlight"><code><span class="n">open</span> <span class="kd">class</span> <span class="kt">DataRequest</span><span class="p">:</span> <span class="kt"><a href="../Classes/Request.html">Request</a></span></code></pre>
  298. </div>
  299. </div>
  300. <p>Specific type of <code><a href="../Classes/Request.html">Request</a></code> that manages an underlying <code>URLSessionDataTask</code>.</p>
  301. </div>
  302. </section>
  303. <section class="section">
  304. <div class="section-content">
  305. <div class="task-group">
  306. <div class="task-name-container">
  307. <a name="/Properties"></a>
  308. <a name="//apple_ref/swift/Section/Properties" class="dashAnchor"></a>
  309. <a href="#/Properties">
  310. <h3 class="section-name">Properties</h3>
  311. </a>
  312. </div>
  313. <ul class="item-container">
  314. <li class="item">
  315. <div>
  316. <code>
  317. <a name="/s:9Alamofire11DataRequestC7request10Foundation10URLRequestVSgv"></a>
  318. <a name="//apple_ref/swift/Property/request" class="dashAnchor"></a>
  319. <a class="token" href="#/s:9Alamofire11DataRequestC7request10Foundation10URLRequestVSgv">request</a>
  320. </code>
  321. </div>
  322. <div class="height-container">
  323. <div class="pointer-container"></div>
  324. <section class="section">
  325. <div class="pointer"></div>
  326. <div class="abstract">
  327. <p>The request sent or to be sent to the server.</p>
  328. </div>
  329. <div class="declaration">
  330. <h4>Declaration</h4>
  331. <div class="language">
  332. <p class="aside-title">Swift</p>
  333. <pre class="highlight"><code><span class="n">open</span> <span class="k">override</span> <span class="k">var</span> <span class="nv">request</span><span class="p">:</span> <span class="kt">URLRequest</span><span class="p">?</span></code></pre>
  334. </div>
  335. </div>
  336. </section>
  337. </div>
  338. </li>
  339. <li class="item">
  340. <div>
  341. <code>
  342. <a name="/s:9Alamofire11DataRequestC8progressSo8ProgressCv"></a>
  343. <a name="//apple_ref/swift/Property/progress" class="dashAnchor"></a>
  344. <a class="token" href="#/s:9Alamofire11DataRequestC8progressSo8ProgressCv">progress</a>
  345. </code>
  346. </div>
  347. <div class="height-container">
  348. <div class="pointer-container"></div>
  349. <section class="section">
  350. <div class="pointer"></div>
  351. <div class="abstract">
  352. <p>The progress of fetching the response data from the server for the request.</p>
  353. </div>
  354. <div class="declaration">
  355. <h4>Declaration</h4>
  356. <div class="language">
  357. <p class="aside-title">Swift</p>
  358. <pre class="highlight"><code><span class="n">open</span> <span class="k">var</span> <span class="nv">progress</span><span class="p">:</span> <span class="kt">Progress</span></code></pre>
  359. </div>
  360. </div>
  361. </section>
  362. </div>
  363. </li>
  364. </ul>
  365. </div>
  366. <div class="task-group">
  367. <div class="task-name-container">
  368. <a name="/Stream"></a>
  369. <a name="//apple_ref/swift/Section/Stream" class="dashAnchor"></a>
  370. <a href="#/Stream">
  371. <h3 class="section-name">Stream</h3>
  372. </a>
  373. </div>
  374. <ul class="item-container">
  375. <li class="item">
  376. <div>
  377. <code>
  378. <a name="/s:9Alamofire11DataRequestC6streamACXDy10Foundation0B0VcSg7closure_tF"></a>
  379. <a name="//apple_ref/swift/Method/stream(closure:)" class="dashAnchor"></a>
  380. <a class="token" href="#/s:9Alamofire11DataRequestC6streamACXDy10Foundation0B0VcSg7closure_tF">stream(closure:)</a>
  381. </code>
  382. </div>
  383. <div class="height-container">
  384. <div class="pointer-container"></div>
  385. <section class="section">
  386. <div class="pointer"></div>
  387. <div class="abstract">
  388. <p>Sets a closure to be called periodically during the lifecycle of the request as data is read from the server.</p>
  389. <p>This closure returns the bytes most recently received from the server, not including data from previous calls.
  390. If this closure is set, data will only be available within this closure, and will not be saved elsewhere. It is
  391. also important to note that the server data in any <code>Response</code> object will be <code>nil</code>.</p>
  392. </div>
  393. <div class="declaration">
  394. <h4>Declaration</h4>
  395. <div class="language">
  396. <p class="aside-title">Swift</p>
  397. <pre class="highlight"><code><span class="n">open</span> <span class="kd">func</span> <span class="nf">stream</span><span class="p">(</span><span class="nv">closure</span><span class="p">:</span> <span class="p">((</span><span class="kt">Data</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  398. </div>
  399. </div>
  400. <div>
  401. <h4>Parameters</h4>
  402. <table class="graybox">
  403. <tbody>
  404. <tr>
  405. <td>
  406. <code>
  407. <em>closure</em>
  408. </code>
  409. </td>
  410. <td>
  411. <div>
  412. <p>The code to be executed periodically during the lifecycle of the request.</p>
  413. </div>
  414. </td>
  415. </tr>
  416. </tbody>
  417. </table>
  418. </div>
  419. <div>
  420. <h4>Return Value</h4>
  421. <p>The request.</p>
  422. </div>
  423. </section>
  424. </div>
  425. </li>
  426. </ul>
  427. </div>
  428. <div class="task-group">
  429. <div class="task-name-container">
  430. <a name="/Progress"></a>
  431. <a name="//apple_ref/swift/Section/Progress" class="dashAnchor"></a>
  432. <a href="#/Progress">
  433. <h3 class="section-name">Progress</h3>
  434. </a>
  435. </div>
  436. <ul class="item-container">
  437. <li class="item">
  438. <div>
  439. <code>
  440. <a name="/s:9Alamofire11DataRequestC16downloadProgressACXDSo13DispatchQueueC5queue_ySo0E0Cc7closuretF"></a>
  441. <a name="//apple_ref/swift/Method/downloadProgress(queue:closure:)" class="dashAnchor"></a>
  442. <a class="token" href="#/s:9Alamofire11DataRequestC16downloadProgressACXDSo13DispatchQueueC5queue_ySo0E0Cc7closuretF">downloadProgress(queue:closure:)</a>
  443. </code>
  444. </div>
  445. <div class="height-container">
  446. <div class="pointer-container"></div>
  447. <section class="section">
  448. <div class="pointer"></div>
  449. <div class="abstract">
  450. <p>Sets a closure to be called periodically during the lifecycle of the <code><a href="../Classes/Request.html">Request</a></code> as data is read from the server.</p>
  451. </div>
  452. <div class="declaration">
  453. <h4>Declaration</h4>
  454. <div class="language">
  455. <p class="aside-title">Swift</p>
  456. <pre class="highlight"><code><span class="n">open</span> <span class="kd">func</span> <span class="nf">downloadProgress</span><span class="p">(</span><span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span> <span class="o">=</span> <span class="kt">DispatchQueue</span><span class="o">.</span><span class="n">main</span><span class="p">,</span> <span class="nv">closure</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="kt">ProgressHandler</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  457. </div>
  458. </div>
  459. <div>
  460. <h4>Parameters</h4>
  461. <table class="graybox">
  462. <tbody>
  463. <tr>
  464. <td>
  465. <code>
  466. <em>queue</em>
  467. </code>
  468. </td>
  469. <td>
  470. <div>
  471. <p>The dispatch queue to execute the closure on.</p>
  472. </div>
  473. </td>
  474. </tr>
  475. <tr>
  476. <td>
  477. <code>
  478. <em>closure</em>
  479. </code>
  480. </td>
  481. <td>
  482. <div>
  483. <p>The code to be executed periodically as data is read from the server.</p>
  484. </div>
  485. </td>
  486. </tr>
  487. </tbody>
  488. </table>
  489. </div>
  490. <div>
  491. <h4>Return Value</h4>
  492. <p>The request.</p>
  493. </div>
  494. </section>
  495. </div>
  496. </li>
  497. </ul>
  498. </div>
  499. <div class="task-group">
  500. <ul class="item-container">
  501. <li class="item">
  502. <div>
  503. <code>
  504. <a name="/s:9Alamofire11DataRequestC8responseACXDSo13DispatchQueueCSg5queue_yAA07DefaultB8ResponseVc17completionHandlertF"></a>
  505. <a name="//apple_ref/swift/Method/response(queue:completionHandler:)" class="dashAnchor"></a>
  506. <a class="token" href="#/s:9Alamofire11DataRequestC8responseACXDSo13DispatchQueueCSg5queue_yAA07DefaultB8ResponseVc17completionHandlertF">response(queue:completionHandler:)</a>
  507. </code>
  508. </div>
  509. <div class="height-container">
  510. <div class="pointer-container"></div>
  511. <section class="section">
  512. <div class="pointer"></div>
  513. <div class="abstract">
  514. <p>Adds a handler to be called once the request has finished.</p>
  515. </div>
  516. <div class="declaration">
  517. <h4>Declaration</h4>
  518. <div class="language">
  519. <p class="aside-title">Swift</p>
  520. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">response</span><span class="p">(</span><span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span> <span class="nv">completionHandler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Structs/DefaultDataResponse.html">DefaultDataResponse</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  521. </div>
  522. </div>
  523. <div>
  524. <h4>Parameters</h4>
  525. <table class="graybox">
  526. <tbody>
  527. <tr>
  528. <td>
  529. <code>
  530. <em>queue</em>
  531. </code>
  532. </td>
  533. <td>
  534. <div>
  535. <p>The queue on which the completion handler is dispatched.</p>
  536. </div>
  537. </td>
  538. </tr>
  539. <tr>
  540. <td>
  541. <code>
  542. <em>completionHandler</em>
  543. </code>
  544. </td>
  545. <td>
  546. <div>
  547. <p>The code to be executed once the request has finished.</p>
  548. </div>
  549. </td>
  550. </tr>
  551. </tbody>
  552. </table>
  553. </div>
  554. <div>
  555. <h4>Return Value</h4>
  556. <p>The request.</p>
  557. </div>
  558. </section>
  559. </div>
  560. </li>
  561. <li class="item">
  562. <div>
  563. <code>
  564. <a name="/s:9Alamofire11DataRequestC8responseACXDSo13DispatchQueueCSg5queue_x0D10SerializeryAA0B8ResponseVy16SerializedObjectQzGc17completionHandlertAA0biH8ProtocolRzlF"></a>
  565. <a name="//apple_ref/swift/Method/response(queue:responseSerializer:completionHandler:)" class="dashAnchor"></a>
  566. <a class="token" href="#/s:9Alamofire11DataRequestC8responseACXDSo13DispatchQueueCSg5queue_x0D10SerializeryAA0B8ResponseVy16SerializedObjectQzGc17completionHandlertAA0biH8ProtocolRzlF">response(queue:responseSerializer:completionHandler:)</a>
  567. </code>
  568. </div>
  569. <div class="height-container">
  570. <div class="pointer-container"></div>
  571. <section class="section">
  572. <div class="pointer"></div>
  573. <div class="abstract">
  574. <p>Adds a handler to be called once the request has finished.</p>
  575. </div>
  576. <div class="declaration">
  577. <h4>Declaration</h4>
  578. <div class="language">
  579. <p class="aside-title">Swift</p>
  580. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="n">response</span><span class="o">&lt;</span><span class="kt">T</span><span class="p">:</span> <span class="kt"><a href="../Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a></span><span class="o">&gt;</span><span class="p">(</span>
  581. <span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  582. <span class="nv">responseSerializer</span><span class="p">:</span> <span class="kt">T</span><span class="p">,</span>
  583. <span class="nv">completionHandler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Structs/DataResponse.html">DataResponse</a></span><span class="o">&lt;</span><span class="kt">T</span><span class="o">.</span><span class="kt">SerializedObject</span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span>
  584. <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  585. </div>
  586. </div>
  587. <div>
  588. <h4>Parameters</h4>
  589. <table class="graybox">
  590. <tbody>
  591. <tr>
  592. <td>
  593. <code>
  594. <em>queue</em>
  595. </code>
  596. </td>
  597. <td>
  598. <div>
  599. <p>The queue on which the completion handler is dispatched.</p>
  600. </div>
  601. </td>
  602. </tr>
  603. <tr>
  604. <td>
  605. <code>
  606. <em>responseSerializer</em>
  607. </code>
  608. </td>
  609. <td>
  610. <div>
  611. <p>The response serializer responsible for serializing the request, response,
  612. and data.</p>
  613. </div>
  614. </td>
  615. </tr>
  616. <tr>
  617. <td>
  618. <code>
  619. <em>completionHandler</em>
  620. </code>
  621. </td>
  622. <td>
  623. <div>
  624. <p>The code to be executed once the request has finished.</p>
  625. </div>
  626. </td>
  627. </tr>
  628. </tbody>
  629. </table>
  630. </div>
  631. <div>
  632. <h4>Return Value</h4>
  633. <p>The request.</p>
  634. </div>
  635. </section>
  636. </div>
  637. </li>
  638. </ul>
  639. </div>
  640. <div class="task-group">
  641. <ul class="item-container">
  642. <li class="item">
  643. <div>
  644. <code>
  645. <a name="/s:9Alamofire11DataRequestC22dataResponseSerializerAA0beF0Vy10Foundation0B0VGyFZ"></a>
  646. <a name="//apple_ref/swift/Method/dataResponseSerializer()" class="dashAnchor"></a>
  647. <a class="token" href="#/s:9Alamofire11DataRequestC22dataResponseSerializerAA0beF0Vy10Foundation0B0VGyFZ">dataResponseSerializer()</a>
  648. </code>
  649. </div>
  650. <div class="height-container">
  651. <div class="pointer-container"></div>
  652. <section class="section">
  653. <div class="pointer"></div>
  654. <div class="abstract">
  655. <p>Creates a response serializer that returns the associated data as-is.</p>
  656. </div>
  657. <div class="declaration">
  658. <h4>Declaration</h4>
  659. <div class="language">
  660. <p class="aside-title">Swift</p>
  661. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">dataResponseSerializer</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Structs/DataResponseSerializer.html">DataResponseSerializer</a></span><span class="o">&lt;</span><span class="kt">Data</span><span class="o">&gt;</span></code></pre>
  662. </div>
  663. </div>
  664. <div>
  665. <h4>Return Value</h4>
  666. <p>A data response serializer.</p>
  667. </div>
  668. </section>
  669. </div>
  670. </li>
  671. <li class="item">
  672. <div>
  673. <code>
  674. <a name="/s:9Alamofire11DataRequestC08responseB0ACXDSo13DispatchQueueCSg5queue_yAA0B8ResponseVy10Foundation0B0VGc17completionHandlertF"></a>
  675. <a name="//apple_ref/swift/Method/responseData(queue:completionHandler:)" class="dashAnchor"></a>
  676. <a class="token" href="#/s:9Alamofire11DataRequestC08responseB0ACXDSo13DispatchQueueCSg5queue_yAA0B8ResponseVy10Foundation0B0VGc17completionHandlertF">responseData(queue:completionHandler:)</a>
  677. </code>
  678. </div>
  679. <div class="height-container">
  680. <div class="pointer-container"></div>
  681. <section class="section">
  682. <div class="pointer"></div>
  683. <div class="abstract">
  684. <p>Adds a handler to be called once the request has finished.</p>
  685. </div>
  686. <div class="declaration">
  687. <h4>Declaration</h4>
  688. <div class="language">
  689. <p class="aside-title">Swift</p>
  690. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">responseData</span><span class="p">(</span>
  691. <span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  692. <span class="nv">completionHandler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Structs/DataResponse.html">DataResponse</a></span><span class="o">&lt;</span><span class="kt">Data</span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span>
  693. <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  694. </div>
  695. </div>
  696. <div>
  697. <h4>Parameters</h4>
  698. <table class="graybox">
  699. <tbody>
  700. <tr>
  701. <td>
  702. <code>
  703. <em>completionHandler</em>
  704. </code>
  705. </td>
  706. <td>
  707. <div>
  708. <p>The code to be executed once the request has finished.</p>
  709. </div>
  710. </td>
  711. </tr>
  712. </tbody>
  713. </table>
  714. </div>
  715. <div>
  716. <h4>Return Value</h4>
  717. <p>The request.</p>
  718. </div>
  719. </section>
  720. </div>
  721. </li>
  722. </ul>
  723. </div>
  724. <div class="task-group">
  725. <ul class="item-container">
  726. <li class="item">
  727. <div>
  728. <code>
  729. <a name="/s:9Alamofire11DataRequestC24stringResponseSerializerAA0beF0VySSGSS10FoundationE8EncodingVSg8encoding_tFZ"></a>
  730. <a name="//apple_ref/swift/Method/stringResponseSerializer(encoding:)" class="dashAnchor"></a>
  731. <a class="token" href="#/s:9Alamofire11DataRequestC24stringResponseSerializerAA0beF0VySSGSS10FoundationE8EncodingVSg8encoding_tFZ">stringResponseSerializer(encoding:)</a>
  732. </code>
  733. </div>
  734. <div class="height-container">
  735. <div class="pointer-container"></div>
  736. <section class="section">
  737. <div class="pointer"></div>
  738. <div class="abstract">
  739. <p>Creates a response serializer that returns a result string type initialized from the response data with
  740. the specified string encoding.</p>
  741. </div>
  742. <div class="declaration">
  743. <h4>Declaration</h4>
  744. <div class="language">
  745. <p class="aside-title">Swift</p>
  746. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">stringResponseSerializer</span><span class="p">(</span><span class="nv">encoding</span><span class="p">:</span> <span class="kt">String</span><span class="o">.</span><span class="kt">Encoding</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Structs/DataResponseSerializer.html">DataResponseSerializer</a></span><span class="o">&lt;</span><span class="kt">String</span><span class="o">&gt;</span></code></pre>
  747. </div>
  748. </div>
  749. <div>
  750. <h4>Parameters</h4>
  751. <table class="graybox">
  752. <tbody>
  753. <tr>
  754. <td>
  755. <code>
  756. <em>encoding</em>
  757. </code>
  758. </td>
  759. <td>
  760. <div>
  761. <p>The string encoding. If <code>nil</code>, the string encoding will be determined from the server
  762. response, falling back to the default HTTP default character set, ISO-8859-1.</p>
  763. </div>
  764. </td>
  765. </tr>
  766. </tbody>
  767. </table>
  768. </div>
  769. <div>
  770. <h4>Return Value</h4>
  771. <p>A string response serializer.</p>
  772. </div>
  773. </section>
  774. </div>
  775. </li>
  776. <li class="item">
  777. <div>
  778. <code>
  779. <a name="/s:9Alamofire11DataRequestC14responseStringACXDSo13DispatchQueueCSg5queue_SS10FoundationE8EncodingVSg8encodingyAA0B8ResponseVySSGc17completionHandlertF"></a>
  780. <a name="//apple_ref/swift/Method/responseString(queue:encoding:completionHandler:)" class="dashAnchor"></a>
  781. <a class="token" href="#/s:9Alamofire11DataRequestC14responseStringACXDSo13DispatchQueueCSg5queue_SS10FoundationE8EncodingVSg8encodingyAA0B8ResponseVySSGc17completionHandlertF">responseString(queue:encoding:completionHandler:)</a>
  782. </code>
  783. </div>
  784. <div class="height-container">
  785. <div class="pointer-container"></div>
  786. <section class="section">
  787. <div class="pointer"></div>
  788. <div class="abstract">
  789. <p>Adds a handler to be called once the request has finished.</p>
  790. </div>
  791. <div class="declaration">
  792. <h4>Declaration</h4>
  793. <div class="language">
  794. <p class="aside-title">Swift</p>
  795. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">responseString</span><span class="p">(</span>
  796. <span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  797. <span class="nv">encoding</span><span class="p">:</span> <span class="kt">String</span><span class="o">.</span><span class="kt">Encoding</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  798. <span class="nv">completionHandler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Structs/DataResponse.html">DataResponse</a></span><span class="o">&lt;</span><span class="kt">String</span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span>
  799. <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  800. </div>
  801. </div>
  802. <div>
  803. <h4>Parameters</h4>
  804. <table class="graybox">
  805. <tbody>
  806. <tr>
  807. <td>
  808. <code>
  809. <em>encoding</em>
  810. </code>
  811. </td>
  812. <td>
  813. <div>
  814. <p>The string encoding. If <code>nil</code>, the string encoding will be determined from the
  815. server response, falling back to the default HTTP default character set,
  816. ISO-8859-1.</p>
  817. </div>
  818. </td>
  819. </tr>
  820. <tr>
  821. <td>
  822. <code>
  823. <em>completionHandler</em>
  824. </code>
  825. </td>
  826. <td>
  827. <div>
  828. <p>A closure to be executed once the request has finished.</p>
  829. </div>
  830. </td>
  831. </tr>
  832. </tbody>
  833. </table>
  834. </div>
  835. <div>
  836. <h4>Return Value</h4>
  837. <p>The request.</p>
  838. </div>
  839. </section>
  840. </div>
  841. </li>
  842. </ul>
  843. </div>
  844. <div class="task-group">
  845. <ul class="item-container">
  846. <li class="item">
  847. <div>
  848. <code>
  849. <a name="/s:9Alamofire11DataRequestC22jsonResponseSerializerAA0beF0VyypGSo17JSONSerializationC14ReadingOptionsV7options_tFZ"></a>
  850. <a name="//apple_ref/swift/Method/jsonResponseSerializer(options:)" class="dashAnchor"></a>
  851. <a class="token" href="#/s:9Alamofire11DataRequestC22jsonResponseSerializerAA0beF0VyypGSo17JSONSerializationC14ReadingOptionsV7options_tFZ">jsonResponseSerializer(options:)</a>
  852. </code>
  853. </div>
  854. <div class="height-container">
  855. <div class="pointer-container"></div>
  856. <section class="section">
  857. <div class="pointer"></div>
  858. <div class="abstract">
  859. <p>Creates a response serializer that returns a JSON object result type constructed from the response data using
  860. <code>JSONSerialization</code> with the specified reading options.</p>
  861. </div>
  862. <div class="declaration">
  863. <h4>Declaration</h4>
  864. <div class="language">
  865. <p class="aside-title">Swift</p>
  866. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">jsonResponseSerializer</span><span class="p">(</span>
  867. <span class="nv">options</span><span class="p">:</span> <span class="kt">JSONSerialization</span><span class="o">.</span><span class="kt">ReadingOptions</span> <span class="o">=</span> <span class="o">.</span><span class="n">allowFragments</span><span class="p">)</span>
  868. <span class="o">-&gt;</span> <span class="kt"><a href="../Structs/DataResponseSerializer.html">DataResponseSerializer</a></span><span class="o">&lt;</span><span class="kt">Any</span><span class="o">&gt;</span></code></pre>
  869. </div>
  870. </div>
  871. <div>
  872. <h4>Parameters</h4>
  873. <table class="graybox">
  874. <tbody>
  875. <tr>
  876. <td>
  877. <code>
  878. <em>options</em>
  879. </code>
  880. </td>
  881. <td>
  882. <div>
  883. <p>The JSON serialization reading options. Defaults to <code>.allowFragments</code>.</p>
  884. </div>
  885. </td>
  886. </tr>
  887. </tbody>
  888. </table>
  889. </div>
  890. <div>
  891. <h4>Return Value</h4>
  892. <p>A JSON object response serializer.</p>
  893. </div>
  894. </section>
  895. </div>
  896. </li>
  897. <li class="item">
  898. <div>
  899. <code>
  900. <a name="/s:9Alamofire11DataRequestC12responseJSONACXDSo13DispatchQueueCSg5queue_So17JSONSerializationC14ReadingOptionsV7optionsyAA0B8ResponseVyypGc17completionHandlertF"></a>
  901. <a name="//apple_ref/swift/Method/responseJSON(queue:options:completionHandler:)" class="dashAnchor"></a>
  902. <a class="token" href="#/s:9Alamofire11DataRequestC12responseJSONACXDSo13DispatchQueueCSg5queue_So17JSONSerializationC14ReadingOptionsV7optionsyAA0B8ResponseVyypGc17completionHandlertF">responseJSON(queue:options:completionHandler:)</a>
  903. </code>
  904. </div>
  905. <div class="height-container">
  906. <div class="pointer-container"></div>
  907. <section class="section">
  908. <div class="pointer"></div>
  909. <div class="abstract">
  910. <p>Adds a handler to be called once the request has finished.</p>
  911. </div>
  912. <div class="declaration">
  913. <h4>Declaration</h4>
  914. <div class="language">
  915. <p class="aside-title">Swift</p>
  916. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">responseJSON</span><span class="p">(</span>
  917. <span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  918. <span class="nv">options</span><span class="p">:</span> <span class="kt">JSONSerialization</span><span class="o">.</span><span class="kt">ReadingOptions</span> <span class="o">=</span> <span class="o">.</span><span class="n">allowFragments</span><span class="p">,</span>
  919. <span class="nv">completionHandler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Structs/DataResponse.html">DataResponse</a></span><span class="o">&lt;</span><span class="kt">Any</span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span>
  920. <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  921. </div>
  922. </div>
  923. <div>
  924. <h4>Parameters</h4>
  925. <table class="graybox">
  926. <tbody>
  927. <tr>
  928. <td>
  929. <code>
  930. <em>options</em>
  931. </code>
  932. </td>
  933. <td>
  934. <div>
  935. <p>The JSON serialization reading options. Defaults to <code>.allowFragments</code>.</p>
  936. </div>
  937. </td>
  938. </tr>
  939. <tr>
  940. <td>
  941. <code>
  942. <em>completionHandler</em>
  943. </code>
  944. </td>
  945. <td>
  946. <div>
  947. <p>A closure to be executed once the request has finished.</p>
  948. </div>
  949. </td>
  950. </tr>
  951. </tbody>
  952. </table>
  953. </div>
  954. <div>
  955. <h4>Return Value</h4>
  956. <p>The request.</p>
  957. </div>
  958. </section>
  959. </div>
  960. </li>
  961. </ul>
  962. </div>
  963. <div class="task-group">
  964. <ul class="item-container">
  965. <li class="item">
  966. <div>
  967. <code>
  968. <a name="/s:9Alamofire11DataRequestC30propertyListResponseSerializerAA0bfG0VyypGSo08PropertyE13SerializationC17MutabilityOptionsV7options_tFZ"></a>
  969. <a name="//apple_ref/swift/Method/propertyListResponseSerializer(options:)" class="dashAnchor"></a>
  970. <a class="token" href="#/s:9Alamofire11DataRequestC30propertyListResponseSerializerAA0bfG0VyypGSo08PropertyE13SerializationC17MutabilityOptionsV7options_tFZ">propertyListResponseSerializer(options:)</a>
  971. </code>
  972. </div>
  973. <div class="height-container">
  974. <div class="pointer-container"></div>
  975. <section class="section">
  976. <div class="pointer"></div>
  977. <div class="abstract">
  978. <p>Creates a response serializer that returns an object constructed from the response data using
  979. <code>PropertyListSerialization</code> with the specified reading options.</p>
  980. </div>
  981. <div class="declaration">
  982. <h4>Declaration</h4>
  983. <div class="language">
  984. <p class="aside-title">Swift</p>
  985. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">propertyListResponseSerializer</span><span class="p">(</span>
  986. <span class="nv">options</span><span class="p">:</span> <span class="kt">PropertyListSerialization</span><span class="o">.</span><span class="kt">ReadOptions</span> <span class="o">=</span> <span class="p">[])</span>
  987. <span class="o">-&gt;</span> <span class="kt"><a href="../Structs/DataResponseSerializer.html">DataResponseSerializer</a></span><span class="o">&lt;</span><span class="kt">Any</span><span class="o">&gt;</span></code></pre>
  988. </div>
  989. </div>
  990. <div>
  991. <h4>Parameters</h4>
  992. <table class="graybox">
  993. <tbody>
  994. <tr>
  995. <td>
  996. <code>
  997. <em>options</em>
  998. </code>
  999. </td>
  1000. <td>
  1001. <div>
  1002. <p>The property list reading options. Defaults to <code>[]</code>.</p>
  1003. </div>
  1004. </td>
  1005. </tr>
  1006. </tbody>
  1007. </table>
  1008. </div>
  1009. <div>
  1010. <h4>Return Value</h4>
  1011. <p>A property list object response serializer.</p>
  1012. </div>
  1013. </section>
  1014. </div>
  1015. </li>
  1016. <li class="item">
  1017. <div>
  1018. <code>
  1019. <a name="/s:9Alamofire11DataRequestC20responsePropertyListACXDSo13DispatchQueueCSg5queue_So0eF13SerializationC17MutabilityOptionsV7optionsyAA0B8ResponseVyypGc17completionHandlertF"></a>
  1020. <a name="//apple_ref/swift/Method/responsePropertyList(queue:options:completionHandler:)" class="dashAnchor"></a>
  1021. <a class="token" href="#/s:9Alamofire11DataRequestC20responsePropertyListACXDSo13DispatchQueueCSg5queue_So0eF13SerializationC17MutabilityOptionsV7optionsyAA0B8ResponseVyypGc17completionHandlertF">responsePropertyList(queue:options:completionHandler:)</a>
  1022. </code>
  1023. </div>
  1024. <div class="height-container">
  1025. <div class="pointer-container"></div>
  1026. <section class="section">
  1027. <div class="pointer"></div>
  1028. <div class="abstract">
  1029. <p>Adds a handler to be called once the request has finished.</p>
  1030. </div>
  1031. <div class="declaration">
  1032. <h4>Declaration</h4>
  1033. <div class="language">
  1034. <p class="aside-title">Swift</p>
  1035. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">responsePropertyList</span><span class="p">(</span>
  1036. <span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1037. <span class="nv">options</span><span class="p">:</span> <span class="kt">PropertyListSerialization</span><span class="o">.</span><span class="kt">ReadOptions</span> <span class="o">=</span> <span class="p">[],</span>
  1038. <span class="nv">completionHandler</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Structs/DataResponse.html">DataResponse</a></span><span class="o">&lt;</span><span class="kt">Any</span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span>
  1039. <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  1040. </div>
  1041. </div>
  1042. <div>
  1043. <h4>Parameters</h4>
  1044. <table class="graybox">
  1045. <tbody>
  1046. <tr>
  1047. <td>
  1048. <code>
  1049. <em>options</em>
  1050. </code>
  1051. </td>
  1052. <td>
  1053. <div>
  1054. <p>The property list reading options. Defaults to <code>[]</code>.</p>
  1055. </div>
  1056. </td>
  1057. </tr>
  1058. <tr>
  1059. <td>
  1060. <code>
  1061. <em>completionHandler</em>
  1062. </code>
  1063. </td>
  1064. <td>
  1065. <div>
  1066. <p>A closure to be executed once the request has finished.</p>
  1067. </div>
  1068. </td>
  1069. </tr>
  1070. </tbody>
  1071. </table>
  1072. </div>
  1073. <div>
  1074. <h4>Return Value</h4>
  1075. <p>The request.</p>
  1076. </div>
  1077. </section>
  1078. </div>
  1079. </li>
  1080. </ul>
  1081. </div>
  1082. <div class="task-group">
  1083. <ul class="item-container">
  1084. <li class="item">
  1085. <div>
  1086. <code>
  1087. <a name="/s:9Alamofire11DataRequestC10Validationa"></a>
  1088. <a name="//apple_ref/swift/Alias/Validation" class="dashAnchor"></a>
  1089. <a class="token" href="#/s:9Alamofire11DataRequestC10Validationa">Validation</a>
  1090. </code>
  1091. </div>
  1092. <div class="height-container">
  1093. <div class="pointer-container"></div>
  1094. <section class="section">
  1095. <div class="pointer"></div>
  1096. <div class="abstract">
  1097. <p>A closure used to validate a request that takes a URL request, a URL response and data, and returns whether the
  1098. request was valid.</p>
  1099. </div>
  1100. <div class="declaration">
  1101. <h4>Declaration</h4>
  1102. <div class="language">
  1103. <p class="aside-title">Swift</p>
  1104. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">typealias</span> <span class="kt">Validation</span> <span class="o">=</span> <span class="p">(</span><span class="kt">URLRequest</span><span class="p">?,</span> <span class="kt">HTTPURLResponse</span><span class="p">,</span> <span class="kt">Data</span><span class="p">?)</span> <span class="o">-&gt;</span> <span class="kt">ValidationResult</span></code></pre>
  1105. </div>
  1106. </div>
  1107. </section>
  1108. </div>
  1109. </li>
  1110. <li class="item">
  1111. <div>
  1112. <code>
  1113. <a name="/s:9Alamofire11DataRequestC8validateACXDAA0C0C16ValidationResultO10Foundation10URLRequestVSg_So15HTTPURLResponseCAI0B0VSgtcF"></a>
  1114. <a name="//apple_ref/swift/Method/validate(_:)" class="dashAnchor"></a>
  1115. <a class="token" href="#/s:9Alamofire11DataRequestC8validateACXDAA0C0C16ValidationResultO10Foundation10URLRequestVSg_So15HTTPURLResponseCAI0B0VSgtcF">validate(_:)</a>
  1116. </code>
  1117. </div>
  1118. <div class="height-container">
  1119. <div class="pointer-container"></div>
  1120. <section class="section">
  1121. <div class="pointer"></div>
  1122. <div class="abstract">
  1123. <p>Validates the request, using the specified closure.</p>
  1124. <p>If validation fails, subsequent calls to response handlers will have an associated error.</p>
  1125. </div>
  1126. <div class="declaration">
  1127. <h4>Declaration</h4>
  1128. <div class="language">
  1129. <p class="aside-title">Swift</p>
  1130. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">validate</span><span class="p">(</span><span class="n">_</span> <span class="nv">validation</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="kt"><a href="../Classes/DataRequest.html#/s:9Alamofire11DataRequestC10Validationa">Validation</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  1131. </div>
  1132. </div>
  1133. <div>
  1134. <h4>Parameters</h4>
  1135. <table class="graybox">
  1136. <tbody>
  1137. <tr>
  1138. <td>
  1139. <code>
  1140. <em>validation</em>
  1141. </code>
  1142. </td>
  1143. <td>
  1144. <div>
  1145. <p>A closure to validate the request.</p>
  1146. </div>
  1147. </td>
  1148. </tr>
  1149. </tbody>
  1150. </table>
  1151. </div>
  1152. <div>
  1153. <h4>Return Value</h4>
  1154. <p>The request.</p>
  1155. </div>
  1156. </section>
  1157. </div>
  1158. </li>
  1159. <li class="item">
  1160. <div>
  1161. <code>
  1162. <a name="/s:9Alamofire11DataRequestC8validateACXDx10statusCode_ts8SequenceRzSi7ElementRtzlF"></a>
  1163. <a name="//apple_ref/swift/Method/validate(statusCode:)" class="dashAnchor"></a>
  1164. <a class="token" href="#/s:9Alamofire11DataRequestC8validateACXDx10statusCode_ts8SequenceRzSi7ElementRtzlF">validate(statusCode:)</a>
  1165. </code>
  1166. </div>
  1167. <div class="height-container">
  1168. <div class="pointer-container"></div>
  1169. <section class="section">
  1170. <div class="pointer"></div>
  1171. <div class="abstract">
  1172. <p>Validates that the response has a status code in the specified sequence.</p>
  1173. <p>If validation fails, subsequent calls to response handlers will have an associated error.</p>
  1174. </div>
  1175. <div class="declaration">
  1176. <h4>Declaration</h4>
  1177. <div class="language">
  1178. <p class="aside-title">Swift</p>
  1179. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="n">validate</span><span class="o">&lt;</span><span class="kt">S</span><span class="p">:</span> <span class="kt">Sequence</span><span class="o">&gt;</span><span class="p">(</span><span class="n">statusCode</span> <span class="nv">acceptableStatusCodes</span><span class="p">:</span> <span class="kt">S</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="k">Self</span> <span class="k">where</span> <span class="kt">S</span><span class="o">.</span><span class="kt">Iterator</span><span class="o">.</span><span class="kt">Element</span> <span class="o">==</span> <span class="kt">Int</span></code></pre>
  1180. </div>
  1181. </div>
  1182. <div>
  1183. <h4>Parameters</h4>
  1184. <table class="graybox">
  1185. <tbody>
  1186. <tr>
  1187. <td>
  1188. <code>
  1189. <em>range</em>
  1190. </code>
  1191. </td>
  1192. <td>
  1193. <div>
  1194. <p>The range of acceptable status codes.</p>
  1195. </div>
  1196. </td>
  1197. </tr>
  1198. </tbody>
  1199. </table>
  1200. </div>
  1201. <div>
  1202. <h4>Return Value</h4>
  1203. <p>The request.</p>
  1204. </div>
  1205. </section>
  1206. </div>
  1207. </li>
  1208. <li class="item">
  1209. <div>
  1210. <code>
  1211. <a name="/s:9Alamofire11DataRequestC8validateACXDx11contentType_ts8SequenceRzSS7ElementRtzlF"></a>
  1212. <a name="//apple_ref/swift/Method/validate(contentType:)" class="dashAnchor"></a>
  1213. <a class="token" href="#/s:9Alamofire11DataRequestC8validateACXDx11contentType_ts8SequenceRzSS7ElementRtzlF">validate(contentType:)</a>
  1214. </code>
  1215. </div>
  1216. <div class="height-container">
  1217. <div class="pointer-container"></div>
  1218. <section class="section">
  1219. <div class="pointer"></div>
  1220. <div class="abstract">
  1221. <p>Validates that the response has a content type in the specified sequence.</p>
  1222. <p>If validation fails, subsequent calls to response handlers will have an associated error.</p>
  1223. </div>
  1224. <div class="declaration">
  1225. <h4>Declaration</h4>
  1226. <div class="language">
  1227. <p class="aside-title">Swift</p>
  1228. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="n">validate</span><span class="o">&lt;</span><span class="kt">S</span><span class="p">:</span> <span class="kt">Sequence</span><span class="o">&gt;</span><span class="p">(</span><span class="n">contentType</span> <span class="nv">acceptableContentTypes</span><span class="p">:</span> <span class="kt">S</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="k">Self</span> <span class="k">where</span> <span class="kt">S</span><span class="o">.</span><span class="kt">Iterator</span><span class="o">.</span><span class="kt">Element</span> <span class="o">==</span> <span class="kt">String</span></code></pre>
  1229. </div>
  1230. </div>
  1231. <div>
  1232. <h4>Parameters</h4>
  1233. <table class="graybox">
  1234. <tbody>
  1235. <tr>
  1236. <td>
  1237. <code>
  1238. <em>contentType</em>
  1239. </code>
  1240. </td>
  1241. <td>
  1242. <div>
  1243. <p>The acceptable content types, which may specify wildcard types and/or subtypes.</p>
  1244. </div>
  1245. </td>
  1246. </tr>
  1247. </tbody>
  1248. </table>
  1249. </div>
  1250. <div>
  1251. <h4>Return Value</h4>
  1252. <p>The request.</p>
  1253. </div>
  1254. </section>
  1255. </div>
  1256. </li>
  1257. <li class="item">
  1258. <div>
  1259. <code>
  1260. <a name="/s:9Alamofire11DataRequestC8validateACXDyF"></a>
  1261. <a name="//apple_ref/swift/Method/validate()" class="dashAnchor"></a>
  1262. <a class="token" href="#/s:9Alamofire11DataRequestC8validateACXDyF">validate()</a>
  1263. </code>
  1264. </div>
  1265. <div class="height-container">
  1266. <div class="pointer-container"></div>
  1267. <section class="section">
  1268. <div class="pointer"></div>
  1269. <div class="abstract">
  1270. <p>Validates that the response has a status code in the default acceptable range of 200&hellip;299, and that the content
  1271. type matches any specified in the Accept HTTP header field.</p>
  1272. <p>If validation fails, subsequent calls to response handlers will have an associated error.</p>
  1273. </div>
  1274. <div class="declaration">
  1275. <h4>Declaration</h4>
  1276. <div class="language">
  1277. <p class="aside-title">Swift</p>
  1278. <pre class="highlight"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">validate</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="k">Self</span></code></pre>
  1279. </div>
  1280. </div>
  1281. <div>
  1282. <h4>Return Value</h4>
  1283. <p>The request.</p>
  1284. </div>
  1285. </section>
  1286. </div>
  1287. </li>
  1288. </ul>
  1289. </div>
  1290. </div>
  1291. </section>
  1292. </article>
  1293. </div>
  1294. <section class="footer">
  1295. <p>&copy; 2017 <a class="link" href="http://alamofire.org/" target="_blank" rel="external">Alamofire Software Foundation</a>. All rights reserved. (Last updated: 2017-12-03)</p>
  1296. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.0</a>, a <a class="link" href="http://realm.io" target="_blank" rel="external">Realm</a> project.</p>
  1297. </section>
  1298. </body>
  1299. </div>
  1300. </html>