Session.html 260 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>Session 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/Session" class="dashAnchor"></a>
  16. <a title="Session 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 5.8.1 Docs
  21. </a>
  22. (97% documented)
  23. </p>
  24. <div class="header-col--secondary">
  25. <form role="search" action="../search.json">
  26. <input type="text" placeholder="Search documentation" data-typeahead>
  27. </form>
  28. </div>
  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" alt="GitHub"/>
  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.github.io%2FAlamofire%2Fdocsets%2FAlamofire.xml">
  37. <img class="header-icon" src="../img/dash.png" alt="Dash"/>
  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" alt=""/>
  45. Session 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/Adapter.html">Adapter</a>
  55. </li>
  56. <li class="nav-group-task">
  57. <a class="nav-group-task-link" href="../Classes/AlamofireNotifications.html">AlamofireNotifications</a>
  58. </li>
  59. <li class="nav-group-task">
  60. <a class="nav-group-task-link" href="../Classes/AuthenticationInterceptor.html">AuthenticationInterceptor</a>
  61. </li>
  62. <li class="nav-group-task">
  63. <a class="nav-group-task-link" href="../Classes/AuthenticationInterceptor/RefreshWindow.html">– RefreshWindow</a>
  64. </li>
  65. <li class="nav-group-task">
  66. <a class="nav-group-task-link" href="../Classes/ClosureEventMonitor.html">ClosureEventMonitor</a>
  67. </li>
  68. <li class="nav-group-task">
  69. <a class="nav-group-task-link" href="../Classes/CompositeEventMonitor.html">CompositeEventMonitor</a>
  70. </li>
  71. <li class="nav-group-task">
  72. <a class="nav-group-task-link" href="../Classes/CompositeTrustEvaluator.html">CompositeTrustEvaluator</a>
  73. </li>
  74. <li class="nav-group-task">
  75. <a class="nav-group-task-link" href="../Classes/ConnectionLostRetryPolicy.html">ConnectionLostRetryPolicy</a>
  76. </li>
  77. <li class="nav-group-task">
  78. <a class="nav-group-task-link" href="../Classes/DataRequest.html">DataRequest</a>
  79. </li>
  80. <li class="nav-group-task">
  81. <a class="nav-group-task-link" href="../Classes/DataResponseSerializer.html">DataResponseSerializer</a>
  82. </li>
  83. <li class="nav-group-task">
  84. <a class="nav-group-task-link" href="../Classes/DataStreamRequest.html">DataStreamRequest</a>
  85. </li>
  86. <li class="nav-group-task">
  87. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/Stream.html">– Stream</a>
  88. </li>
  89. <li class="nav-group-task">
  90. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/Event.html">– Event</a>
  91. </li>
  92. <li class="nav-group-task">
  93. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/Completion.html">– Completion</a>
  94. </li>
  95. <li class="nav-group-task">
  96. <a class="nav-group-task-link" href="../Classes/DataStreamRequest/CancellationToken.html">– CancellationToken</a>
  97. </li>
  98. <li class="nav-group-task">
  99. <a class="nav-group-task-link" href="../Classes/DecodableResponseSerializer.html">DecodableResponseSerializer</a>
  100. </li>
  101. <li class="nav-group-task">
  102. <a class="nav-group-task-link" href="../Classes/DefaultTrustEvaluator.html">DefaultTrustEvaluator</a>
  103. </li>
  104. <li class="nav-group-task">
  105. <a class="nav-group-task-link" href="../Classes/DisabledTrustEvaluator.html">DisabledTrustEvaluator</a>
  106. </li>
  107. <li class="nav-group-task">
  108. <a class="nav-group-task-link" href="../Classes/DownloadRequest.html">DownloadRequest</a>
  109. </li>
  110. <li class="nav-group-task">
  111. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Options.html">– Options</a>
  112. </li>
  113. <li class="nav-group-task">
  114. <a class="nav-group-task-link" href="../Classes/DownloadRequest/Downloadable.html">– Downloadable</a>
  115. </li>
  116. <li class="nav-group-task">
  117. <a class="nav-group-task-link" href="../Classes/Interceptor.html">Interceptor</a>
  118. </li>
  119. <li class="nav-group-task">
  120. <a class="nav-group-task-link" href="../Classes/JSONParameterEncoder.html">JSONParameterEncoder</a>
  121. </li>
  122. <li class="nav-group-task">
  123. <a class="nav-group-task-link" href="../Classes/JSONResponseSerializer.html">JSONResponseSerializer</a>
  124. </li>
  125. <li class="nav-group-task">
  126. <a class="nav-group-task-link" href="../Classes/MultipartFormData.html">MultipartFormData</a>
  127. </li>
  128. <li class="nav-group-task">
  129. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager.html">NetworkReachabilityManager</a>
  130. </li>
  131. <li class="nav-group-task">
  132. <a class="nav-group-task-link" href="../Classes/NetworkReachabilityManager/NetworkReachabilityStatus.html">– NetworkReachabilityStatus</a>
  133. </li>
  134. <li class="nav-group-task">
  135. <a class="nav-group-task-link" href="../Classes/PinnedCertificatesTrustEvaluator.html">PinnedCertificatesTrustEvaluator</a>
  136. </li>
  137. <li class="nav-group-task">
  138. <a class="nav-group-task-link" href="../Classes/PublicKeysTrustEvaluator.html">PublicKeysTrustEvaluator</a>
  139. </li>
  140. <li class="nav-group-task">
  141. <a class="nav-group-task-link" href="../Classes/Request.html">Request</a>
  142. </li>
  143. <li class="nav-group-task">
  144. <a class="nav-group-task-link" href="../Classes/Request/State.html">– State</a>
  145. </li>
  146. <li class="nav-group-task">
  147. <a class="nav-group-task-link" href="../Classes/Request/ResponseDisposition.html">– ResponseDisposition</a>
  148. </li>
  149. <li class="nav-group-task">
  150. <a class="nav-group-task-link" href="../Classes/Retrier.html">Retrier</a>
  151. </li>
  152. <li class="nav-group-task">
  153. <a class="nav-group-task-link" href="../Classes/RetryPolicy.html">RetryPolicy</a>
  154. </li>
  155. <li class="nav-group-task">
  156. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator.html">RevocationTrustEvaluator</a>
  157. </li>
  158. <li class="nav-group-task">
  159. <a class="nav-group-task-link" href="../Classes/RevocationTrustEvaluator/Options.html">– Options</a>
  160. </li>
  161. <li class="nav-group-task">
  162. <a class="nav-group-task-link" href="../Classes/ServerTrustManager.html">ServerTrustManager</a>
  163. </li>
  164. <li class="nav-group-task">
  165. <a class="nav-group-task-link" href="../Classes/Session.html">Session</a>
  166. </li>
  167. <li class="nav-group-task">
  168. <a class="nav-group-task-link" href="../Classes/SessionDelegate.html">SessionDelegate</a>
  169. </li>
  170. <li class="nav-group-task">
  171. <a class="nav-group-task-link" href="../Classes/StringResponseSerializer.html">StringResponseSerializer</a>
  172. </li>
  173. <li class="nav-group-task">
  174. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder.html">URLEncodedFormEncoder</a>
  175. </li>
  176. <li class="nav-group-task">
  177. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/ArrayEncoding.html">– ArrayEncoding</a>
  178. </li>
  179. <li class="nav-group-task">
  180. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/BoolEncoding.html">– BoolEncoding</a>
  181. </li>
  182. <li class="nav-group-task">
  183. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/DataEncoding.html">– DataEncoding</a>
  184. </li>
  185. <li class="nav-group-task">
  186. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/DateEncoding.html">– DateEncoding</a>
  187. </li>
  188. <li class="nav-group-task">
  189. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/KeyEncoding.html">– KeyEncoding</a>
  190. </li>
  191. <li class="nav-group-task">
  192. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/KeyPathEncoding.html">– KeyPathEncoding</a>
  193. </li>
  194. <li class="nav-group-task">
  195. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/NilEncoding.html">– NilEncoding</a>
  196. </li>
  197. <li class="nav-group-task">
  198. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/SpaceEncoding.html">– SpaceEncoding</a>
  199. </li>
  200. <li class="nav-group-task">
  201. <a class="nav-group-task-link" href="../Classes/URLEncodedFormEncoder/Error.html">– Error</a>
  202. </li>
  203. <li class="nav-group-task">
  204. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder.html">URLEncodedFormParameterEncoder</a>
  205. </li>
  206. <li class="nav-group-task">
  207. <a class="nav-group-task-link" href="../Classes/URLEncodedFormParameterEncoder/Destination.html">– Destination</a>
  208. </li>
  209. <li class="nav-group-task">
  210. <a class="nav-group-task-link" href="../Classes/UploadRequest.html">UploadRequest</a>
  211. </li>
  212. <li class="nav-group-task">
  213. <a class="nav-group-task-link" href="../Classes/UploadRequest/Uploadable.html">– Uploadable</a>
  214. </li>
  215. </ul>
  216. </li>
  217. <li class="nav-group-name">
  218. <a class="nav-group-name-link" href="../Global%20Variables.html">Global Variables</a>
  219. <ul class="nav-group-tasks">
  220. <li class="nav-group-task">
  221. <a class="nav-group-task-link" href="../Global%20Variables.html#/s:9Alamofire2AFAA7SessionCvp">AF</a>
  222. </li>
  223. </ul>
  224. </li>
  225. <li class="nav-group-name">
  226. <a class="nav-group-name-link" href="../Enums.html">Enumerations</a>
  227. <ul class="nav-group-tasks">
  228. <li class="nav-group-task">
  229. <a class="nav-group-task-link" href="../Enums/AFError.html">AFError</a>
  230. </li>
  231. <li class="nav-group-task">
  232. <a class="nav-group-task-link" href="../Enums/AFError/MultipartEncodingFailureReason.html">– MultipartEncodingFailureReason</a>
  233. </li>
  234. <li class="nav-group-task">
  235. <a class="nav-group-task-link" href="../Enums/AFError/UnexpectedInputStreamLength.html">– UnexpectedInputStreamLength</a>
  236. </li>
  237. <li class="nav-group-task">
  238. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncodingFailureReason.html">– ParameterEncodingFailureReason</a>
  239. </li>
  240. <li class="nav-group-task">
  241. <a class="nav-group-task-link" href="../Enums/AFError/ParameterEncoderFailureReason.html">– ParameterEncoderFailureReason</a>
  242. </li>
  243. <li class="nav-group-task">
  244. <a class="nav-group-task-link" href="../Enums/AFError/ResponseValidationFailureReason.html">– ResponseValidationFailureReason</a>
  245. </li>
  246. <li class="nav-group-task">
  247. <a class="nav-group-task-link" href="../Enums/AFError/ResponseSerializationFailureReason.html">– ResponseSerializationFailureReason</a>
  248. </li>
  249. <li class="nav-group-task">
  250. <a class="nav-group-task-link" href="../Enums/AFError/ServerTrustFailureReason.html">– ServerTrustFailureReason</a>
  251. </li>
  252. <li class="nav-group-task">
  253. <a class="nav-group-task-link" href="../Enums/AFError/URLRequestValidationFailureReason.html">– URLRequestValidationFailureReason</a>
  254. </li>
  255. <li class="nav-group-task">
  256. <a class="nav-group-task-link" href="../Enums/AuthenticationError.html">AuthenticationError</a>
  257. </li>
  258. <li class="nav-group-task">
  259. <a class="nav-group-task-link" href="../Enums/RetryResult.html">RetryResult</a>
  260. </li>
  261. </ul>
  262. </li>
  263. <li class="nav-group-name">
  264. <a class="nav-group-name-link" href="../Extensions.html">Extensions</a>
  265. <ul class="nav-group-tasks">
  266. <li class="nav-group-task">
  267. <a class="nav-group-task-link" href="../Extensions/Array.html">Array</a>
  268. </li>
  269. <li class="nav-group-task">
  270. <a class="nav-group-task-link" href="../Extensions.html#/c:objc(cs)NSBundle">Bundle</a>
  271. </li>
  272. <li class="nav-group-task">
  273. <a class="nav-group-task-link" href="../Extensions/CharacterSet.html">CharacterSet</a>
  274. </li>
  275. <li class="nav-group-task">
  276. <a class="nav-group-task-link" href="../Extensions/Error.html">Error</a>
  277. </li>
  278. <li class="nav-group-task">
  279. <a class="nav-group-task-link" href="../Extensions/HTTPURLResponse.html">HTTPURLResponse</a>
  280. </li>
  281. <li class="nav-group-task">
  282. <a class="nav-group-task-link" href="../Extensions.html#/s:10Foundation11JSONDecoderC">JSONDecoder</a>
  283. </li>
  284. <li class="nav-group-task">
  285. <a class="nav-group-task-link" href="../Extensions/Notification.html">Notification</a>
  286. </li>
  287. <li class="nav-group-task">
  288. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@OSStatus">OSStatus</a>
  289. </li>
  290. <li class="nav-group-task">
  291. <a class="nav-group-task-link" href="../Extensions.html#/s:10Foundation19PropertyListDecoderC">PropertyListDecoder</a>
  292. </li>
  293. <li class="nav-group-task">
  294. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@SecCertificateRef">SecCertificate</a>
  295. </li>
  296. <li class="nav-group-task">
  297. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@SecPolicyRef">SecPolicy</a>
  298. </li>
  299. <li class="nav-group-task">
  300. <a class="nav-group-task-link" href="../Extensions.html#/c:@T@SecTrustRef">SecTrust</a>
  301. </li>
  302. <li class="nav-group-task">
  303. <a class="nav-group-task-link" href="../Extensions.html#/c:@E@SecTrustResultType">SecTrustResultType</a>
  304. </li>
  305. <li class="nav-group-task">
  306. <a class="nav-group-task-link" href="../Extensions/String.html">String</a>
  307. </li>
  308. <li class="nav-group-task">
  309. <a class="nav-group-task-link" href="../Extensions/URL.html">URL</a>
  310. </li>
  311. <li class="nav-group-task">
  312. <a class="nav-group-task-link" href="../Extensions/URLComponents.html">URLComponents</a>
  313. </li>
  314. <li class="nav-group-task">
  315. <a class="nav-group-task-link" href="../Extensions/URLRequest.html">URLRequest</a>
  316. </li>
  317. <li class="nav-group-task">
  318. <a class="nav-group-task-link" href="../Extensions/URLSessionConfiguration.html">URLSessionConfiguration</a>
  319. </li>
  320. </ul>
  321. </li>
  322. <li class="nav-group-name">
  323. <a class="nav-group-name-link" href="../Protocols.html">Protocols</a>
  324. <ul class="nav-group-tasks">
  325. <li class="nav-group-task">
  326. <a class="nav-group-task-link" href="../Protocols/AlamofireExtended.html">AlamofireExtended</a>
  327. </li>
  328. <li class="nav-group-task">
  329. <a class="nav-group-task-link" href="../Protocols/AuthenticationCredential.html">AuthenticationCredential</a>
  330. </li>
  331. <li class="nav-group-task">
  332. <a class="nav-group-task-link" href="../Protocols/Authenticator.html">Authenticator</a>
  333. </li>
  334. <li class="nav-group-task">
  335. <a class="nav-group-task-link" href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a>
  336. </li>
  337. <li class="nav-group-task">
  338. <a class="nav-group-task-link" href="../Protocols/DataDecoder.html">DataDecoder</a>
  339. </li>
  340. <li class="nav-group-task">
  341. <a class="nav-group-task-link" href="../Protocols/DataPreprocessor.html">DataPreprocessor</a>
  342. </li>
  343. <li class="nav-group-task">
  344. <a class="nav-group-task-link" href="../Protocols/DataResponseSerializerProtocol.html">DataResponseSerializerProtocol</a>
  345. </li>
  346. <li class="nav-group-task">
  347. <a class="nav-group-task-link" href="../Protocols/DataStreamSerializer.html">DataStreamSerializer</a>
  348. </li>
  349. <li class="nav-group-task">
  350. <a class="nav-group-task-link" href="../Protocols/DownloadResponseSerializerProtocol.html">DownloadResponseSerializerProtocol</a>
  351. </li>
  352. <li class="nav-group-task">
  353. <a class="nav-group-task-link" href="../Protocols/EmptyResponse.html">EmptyResponse</a>
  354. </li>
  355. <li class="nav-group-task">
  356. <a class="nav-group-task-link" href="../Protocols/EventMonitor.html">EventMonitor</a>
  357. </li>
  358. <li class="nav-group-task">
  359. <a class="nav-group-task-link" href="../Protocols/ParameterEncoder.html">ParameterEncoder</a>
  360. </li>
  361. <li class="nav-group-task">
  362. <a class="nav-group-task-link" href="../Protocols/ParameterEncoding.html">ParameterEncoding</a>
  363. </li>
  364. <li class="nav-group-task">
  365. <a class="nav-group-task-link" href="../Protocols/RedirectHandler.html">RedirectHandler</a>
  366. </li>
  367. <li class="nav-group-task">
  368. <a class="nav-group-task-link" href="../Protocols/RequestAdapter.html">RequestAdapter</a>
  369. </li>
  370. <li class="nav-group-task">
  371. <a class="nav-group-task-link" href="../Protocols/RequestDelegate.html">RequestDelegate</a>
  372. </li>
  373. <li class="nav-group-task">
  374. <a class="nav-group-task-link" href="../Protocols/RequestInterceptor.html">RequestInterceptor</a>
  375. </li>
  376. <li class="nav-group-task">
  377. <a class="nav-group-task-link" href="../Protocols/RequestRetrier.html">RequestRetrier</a>
  378. </li>
  379. <li class="nav-group-task">
  380. <a class="nav-group-task-link" href="../Protocols/ResponseSerializer.html">ResponseSerializer</a>
  381. </li>
  382. <li class="nav-group-task">
  383. <a class="nav-group-task-link" href="../Protocols/ServerTrustEvaluating.html">ServerTrustEvaluating</a>
  384. </li>
  385. <li class="nav-group-task">
  386. <a class="nav-group-task-link" href="../Protocols/URLConvertible.html">URLConvertible</a>
  387. </li>
  388. <li class="nav-group-task">
  389. <a class="nav-group-task-link" href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
  390. </li>
  391. <li class="nav-group-task">
  392. <a class="nav-group-task-link" href="../Protocols.html#/s:9Alamofire17UploadConvertibleP">UploadConvertible</a>
  393. </li>
  394. <li class="nav-group-task">
  395. <a class="nav-group-task-link" href="../Protocols/UploadableConvertible.html">UploadableConvertible</a>
  396. </li>
  397. </ul>
  398. </li>
  399. <li class="nav-group-name">
  400. <a class="nav-group-name-link" href="../Structs.html">Structures</a>
  401. <ul class="nav-group-tasks">
  402. <li class="nav-group-task">
  403. <a class="nav-group-task-link" href="../Structs/AlamofireExtension.html">AlamofireExtension</a>
  404. </li>
  405. <li class="nav-group-task">
  406. <a class="nav-group-task-link" href="../Structs/DataResponse.html">DataResponse</a>
  407. </li>
  408. <li class="nav-group-task">
  409. <a class="nav-group-task-link" href="../Structs/DataResponsePublisher.html">DataResponsePublisher</a>
  410. </li>
  411. <li class="nav-group-task">
  412. <a class="nav-group-task-link" href="../Structs/DataStreamPublisher.html">DataStreamPublisher</a>
  413. </li>
  414. <li class="nav-group-task">
  415. <a class="nav-group-task-link" href="../Structs/DataStreamTask.html">DataStreamTask</a>
  416. </li>
  417. <li class="nav-group-task">
  418. <a class="nav-group-task-link" href="../Structs/DataTask.html">DataTask</a>
  419. </li>
  420. <li class="nav-group-task">
  421. <a class="nav-group-task-link" href="../Structs/DecodableStreamSerializer.html">DecodableStreamSerializer</a>
  422. </li>
  423. <li class="nav-group-task">
  424. <a class="nav-group-task-link" href="../Structs/DeflateRequestCompressor.html">DeflateRequestCompressor</a>
  425. </li>
  426. <li class="nav-group-task">
  427. <a class="nav-group-task-link" href="../Structs/DeflateRequestCompressor/DuplicateHeaderBehavior.html">– DuplicateHeaderBehavior</a>
  428. </li>
  429. <li class="nav-group-task">
  430. <a class="nav-group-task-link" href="../Structs/DeflateRequestCompressor.html#/s:9Alamofire24DeflateRequestCompressorV20DuplicateHeaderErrorV">– DuplicateHeaderError</a>
  431. </li>
  432. <li class="nav-group-task">
  433. <a class="nav-group-task-link" href="../Structs/DownloadResponse.html">DownloadResponse</a>
  434. </li>
  435. <li class="nav-group-task">
  436. <a class="nav-group-task-link" href="../Structs/DownloadResponsePublisher.html">DownloadResponsePublisher</a>
  437. </li>
  438. <li class="nav-group-task">
  439. <a class="nav-group-task-link" href="../Structs/DownloadTask.html">DownloadTask</a>
  440. </li>
  441. <li class="nav-group-task">
  442. <a class="nav-group-task-link" href="../Structs/Empty.html">Empty</a>
  443. </li>
  444. <li class="nav-group-task">
  445. <a class="nav-group-task-link" href="../Structs/GoogleXSSIPreprocessor.html">GoogleXSSIPreprocessor</a>
  446. </li>
  447. <li class="nav-group-task">
  448. <a class="nav-group-task-link" href="../Structs/HTTPHeader.html">HTTPHeader</a>
  449. </li>
  450. <li class="nav-group-task">
  451. <a class="nav-group-task-link" href="../Structs/HTTPHeaders.html">HTTPHeaders</a>
  452. </li>
  453. <li class="nav-group-task">
  454. <a class="nav-group-task-link" href="../Structs/HTTPMethod.html">HTTPMethod</a>
  455. </li>
  456. <li class="nav-group-task">
  457. <a class="nav-group-task-link" href="../Structs/JSONEncoding.html">JSONEncoding</a>
  458. </li>
  459. <li class="nav-group-task">
  460. <a class="nav-group-task-link" href="../Structs/JSONEncoding/Error.html">– Error</a>
  461. </li>
  462. <li class="nav-group-task">
  463. <a class="nav-group-task-link" href="../Structs/PassthroughPreprocessor.html">PassthroughPreprocessor</a>
  464. </li>
  465. <li class="nav-group-task">
  466. <a class="nav-group-task-link" href="../Structs/PassthroughStreamSerializer.html">PassthroughStreamSerializer</a>
  467. </li>
  468. <li class="nav-group-task">
  469. <a class="nav-group-task-link" href="../Structs/Redirector.html">Redirector</a>
  470. </li>
  471. <li class="nav-group-task">
  472. <a class="nav-group-task-link" href="../Structs/Redirector/Behavior.html">– Behavior</a>
  473. </li>
  474. <li class="nav-group-task">
  475. <a class="nav-group-task-link" href="../Structs/RequestAdapterState.html">RequestAdapterState</a>
  476. </li>
  477. <li class="nav-group-task">
  478. <a class="nav-group-task-link" href="../Structs/ResponseCacher.html">ResponseCacher</a>
  479. </li>
  480. <li class="nav-group-task">
  481. <a class="nav-group-task-link" href="../Structs/ResponseCacher/Behavior.html">– Behavior</a>
  482. </li>
  483. <li class="nav-group-task">
  484. <a class="nav-group-task-link" href="../Structs/StreamOf.html">StreamOf</a>
  485. </li>
  486. <li class="nav-group-task">
  487. <a class="nav-group-task-link" href="../Structs/StreamOf/Iterator.html">– Iterator</a>
  488. </li>
  489. <li class="nav-group-task">
  490. <a class="nav-group-task-link" href="../Structs/StringStreamSerializer.html">StringStreamSerializer</a>
  491. </li>
  492. <li class="nav-group-task">
  493. <a class="nav-group-task-link" href="../Structs/URLEncoding.html">URLEncoding</a>
  494. </li>
  495. <li class="nav-group-task">
  496. <a class="nav-group-task-link" href="../Structs/URLEncoding/Destination.html">– Destination</a>
  497. </li>
  498. <li class="nav-group-task">
  499. <a class="nav-group-task-link" href="../Structs/URLEncoding/ArrayEncoding.html">– ArrayEncoding</a>
  500. </li>
  501. <li class="nav-group-task">
  502. <a class="nav-group-task-link" href="../Structs/URLEncoding/BoolEncoding.html">– BoolEncoding</a>
  503. </li>
  504. <li class="nav-group-task">
  505. <a class="nav-group-task-link" href="../Structs/URLResponseSerializer.html">URLResponseSerializer</a>
  506. </li>
  507. </ul>
  508. </li>
  509. <li class="nav-group-name">
  510. <a class="nav-group-name-link" href="../Typealiases.html">Type Aliases</a>
  511. <ul class="nav-group-tasks">
  512. <li class="nav-group-task">
  513. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire14AFDataResponsea">AFDataResponse</a>
  514. </li>
  515. <li class="nav-group-task">
  516. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire18AFDownloadResponsea">AFDownloadResponse</a>
  517. </li>
  518. <li class="nav-group-task">
  519. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire8AFResulta">AFResult</a>
  520. </li>
  521. <li class="nav-group-task">
  522. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire12AdaptHandlera">AdaptHandler</a>
  523. </li>
  524. <li class="nav-group-task">
  525. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire17DisabledEvaluatora">DisabledEvaluator</a>
  526. </li>
  527. <li class="nav-group-task">
  528. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a>
  529. </li>
  530. <li class="nav-group-task">
  531. <a class="nav-group-task-link" href="../Typealiases.html#/s:9Alamofire12RetryHandlera">RetryHandler</a>
  532. </li>
  533. </ul>
  534. </li>
  535. </ul>
  536. </nav>
  537. <article class="main-content">
  538. <section class="section">
  539. <div class="section-content top-matter">
  540. <h1>Session</h1>
  541. <div class="declaration">
  542. <div class="language">
  543. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">class</span> <span class="kt">Session</span></code></pre>
  544. <pre class="highlight swift"><code><span class="kd">extension</span> <span class="kt">Session</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestDelegate.html">RequestDelegate</a></span></code></pre>
  545. </div>
  546. </div>
  547. <p><code>Session</code> creates and manages Alamofire&rsquo;s <code><a href="../Classes/Request.html">Request</a></code> types during their lifetimes. It also provides common
  548. functionality for all <code><a href="../Classes/Request.html">Request</a></code>s, including queuing, interception, trust management, redirect handling, and response
  549. cache handling.</p>
  550. </div>
  551. </section>
  552. <section class="section">
  553. <div class="section-content">
  554. <div class="task-group">
  555. <ul class="item-container">
  556. <li class="item">
  557. <div>
  558. <code>
  559. <a name="/s:9Alamofire7SessionC7defaultACvpZ"></a>
  560. <a name="//apple_ref/swift/Variable/default" class="dashAnchor"></a>
  561. <a class="token" href="#/s:9Alamofire7SessionC7defaultACvpZ">default</a>
  562. </code>
  563. </div>
  564. <div class="height-container">
  565. <div class="pointer-container"></div>
  566. <section class="section">
  567. <div class="pointer"></div>
  568. <div class="abstract">
  569. <p>Shared singleton instance used by all <code>AF.request</code> APIs. Cannot be modified.</p>
  570. </div>
  571. <div class="declaration">
  572. <h4>Declaration</h4>
  573. <div class="language">
  574. <p class="aside-title">Swift</p>
  575. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="kd">let</span> <span class="err">`</span><span class="k">default</span><span class="err">`</span><span class="p">:</span> <span class="kt">Session</span></code></pre>
  576. </div>
  577. </div>
  578. </section>
  579. </div>
  580. </li>
  581. <li class="item">
  582. <div>
  583. <code>
  584. <a name="/s:9Alamofire7SessionC7sessionSo12NSURLSessionCvp"></a>
  585. <a name="//apple_ref/swift/Property/session" class="dashAnchor"></a>
  586. <a class="token" href="#/s:9Alamofire7SessionC7sessionSo12NSURLSessionCvp">session</a>
  587. </code>
  588. </div>
  589. <div class="height-container">
  590. <div class="pointer-container"></div>
  591. <section class="section">
  592. <div class="pointer"></div>
  593. <div class="abstract">
  594. <p>Underlying <code>URLSession</code> used to create <code>URLSessionTasks</code> for this instance, and for which this instance&rsquo;s
  595. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC8delegateAA0B8DelegateCvp">delegate</a></code> handles <code>URLSessionDelegate</code> callbacks.</p>
  596. <div class="aside aside-note">
  597. <p class="aside-title">Note</p>
  598. This instance should <strong>NOT</strong> be used to interact with the underlying <code>URLSessionTask</code>s. Doing so will
  599. break internal Alamofire logic that tracks those tasks.
  600. </div>
  601. </div>
  602. <div class="declaration">
  603. <h4>Declaration</h4>
  604. <div class="language">
  605. <p class="aside-title">Swift</p>
  606. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">session</span><span class="p">:</span> <span class="kt">URLSession</span></code></pre>
  607. </div>
  608. </div>
  609. </section>
  610. </div>
  611. </li>
  612. <li class="item">
  613. <div>
  614. <code>
  615. <a name="/s:9Alamofire7SessionC8delegateAA0B8DelegateCvp"></a>
  616. <a name="//apple_ref/swift/Property/delegate" class="dashAnchor"></a>
  617. <a class="token" href="#/s:9Alamofire7SessionC8delegateAA0B8DelegateCvp">delegate</a>
  618. </code>
  619. </div>
  620. <div class="height-container">
  621. <div class="pointer-container"></div>
  622. <section class="section">
  623. <div class="pointer"></div>
  624. <div class="abstract">
  625. <p>Instance&rsquo;s <code><a href="../Classes/SessionDelegate.html">SessionDelegate</a></code>, which handles the <code>URLSessionDelegate</code> methods and <code><a href="../Classes/Request.html">Request</a></code> interaction.</p>
  626. </div>
  627. <div class="declaration">
  628. <h4>Declaration</h4>
  629. <div class="language">
  630. <p class="aside-title">Swift</p>
  631. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">delegate</span><span class="p">:</span> <span class="kt"><a href="../Classes/SessionDelegate.html">SessionDelegate</a></span></code></pre>
  632. </div>
  633. </div>
  634. </section>
  635. </div>
  636. </li>
  637. <li class="item">
  638. <div>
  639. <code>
  640. <a name="/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp"></a>
  641. <a name="//apple_ref/swift/Property/rootQueue" class="dashAnchor"></a>
  642. <a class="token" href="#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a>
  643. </code>
  644. </div>
  645. <div class="height-container">
  646. <div class="pointer-container"></div>
  647. <section class="section">
  648. <div class="pointer"></div>
  649. <div class="abstract">
  650. <p>Root <code>DispatchQueue</code> for all internal callbacks and state update. <strong>MUST</strong> be a serial queue.</p>
  651. </div>
  652. <div class="declaration">
  653. <h4>Declaration</h4>
  654. <div class="language">
  655. <p class="aside-title">Swift</p>
  656. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">rootQueue</span><span class="p">:</span> <span class="kt">DispatchQueue</span></code></pre>
  657. </div>
  658. </div>
  659. </section>
  660. </div>
  661. </li>
  662. <li class="item">
  663. <div>
  664. <code>
  665. <a name="/s:9Alamofire7SessionC24startRequestsImmediatelySbvp"></a>
  666. <a name="//apple_ref/swift/Property/startRequestsImmediately" class="dashAnchor"></a>
  667. <a class="token" href="#/s:9Alamofire7SessionC24startRequestsImmediatelySbvp">startRequestsImmediately</a>
  668. </code>
  669. </div>
  670. <div class="height-container">
  671. <div class="pointer-container"></div>
  672. <section class="section">
  673. <div class="pointer"></div>
  674. <div class="abstract">
  675. <p>Value determining whether this instance automatically calls <code>resume()</code> on all created <code><a href="../Classes/Request.html">Request</a></code>s.</p>
  676. </div>
  677. <div class="declaration">
  678. <h4>Declaration</h4>
  679. <div class="language">
  680. <p class="aside-title">Swift</p>
  681. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">startRequestsImmediately</span><span class="p">:</span> <span class="kt">Bool</span></code></pre>
  682. </div>
  683. </div>
  684. </section>
  685. </div>
  686. </li>
  687. <li class="item">
  688. <div>
  689. <code>
  690. <a name="/s:9Alamofire7SessionC12requestQueueSo17OS_dispatch_queueCvp"></a>
  691. <a name="//apple_ref/swift/Property/requestQueue" class="dashAnchor"></a>
  692. <a class="token" href="#/s:9Alamofire7SessionC12requestQueueSo17OS_dispatch_queueCvp">requestQueue</a>
  693. </code>
  694. </div>
  695. <div class="height-container">
  696. <div class="pointer-container"></div>
  697. <section class="section">
  698. <div class="pointer"></div>
  699. <div class="abstract">
  700. <p><code>DispatchQueue</code> on which <code>URLRequest</code>s are created asynchronously. By default this queue uses <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> as its
  701. <code>target</code>, but a separate queue can be used if request creation is determined to be a bottleneck. Always profile
  702. and test before introducing an additional queue.</p>
  703. </div>
  704. <div class="declaration">
  705. <h4>Declaration</h4>
  706. <div class="language">
  707. <p class="aside-title">Swift</p>
  708. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">requestQueue</span><span class="p">:</span> <span class="kt">DispatchQueue</span></code></pre>
  709. </div>
  710. </div>
  711. </section>
  712. </div>
  713. </li>
  714. <li class="item">
  715. <div>
  716. <code>
  717. <a name="/s:9Alamofire7SessionC18serializationQueueSo17OS_dispatch_queueCvp"></a>
  718. <a name="//apple_ref/swift/Property/serializationQueue" class="dashAnchor"></a>
  719. <a class="token" href="#/s:9Alamofire7SessionC18serializationQueueSo17OS_dispatch_queueCvp">serializationQueue</a>
  720. </code>
  721. </div>
  722. <div class="height-container">
  723. <div class="pointer-container"></div>
  724. <section class="section">
  725. <div class="pointer"></div>
  726. <div class="abstract">
  727. <p><code>DispatchQueue</code> passed to all <code><a href="../Classes/Request.html">Request</a></code>s on which they perform their response serialization. By default this
  728. queue uses <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> as its <code>target</code> but a separate queue can be used if response serialization is determined
  729. to be a bottleneck. Always profile and test before introducing an additional queue.</p>
  730. </div>
  731. <div class="declaration">
  732. <h4>Declaration</h4>
  733. <div class="language">
  734. <p class="aside-title">Swift</p>
  735. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">serializationQueue</span><span class="p">:</span> <span class="kt">DispatchQueue</span></code></pre>
  736. </div>
  737. </div>
  738. </section>
  739. </div>
  740. </li>
  741. <li class="item">
  742. <div>
  743. <code>
  744. <a name="/s:9Alamofire7SessionC11interceptorAA18RequestInterceptor_pSgvp"></a>
  745. <a name="//apple_ref/swift/Property/interceptor" class="dashAnchor"></a>
  746. <a class="token" href="#/s:9Alamofire7SessionC11interceptorAA18RequestInterceptor_pSgvp">interceptor</a>
  747. </code>
  748. </div>
  749. <div class="height-container">
  750. <div class="pointer-container"></div>
  751. <section class="section">
  752. <div class="pointer"></div>
  753. <div class="abstract">
  754. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> used for all <code><a href="../Classes/Request.html">Request</a></code> created by the instance. <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>s can also be set on a
  755. per-<code><a href="../Classes/Request.html">Request</a></code> basis, in which case the <code><a href="../Classes/Request.html">Request</a></code>&lsquo;s interceptor takes precedence over this value.</p>
  756. </div>
  757. <div class="declaration">
  758. <h4>Declaration</h4>
  759. <div class="language">
  760. <p class="aside-title">Swift</p>
  761. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span></code></pre>
  762. </div>
  763. </div>
  764. </section>
  765. </div>
  766. </li>
  767. <li class="item">
  768. <div>
  769. <code>
  770. <a name="/s:9Alamofire7SessionC18serverTrustManagerAA06ServerdE0CSgvp"></a>
  771. <a name="//apple_ref/swift/Property/serverTrustManager" class="dashAnchor"></a>
  772. <a class="token" href="#/s:9Alamofire7SessionC18serverTrustManagerAA06ServerdE0CSgvp">serverTrustManager</a>
  773. </code>
  774. </div>
  775. <div class="height-container">
  776. <div class="pointer-container"></div>
  777. <section class="section">
  778. <div class="pointer"></div>
  779. <div class="abstract">
  780. <p><code><a href="../Classes/ServerTrustManager.html">ServerTrustManager</a></code> instance used to evaluate all trust challenges and provide certificate and key pinning.</p>
  781. </div>
  782. <div class="declaration">
  783. <h4>Declaration</h4>
  784. <div class="language">
  785. <p class="aside-title">Swift</p>
  786. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">serverTrustManager</span><span class="p">:</span> <span class="kt"><a href="../Classes/ServerTrustManager.html">ServerTrustManager</a></span><span class="p">?</span></code></pre>
  787. </div>
  788. </div>
  789. </section>
  790. </div>
  791. </li>
  792. <li class="item">
  793. <div>
  794. <code>
  795. <a name="/s:9Alamofire7SessionC15redirectHandlerAA08RedirectD0_pSgvp"></a>
  796. <a name="//apple_ref/swift/Property/redirectHandler" class="dashAnchor"></a>
  797. <a class="token" href="#/s:9Alamofire7SessionC15redirectHandlerAA08RedirectD0_pSgvp">redirectHandler</a>
  798. </code>
  799. </div>
  800. <div class="height-container">
  801. <div class="pointer-container"></div>
  802. <section class="section">
  803. <div class="pointer"></div>
  804. <div class="abstract">
  805. <p><code><a href="../Protocols/RedirectHandler.html">RedirectHandler</a></code> instance used to provide customization for request redirection.</p>
  806. </div>
  807. <div class="declaration">
  808. <h4>Declaration</h4>
  809. <div class="language">
  810. <p class="aside-title">Swift</p>
  811. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">redirectHandler</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RedirectHandler.html">RedirectHandler</a></span><span class="p">?</span></code></pre>
  812. </div>
  813. </div>
  814. </section>
  815. </div>
  816. </li>
  817. <li class="item">
  818. <div>
  819. <code>
  820. <a name="/s:9Alamofire7SessionC21cachedResponseHandlerAA06CacheddE0_pSgvp"></a>
  821. <a name="//apple_ref/swift/Property/cachedResponseHandler" class="dashAnchor"></a>
  822. <a class="token" href="#/s:9Alamofire7SessionC21cachedResponseHandlerAA06CacheddE0_pSgvp">cachedResponseHandler</a>
  823. </code>
  824. </div>
  825. <div class="height-container">
  826. <div class="pointer-container"></div>
  827. <section class="section">
  828. <div class="pointer"></div>
  829. <div class="abstract">
  830. <p><code><a href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a></code> instance used to provide customization of cached response handling.</p>
  831. </div>
  832. <div class="declaration">
  833. <h4>Declaration</h4>
  834. <div class="language">
  835. <p class="aside-title">Swift</p>
  836. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">cachedResponseHandler</span><span class="p">:</span> <span class="kt"><a href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a></span><span class="p">?</span></code></pre>
  837. </div>
  838. </div>
  839. </section>
  840. </div>
  841. </li>
  842. <li class="item">
  843. <div>
  844. <code>
  845. <a name="/s:9Alamofire7SessionC12eventMonitorAA014CompositeEventD0Cvp"></a>
  846. <a name="//apple_ref/swift/Property/eventMonitor" class="dashAnchor"></a>
  847. <a class="token" href="#/s:9Alamofire7SessionC12eventMonitorAA014CompositeEventD0Cvp">eventMonitor</a>
  848. </code>
  849. </div>
  850. <div class="height-container">
  851. <div class="pointer-container"></div>
  852. <section class="section">
  853. <div class="pointer"></div>
  854. <div class="abstract">
  855. <p><code><a href="../Classes/CompositeEventMonitor.html">CompositeEventMonitor</a></code> used to compose Alamofire&rsquo;s <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC20defaultEventMonitorsSayAA0D7Monitor_pGvp">defaultEventMonitors</a></code> and any passed <code><a href="../Protocols/EventMonitor.html">EventMonitor</a></code>s.</p>
  856. </div>
  857. <div class="declaration">
  858. <h4>Declaration</h4>
  859. <div class="language">
  860. <p class="aside-title">Swift</p>
  861. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">eventMonitor</span><span class="p">:</span> <span class="kt"><a href="../Classes/CompositeEventMonitor.html">CompositeEventMonitor</a></span></code></pre>
  862. </div>
  863. </div>
  864. </section>
  865. </div>
  866. </li>
  867. <li class="item">
  868. <div>
  869. <code>
  870. <a name="/s:9Alamofire7SessionC20defaultEventMonitorsSayAA0D7Monitor_pGvp"></a>
  871. <a name="//apple_ref/swift/Property/defaultEventMonitors" class="dashAnchor"></a>
  872. <a class="token" href="#/s:9Alamofire7SessionC20defaultEventMonitorsSayAA0D7Monitor_pGvp">defaultEventMonitors</a>
  873. </code>
  874. </div>
  875. <div class="height-container">
  876. <div class="pointer-container"></div>
  877. <section class="section">
  878. <div class="pointer"></div>
  879. <div class="abstract">
  880. <p><code><a href="../Protocols/EventMonitor.html">EventMonitor</a></code>s included in all instances. <code>[AlamofireNotifications()]</code> by default.</p>
  881. </div>
  882. <div class="declaration">
  883. <h4>Declaration</h4>
  884. <div class="language">
  885. <p class="aside-title">Swift</p>
  886. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">let</span> <span class="nv">defaultEventMonitors</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Protocols/EventMonitor.html">EventMonitor</a></span><span class="p">]</span></code></pre>
  887. </div>
  888. </div>
  889. </section>
  890. </div>
  891. </li>
  892. <li class="item">
  893. <div>
  894. <code>
  895. <a name="/s:9Alamofire7SessionC7session8delegate9rootQueue24startRequestsImmediately07requestF0013serializationF011interceptor18serverTrustManager15redirectHandler014cachedResponseQ013eventMonitorsACSo12NSURLSessionC_AA0B8DelegateCSo17OS_dispatch_queueCSbATSgAuA18RequestInterceptor_pSgAA06ServernO0CSgAA08RedirectQ0_pSgAA06CachedsQ0_pSgSayAA12EventMonitor_pGtcfc"></a>
  896. <a name="//apple_ref/swift/Method/init(session:delegate:rootQueue:startRequestsImmediately:requestQueue:serializationQueue:interceptor:serverTrustManager:redirectHandler:cachedResponseHandler:eventMonitors:)" class="dashAnchor"></a>
  897. <a class="token" href="#/s:9Alamofire7SessionC7session8delegate9rootQueue24startRequestsImmediately07requestF0013serializationF011interceptor18serverTrustManager15redirectHandler014cachedResponseQ013eventMonitorsACSo12NSURLSessionC_AA0B8DelegateCSo17OS_dispatch_queueCSbATSgAuA18RequestInterceptor_pSgAA06ServernO0CSgAA08RedirectQ0_pSgAA06CachedsQ0_pSgSayAA12EventMonitor_pGtcfc">init(session:<wbr>delegate:<wbr>rootQueue:<wbr>startRequestsImmediately:<wbr>requestQueue:<wbr>serializationQueue:<wbr>interceptor:<wbr>serverTrustManager:<wbr>redirectHandler:<wbr>cachedResponseHandler:<wbr>eventMonitors:<wbr>)</a>
  898. </code>
  899. </div>
  900. <div class="height-container">
  901. <div class="pointer-container"></div>
  902. <section class="section">
  903. <div class="pointer"></div>
  904. <div class="abstract">
  905. <p>Creates a <code>Session</code> from a <code>URLSession</code> and other parameters.</p>
  906. <div class="aside aside-note">
  907. <p class="aside-title">Note</p>
  908. <p>When passing a <code>URLSession</code>, you must create the <code>URLSession</code> with a specific <code>delegateQueue</code> value and
  909. pass the <code>delegateQueue</code>&lsquo;s <code>underlyingQueue</code> as the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> parameter of this initializer.</p>
  910. </div>
  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 swift"><code><span class="kd">public</span> <span class="nf">init</span><span class="p">(</span><span class="nv">session</span><span class="p">:</span> <span class="kt">URLSession</span><span class="p">,</span>
  917. <span class="nv">delegate</span><span class="p">:</span> <span class="kt"><a href="../Classes/SessionDelegate.html">SessionDelegate</a></span><span class="p">,</span>
  918. <span class="nv">rootQueue</span><span class="p">:</span> <span class="kt">DispatchQueue</span><span class="p">,</span>
  919. <span class="nv">startRequestsImmediately</span><span class="p">:</span> <span class="kt">Bool</span> <span class="o">=</span> <span class="kc">true</span><span class="p">,</span>
  920. <span class="nv">requestQueue</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>
  921. <span class="nv">serializationQueue</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>
  922. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  923. <span class="nv">serverTrustManager</span><span class="p">:</span> <span class="kt"><a href="../Classes/ServerTrustManager.html">ServerTrustManager</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  924. <span class="nv">redirectHandler</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RedirectHandler.html">RedirectHandler</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  925. <span class="nv">cachedResponseHandler</span><span class="p">:</span> <span class="kt"><a href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  926. <span class="nv">eventMonitors</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Protocols/EventMonitor.html">EventMonitor</a></span><span class="p">]</span> <span class="o">=</span> <span class="p">[])</span></code></pre>
  927. </div>
  928. </div>
  929. <div>
  930. <h4>Parameters</h4>
  931. <table class="graybox">
  932. <tbody>
  933. <tr>
  934. <td>
  935. <code>
  936. <em>session</em>
  937. </code>
  938. </td>
  939. <td>
  940. <div>
  941. <p>Underlying <code>URLSession</code> for this instance.</p>
  942. </div>
  943. </td>
  944. </tr>
  945. <tr>
  946. <td>
  947. <code>
  948. <em>delegate</em>
  949. </code>
  950. </td>
  951. <td>
  952. <div>
  953. <p><code><a href="../Classes/SessionDelegate.html">SessionDelegate</a></code> that handles <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7sessionSo12NSURLSessionCvp">session</a></code>&lsquo;s delegate callbacks as well as <code><a href="../Classes/Request.html">Request</a></code>
  954. interaction.</p>
  955. </div>
  956. </td>
  957. </tr>
  958. <tr>
  959. <td>
  960. <code>
  961. <em>rootQueue</em>
  962. </code>
  963. </td>
  964. <td>
  965. <div>
  966. <p>Root <code>DispatchQueue</code> for all internal callbacks and state updates. <strong>MUST</strong> be a
  967. serial queue.</p>
  968. </div>
  969. </td>
  970. </tr>
  971. <tr>
  972. <td>
  973. <code>
  974. <em>startRequestsImmediately</em>
  975. </code>
  976. </td>
  977. <td>
  978. <div>
  979. <p>Determines whether this instance will automatically start all <code><a href="../Classes/Request.html">Request</a></code>s. <code>true</code>
  980. by default. If set to <code>false</code>, all <code><a href="../Classes/Request.html">Request</a></code>s created must have <code>.resume()</code> called.
  981. on them for them to start.</p>
  982. </div>
  983. </td>
  984. </tr>
  985. <tr>
  986. <td>
  987. <code>
  988. <em>requestQueue</em>
  989. </code>
  990. </td>
  991. <td>
  992. <div>
  993. <p><code>DispatchQueue</code> on which to perform <code>URLRequest</code> creation. By default this queue
  994. will use the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> as its <code>target</code>. A separate queue can be used if it&rsquo;s
  995. determined request creation is a bottleneck, but that should only be done after
  996. careful testing and profiling. <code>nil</code> by default.</p>
  997. </div>
  998. </td>
  999. </tr>
  1000. <tr>
  1001. <td>
  1002. <code>
  1003. <em>serializationQueue</em>
  1004. </code>
  1005. </td>
  1006. <td>
  1007. <div>
  1008. <p><code>DispatchQueue</code> on which to perform all response serialization. By default this
  1009. queue will use the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> as its <code>target</code>. A separate queue can be used if
  1010. it&rsquo;s determined response serialization is a bottleneck, but that should only be
  1011. done after careful testing and profiling. <code>nil</code> by default.</p>
  1012. </div>
  1013. </td>
  1014. </tr>
  1015. <tr>
  1016. <td>
  1017. <code>
  1018. <em>interceptor</em>
  1019. </code>
  1020. </td>
  1021. <td>
  1022. <div>
  1023. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> to be used for all <code><a href="../Classes/Request.html">Request</a></code>s created by this instance. <code>nil</code>
  1024. by default.</p>
  1025. </div>
  1026. </td>
  1027. </tr>
  1028. <tr>
  1029. <td>
  1030. <code>
  1031. <em>serverTrustManager</em>
  1032. </code>
  1033. </td>
  1034. <td>
  1035. <div>
  1036. <p><code><a href="../Classes/ServerTrustManager.html">ServerTrustManager</a></code> to be used for all trust evaluations by this instance. <code>nil</code>
  1037. by default.</p>
  1038. </div>
  1039. </td>
  1040. </tr>
  1041. <tr>
  1042. <td>
  1043. <code>
  1044. <em>redirectHandler</em>
  1045. </code>
  1046. </td>
  1047. <td>
  1048. <div>
  1049. <p><code><a href="../Protocols/RedirectHandler.html">RedirectHandler</a></code> to be used by all <code><a href="../Classes/Request.html">Request</a></code>s created by this instance. <code>nil</code> by
  1050. default.</p>
  1051. </div>
  1052. </td>
  1053. </tr>
  1054. <tr>
  1055. <td>
  1056. <code>
  1057. <em>cachedResponseHandler</em>
  1058. </code>
  1059. </td>
  1060. <td>
  1061. <div>
  1062. <p><code><a href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a></code> to be used by all <code><a href="../Classes/Request.html">Request</a></code>s created by this instance.
  1063. <code>nil</code> by default.</p>
  1064. </div>
  1065. </td>
  1066. </tr>
  1067. <tr>
  1068. <td>
  1069. <code>
  1070. <em>eventMonitors</em>
  1071. </code>
  1072. </td>
  1073. <td>
  1074. <div>
  1075. <p>Additional <code><a href="../Protocols/EventMonitor.html">EventMonitor</a></code>s used by the instance. Alamofire always adds a
  1076. <code><a href="../Classes/AlamofireNotifications.html">AlamofireNotifications</a></code> <code><a href="../Protocols/EventMonitor.html">EventMonitor</a></code> to the array passed here. <code>[]</code> by default.</p>
  1077. </div>
  1078. </td>
  1079. </tr>
  1080. </tbody>
  1081. </table>
  1082. </div>
  1083. </section>
  1084. </div>
  1085. </li>
  1086. <li class="item">
  1087. <div>
  1088. <code>
  1089. <a name="/s:9Alamofire7SessionC13configuration8delegate9rootQueue24startRequestsImmediately07requestF0013serializationF011interceptor18serverTrustManager15redirectHandler014cachedResponseQ013eventMonitorsACSo25NSURLSessionConfigurationC_AA0B8DelegateCSo17OS_dispatch_queueCSbATSgAuA18RequestInterceptor_pSgAA06ServernO0CSgAA08RedirectQ0_pSgAA06CachedsQ0_pSgSayAA12EventMonitor_pGtcfc"></a>
  1090. <a name="//apple_ref/swift/Method/init(configuration:delegate:rootQueue:startRequestsImmediately:requestQueue:serializationQueue:interceptor:serverTrustManager:redirectHandler:cachedResponseHandler:eventMonitors:)" class="dashAnchor"></a>
  1091. <a class="token" href="#/s:9Alamofire7SessionC13configuration8delegate9rootQueue24startRequestsImmediately07requestF0013serializationF011interceptor18serverTrustManager15redirectHandler014cachedResponseQ013eventMonitorsACSo25NSURLSessionConfigurationC_AA0B8DelegateCSo17OS_dispatch_queueCSbATSgAuA18RequestInterceptor_pSgAA06ServernO0CSgAA08RedirectQ0_pSgAA06CachedsQ0_pSgSayAA12EventMonitor_pGtcfc">init(configuration:<wbr>delegate:<wbr>rootQueue:<wbr>startRequestsImmediately:<wbr>requestQueue:<wbr>serializationQueue:<wbr>interceptor:<wbr>serverTrustManager:<wbr>redirectHandler:<wbr>cachedResponseHandler:<wbr>eventMonitors:<wbr>)</a>
  1092. </code>
  1093. </div>
  1094. <div class="height-container">
  1095. <div class="pointer-container"></div>
  1096. <section class="section">
  1097. <div class="pointer"></div>
  1098. <div class="abstract">
  1099. <p>Creates a <code>Session</code> from a <code>URLSessionConfiguration</code>.</p>
  1100. <div class="aside aside-note">
  1101. <p class="aside-title">Note</p>
  1102. <p>This initializer lets Alamofire handle the creation of the underlying <code>URLSession</code> and its
  1103. <code>delegateQueue</code>, and is the recommended initializer for most uses.</p>
  1104. </div>
  1105. </div>
  1106. <div class="declaration">
  1107. <h4>Declaration</h4>
  1108. <div class="language">
  1109. <p class="aside-title">Swift</p>
  1110. <pre class="highlight swift"><code><span class="kd">public</span> <span class="n">convenience</span> <span class="nf">init</span><span class="p">(</span><span class="nv">configuration</span><span class="p">:</span> <span class="kt">URLSessionConfiguration</span> <span class="o">=</span> <span class="kt">URLSessionConfiguration</span><span class="o">.</span><span class="n">af</span><span class="o">.</span><span class="k">default</span><span class="p">,</span>
  1111. <span class="nv">delegate</span><span class="p">:</span> <span class="kt"><a href="../Classes/SessionDelegate.html">SessionDelegate</a></span> <span class="o">=</span> <span class="kt"><a href="../Classes/SessionDelegate.html">SessionDelegate</a></span><span class="p">(),</span>
  1112. <span class="nv">rootQueue</span><span class="p">:</span> <span class="kt">DispatchQueue</span> <span class="o">=</span> <span class="kt">DispatchQueue</span><span class="p">(</span><span class="nv">label</span><span class="p">:</span> <span class="s">"org.alamofire.session.rootQueue"</span><span class="p">),</span>
  1113. <span class="nv">startRequestsImmediately</span><span class="p">:</span> <span class="kt">Bool</span> <span class="o">=</span> <span class="kc">true</span><span class="p">,</span>
  1114. <span class="nv">requestQueue</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>
  1115. <span class="nv">serializationQueue</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>
  1116. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1117. <span class="nv">serverTrustManager</span><span class="p">:</span> <span class="kt"><a href="../Classes/ServerTrustManager.html">ServerTrustManager</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1118. <span class="nv">redirectHandler</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RedirectHandler.html">RedirectHandler</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1119. <span class="nv">cachedResponseHandler</span><span class="p">:</span> <span class="kt"><a href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1120. <span class="nv">eventMonitors</span><span class="p">:</span> <span class="p">[</span><span class="kt"><a href="../Protocols/EventMonitor.html">EventMonitor</a></span><span class="p">]</span> <span class="o">=</span> <span class="p">[])</span></code></pre>
  1121. </div>
  1122. </div>
  1123. <div>
  1124. <h4>Parameters</h4>
  1125. <table class="graybox">
  1126. <tbody>
  1127. <tr>
  1128. <td>
  1129. <code>
  1130. <em>configuration</em>
  1131. </code>
  1132. </td>
  1133. <td>
  1134. <div>
  1135. <p><code>URLSessionConfiguration</code> to be used to create the underlying <code>URLSession</code>. Changes
  1136. to this value after being passed to this initializer will have no effect.
  1137. <code>URLSessionConfiguration.af.default</code> by default.</p>
  1138. </div>
  1139. </td>
  1140. </tr>
  1141. <tr>
  1142. <td>
  1143. <code>
  1144. <em>delegate</em>
  1145. </code>
  1146. </td>
  1147. <td>
  1148. <div>
  1149. <p><code><a href="../Classes/SessionDelegate.html">SessionDelegate</a></code> that handles <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7sessionSo12NSURLSessionCvp">session</a></code>&lsquo;s delegate callbacks as well as <code><a href="../Classes/Request.html">Request</a></code>
  1150. interaction. <code>SessionDelegate()</code> by default.</p>
  1151. </div>
  1152. </td>
  1153. </tr>
  1154. <tr>
  1155. <td>
  1156. <code>
  1157. <em>rootQueue</em>
  1158. </code>
  1159. </td>
  1160. <td>
  1161. <div>
  1162. <p>Root <code>DispatchQueue</code> for all internal callbacks and state updates. <strong>MUST</strong> be a
  1163. serial queue. <code>DispatchQueue(label: &quot;org.alamofire.session.rootQueue&quot;)</code> by default.</p>
  1164. </div>
  1165. </td>
  1166. </tr>
  1167. <tr>
  1168. <td>
  1169. <code>
  1170. <em>startRequestsImmediately</em>
  1171. </code>
  1172. </td>
  1173. <td>
  1174. <div>
  1175. <p>Determines whether this instance will automatically start all <code><a href="../Classes/Request.html">Request</a></code>s. <code>true</code>
  1176. by default. If set to <code>false</code>, all <code><a href="../Classes/Request.html">Request</a></code>s created must have <code>.resume()</code> called.
  1177. on them for them to start.</p>
  1178. </div>
  1179. </td>
  1180. </tr>
  1181. <tr>
  1182. <td>
  1183. <code>
  1184. <em>requestQueue</em>
  1185. </code>
  1186. </td>
  1187. <td>
  1188. <div>
  1189. <p><code>DispatchQueue</code> on which to perform <code>URLRequest</code> creation. By default this queue
  1190. will use the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> as its <code>target</code>. A separate queue can be used if it&rsquo;s
  1191. determined request creation is a bottleneck, but that should only be done after
  1192. careful testing and profiling. <code>nil</code> by default.</p>
  1193. </div>
  1194. </td>
  1195. </tr>
  1196. <tr>
  1197. <td>
  1198. <code>
  1199. <em>serializationQueue</em>
  1200. </code>
  1201. </td>
  1202. <td>
  1203. <div>
  1204. <p><code>DispatchQueue</code> on which to perform all response serialization. By default this
  1205. queue will use the <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code> as its <code>target</code>. A separate queue can be used if
  1206. it&rsquo;s determined response serialization is a bottleneck, but that should only be
  1207. done after careful testing and profiling. <code>nil</code> by default.</p>
  1208. </div>
  1209. </td>
  1210. </tr>
  1211. <tr>
  1212. <td>
  1213. <code>
  1214. <em>interceptor</em>
  1215. </code>
  1216. </td>
  1217. <td>
  1218. <div>
  1219. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> to be used for all <code><a href="../Classes/Request.html">Request</a></code>s created by this instance. <code>nil</code>
  1220. by default.</p>
  1221. </div>
  1222. </td>
  1223. </tr>
  1224. <tr>
  1225. <td>
  1226. <code>
  1227. <em>serverTrustManager</em>
  1228. </code>
  1229. </td>
  1230. <td>
  1231. <div>
  1232. <p><code><a href="../Classes/ServerTrustManager.html">ServerTrustManager</a></code> to be used for all trust evaluations by this instance. <code>nil</code>
  1233. by default.</p>
  1234. </div>
  1235. </td>
  1236. </tr>
  1237. <tr>
  1238. <td>
  1239. <code>
  1240. <em>redirectHandler</em>
  1241. </code>
  1242. </td>
  1243. <td>
  1244. <div>
  1245. <p><code><a href="../Protocols/RedirectHandler.html">RedirectHandler</a></code> to be used by all <code><a href="../Classes/Request.html">Request</a></code>s created by this instance. <code>nil</code> by
  1246. default.</p>
  1247. </div>
  1248. </td>
  1249. </tr>
  1250. <tr>
  1251. <td>
  1252. <code>
  1253. <em>cachedResponseHandler</em>
  1254. </code>
  1255. </td>
  1256. <td>
  1257. <div>
  1258. <p><code><a href="../Protocols/CachedResponseHandler.html">CachedResponseHandler</a></code> to be used by all <code><a href="../Classes/Request.html">Request</a></code>s created by this instance.
  1259. <code>nil</code> by default.</p>
  1260. </div>
  1261. </td>
  1262. </tr>
  1263. <tr>
  1264. <td>
  1265. <code>
  1266. <em>eventMonitors</em>
  1267. </code>
  1268. </td>
  1269. <td>
  1270. <div>
  1271. <p>Additional <code><a href="../Protocols/EventMonitor.html">EventMonitor</a></code>s used by the instance. Alamofire always adds a
  1272. <code><a href="../Classes/AlamofireNotifications.html">AlamofireNotifications</a></code> <code><a href="../Protocols/EventMonitor.html">EventMonitor</a></code> to the array passed here. <code>[]</code> by default.</p>
  1273. </div>
  1274. </td>
  1275. </tr>
  1276. </tbody>
  1277. </table>
  1278. </div>
  1279. </section>
  1280. </div>
  1281. </li>
  1282. </ul>
  1283. </div>
  1284. <div class="task-group">
  1285. <div class="task-name-container">
  1286. <a name="/All%20Requests%20API"></a>
  1287. <a name="//apple_ref/swift/Section/All Requests API" class="dashAnchor"></a>
  1288. <div class="section-name-container">
  1289. <a class="section-name-link" href="#/All%20Requests%20API"></a>
  1290. <h3 class="section-name"><span>All Requests API</span>
  1291. </h3>
  1292. </div>
  1293. </div>
  1294. <ul class="item-container">
  1295. <li class="item">
  1296. <div>
  1297. <code>
  1298. <a name="/s:9Alamofire7SessionC15withAllRequests7performyyShyAA7RequestCGc_tF"></a>
  1299. <a name="//apple_ref/swift/Method/withAllRequests(perform:)" class="dashAnchor"></a>
  1300. <a class="token" href="#/s:9Alamofire7SessionC15withAllRequests7performyyShyAA7RequestCGc_tF">withAllRequests(perform:<wbr>)</a>
  1301. </code>
  1302. </div>
  1303. <div class="height-container">
  1304. <div class="pointer-container"></div>
  1305. <section class="section">
  1306. <div class="pointer"></div>
  1307. <div class="abstract">
  1308. <p>Perform an action on all active <code><a href="../Classes/Request.html">Request</a></code>s.</p>
  1309. <div class="aside aside-note">
  1310. <p class="aside-title">Note</p>
  1311. <p>The provided <code>action</code> closure is performed asynchronously, meaning that some <code><a href="../Classes/Request.html">Request</a></code>s may complete and
  1312. be unavailable by time it runs. Additionally, this action is performed on the instances&rsquo;s <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC9rootQueueSo17OS_dispatch_queueCvp">rootQueue</a></code>,
  1313. so care should be taken that actions are fast. Once the work on the <code><a href="../Classes/Request.html">Request</a></code>s is complete, any
  1314. additional work should be performed on another queue.</p>
  1315. </div>
  1316. </div>
  1317. <div class="declaration">
  1318. <h4>Declaration</h4>
  1319. <div class="language">
  1320. <p class="aside-title">Swift</p>
  1321. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">withAllRequests</span><span class="p">(</span><span class="n">perform</span> <span class="nv">action</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">Set</span><span class="o">&lt;</span><span class="kt"><a href="../Classes/Request.html">Request</a></span><span class="o">&gt;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span></code></pre>
  1322. </div>
  1323. </div>
  1324. <div>
  1325. <h4>Parameters</h4>
  1326. <table class="graybox">
  1327. <tbody>
  1328. <tr>
  1329. <td>
  1330. <code>
  1331. <em>action</em>
  1332. </code>
  1333. </td>
  1334. <td>
  1335. <div>
  1336. <p>Closure to perform with all <code><a href="../Classes/Request.html">Request</a></code>s.</p>
  1337. </div>
  1338. </td>
  1339. </tr>
  1340. </tbody>
  1341. </table>
  1342. </div>
  1343. </section>
  1344. </div>
  1345. </li>
  1346. <li class="item">
  1347. <div>
  1348. <code>
  1349. <a name="/s:9Alamofire7SessionC17cancelAllRequests17completingOnQueue10completionySo17OS_dispatch_queueC_yycSgtF"></a>
  1350. <a name="//apple_ref/swift/Method/cancelAllRequests(completingOnQueue:completion:)" class="dashAnchor"></a>
  1351. <a class="token" href="#/s:9Alamofire7SessionC17cancelAllRequests17completingOnQueue10completionySo17OS_dispatch_queueC_yycSgtF">cancelAllRequests(completingOnQueue:<wbr>completion:<wbr>)</a>
  1352. </code>
  1353. </div>
  1354. <div class="height-container">
  1355. <div class="pointer-container"></div>
  1356. <section class="section">
  1357. <div class="pointer"></div>
  1358. <div class="abstract">
  1359. <p>Cancel all active <code><a href="../Classes/Request.html">Request</a></code>s, optionally calling a completion handler when complete.</p>
  1360. <div class="aside aside-note">
  1361. <p class="aside-title">Note</p>
  1362. <p>This is an asynchronous operation and does not block the creation of future <code><a href="../Classes/Request.html">Request</a></code>s. Cancelled
  1363. <code><a href="../Classes/Request.html">Request</a></code>s may not cancel immediately due internal work, and may not cancel at all if they are close to
  1364. completion when cancelled.</p>
  1365. </div>
  1366. </div>
  1367. <div class="declaration">
  1368. <h4>Declaration</h4>
  1369. <div class="language">
  1370. <p class="aside-title">Swift</p>
  1371. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">cancelAllRequests</span><span class="p">(</span><span class="n">completingOnQueue</span> <span class="nv">queue</span><span class="p">:</span> <span class="kt">DispatchQueue</span> <span class="o">=</span> <span class="o">.</span><span class="n">main</span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</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></code></pre>
  1372. </div>
  1373. </div>
  1374. <div>
  1375. <h4>Parameters</h4>
  1376. <table class="graybox">
  1377. <tbody>
  1378. <tr>
  1379. <td>
  1380. <code>
  1381. <em>queue</em>
  1382. </code>
  1383. </td>
  1384. <td>
  1385. <div>
  1386. <p><code>DispatchQueue</code> on which the completion handler is run. <code>.main</code> by default.</p>
  1387. </div>
  1388. </td>
  1389. </tr>
  1390. <tr>
  1391. <td>
  1392. <code>
  1393. <em>completion</em>
  1394. </code>
  1395. </td>
  1396. <td>
  1397. <div>
  1398. <p>Closure to be called when all <code><a href="../Classes/Request.html">Request</a></code>s have been cancelled.</p>
  1399. </div>
  1400. </td>
  1401. </tr>
  1402. </tbody>
  1403. </table>
  1404. </div>
  1405. </section>
  1406. </div>
  1407. </li>
  1408. </ul>
  1409. </div>
  1410. <div class="task-group">
  1411. <div class="task-name-container">
  1412. <a name="/DataRequest"></a>
  1413. <a name="//apple_ref/swift/Section/DataRequest" class="dashAnchor"></a>
  1414. <div class="section-name-container">
  1415. <a class="section-name-link" href="#/DataRequest"></a>
  1416. <h3 class="section-name"><span>DataRequest</span>
  1417. </h3>
  1418. </div>
  1419. </div>
  1420. <ul class="item-container">
  1421. <li class="item">
  1422. <div>
  1423. <code>
  1424. <a name="/s:9Alamofire7SessionC15RequestModifiera"></a>
  1425. <a name="//apple_ref/swift/Alias/RequestModifier" class="dashAnchor"></a>
  1426. <a class="token" href="#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a>
  1427. </code>
  1428. </div>
  1429. <div class="height-container">
  1430. <div class="pointer-container"></div>
  1431. <section class="section">
  1432. <div class="pointer"></div>
  1433. <div class="abstract">
  1434. <p>Closure which provides a <code>URLRequest</code> for mutation.</p>
  1435. </div>
  1436. <div class="declaration">
  1437. <h4>Declaration</h4>
  1438. <div class="language">
  1439. <p class="aside-title">Swift</p>
  1440. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">typealias</span> <span class="kt">RequestModifier</span> <span class="o">=</span> <span class="p">(</span><span class="k">inout</span> <span class="kt">URLRequest</span><span class="p">)</span> <span class="k">throws</span> <span class="o">-&gt;</span> <span class="kt">Void</span></code></pre>
  1441. </div>
  1442. </div>
  1443. </section>
  1444. </div>
  1445. </li>
  1446. <li class="item">
  1447. <div>
  1448. <code>
  1449. <a name="/s:9Alamofire7SessionC7request_6method10parameters8encoding7headers11interceptor0C8ModifierAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodVSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0K11Interceptor_pSgy10Foundation10URLRequestVzKcSgtF"></a>
  1450. <a name="//apple_ref/swift/Method/request(_:method:parameters:encoding:headers:interceptor:requestModifier:)" class="dashAnchor"></a>
  1451. <a class="token" href="#/s:9Alamofire7SessionC7request_6method10parameters8encoding7headers11interceptor0C8ModifierAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodVSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0K11Interceptor_pSgy10Foundation10URLRequestVzKcSgtF">request(_:<wbr>method:<wbr>parameters:<wbr>encoding:<wbr>headers:<wbr>interceptor:<wbr>requestModifier:<wbr>)</a>
  1452. </code>
  1453. </div>
  1454. <div class="height-container">
  1455. <div class="pointer-container"></div>
  1456. <section class="section">
  1457. <div class="pointer"></div>
  1458. <div class="abstract">
  1459. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> from a <code>URLRequest</code> created using the passed components and a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1460. </div>
  1461. <div class="declaration">
  1462. <h4>Declaration</h4>
  1463. <div class="language">
  1464. <p class="aside-title">Swift</p>
  1465. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="n">_</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1466. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  1467. <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>
  1468. <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>
  1469. <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>
  1470. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1471. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  1472. </div>
  1473. </div>
  1474. <div>
  1475. <h4>Parameters</h4>
  1476. <table class="graybox">
  1477. <tbody>
  1478. <tr>
  1479. <td>
  1480. <code>
  1481. <em>convertible</em>
  1482. </code>
  1483. </td>
  1484. <td>
  1485. <div>
  1486. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  1487. </div>
  1488. </td>
  1489. </tr>
  1490. <tr>
  1491. <td>
  1492. <code>
  1493. <em>method</em>
  1494. </code>
  1495. </td>
  1496. <td>
  1497. <div>
  1498. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.get</code> by default.</p>
  1499. </div>
  1500. </td>
  1501. </tr>
  1502. <tr>
  1503. <td>
  1504. <code>
  1505. <em>parameters</em>
  1506. </code>
  1507. </td>
  1508. <td>
  1509. <div>
  1510. <p><code><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></code> (a.k.a. <code>[String: Any]</code>) value to be encoded into the <code>URLRequest</code>. <code>nil</code> by
  1511. default.</p>
  1512. </div>
  1513. </td>
  1514. </tr>
  1515. <tr>
  1516. <td>
  1517. <code>
  1518. <em>encoding</em>
  1519. </code>
  1520. </td>
  1521. <td>
  1522. <div>
  1523. <p><code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code> to be used to encode the <code>parameters</code> value into the <code>URLRequest</code>.
  1524. <code><a href="../Structs/URLEncoding.html#/s:9Alamofire11URLEncodingV7defaultACvpZ">URLEncoding.default</a></code> by default.</p>
  1525. </div>
  1526. </td>
  1527. </tr>
  1528. <tr>
  1529. <td>
  1530. <code>
  1531. <em>headers</em>
  1532. </code>
  1533. </td>
  1534. <td>
  1535. <div>
  1536. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1537. </div>
  1538. </td>
  1539. </tr>
  1540. <tr>
  1541. <td>
  1542. <code>
  1543. <em>interceptor</em>
  1544. </code>
  1545. </td>
  1546. <td>
  1547. <div>
  1548. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  1549. </div>
  1550. </td>
  1551. </tr>
  1552. <tr>
  1553. <td>
  1554. <code>
  1555. <em>requestModifier</em>
  1556. </code>
  1557. </td>
  1558. <td>
  1559. <div>
  1560. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the provided
  1561. parameters. <code>nil</code> by default.</p>
  1562. </div>
  1563. </td>
  1564. </tr>
  1565. </tbody>
  1566. </table>
  1567. </div>
  1568. <div>
  1569. <h4>Return Value</h4>
  1570. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  1571. </div>
  1572. </section>
  1573. </div>
  1574. </li>
  1575. <li class="item">
  1576. <div>
  1577. <code>
  1578. <a name="/s:9Alamofire7SessionC7request_6method10parameters7encoder7headers11interceptor0C8ModifierAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodVxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0K11Interceptor_pSgy10Foundation10URLRequestVzKcSgtSERzlF"></a>
  1579. <a name="//apple_ref/swift/Method/request(_:method:parameters:encoder:headers:interceptor:requestModifier:)" class="dashAnchor"></a>
  1580. <a class="token" href="#/s:9Alamofire7SessionC7request_6method10parameters7encoder7headers11interceptor0C8ModifierAA11DataRequestCAA14URLConvertible_p_AA10HTTPMethodVxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0K11Interceptor_pSgy10Foundation10URLRequestVzKcSgtSERzlF">request(_:<wbr>method:<wbr>parameters:<wbr>encoder:<wbr>headers:<wbr>interceptor:<wbr>requestModifier:<wbr>)</a>
  1581. </code>
  1582. </div>
  1583. <div class="height-container">
  1584. <div class="pointer-container"></div>
  1585. <section class="section">
  1586. <div class="pointer"></div>
  1587. <div class="abstract">
  1588. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> from a <code>URLRequest</code> created using the passed components, <code>Encodable</code> parameters, and a
  1589. <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1590. </div>
  1591. <div class="declaration">
  1592. <h4>Declaration</h4>
  1593. <div class="language">
  1594. <p class="aside-title">Swift</p>
  1595. <pre class="highlight swift"><code><span class="kd">open</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">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1596. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  1597. <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>
  1598. <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>
  1599. <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>
  1600. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1601. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  1602. </div>
  1603. </div>
  1604. <div>
  1605. <h4>Parameters</h4>
  1606. <table class="graybox">
  1607. <tbody>
  1608. <tr>
  1609. <td>
  1610. <code>
  1611. <em>convertible</em>
  1612. </code>
  1613. </td>
  1614. <td>
  1615. <div>
  1616. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  1617. </div>
  1618. </td>
  1619. </tr>
  1620. <tr>
  1621. <td>
  1622. <code>
  1623. <em>method</em>
  1624. </code>
  1625. </td>
  1626. <td>
  1627. <div>
  1628. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.get</code> by default.</p>
  1629. </div>
  1630. </td>
  1631. </tr>
  1632. <tr>
  1633. <td>
  1634. <code>
  1635. <em>parameters</em>
  1636. </code>
  1637. </td>
  1638. <td>
  1639. <div>
  1640. <p><code>Encodable</code> value to be encoded into the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1641. </div>
  1642. </td>
  1643. </tr>
  1644. <tr>
  1645. <td>
  1646. <code>
  1647. <em>encoder</em>
  1648. </code>
  1649. </td>
  1650. <td>
  1651. <div>
  1652. <p><code><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></code> to be used to encode the <code>parameters</code> value into the <code>URLRequest</code>.
  1653. <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code> by default.</p>
  1654. </div>
  1655. </td>
  1656. </tr>
  1657. <tr>
  1658. <td>
  1659. <code>
  1660. <em>headers</em>
  1661. </code>
  1662. </td>
  1663. <td>
  1664. <div>
  1665. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1666. </div>
  1667. </td>
  1668. </tr>
  1669. <tr>
  1670. <td>
  1671. <code>
  1672. <em>interceptor</em>
  1673. </code>
  1674. </td>
  1675. <td>
  1676. <div>
  1677. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  1678. </div>
  1679. </td>
  1680. </tr>
  1681. <tr>
  1682. <td>
  1683. <code>
  1684. <em>requestModifier</em>
  1685. </code>
  1686. </td>
  1687. <td>
  1688. <div>
  1689. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from
  1690. the provided parameters. <code>nil</code> by default.</p>
  1691. </div>
  1692. </td>
  1693. </tr>
  1694. </tbody>
  1695. </table>
  1696. </div>
  1697. <div>
  1698. <h4>Return Value</h4>
  1699. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  1700. </div>
  1701. </section>
  1702. </div>
  1703. </li>
  1704. <li class="item">
  1705. <div>
  1706. <code>
  1707. <a name="/s:9Alamofire7SessionC7request_11interceptorAA11DataRequestCAA21URLRequestConvertible_p_AA0F11Interceptor_pSgtF"></a>
  1708. <a name="//apple_ref/swift/Method/request(_:interceptor:)" class="dashAnchor"></a>
  1709. <a class="token" href="#/s:9Alamofire7SessionC7request_11interceptorAA11DataRequestCAA21URLRequestConvertible_p_AA0F11Interceptor_pSgtF">request(_:<wbr>interceptor:<wbr>)</a>
  1710. </code>
  1711. </div>
  1712. <div class="height-container">
  1713. <div class="pointer-container"></div>
  1714. <section class="section">
  1715. <div class="pointer"></div>
  1716. <div class="abstract">
  1717. <p>Creates a <code><a href="../Classes/DataRequest.html">DataRequest</a></code> from a <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value and a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1718. </div>
  1719. <div class="declaration">
  1720. <h4>Declaration</h4>
  1721. <div class="language">
  1722. <p class="aside-title">Swift</p>
  1723. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="n">_</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span> <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</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>
  1724. </div>
  1725. </div>
  1726. <div>
  1727. <h4>Parameters</h4>
  1728. <table class="graybox">
  1729. <tbody>
  1730. <tr>
  1731. <td>
  1732. <code>
  1733. <em>convertible</em>
  1734. </code>
  1735. </td>
  1736. <td>
  1737. <div>
  1738. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  1739. </div>
  1740. </td>
  1741. </tr>
  1742. <tr>
  1743. <td>
  1744. <code>
  1745. <em>interceptor</em>
  1746. </code>
  1747. </td>
  1748. <td>
  1749. <div>
  1750. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  1751. </div>
  1752. </td>
  1753. </tr>
  1754. </tbody>
  1755. </table>
  1756. </div>
  1757. <div>
  1758. <h4>Return Value</h4>
  1759. <p>The created <code><a href="../Classes/DataRequest.html">DataRequest</a></code>.</p>
  1760. </div>
  1761. </section>
  1762. </div>
  1763. </li>
  1764. </ul>
  1765. </div>
  1766. <div class="task-group">
  1767. <div class="task-name-container">
  1768. <a name="/DataStreamRequest"></a>
  1769. <a name="//apple_ref/swift/Section/DataStreamRequest" class="dashAnchor"></a>
  1770. <div class="section-name-container">
  1771. <a class="section-name-link" href="#/DataStreamRequest"></a>
  1772. <h3 class="section-name"><span>DataStreamRequest</span>
  1773. </h3>
  1774. </div>
  1775. </div>
  1776. <ul class="item-container">
  1777. <li class="item">
  1778. <div>
  1779. <code>
  1780. <a name="/s:9Alamofire7SessionC13streamRequest_6method10parameters7encoder7headers32automaticallyCancelOnStreamError11interceptor15requestModifierAA04DatalD0CAA14URLConvertible_p_AA10HTTPMethodVxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgSbAA0D11Interceptor_pSgy10Foundation10URLRequestVzKcSgtSERzlF"></a>
  1781. <a name="//apple_ref/swift/Method/streamRequest(_:method:parameters:encoder:headers:automaticallyCancelOnStreamError:interceptor:requestModifier:)" class="dashAnchor"></a>
  1782. <a class="token" href="#/s:9Alamofire7SessionC13streamRequest_6method10parameters7encoder7headers32automaticallyCancelOnStreamError11interceptor15requestModifierAA04DatalD0CAA14URLConvertible_p_AA10HTTPMethodVxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgSbAA0D11Interceptor_pSgy10Foundation10URLRequestVzKcSgtSERzlF">streamRequest(_:<wbr>method:<wbr>parameters:<wbr>encoder:<wbr>headers:<wbr>automaticallyCancelOnStreamError:<wbr>interceptor:<wbr>requestModifier:<wbr>)</a>
  1783. </code>
  1784. </div>
  1785. <div class="height-container">
  1786. <div class="pointer-container"></div>
  1787. <section class="section">
  1788. <div class="pointer"></div>
  1789. <div class="abstract">
  1790. <p>Creates a <code><a href="../Classes/DataStreamRequest.html">DataStreamRequest</a></code> from the passed components, <code>Encodable</code> parameters, and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1791. </div>
  1792. <div class="declaration">
  1793. <h4>Declaration</h4>
  1794. <div class="language">
  1795. <p class="aside-title">Swift</p>
  1796. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="n">streamRequest</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">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1797. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  1798. <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>
  1799. <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>
  1800. <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>
  1801. <span class="nv">automaticallyCancelOnStreamError</span><span class="p">:</span> <span class="kt">Bool</span> <span class="o">=</span> <span class="kc">false</span><span class="p">,</span>
  1802. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1803. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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/DataStreamRequest.html">DataStreamRequest</a></span></code></pre>
  1804. </div>
  1805. </div>
  1806. <div>
  1807. <h4>Parameters</h4>
  1808. <table class="graybox">
  1809. <tbody>
  1810. <tr>
  1811. <td>
  1812. <code>
  1813. <em>convertible</em>
  1814. </code>
  1815. </td>
  1816. <td>
  1817. <div>
  1818. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  1819. </div>
  1820. </td>
  1821. </tr>
  1822. <tr>
  1823. <td>
  1824. <code>
  1825. <em>method</em>
  1826. </code>
  1827. </td>
  1828. <td>
  1829. <div>
  1830. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.get</code> by default.</p>
  1831. </div>
  1832. </td>
  1833. </tr>
  1834. <tr>
  1835. <td>
  1836. <code>
  1837. <em>parameters</em>
  1838. </code>
  1839. </td>
  1840. <td>
  1841. <div>
  1842. <p><code>Encodable</code> value to be encoded into the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1843. </div>
  1844. </td>
  1845. </tr>
  1846. <tr>
  1847. <td>
  1848. <code>
  1849. <em>encoder</em>
  1850. </code>
  1851. </td>
  1852. <td>
  1853. <div>
  1854. <p><code><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></code> to be used to encode the <code>parameters</code> value into the
  1855. <code>URLRequest</code>.
  1856. <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code> by default.</p>
  1857. </div>
  1858. </td>
  1859. </tr>
  1860. <tr>
  1861. <td>
  1862. <code>
  1863. <em>headers</em>
  1864. </code>
  1865. </td>
  1866. <td>
  1867. <div>
  1868. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1869. </div>
  1870. </td>
  1871. </tr>
  1872. <tr>
  1873. <td>
  1874. <code>
  1875. <em>automaticallyCancelOnStreamError</em>
  1876. </code>
  1877. </td>
  1878. <td>
  1879. <div>
  1880. <p><code>Bool</code> indicating whether the instance should be canceled when an <code>Error</code>
  1881. is thrown while serializing stream <code>Data</code>. <code>false</code> by default.</p>
  1882. </div>
  1883. </td>
  1884. </tr>
  1885. <tr>
  1886. <td>
  1887. <code>
  1888. <em>interceptor</em>
  1889. </code>
  1890. </td>
  1891. <td>
  1892. <div>
  1893. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code>
  1894. by default.</p>
  1895. </div>
  1896. </td>
  1897. </tr>
  1898. <tr>
  1899. <td>
  1900. <code>
  1901. <em>requestModifier</em>
  1902. </code>
  1903. </td>
  1904. <td>
  1905. <div>
  1906. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from
  1907. the provided parameters. <code>nil</code> by default.</p>
  1908. </div>
  1909. </td>
  1910. </tr>
  1911. </tbody>
  1912. </table>
  1913. </div>
  1914. <div>
  1915. <h4>Return Value</h4>
  1916. <p>The created <code>DataStream</code> request.</p>
  1917. </div>
  1918. </section>
  1919. </div>
  1920. </li>
  1921. <li class="item">
  1922. <div>
  1923. <code>
  1924. <a name="/s:9Alamofire7SessionC13streamRequest_6method7headers32automaticallyCancelOnStreamError11interceptor15requestModifierAA04DatajD0CAA14URLConvertible_p_AA10HTTPMethodVAA11HTTPHeadersVSgSbAA0D11Interceptor_pSgy10Foundation10URLRequestVzKcSgtF"></a>
  1925. <a name="//apple_ref/swift/Method/streamRequest(_:method:headers:automaticallyCancelOnStreamError:interceptor:requestModifier:)" class="dashAnchor"></a>
  1926. <a class="token" href="#/s:9Alamofire7SessionC13streamRequest_6method7headers32automaticallyCancelOnStreamError11interceptor15requestModifierAA04DatajD0CAA14URLConvertible_p_AA10HTTPMethodVAA11HTTPHeadersVSgSbAA0D11Interceptor_pSgy10Foundation10URLRequestVzKcSgtF">streamRequest(_:<wbr>method:<wbr>headers:<wbr>automaticallyCancelOnStreamError:<wbr>interceptor:<wbr>requestModifier:<wbr>)</a>
  1927. </code>
  1928. </div>
  1929. <div class="height-container">
  1930. <div class="pointer-container"></div>
  1931. <section class="section">
  1932. <div class="pointer"></div>
  1933. <div class="abstract">
  1934. <p>Creates a <code><a href="../Classes/DataStreamRequest.html">DataStreamRequest</a></code> from the passed components and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  1935. </div>
  1936. <div class="declaration">
  1937. <h4>Declaration</h4>
  1938. <div class="language">
  1939. <p class="aside-title">Swift</p>
  1940. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">streamRequest</span><span class="p">(</span><span class="n">_</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  1941. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  1942. <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>
  1943. <span class="nv">automaticallyCancelOnStreamError</span><span class="p">:</span> <span class="kt">Bool</span> <span class="o">=</span> <span class="kc">false</span><span class="p">,</span>
  1944. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  1945. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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/DataStreamRequest.html">DataStreamRequest</a></span></code></pre>
  1946. </div>
  1947. </div>
  1948. <div>
  1949. <h4>Parameters</h4>
  1950. <table class="graybox">
  1951. <tbody>
  1952. <tr>
  1953. <td>
  1954. <code>
  1955. <em>convertible</em>
  1956. </code>
  1957. </td>
  1958. <td>
  1959. <div>
  1960. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  1961. </div>
  1962. </td>
  1963. </tr>
  1964. <tr>
  1965. <td>
  1966. <code>
  1967. <em>method</em>
  1968. </code>
  1969. </td>
  1970. <td>
  1971. <div>
  1972. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.get</code> by default.</p>
  1973. </div>
  1974. </td>
  1975. </tr>
  1976. <tr>
  1977. <td>
  1978. <code>
  1979. <em>headers</em>
  1980. </code>
  1981. </td>
  1982. <td>
  1983. <div>
  1984. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  1985. </div>
  1986. </td>
  1987. </tr>
  1988. <tr>
  1989. <td>
  1990. <code>
  1991. <em>automaticallyCancelOnStreamError</em>
  1992. </code>
  1993. </td>
  1994. <td>
  1995. <div>
  1996. <p><code>Bool</code> indicating whether the instance should be canceled when an <code>Error</code>
  1997. is thrown while serializing stream <code>Data</code>. <code>false</code> by default.</p>
  1998. </div>
  1999. </td>
  2000. </tr>
  2001. <tr>
  2002. <td>
  2003. <code>
  2004. <em>interceptor</em>
  2005. </code>
  2006. </td>
  2007. <td>
  2008. <div>
  2009. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code>
  2010. by default.</p>
  2011. </div>
  2012. </td>
  2013. </tr>
  2014. <tr>
  2015. <td>
  2016. <code>
  2017. <em>requestModifier</em>
  2018. </code>
  2019. </td>
  2020. <td>
  2021. <div>
  2022. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from
  2023. the provided parameters. <code>nil</code> by default.</p>
  2024. </div>
  2025. </td>
  2026. </tr>
  2027. </tbody>
  2028. </table>
  2029. </div>
  2030. <div>
  2031. <h4>Return Value</h4>
  2032. <p>The created <code>DataStream</code> request.</p>
  2033. </div>
  2034. </section>
  2035. </div>
  2036. </li>
  2037. <li class="item">
  2038. <div>
  2039. <code>
  2040. <a name="/s:9Alamofire7SessionC13streamRequest_32automaticallyCancelOnStreamError11interceptorAA04DatahD0CAA21URLRequestConvertible_p_SbAA0D11Interceptor_pSgtF"></a>
  2041. <a name="//apple_ref/swift/Method/streamRequest(_:automaticallyCancelOnStreamError:interceptor:)" class="dashAnchor"></a>
  2042. <a class="token" href="#/s:9Alamofire7SessionC13streamRequest_32automaticallyCancelOnStreamError11interceptorAA04DatahD0CAA21URLRequestConvertible_p_SbAA0D11Interceptor_pSgtF">streamRequest(_:<wbr>automaticallyCancelOnStreamError:<wbr>interceptor:<wbr>)</a>
  2043. </code>
  2044. </div>
  2045. <div class="height-container">
  2046. <div class="pointer-container"></div>
  2047. <section class="section">
  2048. <div class="pointer"></div>
  2049. <div class="abstract">
  2050. <p>Creates a <code><a href="../Classes/DataStreamRequest.html">DataStreamRequest</a></code> from the passed <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2051. </div>
  2052. <div class="declaration">
  2053. <h4>Declaration</h4>
  2054. <div class="language">
  2055. <p class="aside-title">Swift</p>
  2056. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">streamRequest</span><span class="p">(</span><span class="n">_</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  2057. <span class="nv">automaticallyCancelOnStreamError</span><span class="p">:</span> <span class="kt">Bool</span> <span class="o">=</span> <span class="kc">false</span><span class="p">,</span>
  2058. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</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/DataStreamRequest.html">DataStreamRequest</a></span></code></pre>
  2059. </div>
  2060. </div>
  2061. <div>
  2062. <h4>Parameters</h4>
  2063. <table class="graybox">
  2064. <tbody>
  2065. <tr>
  2066. <td>
  2067. <code>
  2068. <em>convertible</em>
  2069. </code>
  2070. </td>
  2071. <td>
  2072. <div>
  2073. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  2074. </div>
  2075. </td>
  2076. </tr>
  2077. <tr>
  2078. <td>
  2079. <code>
  2080. <em>automaticallyCancelOnStreamError</em>
  2081. </code>
  2082. </td>
  2083. <td>
  2084. <div>
  2085. <p><code>Bool</code> indicating whether the instance should be canceled when an <code>Error</code>
  2086. is thrown while serializing stream <code>Data</code>. <code>false</code> by default.</p>
  2087. </div>
  2088. </td>
  2089. </tr>
  2090. <tr>
  2091. <td>
  2092. <code>
  2093. <em>interceptor</em>
  2094. </code>
  2095. </td>
  2096. <td>
  2097. <div>
  2098. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code>
  2099. by default.</p>
  2100. </div>
  2101. </td>
  2102. </tr>
  2103. </tbody>
  2104. </table>
  2105. </div>
  2106. <div>
  2107. <h4>Return Value</h4>
  2108. <p>The created <code><a href="../Classes/DataStreamRequest.html">DataStreamRequest</a></code>.</p>
  2109. </div>
  2110. </section>
  2111. </div>
  2112. </li>
  2113. </ul>
  2114. </div>
  2115. <div class="task-group">
  2116. <div class="task-name-container">
  2117. <a name="/DownloadRequest"></a>
  2118. <a name="//apple_ref/swift/Section/DownloadRequest" class="dashAnchor"></a>
  2119. <div class="section-name-container">
  2120. <a class="section-name-link" href="#/DownloadRequest"></a>
  2121. <h3 class="section-name"><span>DownloadRequest</span>
  2122. </h3>
  2123. </div>
  2124. </div>
  2125. <ul class="item-container">
  2126. <li class="item">
  2127. <div>
  2128. <code>
  2129. <a name="/s:9Alamofire7SessionC8download_6method10parameters8encoding7headers11interceptor15requestModifier2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodVSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0M11Interceptor_pSgy10Foundation10URLRequestVzKcSgAY3URLV011destinationV0_AM7OptionsV7optionstA2__So17NSHTTPURLResponseCtcSgtF"></a>
  2130. <a name="//apple_ref/swift/Method/download(_:method:parameters:encoding:headers:interceptor:requestModifier:to:)" class="dashAnchor"></a>
  2131. <a class="token" href="#/s:9Alamofire7SessionC8download_6method10parameters8encoding7headers11interceptor15requestModifier2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodVSDySSypGSgAA17ParameterEncoding_pAA11HTTPHeadersVSgAA0M11Interceptor_pSgy10Foundation10URLRequestVzKcSgAY3URLV011destinationV0_AM7OptionsV7optionstA2__So17NSHTTPURLResponseCtcSgtF">download(_:<wbr>method:<wbr>parameters:<wbr>encoding:<wbr>headers:<wbr>interceptor:<wbr>requestModifier:<wbr>to:<wbr>)</a>
  2132. </code>
  2133. </div>
  2134. <div class="height-container">
  2135. <div class="pointer-container"></div>
  2136. <section class="section">
  2137. <div class="pointer"></div>
  2138. <div class="abstract">
  2139. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> using a <code>URLRequest</code> created using the passed components, <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, and
  2140. <code>Destination</code>.</p>
  2141. </div>
  2142. <div class="declaration">
  2143. <h4>Declaration</h4>
  2144. <div class="language">
  2145. <p class="aside-title">Swift</p>
  2146. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">_</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  2147. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  2148. <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>
  2149. <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>
  2150. <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>
  2151. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2152. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2153. <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>
  2154. </div>
  2155. </div>
  2156. <div>
  2157. <h4>Parameters</h4>
  2158. <table class="graybox">
  2159. <tbody>
  2160. <tr>
  2161. <td>
  2162. <code>
  2163. <em>convertible</em>
  2164. </code>
  2165. </td>
  2166. <td>
  2167. <div>
  2168. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  2169. </div>
  2170. </td>
  2171. </tr>
  2172. <tr>
  2173. <td>
  2174. <code>
  2175. <em>method</em>
  2176. </code>
  2177. </td>
  2178. <td>
  2179. <div>
  2180. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.get</code> by default.</p>
  2181. </div>
  2182. </td>
  2183. </tr>
  2184. <tr>
  2185. <td>
  2186. <code>
  2187. <em>parameters</em>
  2188. </code>
  2189. </td>
  2190. <td>
  2191. <div>
  2192. <p><code><a href="../Typealiases.html#/s:9Alamofire10Parametersa">Parameters</a></code> (a.k.a. <code>[String: Any]</code>) value to be encoded into the <code>URLRequest</code>. <code>nil</code> by
  2193. default.</p>
  2194. </div>
  2195. </td>
  2196. </tr>
  2197. <tr>
  2198. <td>
  2199. <code>
  2200. <em>encoding</em>
  2201. </code>
  2202. </td>
  2203. <td>
  2204. <div>
  2205. <p><code><a href="../Protocols/ParameterEncoding.html">ParameterEncoding</a></code> to be used to encode the <code>parameters</code> value into the <code>URLRequest</code>.
  2206. Defaults to <code><a href="../Structs/URLEncoding.html#/s:9Alamofire11URLEncodingV7defaultACvpZ">URLEncoding.default</a></code>.</p>
  2207. </div>
  2208. </td>
  2209. </tr>
  2210. <tr>
  2211. <td>
  2212. <code>
  2213. <em>headers</em>
  2214. </code>
  2215. </td>
  2216. <td>
  2217. <div>
  2218. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  2219. </div>
  2220. </td>
  2221. </tr>
  2222. <tr>
  2223. <td>
  2224. <code>
  2225. <em>interceptor</em>
  2226. </code>
  2227. </td>
  2228. <td>
  2229. <div>
  2230. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2231. </div>
  2232. </td>
  2233. </tr>
  2234. <tr>
  2235. <td>
  2236. <code>
  2237. <em>requestModifier</em>
  2238. </code>
  2239. </td>
  2240. <td>
  2241. <div>
  2242. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the provided
  2243. parameters. <code>nil</code> by default.</p>
  2244. </div>
  2245. </td>
  2246. </tr>
  2247. <tr>
  2248. <td>
  2249. <code>
  2250. <em>destination</em>
  2251. </code>
  2252. </td>
  2253. <td>
  2254. <div>
  2255. <p><code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used to determine how and where the downloaded file
  2256. should be moved. <code>nil</code> by default.</p>
  2257. </div>
  2258. </td>
  2259. </tr>
  2260. </tbody>
  2261. </table>
  2262. </div>
  2263. <div>
  2264. <h4>Return Value</h4>
  2265. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  2266. </div>
  2267. </section>
  2268. </div>
  2269. </li>
  2270. <li class="item">
  2271. <div>
  2272. <code>
  2273. <a name="/s:9Alamofire7SessionC8download_6method10parameters7encoder7headers11interceptor15requestModifier2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodVxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0M11Interceptor_pSgy10Foundation10URLRequestVzKcSgAX3URLV011destinationV0_AM7OptionsV7optionstA1__So17NSHTTPURLResponseCtcSgtSERzlF"></a>
  2274. <a name="//apple_ref/swift/Method/download(_:method:parameters:encoder:headers:interceptor:requestModifier:to:)" class="dashAnchor"></a>
  2275. <a class="token" href="#/s:9Alamofire7SessionC8download_6method10parameters7encoder7headers11interceptor15requestModifier2toAA15DownloadRequestCAA14URLConvertible_p_AA10HTTPMethodVxSgAA16ParameterEncoder_pAA11HTTPHeadersVSgAA0M11Interceptor_pSgy10Foundation10URLRequestVzKcSgAX3URLV011destinationV0_AM7OptionsV7optionstA1__So17NSHTTPURLResponseCtcSgtSERzlF">download(_:<wbr>method:<wbr>parameters:<wbr>encoder:<wbr>headers:<wbr>interceptor:<wbr>requestModifier:<wbr>to:<wbr>)</a>
  2276. </code>
  2277. </div>
  2278. <div class="height-container">
  2279. <div class="pointer-container"></div>
  2280. <section class="section">
  2281. <div class="pointer"></div>
  2282. <div class="abstract">
  2283. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> from a <code>URLRequest</code> created using the passed components, <code>Encodable</code> parameters, and
  2284. a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2285. </div>
  2286. <div class="declaration">
  2287. <h4>Declaration</h4>
  2288. <div class="language">
  2289. <p class="aside-title">Swift</p>
  2290. <pre class="highlight swift"><code><span class="kd">open</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">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  2291. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="k">get</span><span class="p">,</span>
  2292. <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>
  2293. <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>
  2294. <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>
  2295. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2296. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2297. <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>
  2298. </div>
  2299. </div>
  2300. <div>
  2301. <h4>Parameters</h4>
  2302. <table class="graybox">
  2303. <tbody>
  2304. <tr>
  2305. <td>
  2306. <code>
  2307. <em>convertible</em>
  2308. </code>
  2309. </td>
  2310. <td>
  2311. <div>
  2312. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  2313. </div>
  2314. </td>
  2315. </tr>
  2316. <tr>
  2317. <td>
  2318. <code>
  2319. <em>method</em>
  2320. </code>
  2321. </td>
  2322. <td>
  2323. <div>
  2324. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.get</code> by default.</p>
  2325. </div>
  2326. </td>
  2327. </tr>
  2328. <tr>
  2329. <td>
  2330. <code>
  2331. <em>parameters</em>
  2332. </code>
  2333. </td>
  2334. <td>
  2335. <div>
  2336. <p>Value conforming to <code>Encodable</code> to be encoded into the <code>URLRequest</code>. <code>nil</code> by default.</p>
  2337. </div>
  2338. </td>
  2339. </tr>
  2340. <tr>
  2341. <td>
  2342. <code>
  2343. <em>encoder</em>
  2344. </code>
  2345. </td>
  2346. <td>
  2347. <div>
  2348. <p><code><a href="../Protocols/ParameterEncoder.html">ParameterEncoder</a></code> to be used to encode the <code>parameters</code> value into the <code>URLRequest</code>.
  2349. Defaults to <code><a href="../Classes/URLEncodedFormParameterEncoder.html#/s:9Alamofire30URLEncodedFormParameterEncoderC7defaultACvpZ">URLEncodedFormParameterEncoder.default</a></code>.</p>
  2350. </div>
  2351. </td>
  2352. </tr>
  2353. <tr>
  2354. <td>
  2355. <code>
  2356. <em>headers</em>
  2357. </code>
  2358. </td>
  2359. <td>
  2360. <div>
  2361. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  2362. </div>
  2363. </td>
  2364. </tr>
  2365. <tr>
  2366. <td>
  2367. <code>
  2368. <em>interceptor</em>
  2369. </code>
  2370. </td>
  2371. <td>
  2372. <div>
  2373. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2374. </div>
  2375. </td>
  2376. </tr>
  2377. <tr>
  2378. <td>
  2379. <code>
  2380. <em>requestModifier</em>
  2381. </code>
  2382. </td>
  2383. <td>
  2384. <div>
  2385. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the provided
  2386. parameters. <code>nil</code> by default.</p>
  2387. </div>
  2388. </td>
  2389. </tr>
  2390. <tr>
  2391. <td>
  2392. <code>
  2393. <em>destination</em>
  2394. </code>
  2395. </td>
  2396. <td>
  2397. <div>
  2398. <p><code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used to determine how and where the downloaded file
  2399. should be moved. <code>nil</code> by default.</p>
  2400. </div>
  2401. </td>
  2402. </tr>
  2403. </tbody>
  2404. </table>
  2405. </div>
  2406. <div>
  2407. <h4>Return Value</h4>
  2408. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  2409. </div>
  2410. </section>
  2411. </div>
  2412. </li>
  2413. <li class="item">
  2414. <div>
  2415. <code>
  2416. <a name="/s:9Alamofire7SessionC8download_11interceptor2toAA15DownloadRequestCAA21URLRequestConvertible_p_AA0G11Interceptor_pSg10Foundation3URLV011destinationL0_AH7OptionsV7optionstAN_So17NSHTTPURLResponseCtcSgtF"></a>
  2417. <a name="//apple_ref/swift/Method/download(_:interceptor:to:)" class="dashAnchor"></a>
  2418. <a class="token" href="#/s:9Alamofire7SessionC8download_11interceptor2toAA15DownloadRequestCAA21URLRequestConvertible_p_AA0G11Interceptor_pSg10Foundation3URLV011destinationL0_AH7OptionsV7optionstAN_So17NSHTTPURLResponseCtcSgtF">download(_:<wbr>interceptor:<wbr>to:<wbr>)</a>
  2419. </code>
  2420. </div>
  2421. <div class="height-container">
  2422. <div class="pointer-container"></div>
  2423. <section class="section">
  2424. <div class="pointer"></div>
  2425. <div class="abstract">
  2426. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> from a <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value, a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, and a <code>Destination</code>.</p>
  2427. </div>
  2428. <div class="declaration">
  2429. <h4>Declaration</h4>
  2430. <div class="language">
  2431. <p class="aside-title">Swift</p>
  2432. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">_</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  2433. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2434. <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>
  2435. </div>
  2436. </div>
  2437. <div>
  2438. <h4>Parameters</h4>
  2439. <table class="graybox">
  2440. <tbody>
  2441. <tr>
  2442. <td>
  2443. <code>
  2444. <em>convertible</em>
  2445. </code>
  2446. </td>
  2447. <td>
  2448. <div>
  2449. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  2450. </div>
  2451. </td>
  2452. </tr>
  2453. <tr>
  2454. <td>
  2455. <code>
  2456. <em>interceptor</em>
  2457. </code>
  2458. </td>
  2459. <td>
  2460. <div>
  2461. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2462. </div>
  2463. </td>
  2464. </tr>
  2465. <tr>
  2466. <td>
  2467. <code>
  2468. <em>destination</em>
  2469. </code>
  2470. </td>
  2471. <td>
  2472. <div>
  2473. <p><code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used to determine how and where the downloaded file
  2474. should be moved. <code>nil</code> by default.</p>
  2475. </div>
  2476. </td>
  2477. </tr>
  2478. </tbody>
  2479. </table>
  2480. </div>
  2481. <div>
  2482. <h4>Return Value</h4>
  2483. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  2484. </div>
  2485. </section>
  2486. </div>
  2487. </li>
  2488. <li class="item">
  2489. <div>
  2490. <code>
  2491. <a name="/s:9Alamofire7SessionC8download12resumingWith11interceptor2toAA15DownloadRequestC10Foundation4DataV_AA0I11Interceptor_pSgAJ3URLV011destinationM0_AI7OptionsV7optionstAP_So17NSHTTPURLResponseCtcSgtF"></a>
  2492. <a name="//apple_ref/swift/Method/download(resumingWith:interceptor:to:)" class="dashAnchor"></a>
  2493. <a class="token" href="#/s:9Alamofire7SessionC8download12resumingWith11interceptor2toAA15DownloadRequestC10Foundation4DataV_AA0I11Interceptor_pSgAJ3URLV011destinationM0_AI7OptionsV7optionstAP_So17NSHTTPURLResponseCtcSgtF">download(resumingWith:<wbr>interceptor:<wbr>to:<wbr>)</a>
  2494. </code>
  2495. </div>
  2496. <div class="height-container">
  2497. <div class="pointer-container"></div>
  2498. <section class="section">
  2499. <div class="pointer"></div>
  2500. <div class="abstract">
  2501. <p>Creates a <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> from the <code>resumeData</code> produced from a previously cancelled <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>, as
  2502. well as a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>, and a <code>Destination</code>.</p>
  2503. <div class="aside aside-note">
  2504. <p class="aside-title">Note</p>
  2505. <p>If <code>destination</code> is not specified, the download will be moved to a temporary location determined by
  2506. Alamofire. The file will not be deleted until the system purges the temporary files.</p>
  2507. </div><div class="aside aside-note">
  2508. <p class="aside-title">Note</p>
  2509. <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),
  2510. <code>resumeData</code> is broken on background URL session configurations. There&rsquo;s an underlying bug in the <code>resumeData</code>
  2511. generation logic where the data is written incorrectly and will always fail to resume the download. For more
  2512. 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>
  2513. </div>
  2514. </div>
  2515. <div class="declaration">
  2516. <h4>Declaration</h4>
  2517. <div class="language">
  2518. <p class="aside-title">Swift</p>
  2519. <pre class="highlight swift"><code><span class="kd">open</span> <span class="kd">func</span> <span class="nf">download</span><span class="p">(</span><span class="n">resumingWith</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span>
  2520. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2521. <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>
  2522. </div>
  2523. </div>
  2524. <div>
  2525. <h4>Parameters</h4>
  2526. <table class="graybox">
  2527. <tbody>
  2528. <tr>
  2529. <td>
  2530. <code>
  2531. <em>data</em>
  2532. </code>
  2533. </td>
  2534. <td>
  2535. <div>
  2536. <p>The resume data from a previously cancelled <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code> or <code>URLSessionDownloadTask</code>.</p>
  2537. </div>
  2538. </td>
  2539. </tr>
  2540. <tr>
  2541. <td>
  2542. <code>
  2543. <em>interceptor</em>
  2544. </code>
  2545. </td>
  2546. <td>
  2547. <div>
  2548. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2549. </div>
  2550. </td>
  2551. </tr>
  2552. <tr>
  2553. <td>
  2554. <code>
  2555. <em>destination</em>
  2556. </code>
  2557. </td>
  2558. <td>
  2559. <div>
  2560. <p><code><a href="../Classes/DownloadRequest.html#/s:9Alamofire15DownloadRequestC11Destinationa">DownloadRequest.Destination</a></code> closure used to determine how and where the downloaded file
  2561. should be moved. <code>nil</code> by default.</p>
  2562. </div>
  2563. </td>
  2564. </tr>
  2565. </tbody>
  2566. </table>
  2567. </div>
  2568. <div>
  2569. <h4>Return Value</h4>
  2570. <p>The created <code><a href="../Classes/DownloadRequest.html">DownloadRequest</a></code>.</p>
  2571. </div>
  2572. </section>
  2573. </div>
  2574. </li>
  2575. </ul>
  2576. </div>
  2577. <div class="task-group">
  2578. <div class="task-name-container">
  2579. <a name="/Data"></a>
  2580. <a name="//apple_ref/swift/Section/Data" class="dashAnchor"></a>
  2581. <div class="section-name-container">
  2582. <a class="section-name-link" href="#/Data"></a>
  2583. <h3 class="section-name"><span>Data</span>
  2584. </h3>
  2585. </div>
  2586. </div>
  2587. <ul class="item-container">
  2588. <li class="item">
  2589. <div>
  2590. <code>
  2591. <a name="/s:9Alamofire7SessionC6upload_2to6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_pAA10HTTPMethodVAA11HTTPHeadersVSgAA0M11Interceptor_pSgSo06NSFileI0CyAM10URLRequestVzKcSgtF"></a>
  2592. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:interceptor:fileManager:requestModifier:)" class="dashAnchor"></a>
  2593. <a class="token" href="#/s:9Alamofire7SessionC6upload_2to6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestC10Foundation4DataV_AA14URLConvertible_pAA10HTTPMethodVAA11HTTPHeadersVSgAA0M11Interceptor_pSgSo06NSFileI0CyAM10URLRequestVzKcSgtF">upload(_:<wbr>to:<wbr>method:<wbr>headers:<wbr>interceptor:<wbr>fileManager:<wbr>requestModifier:<wbr>)</a>
  2594. </code>
  2595. </div>
  2596. <div class="height-container">
  2597. <div class="pointer-container"></div>
  2598. <section class="section">
  2599. <div class="pointer"></div>
  2600. <div class="abstract">
  2601. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the given <code>Data</code>, <code>URLRequest</code> components, and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2602. </div>
  2603. <div class="declaration">
  2604. <h4>Declaration</h4>
  2605. <div class="language">
  2606. <p class="aside-title">Swift</p>
  2607. <pre class="highlight swift"><code><span class="kd">open</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>
  2608. <span class="n">to</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  2609. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  2610. <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>
  2611. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2612. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  2613. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  2614. </div>
  2615. </div>
  2616. <div>
  2617. <h4>Parameters</h4>
  2618. <table class="graybox">
  2619. <tbody>
  2620. <tr>
  2621. <td>
  2622. <code>
  2623. <em>data</em>
  2624. </code>
  2625. </td>
  2626. <td>
  2627. <div>
  2628. <p>The <code>Data</code> to upload.</p>
  2629. </div>
  2630. </td>
  2631. </tr>
  2632. <tr>
  2633. <td>
  2634. <code>
  2635. <em>convertible</em>
  2636. </code>
  2637. </td>
  2638. <td>
  2639. <div>
  2640. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  2641. </div>
  2642. </td>
  2643. </tr>
  2644. <tr>
  2645. <td>
  2646. <code>
  2647. <em>method</em>
  2648. </code>
  2649. </td>
  2650. <td>
  2651. <div>
  2652. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  2653. </div>
  2654. </td>
  2655. </tr>
  2656. <tr>
  2657. <td>
  2658. <code>
  2659. <em>headers</em>
  2660. </code>
  2661. </td>
  2662. <td>
  2663. <div>
  2664. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  2665. </div>
  2666. </td>
  2667. </tr>
  2668. <tr>
  2669. <td>
  2670. <code>
  2671. <em>interceptor</em>
  2672. </code>
  2673. </td>
  2674. <td>
  2675. <div>
  2676. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2677. </div>
  2678. </td>
  2679. </tr>
  2680. <tr>
  2681. <td>
  2682. <code>
  2683. <em>fileManager</em>
  2684. </code>
  2685. </td>
  2686. <td>
  2687. <div>
  2688. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  2689. default.</p>
  2690. </div>
  2691. </td>
  2692. </tr>
  2693. <tr>
  2694. <td>
  2695. <code>
  2696. <em>requestModifier</em>
  2697. </code>
  2698. </td>
  2699. <td>
  2700. <div>
  2701. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the provided
  2702. parameters. <code>nil</code> by default.</p>
  2703. </div>
  2704. </td>
  2705. </tr>
  2706. </tbody>
  2707. </table>
  2708. </div>
  2709. <div>
  2710. <h4>Return Value</h4>
  2711. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  2712. </div>
  2713. </section>
  2714. </div>
  2715. </li>
  2716. <li class="item">
  2717. <div>
  2718. <code>
  2719. <a name="/s:9Alamofire7SessionC6upload_4with11interceptor11fileManagerAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_pAA0I11Interceptor_pSgSo06NSFileG0CtF"></a>
  2720. <a name="//apple_ref/swift/Method/upload(_:with:interceptor:fileManager:)" class="dashAnchor"></a>
  2721. <a class="token" href="#/s:9Alamofire7SessionC6upload_4with11interceptor11fileManagerAA13UploadRequestC10Foundation4DataV_AA21URLRequestConvertible_pAA0I11Interceptor_pSgSo06NSFileG0CtF">upload(_:<wbr>with:<wbr>interceptor:<wbr>fileManager:<wbr>)</a>
  2722. </code>
  2723. </div>
  2724. <div class="height-container">
  2725. <div class="pointer-container"></div>
  2726. <section class="section">
  2727. <div class="pointer"></div>
  2728. <div class="abstract">
  2729. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the given <code>Data</code> using the <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2730. </div>
  2731. <div class="declaration">
  2732. <h4>Declaration</h4>
  2733. <div class="language">
  2734. <p class="aside-title">Swift</p>
  2735. <pre class="highlight swift"><code><span class="kd">open</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>
  2736. <span class="n">with</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  2737. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2738. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  2739. </div>
  2740. </div>
  2741. <div>
  2742. <h4>Parameters</h4>
  2743. <table class="graybox">
  2744. <tbody>
  2745. <tr>
  2746. <td>
  2747. <code>
  2748. <em>data</em>
  2749. </code>
  2750. </td>
  2751. <td>
  2752. <div>
  2753. <p>The <code>Data</code> to upload.</p>
  2754. </div>
  2755. </td>
  2756. </tr>
  2757. <tr>
  2758. <td>
  2759. <code>
  2760. <em>convertible</em>
  2761. </code>
  2762. </td>
  2763. <td>
  2764. <div>
  2765. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  2766. </div>
  2767. </td>
  2768. </tr>
  2769. <tr>
  2770. <td>
  2771. <code>
  2772. <em>interceptor</em>
  2773. </code>
  2774. </td>
  2775. <td>
  2776. <div>
  2777. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  2778. </div>
  2779. </td>
  2780. </tr>
  2781. <tr>
  2782. <td>
  2783. <code>
  2784. <em>fileManager</em>
  2785. </code>
  2786. </td>
  2787. <td>
  2788. <div>
  2789. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  2790. default.</p>
  2791. </div>
  2792. </td>
  2793. </tr>
  2794. </tbody>
  2795. </table>
  2796. </div>
  2797. <div>
  2798. <h4>Return Value</h4>
  2799. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  2800. </div>
  2801. </section>
  2802. </div>
  2803. </li>
  2804. </ul>
  2805. </div>
  2806. <div class="task-group">
  2807. <div class="task-name-container">
  2808. <a name="/File"></a>
  2809. <a name="//apple_ref/swift/Section/File" class="dashAnchor"></a>
  2810. <div class="section-name-container">
  2811. <a class="section-name-link" href="#/File"></a>
  2812. <h3 class="section-name"><span>File</span>
  2813. </h3>
  2814. </div>
  2815. </div>
  2816. <ul class="item-container">
  2817. <li class="item">
  2818. <div>
  2819. <code>
  2820. <a name="/s:9Alamofire7SessionC6upload_2to6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_pAA10HTTPMethodVAA11HTTPHeadersVSgAA0M11Interceptor_pSgSo06NSFileI0CyAM10URLRequestVzKcSgtF"></a>
  2821. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:interceptor:fileManager:requestModifier:)" class="dashAnchor"></a>
  2822. <a class="token" href="#/s:9Alamofire7SessionC6upload_2to6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestC10Foundation3URLV_AA14URLConvertible_pAA10HTTPMethodVAA11HTTPHeadersVSgAA0M11Interceptor_pSgSo06NSFileI0CyAM10URLRequestVzKcSgtF">upload(_:<wbr>to:<wbr>method:<wbr>headers:<wbr>interceptor:<wbr>fileManager:<wbr>requestModifier:<wbr>)</a>
  2823. </code>
  2824. </div>
  2825. <div class="height-container">
  2826. <div class="pointer-container"></div>
  2827. <section class="section">
  2828. <div class="pointer"></div>
  2829. <div class="abstract">
  2830. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the file at the given file <code>URL</code>, using a <code>URLRequest</code> from the provided
  2831. components and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2832. </div>
  2833. <div class="declaration">
  2834. <h4>Declaration</h4>
  2835. <div class="language">
  2836. <p class="aside-title">Swift</p>
  2837. <pre class="highlight swift"><code><span class="kd">open</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>
  2838. <span class="n">to</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  2839. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  2840. <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>
  2841. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2842. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  2843. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  2844. </div>
  2845. </div>
  2846. <div>
  2847. <h4>Parameters</h4>
  2848. <table class="graybox">
  2849. <tbody>
  2850. <tr>
  2851. <td>
  2852. <code>
  2853. <em>fileURL</em>
  2854. </code>
  2855. </td>
  2856. <td>
  2857. <div>
  2858. <p>The <code>URL</code> of the file to upload.</p>
  2859. </div>
  2860. </td>
  2861. </tr>
  2862. <tr>
  2863. <td>
  2864. <code>
  2865. <em>convertible</em>
  2866. </code>
  2867. </td>
  2868. <td>
  2869. <div>
  2870. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  2871. </div>
  2872. </td>
  2873. </tr>
  2874. <tr>
  2875. <td>
  2876. <code>
  2877. <em>method</em>
  2878. </code>
  2879. </td>
  2880. <td>
  2881. <div>
  2882. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  2883. </div>
  2884. </td>
  2885. </tr>
  2886. <tr>
  2887. <td>
  2888. <code>
  2889. <em>headers</em>
  2890. </code>
  2891. </td>
  2892. <td>
  2893. <div>
  2894. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  2895. </div>
  2896. </td>
  2897. </tr>
  2898. <tr>
  2899. <td>
  2900. <code>
  2901. <em>interceptor</em>
  2902. </code>
  2903. </td>
  2904. <td>
  2905. <div>
  2906. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code>nil</code> by default.</p>
  2907. </div>
  2908. </td>
  2909. </tr>
  2910. <tr>
  2911. <td>
  2912. <code>
  2913. <em>fileManager</em>
  2914. </code>
  2915. </td>
  2916. <td>
  2917. <div>
  2918. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  2919. default.</p>
  2920. </div>
  2921. </td>
  2922. </tr>
  2923. <tr>
  2924. <td>
  2925. <code>
  2926. <em>requestModifier</em>
  2927. </code>
  2928. </td>
  2929. <td>
  2930. <div>
  2931. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the provided
  2932. parameters. <code>nil</code> by default.</p>
  2933. </div>
  2934. </td>
  2935. </tr>
  2936. </tbody>
  2937. </table>
  2938. </div>
  2939. <div>
  2940. <h4>Return Value</h4>
  2941. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  2942. </div>
  2943. </section>
  2944. </div>
  2945. </li>
  2946. <li class="item">
  2947. <div>
  2948. <code>
  2949. <a name="/s:9Alamofire7SessionC6upload_4with11interceptor11fileManagerAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_pAA0I11Interceptor_pSgSo06NSFileG0CtF"></a>
  2950. <a name="//apple_ref/swift/Method/upload(_:with:interceptor:fileManager:)" class="dashAnchor"></a>
  2951. <a class="token" href="#/s:9Alamofire7SessionC6upload_4with11interceptor11fileManagerAA13UploadRequestC10Foundation3URLV_AA21URLRequestConvertible_pAA0I11Interceptor_pSgSo06NSFileG0CtF">upload(_:<wbr>with:<wbr>interceptor:<wbr>fileManager:<wbr>)</a>
  2952. </code>
  2953. </div>
  2954. <div class="height-container">
  2955. <div class="pointer-container"></div>
  2956. <section class="section">
  2957. <div class="pointer"></div>
  2958. <div class="abstract">
  2959. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the file at the given file <code>URL</code> using the <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value and
  2960. <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  2961. </div>
  2962. <div class="declaration">
  2963. <h4>Declaration</h4>
  2964. <div class="language">
  2965. <p class="aside-title">Swift</p>
  2966. <pre class="highlight swift"><code><span class="kd">open</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>
  2967. <span class="n">with</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  2968. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  2969. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  2970. </div>
  2971. </div>
  2972. <div>
  2973. <h4>Parameters</h4>
  2974. <table class="graybox">
  2975. <tbody>
  2976. <tr>
  2977. <td>
  2978. <code>
  2979. <em>fileURL</em>
  2980. </code>
  2981. </td>
  2982. <td>
  2983. <div>
  2984. <p>The <code>URL</code> of the file to upload.</p>
  2985. </div>
  2986. </td>
  2987. </tr>
  2988. <tr>
  2989. <td>
  2990. <code>
  2991. <em>convertible</em>
  2992. </code>
  2993. </td>
  2994. <td>
  2995. <div>
  2996. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  2997. </div>
  2998. </td>
  2999. </tr>
  3000. <tr>
  3001. <td>
  3002. <code>
  3003. <em>interceptor</em>
  3004. </code>
  3005. </td>
  3006. <td>
  3007. <div>
  3008. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3009. </div>
  3010. </td>
  3011. </tr>
  3012. <tr>
  3013. <td>
  3014. <code>
  3015. <em>fileManager</em>
  3016. </code>
  3017. </td>
  3018. <td>
  3019. <div>
  3020. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  3021. default.</p>
  3022. </div>
  3023. </td>
  3024. </tr>
  3025. </tbody>
  3026. </table>
  3027. </div>
  3028. <div>
  3029. <h4>Return Value</h4>
  3030. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3031. </div>
  3032. </section>
  3033. </div>
  3034. </li>
  3035. </ul>
  3036. </div>
  3037. <div class="task-group">
  3038. <div class="task-name-container">
  3039. <a name="/InputStream"></a>
  3040. <a name="//apple_ref/swift/Section/InputStream" class="dashAnchor"></a>
  3041. <div class="section-name-container">
  3042. <a class="section-name-link" href="#/InputStream"></a>
  3043. <h3 class="section-name"><span>InputStream</span>
  3044. </h3>
  3045. </div>
  3046. </div>
  3047. <ul class="item-container">
  3048. <li class="item">
  3049. <div>
  3050. <code>
  3051. <a name="/s:9Alamofire7SessionC6upload_2to6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestCSo13NSInputStreamC_AA14URLConvertible_pAA10HTTPMethodVAA11HTTPHeadersVSgAA0M11Interceptor_pSgSo06NSFileI0Cy10Foundation10URLRequestVzKcSgtF"></a>
  3052. <a name="//apple_ref/swift/Method/upload(_:to:method:headers:interceptor:fileManager:requestModifier:)" class="dashAnchor"></a>
  3053. <a class="token" href="#/s:9Alamofire7SessionC6upload_2to6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestCSo13NSInputStreamC_AA14URLConvertible_pAA10HTTPMethodVAA11HTTPHeadersVSgAA0M11Interceptor_pSgSo06NSFileI0Cy10Foundation10URLRequestVzKcSgtF">upload(_:<wbr>to:<wbr>method:<wbr>headers:<wbr>interceptor:<wbr>fileManager:<wbr>requestModifier:<wbr>)</a>
  3054. </code>
  3055. </div>
  3056. <div class="height-container">
  3057. <div class="pointer-container"></div>
  3058. <section class="section">
  3059. <div class="pointer"></div>
  3060. <div class="abstract">
  3061. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> from the <code>InputStream</code> provided using a <code>URLRequest</code> from the provided components and
  3062. <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  3063. </div>
  3064. <div class="declaration">
  3065. <h4>Declaration</h4>
  3066. <div class="language">
  3067. <p class="aside-title">Swift</p>
  3068. <pre class="highlight swift"><code><span class="kd">open</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>
  3069. <span class="n">to</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLConvertible.html">URLConvertible</a></span><span class="p">,</span>
  3070. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  3071. <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>
  3072. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  3073. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  3074. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  3075. </div>
  3076. </div>
  3077. <div>
  3078. <h4>Parameters</h4>
  3079. <table class="graybox">
  3080. <tbody>
  3081. <tr>
  3082. <td>
  3083. <code>
  3084. <em>stream</em>
  3085. </code>
  3086. </td>
  3087. <td>
  3088. <div>
  3089. <p>The <code>InputStream</code> that provides the data to upload.</p>
  3090. </div>
  3091. </td>
  3092. </tr>
  3093. <tr>
  3094. <td>
  3095. <code>
  3096. <em>convertible</em>
  3097. </code>
  3098. </td>
  3099. <td>
  3100. <div>
  3101. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  3102. </div>
  3103. </td>
  3104. </tr>
  3105. <tr>
  3106. <td>
  3107. <code>
  3108. <em>method</em>
  3109. </code>
  3110. </td>
  3111. <td>
  3112. <div>
  3113. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  3114. </div>
  3115. </td>
  3116. </tr>
  3117. <tr>
  3118. <td>
  3119. <code>
  3120. <em>headers</em>
  3121. </code>
  3122. </td>
  3123. <td>
  3124. <div>
  3125. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  3126. </div>
  3127. </td>
  3128. </tr>
  3129. <tr>
  3130. <td>
  3131. <code>
  3132. <em>interceptor</em>
  3133. </code>
  3134. </td>
  3135. <td>
  3136. <div>
  3137. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3138. </div>
  3139. </td>
  3140. </tr>
  3141. <tr>
  3142. <td>
  3143. <code>
  3144. <em>fileManager</em>
  3145. </code>
  3146. </td>
  3147. <td>
  3148. <div>
  3149. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  3150. default.</p>
  3151. </div>
  3152. </td>
  3153. </tr>
  3154. <tr>
  3155. <td>
  3156. <code>
  3157. <em>requestModifier</em>
  3158. </code>
  3159. </td>
  3160. <td>
  3161. <div>
  3162. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the provided
  3163. parameters. <code>nil</code> by default.</p>
  3164. </div>
  3165. </td>
  3166. </tr>
  3167. </tbody>
  3168. </table>
  3169. </div>
  3170. <div>
  3171. <h4>Return Value</h4>
  3172. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3173. </div>
  3174. </section>
  3175. </div>
  3176. </li>
  3177. <li class="item">
  3178. <div>
  3179. <code>
  3180. <a name="/s:9Alamofire7SessionC6upload_4with11interceptor11fileManagerAA13UploadRequestCSo13NSInputStreamC_AA21URLRequestConvertible_pAA0I11Interceptor_pSgSo06NSFileG0CtF"></a>
  3181. <a name="//apple_ref/swift/Method/upload(_:with:interceptor:fileManager:)" class="dashAnchor"></a>
  3182. <a class="token" href="#/s:9Alamofire7SessionC6upload_4with11interceptor11fileManagerAA13UploadRequestCSo13NSInputStreamC_AA21URLRequestConvertible_pAA0I11Interceptor_pSgSo06NSFileG0CtF">upload(_:<wbr>with:<wbr>interceptor:<wbr>fileManager:<wbr>)</a>
  3183. </code>
  3184. </div>
  3185. <div class="height-container">
  3186. <div class="pointer-container"></div>
  3187. <section class="section">
  3188. <div class="pointer"></div>
  3189. <div class="abstract">
  3190. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> from the provided <code>InputStream</code> using the <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value and
  3191. <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  3192. </div>
  3193. <div class="declaration">
  3194. <h4>Declaration</h4>
  3195. <div class="language">
  3196. <p class="aside-title">Swift</p>
  3197. <pre class="highlight swift"><code><span class="kd">open</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>
  3198. <span class="n">with</span> <span class="nv">convertible</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  3199. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  3200. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  3201. </div>
  3202. </div>
  3203. <div>
  3204. <h4>Parameters</h4>
  3205. <table class="graybox">
  3206. <tbody>
  3207. <tr>
  3208. <td>
  3209. <code>
  3210. <em>stream</em>
  3211. </code>
  3212. </td>
  3213. <td>
  3214. <div>
  3215. <p>The <code>InputStream</code> that provides the data to upload.</p>
  3216. </div>
  3217. </td>
  3218. </tr>
  3219. <tr>
  3220. <td>
  3221. <code>
  3222. <em>convertible</em>
  3223. </code>
  3224. </td>
  3225. <td>
  3226. <div>
  3227. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  3228. </div>
  3229. </td>
  3230. </tr>
  3231. <tr>
  3232. <td>
  3233. <code>
  3234. <em>interceptor</em>
  3235. </code>
  3236. </td>
  3237. <td>
  3238. <div>
  3239. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3240. </div>
  3241. </td>
  3242. </tr>
  3243. <tr>
  3244. <td>
  3245. <code>
  3246. <em>fileManager</em>
  3247. </code>
  3248. </td>
  3249. <td>
  3250. <div>
  3251. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  3252. default.</p>
  3253. </div>
  3254. </td>
  3255. </tr>
  3256. </tbody>
  3257. </table>
  3258. </div>
  3259. <div>
  3260. <h4>Return Value</h4>
  3261. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3262. </div>
  3263. </section>
  3264. </div>
  3265. </li>
  3266. </ul>
  3267. </div>
  3268. <div class="task-group">
  3269. <div class="task-name-container">
  3270. <a name="/MultipartFormData"></a>
  3271. <a name="//apple_ref/swift/Section/MultipartFormData" class="dashAnchor"></a>
  3272. <div class="section-name-container">
  3273. <a class="section-name-link" href="#/MultipartFormData"></a>
  3274. <h3 class="section-name"><span>MultipartFormData</span>
  3275. </h3>
  3276. </div>
  3277. </div>
  3278. <ul class="item-container">
  3279. <li class="item">
  3280. <div>
  3281. <code>
  3282. <a name="/s:9Alamofire7SessionC6upload17multipartFormData2to14usingThreshold6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestCyAA09MultiparteF0Cc_AA14URLConvertible_ps6UInt64VAA10HTTPMethodVAA11HTTPHeadersVSgAA0R11Interceptor_pSgSo06NSFileN0Cy10Foundation10URLRequestVzKcSgtF"></a>
  3283. <a name="//apple_ref/swift/Method/upload(multipartFormData:to:usingThreshold:method:headers:interceptor:fileManager:requestModifier:)" class="dashAnchor"></a>
  3284. <a class="token" href="#/s:9Alamofire7SessionC6upload17multipartFormData2to14usingThreshold6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestCyAA09MultiparteF0Cc_AA14URLConvertible_ps6UInt64VAA10HTTPMethodVAA11HTTPHeadersVSgAA0R11Interceptor_pSgSo06NSFileN0Cy10Foundation10URLRequestVzKcSgtF">upload(multipartFormData:<wbr>to:<wbr>usingThreshold:<wbr>method:<wbr>headers:<wbr>interceptor:<wbr>fileManager:<wbr>requestModifier:<wbr>)</a>
  3285. </code>
  3286. </div>
  3287. <div class="height-container">
  3288. <div class="pointer-container"></div>
  3289. <section class="section">
  3290. <div class="pointer"></div>
  3291. <div class="abstract">
  3292. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the multipart form data built using a closure and sent using the provided
  3293. <code>URLRequest</code> components and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  3294. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cumulative
  3295. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  3296. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  3297. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  3298. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  3299. used for larger payloads such as video content.</p>
  3300. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  3301. 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>,
  3302. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  3303. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  3304. technique was used.</p>
  3305. </div>
  3306. <div class="declaration">
  3307. <h4>Declaration</h4>
  3308. <div class="language">
  3309. <p class="aside-title">Swift</p>
  3310. <pre class="highlight swift"><code><span class="kd">open</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>
  3311. <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>
  3312. <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/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  3313. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  3314. <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>
  3315. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  3316. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  3317. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  3318. </div>
  3319. </div>
  3320. <div>
  3321. <h4>Parameters</h4>
  3322. <table class="graybox">
  3323. <tbody>
  3324. <tr>
  3325. <td>
  3326. <code>
  3327. <em>multipartFormData</em>
  3328. </code>
  3329. </td>
  3330. <td>
  3331. <div>
  3332. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> building closure.</p>
  3333. </div>
  3334. </td>
  3335. </tr>
  3336. <tr>
  3337. <td>
  3338. <code>
  3339. <em>url</em>
  3340. </code>
  3341. </td>
  3342. <td>
  3343. <div>
  3344. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  3345. </div>
  3346. </td>
  3347. </tr>
  3348. <tr>
  3349. <td>
  3350. <code>
  3351. <em>encodingMemoryThreshold</em>
  3352. </code>
  3353. </td>
  3354. <td>
  3355. <div>
  3356. <p>Byte threshold used to determine whether the form data is encoded into memory or
  3357. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by
  3358. default.</p>
  3359. </div>
  3360. </td>
  3361. </tr>
  3362. <tr>
  3363. <td>
  3364. <code>
  3365. <em>method</em>
  3366. </code>
  3367. </td>
  3368. <td>
  3369. <div>
  3370. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  3371. </div>
  3372. </td>
  3373. </tr>
  3374. <tr>
  3375. <td>
  3376. <code>
  3377. <em>headers</em>
  3378. </code>
  3379. </td>
  3380. <td>
  3381. <div>
  3382. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  3383. </div>
  3384. </td>
  3385. </tr>
  3386. <tr>
  3387. <td>
  3388. <code>
  3389. <em>interceptor</em>
  3390. </code>
  3391. </td>
  3392. <td>
  3393. <div>
  3394. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3395. </div>
  3396. </td>
  3397. </tr>
  3398. <tr>
  3399. <td>
  3400. <code>
  3401. <em>fileManager</em>
  3402. </code>
  3403. </td>
  3404. <td>
  3405. <div>
  3406. <p><code>FileManager</code> to be used if the form data exceeds the memory threshold and is
  3407. written to disk before being uploaded. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by default.</p>
  3408. </div>
  3409. </td>
  3410. </tr>
  3411. <tr>
  3412. <td>
  3413. <code>
  3414. <em>requestModifier</em>
  3415. </code>
  3416. </td>
  3417. <td>
  3418. <div>
  3419. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the
  3420. provided parameters. <code>nil</code> by default.</p>
  3421. </div>
  3422. </td>
  3423. </tr>
  3424. </tbody>
  3425. </table>
  3426. </div>
  3427. <div>
  3428. <h4>Return Value</h4>
  3429. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3430. </div>
  3431. </section>
  3432. </div>
  3433. </li>
  3434. <li class="item">
  3435. <div>
  3436. <code>
  3437. <a name="/s:9Alamofire7SessionC6upload17multipartFormData4with14usingThreshold11interceptor11fileManagerAA13UploadRequestCyAA09MultiparteF0Cc_AA21URLRequestConvertible_ps6UInt64VAA0N11Interceptor_pSgSo06NSFileL0CtF"></a>
  3438. <a name="//apple_ref/swift/Method/upload(multipartFormData:with:usingThreshold:interceptor:fileManager:)" class="dashAnchor"></a>
  3439. <a class="token" href="#/s:9Alamofire7SessionC6upload17multipartFormData4with14usingThreshold11interceptor11fileManagerAA13UploadRequestCyAA09MultiparteF0Cc_AA21URLRequestConvertible_ps6UInt64VAA0N11Interceptor_pSgSo06NSFileL0CtF">upload(multipartFormData:<wbr>with:<wbr>usingThreshold:<wbr>interceptor:<wbr>fileManager:<wbr>)</a>
  3440. </code>
  3441. </div>
  3442. <div class="height-container">
  3443. <div class="pointer-container"></div>
  3444. <section class="section">
  3445. <div class="pointer"></div>
  3446. <div class="abstract">
  3447. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> using a <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> building closure, the provided <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code>
  3448. value, and a <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  3449. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cumulative
  3450. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  3451. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  3452. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  3453. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  3454. used for larger payloads such as video content.</p>
  3455. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  3456. 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>,
  3457. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  3458. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  3459. technique was used.</p>
  3460. </div>
  3461. <div class="declaration">
  3462. <h4>Declaration</h4>
  3463. <div class="language">
  3464. <p class="aside-title">Swift</p>
  3465. <pre class="highlight swift"><code><span class="kd">open</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>
  3466. <span class="n">with</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  3467. <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/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  3468. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  3469. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  3470. </div>
  3471. </div>
  3472. <div>
  3473. <h4>Parameters</h4>
  3474. <table class="graybox">
  3475. <tbody>
  3476. <tr>
  3477. <td>
  3478. <code>
  3479. <em>multipartFormData</em>
  3480. </code>
  3481. </td>
  3482. <td>
  3483. <div>
  3484. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> building closure.</p>
  3485. </div>
  3486. </td>
  3487. </tr>
  3488. <tr>
  3489. <td>
  3490. <code>
  3491. <em>request</em>
  3492. </code>
  3493. </td>
  3494. <td>
  3495. <div>
  3496. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  3497. </div>
  3498. </td>
  3499. </tr>
  3500. <tr>
  3501. <td>
  3502. <code>
  3503. <em>encodingMemoryThreshold</em>
  3504. </code>
  3505. </td>
  3506. <td>
  3507. <div>
  3508. <p>Byte threshold used to determine whether the form data is encoded into memory or
  3509. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by
  3510. default.</p>
  3511. </div>
  3512. </td>
  3513. </tr>
  3514. <tr>
  3515. <td>
  3516. <code>
  3517. <em>interceptor</em>
  3518. </code>
  3519. </td>
  3520. <td>
  3521. <div>
  3522. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3523. </div>
  3524. </td>
  3525. </tr>
  3526. <tr>
  3527. <td>
  3528. <code>
  3529. <em>fileManager</em>
  3530. </code>
  3531. </td>
  3532. <td>
  3533. <div>
  3534. <p><code>FileManager</code> to be used if the form data exceeds the memory threshold and is
  3535. written to disk before being uploaded. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by default.</p>
  3536. </div>
  3537. </td>
  3538. </tr>
  3539. </tbody>
  3540. </table>
  3541. </div>
  3542. <div>
  3543. <h4>Return Value</h4>
  3544. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3545. </div>
  3546. </section>
  3547. </div>
  3548. </li>
  3549. <li class="item">
  3550. <div>
  3551. <code>
  3552. <a name="/s:9Alamofire7SessionC6upload17multipartFormData2to14usingThreshold6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestCAA09MultiparteF0C_AA14URLConvertible_ps6UInt64VAA10HTTPMethodVAA11HTTPHeadersVSgAA0R11Interceptor_pSgSo06NSFileN0Cy10Foundation10URLRequestVzKcSgtF"></a>
  3553. <a name="//apple_ref/swift/Method/upload(multipartFormData:to:usingThreshold:method:headers:interceptor:fileManager:requestModifier:)" class="dashAnchor"></a>
  3554. <a class="token" href="#/s:9Alamofire7SessionC6upload17multipartFormData2to14usingThreshold6method7headers11interceptor11fileManager15requestModifierAA13UploadRequestCAA09MultiparteF0C_AA14URLConvertible_ps6UInt64VAA10HTTPMethodVAA11HTTPHeadersVSgAA0R11Interceptor_pSgSo06NSFileN0Cy10Foundation10URLRequestVzKcSgtF">upload(multipartFormData:<wbr>to:<wbr>usingThreshold:<wbr>method:<wbr>headers:<wbr>interceptor:<wbr>fileManager:<wbr>requestModifier:<wbr>)</a>
  3555. </code>
  3556. </div>
  3557. <div class="height-container">
  3558. <div class="pointer-container"></div>
  3559. <section class="section">
  3560. <div class="pointer"></div>
  3561. <div class="abstract">
  3562. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the prebuilt <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> value using the provided <code>URLRequest</code> components
  3563. and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  3564. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cumulative
  3565. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  3566. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  3567. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  3568. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  3569. used for larger payloads such as video content.</p>
  3570. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  3571. 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>,
  3572. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  3573. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  3574. technique was used.</p>
  3575. </div>
  3576. <div class="declaration">
  3577. <h4>Declaration</h4>
  3578. <div class="language">
  3579. <p class="aside-title">Swift</p>
  3580. <pre class="highlight swift"><code><span class="kd">open</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="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">,</span>
  3581. <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>
  3582. <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/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  3583. <span class="nv">method</span><span class="p">:</span> <span class="kt"><a href="../Structs/HTTPMethod.html">HTTPMethod</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">post</span><span class="p">,</span>
  3584. <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>
  3585. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  3586. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">,</span>
  3587. <span class="nv">requestModifier</span><span class="p">:</span> <span class="kt"><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</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>
  3588. </div>
  3589. </div>
  3590. <div>
  3591. <h4>Parameters</h4>
  3592. <table class="graybox">
  3593. <tbody>
  3594. <tr>
  3595. <td>
  3596. <code>
  3597. <em>multipartFormData</em>
  3598. </code>
  3599. </td>
  3600. <td>
  3601. <div>
  3602. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> instance to upload.</p>
  3603. </div>
  3604. </td>
  3605. </tr>
  3606. <tr>
  3607. <td>
  3608. <code>
  3609. <em>url</em>
  3610. </code>
  3611. </td>
  3612. <td>
  3613. <div>
  3614. <p><code><a href="../Protocols/URLConvertible.html">URLConvertible</a></code> value to be used as the <code>URLRequest</code>&lsquo;s <code>URL</code>.</p>
  3615. </div>
  3616. </td>
  3617. </tr>
  3618. <tr>
  3619. <td>
  3620. <code>
  3621. <em>encodingMemoryThreshold</em>
  3622. </code>
  3623. </td>
  3624. <td>
  3625. <div>
  3626. <p>Byte threshold used to determine whether the form data is encoded into memory or
  3627. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by
  3628. default.</p>
  3629. </div>
  3630. </td>
  3631. </tr>
  3632. <tr>
  3633. <td>
  3634. <code>
  3635. <em>method</em>
  3636. </code>
  3637. </td>
  3638. <td>
  3639. <div>
  3640. <p><code><a href="../Structs/HTTPMethod.html">HTTPMethod</a></code> for the <code>URLRequest</code>. <code>.post</code> by default.</p>
  3641. </div>
  3642. </td>
  3643. </tr>
  3644. <tr>
  3645. <td>
  3646. <code>
  3647. <em>headers</em>
  3648. </code>
  3649. </td>
  3650. <td>
  3651. <div>
  3652. <p><code><a href="../Structs/HTTPHeaders.html">HTTPHeaders</a></code> value to be added to the <code>URLRequest</code>. <code>nil</code> by default.</p>
  3653. </div>
  3654. </td>
  3655. </tr>
  3656. <tr>
  3657. <td>
  3658. <code>
  3659. <em>interceptor</em>
  3660. </code>
  3661. </td>
  3662. <td>
  3663. <div>
  3664. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3665. </div>
  3666. </td>
  3667. </tr>
  3668. <tr>
  3669. <td>
  3670. <code>
  3671. <em>fileManager</em>
  3672. </code>
  3673. </td>
  3674. <td>
  3675. <div>
  3676. <p><code>FileManager</code> to be used if the form data exceeds the memory threshold and is
  3677. written to disk before being uploaded. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by default.</p>
  3678. </div>
  3679. </td>
  3680. </tr>
  3681. <tr>
  3682. <td>
  3683. <code>
  3684. <em>requestModifier</em>
  3685. </code>
  3686. </td>
  3687. <td>
  3688. <div>
  3689. <p><code><a href="../Classes/Session.html#/s:9Alamofire7SessionC15RequestModifiera">RequestModifier</a></code> which will be applied to the <code>URLRequest</code> created from the
  3690. provided parameters. <code>nil</code> by default.</p>
  3691. </div>
  3692. </td>
  3693. </tr>
  3694. </tbody>
  3695. </table>
  3696. </div>
  3697. <div>
  3698. <h4>Return Value</h4>
  3699. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3700. </div>
  3701. </section>
  3702. </div>
  3703. </li>
  3704. <li class="item">
  3705. <div>
  3706. <code>
  3707. <a name="/s:9Alamofire7SessionC6upload17multipartFormData4with14usingThreshold11interceptor11fileManagerAA13UploadRequestCAA09MultiparteF0C_AA21URLRequestConvertible_ps6UInt64VAA0N11Interceptor_pSgSo06NSFileL0CtF"></a>
  3708. <a name="//apple_ref/swift/Method/upload(multipartFormData:with:usingThreshold:interceptor:fileManager:)" class="dashAnchor"></a>
  3709. <a class="token" href="#/s:9Alamofire7SessionC6upload17multipartFormData4with14usingThreshold11interceptor11fileManagerAA13UploadRequestCAA09MultiparteF0C_AA21URLRequestConvertible_ps6UInt64VAA0N11Interceptor_pSgSo06NSFileL0CtF">upload(multipartFormData:<wbr>with:<wbr>usingThreshold:<wbr>interceptor:<wbr>fileManager:<wbr>)</a>
  3710. </code>
  3711. </div>
  3712. <div class="height-container">
  3713. <div class="pointer-container"></div>
  3714. <section class="section">
  3715. <div class="pointer"></div>
  3716. <div class="abstract">
  3717. <p>Creates an <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code> for the prebuilt <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> value using the providing <code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code>
  3718. value and <code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code>.</p>
  3719. <p>It is important to understand the memory implications of uploading <code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code>. If the cumulative
  3720. payload is small, encoding the data in-memory and directly uploading to a server is the by far the most
  3721. efficient approach. However, if the payload is too large, encoding the data in-memory could cause your app to
  3722. be terminated. Larger payloads must first be written to disk using input and output streams to keep the memory
  3723. footprint low, then the data can be uploaded as a stream from the resulting file. Streaming from disk MUST be
  3724. used for larger payloads such as video content.</p>
  3725. <p>The <code>encodingMemoryThreshold</code> parameter allows Alamofire to automatically determine whether to encode in-memory
  3726. 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>,
  3727. encoding takes place in-memory. If the content length exceeds the threshold, the data is streamed to disk
  3728. during the encoding process. Then the result is uploaded as data or as a stream depending on which encoding
  3729. technique was used.</p>
  3730. </div>
  3731. <div class="declaration">
  3732. <h4>Declaration</h4>
  3733. <div class="language">
  3734. <p class="aside-title">Swift</p>
  3735. <pre class="highlight swift"><code><span class="kd">open</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="kt"><a href="../Classes/MultipartFormData.html">MultipartFormData</a></span><span class="p">,</span>
  3736. <span class="n">with</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></span><span class="p">,</span>
  3737. <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/MultipartFormData.html">MultipartFormData</a></span><span class="o">.</span><span class="n">encodingMemoryThreshold</span><span class="p">,</span>
  3738. <span class="nv">interceptor</span><span class="p">:</span> <span class="kt"><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
  3739. <span class="nv">fileManager</span><span class="p">:</span> <span class="kt">FileManager</span> <span class="o">=</span> <span class="o">.</span><span class="k">default</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/UploadRequest.html">UploadRequest</a></span></code></pre>
  3740. </div>
  3741. </div>
  3742. <div>
  3743. <h4>Parameters</h4>
  3744. <table class="graybox">
  3745. <tbody>
  3746. <tr>
  3747. <td>
  3748. <code>
  3749. <em>multipartFormData</em>
  3750. </code>
  3751. </td>
  3752. <td>
  3753. <div>
  3754. <p><code><a href="../Classes/MultipartFormData.html">MultipartFormData</a></code> instance to upload.</p>
  3755. </div>
  3756. </td>
  3757. </tr>
  3758. <tr>
  3759. <td>
  3760. <code>
  3761. <em>request</em>
  3762. </code>
  3763. </td>
  3764. <td>
  3765. <div>
  3766. <p><code><a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a></code> value to be used to create the <code>URLRequest</code>.</p>
  3767. </div>
  3768. </td>
  3769. </tr>
  3770. <tr>
  3771. <td>
  3772. <code>
  3773. <em>encodingMemoryThreshold</em>
  3774. </code>
  3775. </td>
  3776. <td>
  3777. <div>
  3778. <p>Byte threshold used to determine whether the form data is encoded into memory or
  3779. onto disk before being uploaded. <code><a href="../Classes/MultipartFormData.html#/s:9Alamofire17MultipartFormDataC23encodingMemoryThresholds6UInt64VvpZ">MultipartFormData.encodingMemoryThreshold</a></code> by
  3780. default.</p>
  3781. </div>
  3782. </td>
  3783. </tr>
  3784. <tr>
  3785. <td>
  3786. <code>
  3787. <em>interceptor</em>
  3788. </code>
  3789. </td>
  3790. <td>
  3791. <div>
  3792. <p><code><a href="../Protocols/RequestInterceptor.html">RequestInterceptor</a></code> value to be used by the returned <code><a href="../Classes/DataRequest.html">DataRequest</a></code>. <code>nil</code> by default.</p>
  3793. </div>
  3794. </td>
  3795. </tr>
  3796. <tr>
  3797. <td>
  3798. <code>
  3799. <em>fileManager</em>
  3800. </code>
  3801. </td>
  3802. <td>
  3803. <div>
  3804. <p><code>FileManager</code> instance to be used by the returned <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>. <code><a href="../Classes/Session.html#/s:9Alamofire7SessionC7defaultACvpZ">.default</a></code> instance by
  3805. default.</p>
  3806. </div>
  3807. </td>
  3808. </tr>
  3809. </tbody>
  3810. </table>
  3811. </div>
  3812. <div>
  3813. <h4>Return Value</h4>
  3814. <p>The created <code><a href="../Classes/UploadRequest.html">UploadRequest</a></code>.</p>
  3815. </div>
  3816. </section>
  3817. </div>
  3818. </li>
  3819. </ul>
  3820. </div>
  3821. <div class="task-group">
  3822. <div class="task-name-container">
  3823. <a name="/RequestDelegate"></a>
  3824. <a name="//apple_ref/swift/Section/RequestDelegate" class="dashAnchor"></a>
  3825. <div class="section-name-container">
  3826. <a class="section-name-link" href="#/RequestDelegate"></a>
  3827. <h3 class="section-name"><span>RequestDelegate</span>
  3828. </h3>
  3829. </div>
  3830. </div>
  3831. <ul class="item-container">
  3832. <li class="item">
  3833. <div>
  3834. <code>
  3835. <a name="/s:9Alamofire15RequestDelegateP20sessionConfigurationSo012NSURLSessionE0Cvp"></a>
  3836. <a name="//apple_ref/swift/Property/sessionConfiguration" class="dashAnchor"></a>
  3837. <a class="token" href="#/s:9Alamofire15RequestDelegateP20sessionConfigurationSo012NSURLSessionE0Cvp">sessionConfiguration</a>
  3838. </code>
  3839. </div>
  3840. <div class="height-container">
  3841. <div class="pointer-container"></div>
  3842. <section class="section">
  3843. <div class="pointer"></div>
  3844. <div class="abstract">
  3845. </div>
  3846. <div class="declaration">
  3847. <h4>Declaration</h4>
  3848. <div class="language">
  3849. <p class="aside-title">Swift</p>
  3850. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">var</span> <span class="nv">sessionConfiguration</span><span class="p">:</span> <span class="kt">URLSessionConfiguration</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>
  3851. </div>
  3852. </div>
  3853. </section>
  3854. </div>
  3855. </li>
  3856. <li class="item">
  3857. <div>
  3858. <code>
  3859. <a name="/s:9Alamofire15RequestDelegateP16startImmediatelySbvp"></a>
  3860. <a name="//apple_ref/swift/Property/startImmediately" class="dashAnchor"></a>
  3861. <a class="token" href="#/s:9Alamofire15RequestDelegateP16startImmediatelySbvp">startImmediately</a>
  3862. </code>
  3863. </div>
  3864. <div class="height-container">
  3865. <div class="pointer-container"></div>
  3866. <section class="section">
  3867. <div class="pointer"></div>
  3868. <div class="abstract">
  3869. </div>
  3870. <div class="declaration">
  3871. <h4>Declaration</h4>
  3872. <div class="language">
  3873. <p class="aside-title">Swift</p>
  3874. <pre class="highlight swift"><code><span class="kd">public</span> <span class="k">var</span> <span class="nv">startImmediately</span><span class="p">:</span> <span class="kt">Bool</span> <span class="p">{</span> <span class="k">get</span> <span class="p">}</span></code></pre>
  3875. </div>
  3876. </div>
  3877. </section>
  3878. </div>
  3879. </li>
  3880. <li class="item">
  3881. <div>
  3882. <code>
  3883. <a name="/s:9Alamofire15RequestDelegateP7cleanup5afteryAA0B0C_tF"></a>
  3884. <a name="//apple_ref/swift/Method/cleanup(after:)" class="dashAnchor"></a>
  3885. <a class="token" href="#/s:9Alamofire15RequestDelegateP7cleanup5afteryAA0B0C_tF">cleanup(after:<wbr>)</a>
  3886. </code>
  3887. </div>
  3888. <div class="height-container">
  3889. <div class="pointer-container"></div>
  3890. <section class="section">
  3891. <div class="pointer"></div>
  3892. <div class="abstract">
  3893. </div>
  3894. <div class="declaration">
  3895. <h4>Declaration</h4>
  3896. <div class="language">
  3897. <p class="aside-title">Swift</p>
  3898. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">cleanup</span><span class="p">(</span><span class="n">after</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Classes/Request.html">Request</a></span><span class="p">)</span></code></pre>
  3899. </div>
  3900. </div>
  3901. </section>
  3902. </div>
  3903. </li>
  3904. <li class="item">
  3905. <div>
  3906. <code>
  3907. <a name="/s:9Alamofire15RequestDelegateP11retryResult3for5dueTo10completionyAA0B0C_AA7AFErrorOyAA05RetryE0OctF"></a>
  3908. <a name="//apple_ref/swift/Method/retryResult(for:dueTo:completion:)" class="dashAnchor"></a>
  3909. <a class="token" href="#/s:9Alamofire15RequestDelegateP11retryResult3for5dueTo10completionyAA0B0C_AA7AFErrorOyAA05RetryE0OctF">retryResult(for:<wbr>dueTo:<wbr>completion:<wbr>)</a>
  3910. </code>
  3911. </div>
  3912. <div class="height-container">
  3913. <div class="pointer-container"></div>
  3914. <section class="section">
  3915. <div class="pointer"></div>
  3916. <div class="abstract">
  3917. </div>
  3918. <div class="declaration">
  3919. <h4>Declaration</h4>
  3920. <div class="language">
  3921. <p class="aside-title">Swift</p>
  3922. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">retryResult</span><span class="p">(</span><span class="k">for</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Classes/Request.html">Request</a></span><span class="p">,</span> <span class="n">dueTo</span> <span class="nv">error</span><span class="p">:</span> <span class="kt"><a href="../Enums/AFError.html">AFError</a></span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt"><a href="../Enums/RetryResult.html">RetryResult</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span></code></pre>
  3923. </div>
  3924. </div>
  3925. </section>
  3926. </div>
  3927. </li>
  3928. <li class="item">
  3929. <div>
  3930. <code>
  3931. <a name="/s:9Alamofire15RequestDelegateP05retryB0_9withDelayyAA0B0C_SdSgtF"></a>
  3932. <a name="//apple_ref/swift/Method/retryRequest(_:withDelay:)" class="dashAnchor"></a>
  3933. <a class="token" href="#/s:9Alamofire15RequestDelegateP05retryB0_9withDelayyAA0B0C_SdSgtF">retryRequest(_:<wbr>withDelay:<wbr>)</a>
  3934. </code>
  3935. </div>
  3936. <div class="height-container">
  3937. <div class="pointer-container"></div>
  3938. <section class="section">
  3939. <div class="pointer"></div>
  3940. <div class="abstract">
  3941. </div>
  3942. <div class="declaration">
  3943. <h4>Declaration</h4>
  3944. <div class="language">
  3945. <p class="aside-title">Swift</p>
  3946. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">func</span> <span class="nf">retryRequest</span><span class="p">(</span><span class="n">_</span> <span class="nv">request</span><span class="p">:</span> <span class="kt"><a href="../Classes/Request.html">Request</a></span><span class="p">,</span> <span class="n">withDelay</span> <span class="nv">timeDelay</span><span class="p">:</span> <span class="kt">TimeInterval</span><span class="p">?)</span></code></pre>
  3947. </div>
  3948. </div>
  3949. </section>
  3950. </div>
  3951. </li>
  3952. </ul>
  3953. </div>
  3954. </div>
  3955. </section>
  3956. </article>
  3957. </div>
  3958. <section class="footer">
  3959. <p>&copy; 2023 <a class="link" href="http://alamofire.org/" target="_blank" rel="external noopener">Alamofire Software Foundation</a>. All rights reserved. (Last updated: 2023-10-25)</p>
  3960. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external noopener">jazzy ♪♫ v0.14.4</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external noopener">Realm</a> project.</p>
  3961. </section>
  3962. </body>
  3963. </html>