blob: 35bc667bdc3343817a5125dad36fb5a94bb458cc [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<title>Manager Class Reference</title>
<link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
<link rel="stylesheet" type="text/css" href="../css/highlight.css" />
<meta charset='utf-8'>
<script type="text/javascript">
window.jazzy = {'docset': false}
if (typeof window.dash != 'undefined') {
document.documentElement.className += ' dash'
window.jazzy.docset = true
}
if (navigator.userAgent.match(/xcode/i)) {
document.documentElement.className += ' xcode'
window.jazzy.docset = true
}
</script>
<script src="../js/jquery.min.js" defer></script>
<script src="../js/jazzy.js" defer></script>
</head>
<body id="reference" class="Swift">
<a name="//apple_ref/swift/Class/Manager" class="dashAnchor"></a>
<a title="Manager Class Reference"></a>
<header>
<div class="content-wrapper">
<p class="header-text"><a href="../index.html"> Docs</a> (41% documented)</p>
<p id="header-links"><a href=""><img id="header-icon" src="../img/gh.png" height="16px" width="16px" />View on GitHub</a></p>
</div>
</header>
<section id="valence">
<div class="content-wrapper">
<p id="hierarchial_navigation">
<a href="../index.html" id="design_resources_link"> Reference</a>
<img id="carat" src="../img/carat.png" height="10px" width="6px" />
Manager Class Reference
</p>
</div>
</section>
<div class="content-wrapper">
<nav class="book-parts">
<ul class="nav-parts">
<li class="part-name tasks">
<a href="../Classes.html">Classes</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Classes/BaseClient.html">BaseClient</a>
</li>
<li class="nav-chapter">
<a href="../Classes/EngineClient.html">EngineClient</a>
</li>
<li class="nav-chapter">
<a href="../Classes/EventClient.html">EventClient</a>
</li>
<li class="nav-chapter">
<a href="../Classes/Manager.html">Manager</a>
</li>
<li class="nav-chapter">
<a href="../Classes/Request.html">Request</a>
</li>
</ul>
</li>
<li class="part-name tasks">
<a href="../Global Variables.html">Global Variables</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Global Variables.html#/s:v15PredictionIOSDK20AlamofireErrorDomainSS">AlamofireErrorDomain</a>
</li>
</ul>
</li>
<li class="part-name tasks">
<a href="../Enums.html">Enums</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Enums.html#/s:O15PredictionIOSDK6Method">Method</a>
</li>
<li class="nav-chapter">
<a href="../Enums/ParameterEncoding.html">ParameterEncoding</a>
</li>
</ul>
</li>
<li class="part-name tasks">
<a href="../Extensions.html">Extensions</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Extensions/EventClient.html">EventClient</a>
</li>
<li class="nav-chapter">
<a href="../Extensions/Manager.html">Manager</a>
</li>
<li class="nav-chapter">
<a href="../Extensions/NSURL.html">NSURL</a>
</li>
<li class="nav-chapter">
<a href="../Extensions/NSURLComponents.html">NSURLComponents</a>
</li>
<li class="nav-chapter">
<a href="../Extensions/NSURLRequest.html">NSURLRequest</a>
</li>
<li class="nav-chapter">
<a href="../Extensions/Request.html">Request</a>
</li>
<li class="nav-chapter">
<a href="../Extensions/String.html">String</a>
</li>
</ul>
</li>
<li class="part-name tasks">
<a href="../Functions.html">Functions</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK8downloadFTPS_21URLRequestConvertible_FTCSo5NSURLCSo17NSHTTPURLResponse_S1__CS_7Request">download(_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK8downloadFTOS_6MethodPS_20URLStringConvertible_FTCSo5NSURLCSo17NSHTTPURLResponse_S2__CS_7Request">download(_:_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK8downloadFT10resumeDataCSo6NSDataFTCSo5NSURLCSo17NSHTTPURLResponse_S1__CS_7Request">download(resumeData:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK7requestFPS_21URLRequestConvertible_CS_7Request">request(_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK7requestFTOS_6MethodPS_20URLStringConvertible_10parametersGSqGVSs10DictionarySSPSs9AnyObject___8encodingOS_17ParameterEncoding_CS_7Request">request(_:_:parameters:encoding:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK6uploadFTPS_21URLRequestConvertible_CSo6NSData_CS_7Request">upload(_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK6uploadFTPS_21URLRequestConvertible_CSo13NSInputStream_CS_7Request">upload(_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK6uploadFTPS_21URLRequestConvertible_CSo5NSURL_CS_7Request">upload(_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK6uploadFTOS_6MethodPS_20URLStringConvertible_CSo13NSInputStream_CS_7Request">upload(_:_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK6uploadFTOS_6MethodPS_20URLStringConvertible_CSo5NSURL_CS_7Request">upload(_:_:_:)</a>
</li>
<li class="nav-chapter">
<a href="../Functions.html#/s:F15PredictionIOSDK6uploadFTOS_6MethodPS_20URLStringConvertible_CSo6NSData_CS_7Request">upload(_:_:_:)</a>
</li>
</ul>
</li>
<li class="part-name tasks">
<a href="../Protocols.html">Protocols</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Protocols/URLRequestConvertible.html">URLRequestConvertible</a>
</li>
<li class="nav-chapter">
<a href="../Protocols/URLStringConvertible.html">URLStringConvertible</a>
</li>
</ul>
</li>
<li class="part-name tasks">
<a href="../Structs.html">Structs</a>
<ul class="nav-chapters">
<li class="nav-chapter">
<a href="../Structs/Event.html">Event</a>
</li>
</ul>
</li>
</ul>
</nav>
<div class="pixel-line"></div>
<div class="rubber-band-gap"></div>
<article class="chapter">
<a name="/"></a>
<h1 class="chapter-name">Manager</h1>
<section>
<section class="section">
<p class="para">Responsible for creating and managing <code>Request</code> objects, as well as their underlying <code>NSURLSession</code>.When finished with a manager, be sure to call either <code>session.finishTasksAndInvalidate()</code> or <code>session.invalidateAndCancel()</code> before deinitialization.</p>
</section>
<section class="section task-group-section">
<div class="task-group">
<div class="task-name-container">
<a name="/Unnamed"></a>
</div>
<ul class="task-group-list">
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:vC15PredictionIOSDK7Manager14sharedInstanceS0_">
<a name="//apple_ref/swift/Property/sharedInstance" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:vC15PredictionIOSDK7Manager14sharedInstanceS0_">sharedInstance</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">A shared instance of <code>Manager</code>, used by top-level Alamofire request methods, and suitable for use directly for any ad hoc requests.</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">class</span> <span class="k">var</span> <span class="nv">sharedInstance</span><span class="p">:</span> <span class="kt">Manager</span></code></pre>
</div>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:VFC15PredictionIOSDK7Managerg14sharedInstanceS0_L_9Singleton">
<a name="//apple_ref/swift/Struct/Singleton" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:VFC15PredictionIOSDK7Managerg14sharedInstanceS0_L_9Singleton">Singleton</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">Undocumented</p>
<a href="../Classes/Manager/Singleton.html" class="see-more">See more</a>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:FC15PredictionIOSDK7Manager18defaultHTTPHeadersFMS0_FT_GVSs10DictionarySSSS_">
<a name="//apple_ref/swift/Method/defaultHTTPHeaders()" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:FC15PredictionIOSDK7Manager18defaultHTTPHeadersFMS0_FT_GVSs10DictionarySSSS_">defaultHTTPHeaders()</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">Creates default values for the <q>Accept-Encoding</q>, <q>Accept-Language</q> and <q>User-Agent</q> headers.</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">class</span> <span class="kd">func</span> <span class="nf">defaultHTTPHeaders</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="p">[</span><span class="kt">String</span><span class="p">:</span> <span class="kt">String</span><span class="p">]</span></code></pre>
</div>
</div>
<div class="result-description">
<h4>Return Value</h4>
<p class="para">The default header values.</p>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:vC15PredictionIOSDK7Manager7sessionCSo12NSURLSession">
<a name="//apple_ref/swift/Property/session" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:vC15PredictionIOSDK7Manager7sessionCSo12NSURLSession">session</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">The underlying session.</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="k">let</span> <span class="nv">session</span><span class="p">:</span> <span class="kt">NSURLSession</span></code></pre>
</div>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:vC15PredictionIOSDK7Manager24startRequestsImmediatelySb">
<a name="//apple_ref/swift/Property/startRequestsImmediately" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:vC15PredictionIOSDK7Manager24startRequestsImmediatelySb">startRequestsImmediately</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">Whether to start requests immediately after being constructed. <code>true</code> by default.</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="k">var</span> <span class="nv">startRequestsImmediately</span><span class="p">:</span> <span class="kt">Bool</span> <span class="o">=</span> <span class="kc">true</span></code></pre>
</div>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:FC15PredictionIOSDK7ManagercFMS0_FT13configurationGSqCSo25NSURLSessionConfiguration__S0_">
<a name="//apple_ref/swift/Method/init(configuration:)" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:FC15PredictionIOSDK7ManagercFMS0_FT13configurationGSqCSo25NSURLSessionConfiguration__S0_">init(configuration:)</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<a href="../Classes/Manager/init(configuration:).html" class="see-more">See more</a>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="nf">init</span><span class="p">(</span><span class="nv">configuration</span><span class="p">:</span> <span class="kt">NSURLSessionConfiguration</span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span></code></pre>
</div>
</div>
<div class="parameters">
<h4>Parameters</h4>
<table class="graybox" border="0" cellspacing="0" cellpadding="5">
<tbody>
<tr>
<td scope="row">
<code>
<em class="term">configuration</em>
</code>
</td>
<td>
<div class="definition">
<p class="para">The configuration used to construct the managed session.</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</section>
</div>
</li>
</ul>
</div>
<div class="task-group">
<div class="task-name-container">
<hr/>
<a name="/Unnamed2"></a>
</div>
<ul class="task-group-list">
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:FC15PredictionIOSDK7Manager7requestFS0_FTOS_6MethodPS_20URLStringConvertible_10parametersGSqGVSs10DictionarySSPSs9AnyObject___8encodingOS_17ParameterEncoding_CS_7Request">
<a name="//apple_ref/swift/Method/request(_:_:parameters:encoding:)" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:FC15PredictionIOSDK7Manager7requestFS0_FTOS_6MethodPS_20URLStringConvertible_10parametersGSqGVSs10DictionarySSPSs9AnyObject___8encodingOS_17ParameterEncoding_CS_7Request">request(_:_:parameters:encoding:)</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">Creates a request for the specified method, URL string, parameters, and parameter encoding.</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="nv">method</span><span class="p">:</span> <span class="kt">Method</span><span class="p">,</span> <span class="n">_</span> <span class="kt">URLString</span><span class="p">:</span> <span class="kt">URLStringConvertible</span><span class="p">,</span> <span class="nv">parameters</span><span class="p">:</span> <span class="p">[</span><span class="kt">String</span><span class="p">:</span> <span class="kt">AnyObject</span><span class="p">]?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span> <span class="nv">encoding</span><span class="p">:</span> <span class="kt">ParameterEncoding</span> <span class="o">=</span> <span class="o">.</span><span class="kt">URL</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Request</span></code></pre>
</div>
</div>
<div class="parameters">
<h4>Parameters</h4>
<table class="graybox" border="0" cellspacing="0" cellpadding="5">
<tbody>
<tr>
<td scope="row">
<code>
<em class="term">method</em>
</code>
</td>
<td>
<div class="definition">
<p class="para">The HTTP method.</p>
</div>
</td>
</tr>
<tr>
<td scope="row">
<code>
<em class="term">URLString</em>
</code>
</td>
<td>
<div class="definition">
<p class="para">The URL string.</p>
</div>
</td>
</tr>
<tr>
<td scope="row">
<code>
<em class="term">parameters</em>
</code>
</td>
<td>
<div class="definition">
<p class="para">The parameters. <code>nil</code> by default.</p>
</div>
</td>
</tr>
<tr>
<td scope="row">
<code>
<em class="term">encoding</em>
</code>
</td>
<td>
<div class="definition">
<p class="para">The parameter encoding. <code>.URL</code> by default.</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="result-description">
<h4>Return Value</h4>
<p class="para">The created request.</p>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:FC15PredictionIOSDK7Manager7requestFS0_FPS_21URLRequestConvertible_CS_7Request">
<a name="//apple_ref/swift/Method/request(_:)" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:FC15PredictionIOSDK7Manager7requestFS0_FPS_21URLRequestConvertible_CS_7Request">request(_:)</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">Creates a request for the specified URL request.If <code>startRequestsImmediately</code> is <code>true</code>, the request will have <code>resume()</code> called before being returned.</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="Swift">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">func</span> <span class="nf">request</span><span class="p">(</span><span class="kt">URLRequest</span><span class="p">:</span> <span class="kt">URLRequestConvertible</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Request</span></code></pre>
</div>
</div>
<div class="parameters">
<h4>Parameters</h4>
<table class="graybox" border="0" cellspacing="0" cellpadding="5">
<tbody>
<tr>
<td scope="row">
<code>
<em class="term">URLRequest</em>
</code>
</td>
<td>
<div class="definition">
<p class="para">The URL request</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="result-description">
<h4>Return Value</h4>
<p class="para">The created request.</p>
</div>
</section>
</div>
</li>
<li class="item symbol">
<div class="task-group-term">
<code>
<a name="/s:CC15PredictionIOSDK7Manager15SessionDelegate">
<a name="//apple_ref/swift/Class/SessionDelegate" class="dashAnchor"></a>
<a class="x-instance-method Swift" href="#/s:CC15PredictionIOSDK7Manager15SessionDelegate">SessionDelegate</a>
</code>
</div>
<div class="height-container">
<div class="pointy-thing-container"></div>
<section class="section instance-method">
<div class="pointy-thing"></div>
<div class="abstract">
<p class="para">Undocumented</p>
<a href="../Classes/Manager/SessionDelegate.html" class="see-more">See more</a>
</div>
</section>
</div>
</li>
</ul>
</div>
</section>
</section>
<section id="footer">
<p class="copyright">&copy; 2015 <a class="link" href="" target="_blank" rel="external"></a>. All rights reserved. (Last updated: 2015-02-24)</p>
<p class="copyright">Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.1.1</a>, a <a class="link" href="http://realm.io" target="_blank" rel="external">Realm</a> project.</p>
</section>
</article>
</div>
</body>
</div>
</html>