AF.html 105 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>AF Enumeration 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/Enum/AF" class="dashAnchor"></a>
  16. <a title="AF Enumeration 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. (77% 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. AF Enumeration 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/AlamofireNotifications.html">AlamofireNotifications</a>
  55. </li>
  56. <li class="nav-group-task">
  57. <a class="nav-group-task-link" href="../Classes/ClosureEventMonitor.html">ClosureEventMonitor</a>
  58. </li>
  59. <li class="nav-group-task">
  60. <a class="nav-group-task-link" href="../Classes/CompositeEventMonitor.html">CompositeEventMonitor</a>
  61. </li>
  62. <li class="nav-group-task">
  63. <a class="nav-group-task-link" href="../Classes/CompositeTrustEvaluator.html">CompositeTrustEvaluator</a>
  64. </li>
  65. <li class="nav-group-task">
  66. <a class="nav-group-task-link" href="../Classes/DataRequest.html">DataRequest</a>
  67. </li>
  68. <li class="nav-group-task">
  69. <a class="nav-group-task-link" href="../Classes/DataResponseSerializer.html">DataResponseSerializer</a>
  70. </li>
  71. <li class="nav-group-task">
  72. <a class="nav-group-task-link" href="../Classes/DecodableResponseSerializer.html">DecodableResponseSerializer</a>
  73. </li>
  74. <li class="nav-group-task">
  75. <a class="nav-group-task-link" href="../Classes/DefaultTrustEvaluator.html">DefaultTrustEvaluator</a>
  76. </li>
  77. <li class="nav-group-task">
  78. <a class="nav-group-task-link" href="../Classes/DisabledEvaluator.html">DisabledEvaluator</a>
  79. </li>
  80. <li class="nav-group-task">
  81. <a class="nav-group-task-link" href="../Classes/DownloadRequest.html">DownloadRequest</a>
  82. </li>
  83. <li class="nav-group-task">
  84. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Options.html">– Options</a>
  85. </li>
  86. <li class="nav-group-task">
  87. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Downloadable.html">– Downloadable</a>
  88. </li>
  89. <li class="nav-group-task">
  90. <a class="nav-group-task-link" href="../Classes/JSONParameterEncoder.html">JSONParameterEncoder</a>
  91. </li>
  92. <li class="nav-group-task">
  93. <a class="nav-group-task-link" href="../Classes/JSONResponseSerializer.html">JSONResponseSerializer</a>
  94. </li>
  95. <li class="nav-group-task">
  96. <a class="nav-group-task-link" href="../Classes/MultipartFormData.html">MultipartFormData</a>
  97. </li>
  98. <li class="nav-group-task">
  99. <a class="nav-group-task-link" href="../Classes/MultipartUpload.html">MultipartUpload</a>
  100. </li>
  101. <li class="nav-group-task">
  102. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a>
  103. </li>
  104. <li class="nav-group-task">
  105. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/NetworkReachabilityStatus.html">– NetworkReachabilityStatus</a>
  106. </li>
  107. <li class="nav-group-task">
  108. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/ConnectionType.html">– ConnectionType</a>
  109. </li>
  110. <li class="nav-group-task">
  111. <a class="nav-group-task-link" href="../Classes/PinnedCertificatesTrustEvaluator.html">PinnedCertificatesTrustEvaluator</a>
  112. </li>
  113. <li class="nav-group-task">
  114. <a class="nav-group-task-link" href="../Classes/PublicKeysTrustEvaluator.html">PublicKeysTrustEvaluator</a>
  115. </li>
  116. <li class="nav-group-task">
  117. <a class="nav-group-task-link" href="../Classes/Request.html">Request</a>
  118. </li>
  119. <li class="nav-group-task">
  120. <a class="nav-group-task-link" href="../Classes/Request/State.html">– State</a>
  121. </li>
  122. <li class="nav-group-task">
  123. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator.html">RevocationTrustEvaluator</a>
  124. </li>
  125. <li class="nav-group-task">
  126. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator/Options.html">– Options</a>
  127. </li>
  128. <li class="nav-group-task">
  129. <a class="nav-group-task-link" href="../Classes/ServerTrustManager.html">ServerTrustManager</a>
  130. </li>
  131. <li class="nav-group-task">
  132. <a class="nav-group-task-link" href="../Classes/Session.html">Session</a>
  133. </li>
  134. <li class="nav-group-task">
  135. <a class="nav-group-task-link" href="../Classes/SessionDelegate.html">SessionDelegate</a>
  136. </li>
  137. <li class="nav-group-task">
  138. <a class="nav-group-task-link" href="../Classes/StringResponseSerializer.html">StringResponseSerializer</a>
  139. </li>
  140. <li class="nav-group-task">
  141. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder.html">URLEncodedFormEncoder</a>
  142. </li>
  143. <li class="nav-group-task">
  144. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/BoolEncoding.html">– BoolEncoding</a>
  145. </li>
  146. <li class="nav-group-task">
  147. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/ArrayEncoding.html">– ArrayEncoding</a>
  148. </li>
  149. <li class="nav-group-task">
  150. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/SpaceEncoding.html">– SpaceEncoding</a>
  151. </li>
  152. <li class="nav-group-task">
  153. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/Error.html">– Error</a>
  154. </li>
  155. <li class="nav-group-task">
  156. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a>
  157. </li>
  158. <li class="nav-group-task">
  159. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder/Destination.html">– Destination</a>
  160. </li>
  161. <li class="nav-group-task">
  162. <a class="nav-group-task-link" href="../Classes/UploadRequest.html">UploadRequest</a>
  163. </li>
  164. <li class="nav-group-task">
  165. <a class="nav-group-task-link" href="../Classes/UploadRequest/Uploadable.html">– Uploadable</a>
  166. </li>
  167. </ul>
  168. </li>
  169. <li class="nav-group-name">
  170. <a class="nav-group-name-link" href="../Enums.html">Enumerations</a>
  171. <ul class="nav-group-tasks">
  172. <li class="nav-group-task">
  173. <a class="nav-group-task-link" href="../Enums/AF.html">AF</a>
  174. </li>
  175. <li class="nav-group-task">
  176. <a class="nav-group-task-link" href="../Enums/AFError.html">AFError</a>
  177. </li>
  178. <li class="nav-group-task">
  179. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncodingFailureReason.html">– ParameterEncodingFailureReason</a>
  180. </li>
  181. <li class="nav-group-task">
  182. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncoderFailureReason.html">– ParameterEncoderFailureReason</a>
  183. </li>
  184. <li class="nav-group-task">
  185. <a class="nav-group-task-link" href="../Enums/AFError/MultipartEncodingFailureReason.html">– MultipartEncodingFailureReason</a>
  186. </li>
  187. <li class="nav-group-task">
  188. <a class="nav-group-task-link" href="../Enums/AFError/ResponseValidationFailureReason.html">– ResponseValidationFailureReason</a>
  189. </li>
  190. <li class="nav-group-task">
  191. <a class="nav-group-task-link" href="../Enums/AFError/ResponseSerializationFailureReason.html">– ResponseSerializationFailureReason</a>
  192. </li>
  193. <li class="nav-group-task">
  194. <a class="nav-group-task-link" href="../Enums/AFError/ServerTrustFailureReason.html">– ServerTrustFailureReason</a>
  195. </li>
  196. <li class="nav-group-task">
  197. <a class="nav-group-task-link" href="../Enums/HTTPMethod.html">HTTPMethod</a>
  198. </li>
  199. <li class="nav-group-task">
  200. <a class="nav-group-task-link" href="../Enums/Result.html">Result</a>
  201. </li>
  202. </ul>
  203. </li>
  204. <li class="nav-group-name">
  205. <a class="nav-group-name-link" href="../Extensions.html">Extensions</a>
  206. <ul class="nav-group-tasks">
  207. <li class="nav-group-task">
  208. <a class="nav-group-task-link" href="../Extensions/Array.html">Array</a>
  209. </li>
  210. <li class="nav-group-task">
  211. <a class="nav-group-task-link" href="../Extensions/Bundle.html">Bundle</a>
  212. </li>
  213. <li class="nav-group-task">
  214. <a class="nav-group-task-link" href="../Extensions/CharacterSet.html">CharacterSet</a>
  215. </li>
  216. <li class="nav-group-task">
  217. <a class="nav-group-task-link" href="../Extensions/Error.html">Error</a>
  218. </li>
  219. <li class="nav-group-task">
  220. <a class="nav-group-task-link" href="../Extensions/HTTPURLResponse.html">HTTPURLResponse</a>
  221. </li>
  222. <li class="nav-group-task">
  223. <a class="nav-group-task-link" href="../Extensions/Notification.html">Notification</a>
  224. </li>
  225. <li class="nav-group-task">
  226. <a class="nav-group-task-link" href="../Extensions/SecTrust.html">SecTrust</a>
  227. </li>
  228. <li class="nav-group-task">
  229. <a class="nav-group-task-link" href="../Extensions/String.html">String</a>
  230. </li>
  231. <li class="nav-group-task">
  232. <a class="nav-group-task-link" href="../Extensions/URL.html">URL</a>
  233. </li>
  234. <li class="nav-group-task">
  235. <a class="nav-group-task-link" href="../Extensions/URLComponents.html">URLComponents</a>
  236. </li>
  237. <li class="nav-group-task">
  238. <a class="nav-group-task-link" href="../Extensions/URLRequest.html">URLRequest</a>
  239. </li>
  240. <li class="nav-group-task">
  241. <a class="nav-group-task-link" href="../Extensions/URLSessionConfiguration.html">URLSessionConfiguration</a>
  242. </li>
  243. </ul>
  244. </li>
  245. <li class="nav-group-name">
  246. <a class="nav-group-name-link" href="../Functions.html">Functions</a>
  247. <ul class="nav-group-tasks">
  248. <li class="nav-group-task">
  249. <a class="nav-group-task-link" href="../Functions.html#/s:9Alamofire2eeoiySbAA26NetworkReachabilityManagerC0cD6StatusO_AFtF">==(_:_:)</a>
  250. </li>
  251. </ul>
  252. </li>
  253. <li class="nav-group-name">
  254. <a class="nav-group-name-link" href="../Protocols.html">Protocols</a>
  255. <ul class="nav-group-tasks">
  256. <li class="nav-group-task">
  257. <a class="nav-group-task-link" href="../Protocols/DataDecoder.html">DataDecoder</a>
  258. </li>
  259. <li class="nav-group-task">
  260. <a class="nav-group-task-link" href="../Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a>
  261. </li>
  262. <li class="nav-group-task">
  263. <a class="nav-group-task-link" href="../Protocols/DownloadResponseSerializerProtocol.html">DownloadResponseSerializerProtocol</a>
  264. </li>
  265. <li class="nav-group-task">
  266. <a class="nav-group-task-link" href="../Protocols/EventMonitor.html">EventMonitor</a>
  267. </li>
  268. <li class="nav-group-task">
  269. <a class="nav-group-task-link" href="../Protocols/ParameterEncoder.html">ParameterEncoder</a>
  270. </li>
  271. <li class="nav-group-task">
  272. <a class="nav-group-task-link" href="../Protocols/ParameterEncoding.html">ParameterEncoding</a>
  273. </li>
  274. <li class="nav-group-task">
  275. <a class="nav-group-task-link" href="../Protocols/RequestAdapter.html">RequestAdapter</a>
  276. </li>
  277. <li class="nav-group-task">
  278. <a class="nav-group-task-link" href="../Protocols/RequestDelegate.html">RequestDelegate</a>
  279. </li>
  280. <li class="nav-group-task">
  281. <a class="nav-group-task-link" href="../Protocols/RequestRetrier.html">RequestRetrier</a>
  282. </li>
  283. <li class="nav-group-task">
  284. <a class="nav-group-task-link" href="../Protocols/ResponseSerializer.html">ResponseSerializer</a>
  285. </li>
  286. <li class="nav-group-task">
  287. <a class="nav-group-task-link" href="../Protocols/ServerTrustEvaluating.html">ServerTrustEvaluating</a>
  288. </li>
  289. <li class="nav-group-task">
  290. <a class="nav-group-task-link" href="../Protocols/SessionStateProvider.html">SessionStateProvider</a>
  291. </li>
  292. <li class="nav-group-task">
  293. <a class="nav-group-task-link" href="../Protocols/URLConvertible.html">URLConvertible</a>
  294. </li>
  295. <li class="nav-group-task">
  296. <a class="nav-group-task-link" href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
  297. </li>
  298. <li class="nav-group-task">
  299. <a class="nav-group-task-link" href="../Protocols.html#/s:9Alamofire17UploadConvertibleP">UploadConvertible</a>
  300. </li>
  301. <li class="nav-group-task">
  302. <a class="nav-group-task-link" href="../Protocols/UploadableConvertible.html">UploadableConvertible</a>
  303. </li>
  304. </ul>
  305. </li>
  306. <li class="nav-group-name">
  307. <a class="nav-group-name-link" href="../Structs.html">Structures</a>
  308. <ul class="nav-group-tasks">
  309. <li class="nav-group-task">
  310. <a class="nav-group-task-link" href="../Structs/DataResponse.html">DataResponse</a>
  311. </li>
  312. <li class="nav-group-task">
  313. <a class="nav-group-task-link" href="../Structs/DownloadResponse.html">DownloadResponse</a>
  314. </li>
  315. <li class="nav-group-task">
  316. <a class="nav-group-task-link" href="../Structs/Empty.html">Empty</a>
  317. </li>
  318. <li class="nav-group-task">
  319. <a class="nav-group-task-link" href="../Structs/HTTPHeader.html">HTTPHeader</a>
  320. </li>
  321. <li class="nav-group-task">
  322. <a class="nav-group-task-link" href="../Structs/HTTPHeaders.html">HTTPHeaders</a>
  323. </li>
  324. <li class="nav-group-task">
  325. <a class="nav-group-task-link" href="../Structs/JSONEncoding.html">JSONEncoding</a>
  326. </li>
  327. <li class="nav-group-task">
  328. <a class="nav-group-task-link" href="../Structs/URLEncoding.html">URLEncoding</a>
  329. </li>
  330. <li class="nav-group-task">
  331. <a class="nav-group-task-link" href="../Structs/URLEncoding/Destination.html">– Destination</a>
  332. </li>
  333. <li class="nav-group-task">
  334. <a class="nav-group-task-link" href="../Structs/URLEncoding/ArrayEncoding.html">– ArrayEncoding</a>
  335. </li>
  336. <li class="nav-group-task">
  337. <a class="nav-group-task-link" href="../Structs/URLEncoding/BoolEncoding.html">– BoolEncoding</a>
  338. </li>
  339. </ul>
  340. </li>
  341. <li class="nav-group-name">
  342. <a class="nav-group-name-link" href="../Typealiases.html">Type Aliases</a>
  343. <ul class="nav-group-tasks">
  344. <li class="nav-group-task">
  345. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a>
  346. </li>
  347. <li class="nav-group-task">
  348. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire22RequestRetryCompletiona">RequestRetryCompletion</a>
  349. </li>
  350. </ul>
  351. </li>
  352. </ul>
  353. </nav>
  354. <article class="main-content">
  355. <section class="section">
  356. <div class="section-content">
  357. <h1>AF</h1>
  358. <div class="declaration">
  359. <div class="language">
  360. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">enum</span> <span class="kt">AF</span></code></pre>
  361. </div>
  362. </div>
  363. <p>Global namespace containing API for the <code>default</code> <code><a href="../Classes/Session.html">Session</a></code> instance.</p>
  364. </div>
  365. </section>
  366. <section class="section">
  367. <div class="section-content">
  368. <div class="task-group">
  369. <div class="task-name-container">
  370. <a name="/Data%20Request"></a>
  371. <a name="//apple_ref/swift/Section/Data Request" class="dashAnchor"></a>
  372. <a href="#/Data%20Request">
  373. <h3 class="section-name">Data Request</h3>
  374. </a>
  375. </div>
  376. <ul class="item-container">
  377. <li class="item">
  378. <div>
  379. <code>
  380. <a name="/s:9Alamofire2AFO7request_6method10parameters8encoding7headersAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgtFZ"></a>
  381. <a name="//apple_ref/swift/Method/request(_:method:parameters:encoding:headers:)" class="dashAnchor"></a>
  382. <a class="token" href="#/s:9Alamofire2AFO7request_6method10parameters8encoding7headersAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgtFZ">request(_:method:parameters:encoding:headers:)</a>
  383. </code>
  384. </div>
  385. <div class="height-container">
  386. <div class="pointer-container"></div>
  387. <section class="section">
  388. <div class="pointer"></div>
  389. <div class="abstract">
  390. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> using <code>SessionManager.default</code> to retrive the contents of the specified <code>url</code>
  391. using the <code>method</code>, <code>parameters</code>, <code>encoding</code>, and <code>headers</code> provided.</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 swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  398. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  399. <span class="nv">parameters</span><span class="p">:</span> <span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  400. <span class="nv">encoding</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></span> <span class="o">=</span> <span class="kt"><a href="../Structs/URLEncoding.html">URLEncoding</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  401. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></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="../Classes/DataRequest.html">DataRequest</a></span></code></pre>
  402. </div>
  403. </div>
  404. <div>
  405. <h4>Parameters</h4>
  406. <table class="graybox">
  407. <tbody>
  408. <tr>
  409. <td>
  410. <code>
  411. <em>url</em>
  412. </code>
  413. </td>
  414. <td>
  415. <div>
  416. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  417. </div>
  418. </td>
  419. </tr>
  420. <tr>
  421. <td>
  422. <code>
  423. <em>method</em>
  424. </code>
  425. </td>
  426. <td>
  427. <div>
  428. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  429. </div>
  430. </td>
  431. </tr>
  432. <tr>
  433. <td>
  434. <code>
  435. <em>parameters</em>
  436. </code>
  437. </td>
  438. <td>
  439. <div>
  440. <p>The <code><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></code>, <code>nil</code> by default.</p>
  441. </div>
  442. </td>
  443. </tr>
  444. <tr>
  445. <td>
  446. <code>
  447. <em>encoding</em>
  448. </code>
  449. </td>
  450. <td>
  451. <div>
  452. <p>The <code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code>, <code><a href="../Structs/URLEncoding.html#/s:9Alamofire11URLEncodingV7defaultACvpZ">URLEncoding.default</a></code> by default.</p>
  453. </div>
  454. </td>
  455. </tr>
  456. <tr>
  457. <td>
  458. <code>
  459. <em>headers</em>
  460. </code>
  461. </td>
  462. <td>
  463. <div>
  464. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  465. </div>
  466. </td>
  467. </tr>
  468. </tbody>
  469. </table>
  470. </div>
  471. <div>
  472. <h4>Return Value</h4>
  473. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  474. </div>
  475. </section>
  476. </div>
  477. </li>
  478. <li class="item">
  479. <div>
  480. <code>
  481. <a name="/s:9Alamofire2AFO7request_6method10parameters7encoder7headersAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgtSERzlFZ"></a>
  482. <a name="//apple_ref/swift/Method/request(_:method:parameters:encoder:headers:)" class="dashAnchor"></a>
  483. <a class="token" href="#/s:9Alamofire2AFO7request_6method10parameters7encoder7headersAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgtSERzlFZ">request(_:method:parameters:encoder:headers:)</a>
  484. </code>
  485. </div>
  486. <div class="height-container">
  487. <div class="pointer-container"></div>
  488. <section class="section">
  489. <div class="pointer"></div>
  490. <div class="abstract">
  491. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> using <code>SessionManager.default</code> to retrive the contents of the specified <code>url</code>
  492. using the <code>method</code>, <code>parameters</code>, <code>encoding</code>, and <code>headers</code> provided.</p>
  493. </div>
  494. <div class="declaration">
  495. <h4>Declaration</h4>
  496. <div class="language">
  497. <p class="aside-title">Swift</p>
  498. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="n">request</span><span class="o">&lt;</span><span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">:</span> <span class="kt">Encodable</span><span class="o">&gt;</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  499. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  500. <span class="nv">parameters</span><span class="p">:</span> <span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  501. <span class="nv">encoder</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></span> <span class="o">=</span> <span class="kt"><a href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  502. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></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="../Classes/DataRequest.html">DataRequest</a></span></code></pre>
  503. </div>
  504. </div>
  505. <div>
  506. <h4>Parameters</h4>
  507. <table class="graybox">
  508. <tbody>
  509. <tr>
  510. <td>
  511. <code>
  512. <em>url</em>
  513. </code>
  514. </td>
  515. <td>
  516. <div>
  517. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  518. </div>
  519. </td>
  520. </tr>
  521. <tr>
  522. <td>
  523. <code>
  524. <em>method</em>
  525. </code>
  526. </td>
  527. <td>
  528. <div>
  529. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  530. </div>
  531. </td>
  532. </tr>
  533. <tr>
  534. <td>
  535. <code>
  536. <em>parameters</em>
  537. </code>
  538. </td>
  539. <td>
  540. <div>
  541. <p>The <code>Encodable</code> parameters, <code>nil</code> by default.</p>
  542. </div>
  543. </td>
  544. </tr>
  545. <tr>
  546. <td>
  547. <code>
  548. <em>encoding</em>
  549. </code>
  550. </td>
  551. <td>
  552. <div>
  553. <p>The <code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code>, <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code> by default.</p>
  554. </div>
  555. </td>
  556. </tr>
  557. <tr>
  558. <td>
  559. <code>
  560. <em>headers</em>
  561. </code>
  562. </td>
  563. <td>
  564. <div>
  565. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  566. </div>
  567. </td>
  568. </tr>
  569. </tbody>
  570. </table>
  571. </div>
  572. <div>
  573. <h4>Return Value</h4>
  574. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  575. </div>
  576. </section>
  577. </div>
  578. </li>
  579. <li class="item">
  580. <div>
  581. <code>
  582. <a name="/s:9Alamofire2AFO7requestyAA11DataRequestCAA21URLRequestConvertible_pFZ"></a>
  583. <a name="//apple_ref/swift/Method/request(_:)" class="dashAnchor"></a>
  584. <a class="token" href="#/s:9Alamofire2AFO7requestyAA11DataRequestCAA21URLRequestConvertible_pFZ">request(_:)</a>
  585. </code>
  586. </div>
  587. <div class="height-container">
  588. <div class="pointer-container"></div>
  589. <section class="section">
  590. <div class="pointer"></div>
  591. <div class="abstract">
  592. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> using <code>SessionManager.default</code> to execute the specified <code>urlRequest</code>.</p>
  593. </div>
  594. <div class="declaration">
  595. <h4>Declaration</h4>
  596. <div class="language">
  597. <p class="aside-title">Swift</p>
  598. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="n">_</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/DataRequest.html">DataRequest</a></span></code></pre>
  599. </div>
  600. </div>
  601. <div>
  602. <h4>Parameters</h4>
  603. <table class="graybox">
  604. <tbody>
  605. <tr>
  606. <td>
  607. <code>
  608. <em>urlRequest</em>
  609. </code>
  610. </td>
  611. <td>
  612. <div>
  613. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  614. </div>
  615. </td>
  616. </tr>
  617. </tbody>
  618. </table>
  619. </div>
  620. <div>
  621. <h4>Return Value</h4>
  622. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  623. </div>
  624. </section>
  625. </div>
  626. </li>
  627. </ul>
  628. </div>
  629. <div class="task-group">
  630. <div class="task-name-container">
  631. <a name="/Download%20Request"></a>
  632. <a name="//apple_ref/swift/Section/Download Request" class="dashAnchor"></a>
  633. <a href="#/Download%20Request">
  634. <h3 class="section-name">Download Request</h3>
  635. </a>
  636. </div>
  637. <ul class="item-container">
  638. <li class="item">
  639. <div>
  640. <code>
  641. <a name="/s:9Alamofire2AFO8download_6method10parameters8encoding7headers2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSg10Foundation3URLV011destinationQ0_AK7OptionsV7optionstAW_So17NSHTTPURLResponseCtcSgtFZ"></a>
  642. <a name="//apple_ref/swift/Method/download(_:method:parameters:encoding:headers:to:)" class="dashAnchor"></a>
  643. <a class="token" href="#/s:9Alamofire2AFO8download_6method10parameters8encoding7headers2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSg10Foundation3URLV011destinationQ0_AK7OptionsV7optionstAW_So17NSHTTPURLResponseCtcSgtFZ">download(_:method:parameters:encoding:headers:to:)</a>
  644. </code>
  645. </div>
  646. <div class="height-container">
  647. <div class="pointer-container"></div>
  648. <section class="section">
  649. <div class="pointer"></div>
  650. <div class="abstract">
  651. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using <code>SessionManager.default</code> to download the contents of the specified <code>url</code> to
  652. the provided <code>destination</code> using the <code>method</code>, <code>parameters</code>, <code>encoding</code>, and <code>headers</code> provided.</p>
  653. <p>If <code>destination</code> is not specified, the download will remain at the temporary location determined by the
  654. underlying <code>URLSession</code>.</p>
  655. </div>
  656. <div class="declaration">
  657. <h4>Declaration</h4>
  658. <div class="language">
  659. <p class="aside-title">Swift</p>
  660. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  661. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  662. <span class="nv">parameters</span><span class="p">:</span> <span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  663. <span class="nv">encoding</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></span> <span class="o">=</span> <span class="kt"><a href="../Structs/URLEncoding.html">URLEncoding</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  664. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  665. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</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="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  666. </div>
  667. </div>
  668. <div>
  669. <h4>Parameters</h4>
  670. <table class="graybox">
  671. <tbody>
  672. <tr>
  673. <td>
  674. <code>
  675. <em>url</em>
  676. </code>
  677. </td>
  678. <td>
  679. <div>
  680. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  681. </div>
  682. </td>
  683. </tr>
  684. <tr>
  685. <td>
  686. <code>
  687. <em>method</em>
  688. </code>
  689. </td>
  690. <td>
  691. <div>
  692. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  693. </div>
  694. </td>
  695. </tr>
  696. <tr>
  697. <td>
  698. <code>
  699. <em>parameters</em>
  700. </code>
  701. </td>
  702. <td>
  703. <div>
  704. <p>The <code><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></code>, <code>nil</code> by default.</p>
  705. </div>
  706. </td>
  707. </tr>
  708. <tr>
  709. <td>
  710. <code>
  711. <em>encoding</em>
  712. </code>
  713. </td>
  714. <td>
  715. <div>
  716. <p>The <code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code>, <code><a href="../Structs/URLEncoding.html#/s:9Alamofire11URLEncodingV7defaultACvpZ">URLEncoding.default</a></code> by default.</p>
  717. </div>
  718. </td>
  719. </tr>
  720. <tr>
  721. <td>
  722. <code>
  723. <em>headers</em>
  724. </code>
  725. </td>
  726. <td>
  727. <div>
  728. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  729. </div>
  730. </td>
  731. </tr>
  732. <tr>
  733. <td>
  734. <code>
  735. <em>destination</em>
  736. </code>
  737. </td>
  738. <td>
  739. <div>
  740. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used the determine the destination of the downloaded
  741. file. <code>nil</code> by default.</p>
  742. </div>
  743. </td>
  744. </tr>
  745. </tbody>
  746. </table>
  747. </div>
  748. <div>
  749. <h4>Return Value</h4>
  750. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  751. </div>
  752. </section>
  753. </div>
  754. </li>
  755. <li class="item">
  756. <div>
  757. <code>
  758. <a name="/s:9Alamofire2AFO8download_6method10parameters7encoder7headers2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSg10Foundation3URLV011destinationQ0_AK7OptionsV7optionstAV_So17NSHTTPURLResponseCtcSgtSERzlFZ"></a>
  759. <a name="//apple_ref/swift/Method/download(_:method:parameters:encoder:headers:to:)" class="dashAnchor"></a>
  760. <a class="token" href="#/s:9Alamofire2AFO8download_6method10parameters7encoder7headers2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodOxSgAA16ParameterEncoder_pAA11HTTPHeadersVSg10Foundation3URLV011destinationQ0_AK7OptionsV7optionstAV_So17NSHTTPURLResponseCtcSgtSERzlFZ">download(_:method:parameters:encoder:headers:to:)</a>
  761. </code>
  762. </div>
  763. <div class="height-container">
  764. <div class="pointer-container"></div>
  765. <section class="section">
  766. <div class="pointer"></div>
  767. <div class="abstract">
  768. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using <code>SessionManager.default</code> to download the contents of the specified <code>url</code> to
  769. the provided <code>destination</code> using the <code>method</code>, encodable <code>parameters</code>, <code>encoder</code>, and <code>headers</code> provided.</p>
  770. <p>If <code>destination</code> is not specified, the download will remain at the temporary location determined by the
  771. underlying <code>URLSession</code>.</p>
  772. </div>
  773. <div class="declaration">
  774. <h4>Declaration</h4>
  775. <div class="language">
  776. <p class="aside-title">Swift</p>
  777. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="n">download</span><span class="o">&lt;</span><span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">:</span> <span class="kt">Encodable</span><span class="o">&gt;</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  778. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  779. <span class="nv">parameters</span><span class="p">:</span> <span class="kt"><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  780. <span class="nv">encoder</span><span class="p">:</span> <span class="kt"><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></span> <span class="o">=</span> <span class="kt"><a href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a></span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  781. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  782. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</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="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  783. </div>
  784. </div>
  785. <div>
  786. <h4>Parameters</h4>
  787. <table class="graybox">
  788. <tbody>
  789. <tr>
  790. <td>
  791. <code>
  792. <em>url</em>
  793. </code>
  794. </td>
  795. <td>
  796. <div>
  797. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  798. </div>
  799. </td>
  800. </tr>
  801. <tr>
  802. <td>
  803. <code>
  804. <em>method</em>
  805. </code>
  806. </td>
  807. <td>
  808. <div>
  809. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.get</code> by default.</p>
  810. </div>
  811. </td>
  812. </tr>
  813. <tr>
  814. <td>
  815. <code>
  816. <em>parameters</em>
  817. </code>
  818. </td>
  819. <td>
  820. <div>
  821. <p>The <code>Encodable</code> parameters, <code>nil</code> by default.</p>
  822. </div>
  823. </td>
  824. </tr>
  825. <tr>
  826. <td>
  827. <code>
  828. <em>encoder</em>
  829. </code>
  830. </td>
  831. <td>
  832. <div>
  833. <p>The <code><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></code>, <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code> by default.</p>
  834. </div>
  835. </td>
  836. </tr>
  837. <tr>
  838. <td>
  839. <code>
  840. <em>headers</em>
  841. </code>
  842. </td>
  843. <td>
  844. <div>
  845. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  846. </div>
  847. </td>
  848. </tr>
  849. <tr>
  850. <td>
  851. <code>
  852. <em>destination</em>
  853. </code>
  854. </td>
  855. <td>
  856. <div>
  857. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used the determine the destination of the downloaded
  858. file. <code>nil</code> by default.</p>
  859. </div>
  860. </td>
  861. </tr>
  862. </tbody>
  863. </table>
  864. </div>
  865. <div>
  866. <h4>Return Value</h4>
  867. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  868. </div>
  869. </section>
  870. </div>
  871. </li>
  872. </ul>
  873. </div>
  874. <div class="task-group">
  875. <div class="task-name-container">
  876. <a name="/URLRequest"></a>
  877. <a name="//apple_ref/swift/Section/URLRequest" class="dashAnchor"></a>
  878. <a href="#/URLRequest">
  879. <h3 class="section-name">URLRequest</h3>
  880. </a>
  881. </div>
  882. <ul class="item-container">
  883. <li class="item">
  884. <div>
  885. <code>
  886. <a name="/s:9Alamofire2AFO8download_2toAA15DownloadRequestCAA21URLRequestConvertible_p_10Foundation3URLV011destinationJ0_AG7OptionsV7optionstAK_So17NSHTTPURLResponseCtcSgtFZ"></a>
  887. <a name="//apple_ref/swift/Method/download(_:to:)" class="dashAnchor"></a>
  888. <a class="token" href="#/s:9Alamofire2AFO8download_2toAA15DownloadRequestCAA21URLRequestConvertible_p_10Foundation3URLV011destinationJ0_AG7OptionsV7optionstAK_So17NSHTTPURLResponseCtcSgtFZ">download(_:to:)</a>
  889. </code>
  890. </div>
  891. <div class="height-container">
  892. <div class="pointer-container"></div>
  893. <section class="section">
  894. <div class="pointer"></div>
  895. <div class="abstract">
  896. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using <code>SessionManager.default</code> to execute the specified <code>urlRequest</code> and download
  897. the result to the provided <code>destination</code>.</p>
  898. </div>
  899. <div class="declaration">
  900. <h4>Declaration</h4>
  901. <div class="language">
  902. <p class="aside-title">Swift</p>
  903. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">_</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  904. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</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="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  905. </div>
  906. </div>
  907. <div>
  908. <h4>Parameters</h4>
  909. <table class="graybox">
  910. <tbody>
  911. <tr>
  912. <td>
  913. <code>
  914. <em>urlRequest</em>
  915. </code>
  916. </td>
  917. <td>
  918. <div>
  919. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  920. </div>
  921. </td>
  922. </tr>
  923. <tr>
  924. <td>
  925. <code>
  926. <em>destination</em>
  927. </code>
  928. </td>
  929. <td>
  930. <div>
  931. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used the determine the destination of the downloaded
  932. file. <code>nil</code> by default.</p>
  933. </div>
  934. </td>
  935. </tr>
  936. </tbody>
  937. </table>
  938. </div>
  939. <div>
  940. <h4>Return Value</h4>
  941. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  942. </div>
  943. </section>
  944. </div>
  945. </li>
  946. </ul>
  947. </div>
  948. <div class="task-group">
  949. <div class="task-name-container">
  950. <a name="/Resume%20Data"></a>
  951. <a name="//apple_ref/swift/Section/Resume Data" class="dashAnchor"></a>
  952. <a href="#/Resume%20Data">
  953. <h3 class="section-name">Resume Data</h3>
  954. </a>
  955. </div>
  956. <ul class="item-container">
  957. <li class="item">
  958. <div>
  959. <code>
  960. <a name="/s:9Alamofire2AFO8download12resumingWith2toAA15DownloadRequestC10Foundation4DataV_AI3URLV011destinationK0_AH7OptionsV7optionstAM_So17NSHTTPURLResponseCtcSgtFZ"></a>
  961. <a name="//apple_ref/swift/Method/download(resumingWith:to:)" class="dashAnchor"></a>
  962. <a class="token" href="#/s:9Alamofire2AFO8download12resumingWith2toAA15DownloadRequestC10Foundation4DataV_AI3URLV011destinationK0_AH7OptionsV7optionstAM_So17NSHTTPURLResponseCtcSgtFZ">download(resumingWith:to:)</a>
  963. </code>
  964. </div>
  965. <div class="height-container">
  966. <div class="pointer-container"></div>
  967. <section class="section">
  968. <div class="pointer"></div>
  969. <div class="abstract">
  970. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using the <code>SessionManager.default</code> from the <code>resumeData</code> produced from a previous
  971. <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> cancellation to retrieve the contents of the original request and save them to the <code>destination</code>.</p>
  972. <p>If <code>destination</code> is not specified, the contents will remain in the temporary location determined by the
  973. underlying URL session.</p>
  974. <p>On some versions of all Apple platforms (iOS 10 - 10.2, macOS 10.12 - 10.12.2, tvOS 10 - 10.1, watchOS 3 - 3.1.1),
  975. <code>resumeData</code> is broken on background URL session configurations. There&rsquo;s an underlying bug in the <code>resumeData</code>
  976. generation logic where the data is written incorrectly and will always fail to resume the download. For more
  977. information about the bug and possible workarounds, please refer to the <a href="http://stackoverflow.com/a/39347461/1342462">this Stack Overflow post</a>.</p>
  978. </div>
  979. <div class="declaration">
  980. <h4>Declaration</h4>
  981. <div class="language">
  982. <p class="aside-title">Swift</p>
  983. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">resumingWith</span> <span class="nv">resumeData</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  984. <span class="n">to</span> <span class="nv">destination</span><span class="p">:</span> <span class="kt"><a href="../Classes/DownloadRequest.html">DownloadRequest</a></span><span class="o">.</span><span class="kt">Destination</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="../Classes/DownloadRequest.html">DownloadRequest</a></span></code></pre>
  985. </div>
  986. </div>
  987. <div>
  988. <h4>Parameters</h4>
  989. <table class="graybox">
  990. <tbody>
  991. <tr>
  992. <td>
  993. <code>
  994. <em>resumeData</em>
  995. </code>
  996. </td>
  997. <td>
  998. <div>
  999. <p>The resume <code>Data</code>. This is an opaque blob produced by <code>URLSessionDownloadTask</code> when a task is
  1000. cancelled. See <a href="https://developer.apple.com/documentation/foundation/urlsessiondownloadtask/1411634-cancel">Apple&rsquo;s documentation</a>
  1001. for more information.</p>
  1002. </div>
  1003. </td>
  1004. </tr>
  1005. <tr>
  1006. <td>
  1007. <code>
  1008. <em>destination</em>
  1009. </code>
  1010. </td>
  1011. <td>
  1012. <div>
  1013. <p>The <code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used to determine the destination of the downloaded
  1014. file. <code>nil</code> by default.</p>
  1015. </div>
  1016. </td>
  1017. </tr>
  1018. </tbody>
  1019. </table>
  1020. </div>
  1021. <div>
  1022. <h4>Return Value</h4>
  1023. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  1024. </div>
  1025. </section>
  1026. </div>
  1027. </li>
  1028. </ul>
  1029. </div>
  1030. <div class="task-group">
  1031. <div class="task-name-container">
  1032. <a name="/File"></a>
  1033. <a name="//apple_ref/swift/Section/File" class="dashAnchor"></a>
  1034. <a href="#/File">
  1035. <h3 class="section-name">File</h3>
  1036. </a>
  1037. </div>
  1038. <ul class="item-container">
  1039. <li class="item">
  1040. <div>
  1041. <code>
  1042. <a name="/s:9Alamofire2AFO6upload_2to6method7headersAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ"></a>
  1043. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:)" class="dashAnchor"></a>
  1044. <a class="token" href="#/s:9Alamofire2AFO6upload_2to6method7headersAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ">upload(_:to:method:headers:)</a>
  1045. </code>
  1046. </div>
  1047. <div class="height-container">
  1048. <div class="pointer-container"></div>
  1049. <section class="section">
  1050. <div class="pointer"></div>
  1051. <div class="abstract">
  1052. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code>SessionManager.default</code> to upload the contents of the <code>fileURL</code> specified
  1053. using the <code>url</code>, <code>method</code> and <code>headers</code> provided.</p>
  1054. </div>
  1055. <div class="declaration">
  1056. <h4>Declaration</h4>
  1057. <div class="language">
  1058. <p class="aside-title">Swift</p>
  1059. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">fileURL</span><span class="p">:</span> <span class="kt">URL</span><span class="p">,</span>
  1060. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1061. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1062. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></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="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1063. </div>
  1064. </div>
  1065. <div>
  1066. <h4>Parameters</h4>
  1067. <table class="graybox">
  1068. <tbody>
  1069. <tr>
  1070. <td>
  1071. <code>
  1072. <em>fileURL</em>
  1073. </code>
  1074. </td>
  1075. <td>
  1076. <div>
  1077. <p>The <code>URL</code> of the file to upload.</p>
  1078. </div>
  1079. </td>
  1080. </tr>
  1081. <tr>
  1082. <td>
  1083. <code>
  1084. <em>url</em>
  1085. </code>
  1086. </td>
  1087. <td>
  1088. <div>
  1089. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1090. </div>
  1091. </td>
  1092. </tr>
  1093. <tr>
  1094. <td>
  1095. <code>
  1096. <em>method</em>
  1097. </code>
  1098. </td>
  1099. <td>
  1100. <div>
  1101. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1102. </div>
  1103. </td>
  1104. </tr>
  1105. <tr>
  1106. <td>
  1107. <code>
  1108. <em>headers</em>
  1109. </code>
  1110. </td>
  1111. <td>
  1112. <div>
  1113. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1114. </div>
  1115. </td>
  1116. </tr>
  1117. </tbody>
  1118. </table>
  1119. </div>
  1120. <div>
  1121. <h4>Return Value</h4>
  1122. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1123. </div>
  1124. </section>
  1125. </div>
  1126. </li>
  1127. <li class="item">
  1128. <div>
  1129. <code>
  1130. <a name="/s:9Alamofire2AFO6upload_4withAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_ptFZ"></a>
  1131. <a name="//apple_ref/swift/Method/upload(_:with:)" class="dashAnchor"></a>
  1132. <a class="token" href="#/s:9Alamofire2AFO6upload_4withAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_ptFZ">upload(_:with:)</a>
  1133. </code>
  1134. </div>
  1135. <div class="height-container">
  1136. <div class="pointer-container"></div>
  1137. <section class="section">
  1138. <div class="pointer"></div>
  1139. <div class="abstract">
  1140. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using the <code>SessionManager.default</code> to upload the contents of the <code>fileURL</code> specificed
  1141. using the <code>urlRequest</code> provided.</p>
  1142. </div>
  1143. <div class="declaration">
  1144. <h4>Declaration</h4>
  1145. <div class="language">
  1146. <p class="aside-title">Swift</p>
  1147. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">fileURL</span><span class="p">:</span> <span class="kt">URL</span><span class="p">,</span> <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1148. </div>
  1149. </div>
  1150. <div>
  1151. <h4>Parameters</h4>
  1152. <table class="graybox">
  1153. <tbody>
  1154. <tr>
  1155. <td>
  1156. <code>
  1157. <em>fileURL</em>
  1158. </code>
  1159. </td>
  1160. <td>
  1161. <div>
  1162. <p>The <code>URL</code> of the file to upload.</p>
  1163. </div>
  1164. </td>
  1165. </tr>
  1166. <tr>
  1167. <td>
  1168. <code>
  1169. <em>urlRequest</em>
  1170. </code>
  1171. </td>
  1172. <td>
  1173. <div>
  1174. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1175. </div>
  1176. </td>
  1177. </tr>
  1178. </tbody>
  1179. </table>
  1180. </div>
  1181. <div>
  1182. <h4>Return Value</h4>
  1183. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1184. </div>
  1185. </section>
  1186. </div>
  1187. </li>
  1188. </ul>
  1189. </div>
  1190. <div class="task-group">
  1191. <div class="task-name-container">
  1192. <a name="/Data"></a>
  1193. <a name="//apple_ref/swift/Section/Data" class="dashAnchor"></a>
  1194. <a href="#/Data">
  1195. <h3 class="section-name">Data</h3>
  1196. </a>
  1197. </div>
  1198. <ul class="item-container">
  1199. <li class="item">
  1200. <div>
  1201. <code>
  1202. <a name="/s:9Alamofire2AFO6upload_2to6method7headersAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ"></a>
  1203. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:)" class="dashAnchor"></a>
  1204. <a class="token" href="#/s:9Alamofire2AFO6upload_2to6method7headersAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ">upload(_:to:method:headers:)</a>
  1205. </code>
  1206. </div>
  1207. <div class="height-container">
  1208. <div class="pointer-container"></div>
  1209. <section class="section">
  1210. <div class="pointer"></div>
  1211. <div class="abstract">
  1212. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code>SessionManager.default</code> to upload the contents of the <code>data</code> specified using
  1213. the <code>url</code>, <code>method</code> and <code>headers</code> provided.</p>
  1214. </div>
  1215. <div class="declaration">
  1216. <h4>Declaration</h4>
  1217. <div class="language">
  1218. <p class="aside-title">Swift</p>
  1219. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  1220. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1221. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1222. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></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="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1223. </div>
  1224. </div>
  1225. <div>
  1226. <h4>Parameters</h4>
  1227. <table class="graybox">
  1228. <tbody>
  1229. <tr>
  1230. <td>
  1231. <code>
  1232. <em>data</em>
  1233. </code>
  1234. </td>
  1235. <td>
  1236. <div>
  1237. <p>The <code>Data</code> to upload.</p>
  1238. </div>
  1239. </td>
  1240. </tr>
  1241. <tr>
  1242. <td>
  1243. <code>
  1244. <em>url</em>
  1245. </code>
  1246. </td>
  1247. <td>
  1248. <div>
  1249. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1250. </div>
  1251. </td>
  1252. </tr>
  1253. <tr>
  1254. <td>
  1255. <code>
  1256. <em>method</em>
  1257. </code>
  1258. </td>
  1259. <td>
  1260. <div>
  1261. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1262. </div>
  1263. </td>
  1264. </tr>
  1265. <tr>
  1266. <td>
  1267. <code>
  1268. <em>headers</em>
  1269. </code>
  1270. </td>
  1271. <td>
  1272. <div>
  1273. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1274. </div>
  1275. </td>
  1276. </tr>
  1277. </tbody>
  1278. </table>
  1279. </div>
  1280. <div>
  1281. <h4>Return Value</h4>
  1282. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1283. </div>
  1284. </section>
  1285. </div>
  1286. </li>
  1287. <li class="item">
  1288. <div>
  1289. <code>
  1290. <a name="/s:9Alamofire2AFO6upload_4withAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_ptFZ"></a>
  1291. <a name="//apple_ref/swift/Method/upload(_:with:)" class="dashAnchor"></a>
  1292. <a class="token" href="#/s:9Alamofire2AFO6upload_4withAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_ptFZ">upload(_:with:)</a>
  1293. </code>
  1294. </div>
  1295. <div class="height-container">
  1296. <div class="pointer-container"></div>
  1297. <section class="section">
  1298. <div class="pointer"></div>
  1299. <div class="abstract">
  1300. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code>SessionManager.default</code> to upload the contents of the <code>data</code> specified using
  1301. the <code>urlRequest</code> provided.</p>
  1302. </div>
  1303. <div class="declaration">
  1304. <h4>Declaration</h4>
  1305. <div class="language">
  1306. <p class="aside-title">Swift</p>
  1307. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span> <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1308. </div>
  1309. </div>
  1310. <div>
  1311. <h4>Parameters</h4>
  1312. <table class="graybox">
  1313. <tbody>
  1314. <tr>
  1315. <td>
  1316. <code>
  1317. <em>data</em>
  1318. </code>
  1319. </td>
  1320. <td>
  1321. <div>
  1322. <p>The <code>Data</code> to upload.</p>
  1323. </div>
  1324. </td>
  1325. </tr>
  1326. <tr>
  1327. <td>
  1328. <code>
  1329. <em>urlRequest</em>
  1330. </code>
  1331. </td>
  1332. <td>
  1333. <div>
  1334. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1335. </div>
  1336. </td>
  1337. </tr>
  1338. </tbody>
  1339. </table>
  1340. </div>
  1341. <div>
  1342. <h4>Return Value</h4>
  1343. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1344. </div>
  1345. </section>
  1346. </div>
  1347. </li>
  1348. </ul>
  1349. </div>
  1350. <div class="task-group">
  1351. <div class="task-name-container">
  1352. <a name="/InputStream"></a>
  1353. <a name="//apple_ref/swift/Section/InputStream" class="dashAnchor"></a>
  1354. <a href="#/InputStream">
  1355. <h3 class="section-name">InputStream</h3>
  1356. </a>
  1357. </div>
  1358. <ul class="item-container">
  1359. <li class="item">
  1360. <div>
  1361. <code>
  1362. <a name="/s:9Alamofire2AFO6upload_2to6method7headersAA13UploadRequestCSo13NSInputStreamC_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ"></a>
  1363. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:)" class="dashAnchor"></a>
  1364. <a class="token" href="#/s:9Alamofire2AFO6upload_2to6method7headersAA13UploadRequestCSo13NSInputStreamC_AA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ">upload(_:to:method:headers:)</a>
  1365. </code>
  1366. </div>
  1367. <div class="height-container">
  1368. <div class="pointer-container"></div>
  1369. <section class="section">
  1370. <div class="pointer"></div>
  1371. <div class="abstract">
  1372. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code>SessionManager.default</code> to upload the content provided by the <code>stream</code>
  1373. specified using the <code>url</code>, <code>method</code> and <code>headers</code> provided.</p>
  1374. </div>
  1375. <div class="declaration">
  1376. <h4>Declaration</h4>
  1377. <div class="language">
  1378. <p class="aside-title">Swift</p>
  1379. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">stream</span><span class="p">:</span> <span class="kt">InputStream</span><span class="p">,</span>
  1380. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1381. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1382. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></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="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1383. </div>
  1384. </div>
  1385. <div>
  1386. <h4>Parameters</h4>
  1387. <table class="graybox">
  1388. <tbody>
  1389. <tr>
  1390. <td>
  1391. <code>
  1392. <em>stream</em>
  1393. </code>
  1394. </td>
  1395. <td>
  1396. <div>
  1397. <p>The <code>InputStream</code> to upload.</p>
  1398. </div>
  1399. </td>
  1400. </tr>
  1401. <tr>
  1402. <td>
  1403. <code>
  1404. <em>url</em>
  1405. </code>
  1406. </td>
  1407. <td>
  1408. <div>
  1409. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1410. </div>
  1411. </td>
  1412. </tr>
  1413. <tr>
  1414. <td>
  1415. <code>
  1416. <em>method</em>
  1417. </code>
  1418. </td>
  1419. <td>
  1420. <div>
  1421. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1422. </div>
  1423. </td>
  1424. </tr>
  1425. <tr>
  1426. <td>
  1427. <code>
  1428. <em>headers</em>
  1429. </code>
  1430. </td>
  1431. <td>
  1432. <div>
  1433. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1434. </div>
  1435. </td>
  1436. </tr>
  1437. </tbody>
  1438. </table>
  1439. </div>
  1440. <div>
  1441. <h4>Return Value</h4>
  1442. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1443. </div>
  1444. </section>
  1445. </div>
  1446. </li>
  1447. <li class="item">
  1448. <div>
  1449. <code>
  1450. <a name="/s:9Alamofire2AFO6upload_4withAA13UploadRequestCSo13NSInputStreamC_AA21URLRequestConvertible_ptFZ"></a>
  1451. <a name="//apple_ref/swift/Method/upload(_:with:)" class="dashAnchor"></a>
  1452. <a class="token" href="#/s:9Alamofire2AFO6upload_4withAA13UploadRequestCSo13NSInputStreamC_AA21URLRequestConvertible_ptFZ">upload(_:with:)</a>
  1453. </code>
  1454. </div>
  1455. <div class="height-container">
  1456. <div class="pointer-container"></div>
  1457. <section class="section">
  1458. <div class="pointer"></div>
  1459. <div class="abstract">
  1460. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using <code>SessionManager.default</code> to upload the content provided by the <code>stream</code>
  1461. specified using the <code>urlRequest</code> specified.</p>
  1462. </div>
  1463. <div class="declaration">
  1464. <h4>Declaration</h4>
  1465. <div class="language">
  1466. <p class="aside-title">Swift</p>
  1467. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="n">_</span> <span class="nv">stream</span><span class="p">:</span> <span class="kt">InputStream</span><span class="p">,</span> <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1468. </div>
  1469. </div>
  1470. <div>
  1471. <h4>Parameters</h4>
  1472. <table class="graybox">
  1473. <tbody>
  1474. <tr>
  1475. <td>
  1476. <code>
  1477. <em>stream</em>
  1478. </code>
  1479. </td>
  1480. <td>
  1481. <div>
  1482. <p>The <code>InputStream</code> to upload.</p>
  1483. </div>
  1484. </td>
  1485. </tr>
  1486. <tr>
  1487. <td>
  1488. <code>
  1489. <em>urlRequest</em>
  1490. </code>
  1491. </td>
  1492. <td>
  1493. <div>
  1494. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1495. </div>
  1496. </td>
  1497. </tr>
  1498. </tbody>
  1499. </table>
  1500. </div>
  1501. <div>
  1502. <h4>Return Value</h4>
  1503. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1504. </div>
  1505. </section>
  1506. </div>
  1507. </li>
  1508. </ul>
  1509. </div>
  1510. <div class="task-group">
  1511. <div class="task-name-container">
  1512. <a name="/MultipartFormData"></a>
  1513. <a name="//apple_ref/swift/Section/MultipartFormData" class="dashAnchor"></a>
  1514. <a href="#/MultipartFormData">
  1515. <h3 class="section-name">MultipartFormData</h3>
  1516. </a>
  1517. </div>
  1518. <ul class="item-container">
  1519. <li class="item">
  1520. <div>
  1521. <code>
  1522. <a name="/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold2to6method7headersAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VAA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ"></a>
  1523. <a name="//apple_ref/swift/Method/upload(multipartFormData:usingThreshold:to:method:headers:)" class="dashAnchor"></a>
  1524. <a class="token" href="#/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold2to6method7headersAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VAA14URLConvertible_pAA10HTTPMethodOAA11HTTPHeadersVSgtFZ">upload(multipartFormData:usingThreshold:to:method:headers:)</a>
  1525. </code>
  1526. </div>
  1527. <div class="height-container">
  1528. <div class="pointer-container"></div>
  1529. <section class="section">
  1530. <div class="pointer"></div>
  1531. <div class="abstract">
  1532. <p>Encodes <code>multipartFormData</code> using <code>encodingMemoryThreshold</code> and uploads the result using <code>SessionManager.default</code>
  1533. with the <code>url</code>, <code>method</code>, and <code>headers</code> provided.</p>
  1534. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  1535. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  1536. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  1537. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  1538. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  1539. used for larger payloads such as video content.</p>
  1540. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  1541. or stream from disk. If the content length of the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> is below the <code>encodingMemoryThreshold</code>,
  1542. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  1543. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  1544. technique was used.</p>
  1545. </div>
  1546. <div class="declaration">
  1547. <h4>Declaration</h4>
  1548. <div class="language">
  1549. <p class="aside-title">Swift</p>
  1550. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="nv">multipartFormData</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">,</span>
  1551. <span class="n">usingThreshold</span> <span class="nv">encodingMemoryThreshold</span><span class="p">:</span> <span class="kt">UInt64</span> <span class="o">=</span> <span class="kt"><a href="../Classes/MultipartUpload.html">MultipartUpload</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  1552. <span class="n">to</span> <span class="nv">url</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1553. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Enums/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  1554. <span class="nv">headers</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></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="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1555. </div>
  1556. </div>
  1557. <div>
  1558. <h4>Parameters</h4>
  1559. <table class="graybox">
  1560. <tbody>
  1561. <tr>
  1562. <td>
  1563. <code>
  1564. <em>multipartFormData</em>
  1565. </code>
  1566. </td>
  1567. <td>
  1568. <div>
  1569. <p>The closure used to append body parts to the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>.</p>
  1570. </div>
  1571. </td>
  1572. </tr>
  1573. <tr>
  1574. <td>
  1575. <code>
  1576. <em>encodingMemoryThreshold</em>
  1577. </code>
  1578. </td>
  1579. <td>
  1580. <div>
  1581. <p>The encoding memory threshold in bytes. <code>10_000_000</code> bytes by default.</p>
  1582. </div>
  1583. </td>
  1584. </tr>
  1585. <tr>
  1586. <td>
  1587. <code>
  1588. <em>url</em>
  1589. </code>
  1590. </td>
  1591. <td>
  1592. <div>
  1593. <p>The <code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value.</p>
  1594. </div>
  1595. </td>
  1596. </tr>
  1597. <tr>
  1598. <td>
  1599. <code>
  1600. <em>method</em>
  1601. </code>
  1602. </td>
  1603. <td>
  1604. <div>
  1605. <p>The <code><a href="../Enums/HTTPMethod.html">HTTPMethod</a></code>, <code>.post</code> by default.</p>
  1606. </div>
  1607. </td>
  1608. </tr>
  1609. <tr>
  1610. <td>
  1611. <code>
  1612. <em>headers</em>
  1613. </code>
  1614. </td>
  1615. <td>
  1616. <div>
  1617. <p>The <code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code>, <code>nil</code> by default.</p>
  1618. </div>
  1619. </td>
  1620. </tr>
  1621. </tbody>
  1622. </table>
  1623. </div>
  1624. <div>
  1625. <h4>Return Value</h4>
  1626. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  1627. </div>
  1628. </section>
  1629. </div>
  1630. </li>
  1631. <li class="item">
  1632. <div>
  1633. <code>
  1634. <a name="/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold4withAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VAA21URLRequestConvertible_ptFZ"></a>
  1635. <a name="//apple_ref/swift/Method/upload(multipartFormData:usingThreshold:with:)" class="dashAnchor"></a>
  1636. <a class="token" href="#/s:9Alamofire2AFO6upload17multipartFormData14usingThreshold4withAA13UploadRequestCyAA09MultiparteF0Cc_s6UInt64VAA21URLRequestConvertible_ptFZ">upload(multipartFormData:usingThreshold:with:)</a>
  1637. </code>
  1638. </div>
  1639. <div class="height-container">
  1640. <div class="pointer-container"></div>
  1641. <section class="section">
  1642. <div class="pointer"></div>
  1643. <div class="abstract">
  1644. <p>Encodes <code>multipartFormData</code> using <code>encodingMemoryThreshold</code> and uploads the result using <code>SessionManager.default</code>
  1645. using the <code>urlRequest</code> provided.</p>
  1646. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cummulative
  1647. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  1648. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  1649. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  1650. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  1651. used for larger payloads such as video content.</p>
  1652. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  1653. or stream from disk. If the content length of the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> is below the <code>encodingMemoryThreshold</code>,
  1654. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  1655. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  1656. technique was used.</p>
  1657. </div>
  1658. <div class="declaration">
  1659. <h4>Declaration</h4>
  1660. <div class="language">
  1661. <p class="aside-title">Swift</p>
  1662. <pre class="highlight swift"><code><span class="kd">@discardableResult</span>
  1663. <span class="kd">public</span> <span class="kd">static</span> <span class="kd">func</span> <span class="nf">upload</span><span class="p">(</span><span class="nv">multipartFormData</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">,</span>
  1664. <span class="n">usingThreshold</span> <span class="nv">encodingMemoryThreshold</span><span class="p">:</span> <span class="kt">UInt64</span> <span class="o">=</span> <span class="kt"><a href="../Classes/MultipartUpload.html">MultipartUpload</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  1665. <span class="n">with</span> <span class="nv">urlRequest</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  1666. </div>
  1667. </div>
  1668. <div>
  1669. <h4>Parameters</h4>
  1670. <table class="graybox">
  1671. <tbody>
  1672. <tr>
  1673. <td>
  1674. <code>
  1675. <em>multipartFormData</em>
  1676. </code>
  1677. </td>
  1678. <td>
  1679. <div>
  1680. <p>The closure used to append body parts to the <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>.</p>
  1681. </div>
  1682. </td>
  1683. </tr>
  1684. <tr>
  1685. <td>
  1686. <code>
  1687. <em>encodingMemoryThreshold</em>
  1688. </code>
  1689. </td>
  1690. <td>
  1691. <div>
  1692. <p>The encoding memory threshold in bytes. <code>10_000_000</code> bytes by default.</p>
  1693. </div>
  1694. </td>
  1695. </tr>
  1696. <tr>
  1697. <td>
  1698. <code>
  1699. <em>urlRequest</em>
  1700. </code>
  1701. </td>
  1702. <td>
  1703. <div>
  1704. <p>The <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value.</p>
  1705. </div>
  1706. </td>
  1707. </tr>
  1708. </tbody>
  1709. </table>
  1710. </div>
  1711. <div>
  1712. <h4>Return Value</h4>
  1713. <p>The <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> created.</p>
  1714. </div>
  1715. </section>
  1716. </div>
  1717. </li>
  1718. </ul>
  1719. </div>
  1720. </div>
  1721. </section>
  1722. </article>
  1723. </div>
  1724. <section class="footer">
  1725. <p>&copy; 2018 <a class="link" href="http://alamofire.org/" target="_blank" rel="external">Alamofire Software Foundation</a>. All rights reserved. (Last updated: 2018-12-05)</p>
  1726. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.4</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
  1727. </section>
  1728. </body>
  1729. </div>
  1730. </html>