Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/share/doc/gnustep-base-doc/Base/Reference/
Upload File :
Current File : //usr/share/doc/gnustep-base-doc/Base/Reference/NSURLConnection.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>NSURLConnection class documentation</title>
</head>
<body>
<font face="serif">
<a href="Base.html">Up</a>
<br />
<h1><a name="title$NSURLConnection">NSURLConnection class documentation</a></h1>
<h3>Authors</h3>
<dl>
<dt>Generated by Debian</dt>
<dd>
</dd>
</dl>
<div>
<hr width="50%" align="left" />
<h3>Contents -</h3>
<ol>
<li>
<a href="#001000000000">Software documentation for the NSURLConnection class</a>
</li>
<li>
<a href="#002000000000">Software documentation for the
NSObject(NSURLConnectionDelegate)
category</a>
</li>
<li>
<a href="#003000000000">Software documentation for the
NSURLConnection(NSURLConnectionSynchronousLoading)
category</a>
</li>
<li>
<a href="#004000000000">Software documentation for the NSURLConnectionDelegate
protocol</a>
</li>
</ol>
<hr width="50%" align="left" />
</div>
<h1><a name="001000000000">
Software documentation for the NSURLConnection class
</a></h1>
<h2><a name="class$NSURLConnection">NSURLConnection</a> : <a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a></h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSURLConnection.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="50%" align="left" />
<a href="#_NSURLConnection_ivars">Instance Variables</a>
<br/><br/>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSURLConnection(NSURLConnectionSynchronousLoading)+sendSynchronousRequest$returningResponse$error$">+sendSynchronousRequest:returningResponse:error:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSURLConnection+canHandleRequest$">+canHandleRequest:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSURLConnection+connectionWithRequest$delegate$">+connectionWithRequest:delegate:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSURLConnection-cancel">-cancel</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSURLConnection-initWithRequest$delegate$">-initWithRequest:delegate:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSURLConnection+canHandleRequest$">canHandleRequest: </a></h3>
+ (BOOL) <b>canHandleRequest:</b> (<a rel="gsdoc" href="NSURLRequest.html#class$NSURLRequest">NSURLRequest</a>*)request;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Performs a preliminary check to see if a load of
the specified <var>request</var> can be handled by an
instance of this class. <br /> The results of this
method may be invalidated by subsequent changes to
the <var>request</var> or changes to the registered
protocols etc.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSURLConnection+connectionWithRequest$delegate$">connectionWithRequest: delegate: </a></h3>
+ (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*) <b>connectionWithRequest:</b> (<a rel="gsdoc" href="NSURLRequest.html#class$NSURLRequest">NSURLRequest</a>*)request<b> delegate:</b> (id)delegate;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Allocates and returns the autoreleased instance
which it initialises using the
<a rel="gsdoc" href="#method$NSURLConnection-initWithRequest$delegate$">
-initWithRequest:delegate:
</a>
method.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSURLConnection-cancel">cancel </a></h3>
- (void) <b>cancel</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Cancel the asynchronous load in progress (if any)
for this connection.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSURLConnection-initWithRequest$delegate$">initWithRequest: delegate: </a></h3>
- (id) <b>initWithRequest:</b> (<a rel="gsdoc" href="NSURLRequest.html#class$NSURLRequest">NSURLRequest</a>*)request<b> delegate:</b> (id)delegate;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
This is a designated initialiser for the class.<br />
<div class="desc">
Initialises the receiver with the specified
<var>request</var> (performing a deep copy so that
the <var>request</var> does not change during loading)
and <var>delegate</var>. <br /> This automatically
initiates an asynchronous load for the
<var>request</var>. <br /> Processing of the
<var>request</var> is done in the thread which calls
this method, so the thread must run its current run
loop (in NSDefaultRunLoopMode) for processing to
continue/complete. <br /> The
<var>delegate</var> will receive callbacks informing
it of the progress of the load. <br /> This method
breaks with convention and retains the
<var>delegate</var> object, releasing it when the
connection finished loading, fails, or is
cancelled.
</div>
<hr width="25%" align="left" />
</div>
<a name="_NSURLConnection_ivars"/> <br/><hr width="50%" align="left" />
<h2>Instance Variables for NSURLConnection Class</h2>
<h3><a name="ivariable$NSURLConnection*_NSURLConnectionInternal">_NSURLConnectionInternal</a></h3>
@protected void* <b>_NSURLConnectionInternal</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
<em>Warning</em> the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically <em>private</em>, it is
intended for internal use within the package, and
you should not use the variable in other code.
</div>
<hr width="25%" align="left" />
<br/><hr width="50%" align="left" /><br/>
<h1><a name="002000000000">
Software documentation for the
NSObject(NSURLConnectionDelegate)
category
</a></h1>
<h2><a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSURLConnectionDelegate)">NSURLConnectionDelegate</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSURLConnection.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.7.0, Base 1.13.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connection$didFailWithError$">-connection:didFailWithError:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connection$didReceiveAuthenticationChallenge$">-connection:didReceiveAuthenticationChallenge:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connection$didReceiveData$">-connection:didReceiveData:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connection$didReceiveResponse$">-connection:didReceiveResponse:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connection$willCacheResponse$">-connection:willCacheResponse:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connection$willSendRequest$redirectResponse$">-connection:willSendRequest:redirectResponse:</a></li>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSObject(NSURLConnectionDelegate)-connectionDidFinishLoading$">-connectionDidFinishLoading:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connection$didFailWithError$">connection: didFailWithError: </a></h3>
- (void) <b>connection:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection<b> didFailWithError:</b> (<a rel="gsdoc" href="NSError.html#class$NSError">NSError</a>*)error;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connection$didReceiveAuthenticationChallenge$">connection: didReceiveAuthenticationChallenge: </a></h3>
- (void) <b>connection:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection<b> didReceiveAuthenticationChallenge:</b> (<a rel="gsdoc" href="NSURLAuthenticationChallenge.html#class$NSURLAuthenticationChallenge">NSURLAuthenticationChallenge</a>*)challenge;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Called when an authentication <var>challenge</var>
is received... the delegate should send
<a rel="gsdoc" href="NSURLAuthenticationChallenge.html#method$(NSURLAuthenticationChallengeSender)-useCredential$forAuthenticationChallenge$">-useCredential:forAuthenticationChallenge:</a>
or <a rel="gsdoc" href="NSURLAuthenticationChallenge.html#method$(NSURLAuthenticationChallengeSender)-continueWithoutCredentialForAuthenticationChallenge$">-continueWithoutCredentialForAuthenticationChallenge:</a>
or <a rel="gsdoc" href="NSURLAuthenticationChallenge.html#method$(NSURLAuthenticationChallengeSender)-cancelAuthenticationChallenge$">-cancelAuthenticationChallenge:</a>
to the <var>challenge</var> sender when done.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connection$didReceiveData$">connection: didReceiveData: </a></h3>
- (void) <b>connection:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection<b> didReceiveData:</b> (<a rel="gsdoc" href="NSData.html#class$NSData">NSData</a>*)data;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Called when content <var>data</var> arrives during a
load operations... this may be incremental or may be
the compolete <var>data</var> for the load.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connection$didReceiveResponse$">connection: didReceiveResponse: </a></h3>
- (void) <b>connection:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection<b> didReceiveResponse:</b> (<a rel="gsdoc" href="NSURLResponse.html#class$NSURLResponse">NSURLResponse</a>*)response;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Called when enough information to build a
NSURLResponse object has been received.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connection$willCacheResponse$">connection: willCacheResponse: </a></h3>
- (<a rel="gsdoc" href="NSURLCache.html#class$NSCachedURLResponse">NSCachedURLResponse</a>*) <b>connection:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection<b> willCacheResponse:</b> (<a rel="gsdoc" href="NSURLCache.html#class$NSCachedURLResponse">NSCachedURLResponse</a>*)cachedResponse;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Called with the <var>cachedResponse</var> to be
stored in the cache. The delegate can inspect the
<var>cachedResponse</var> and return a modified copy
if if wants changed to what whill be stored. <br /> If
it returns <code>nil</code>, nothing will be stored in
the cache.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connection$willSendRequest$redirectResponse$">connection: willSendRequest: redirectResponse: </a></h3>
- (<a rel="gsdoc" href="NSURLRequest.html#class$NSURLRequest">NSURLRequest</a>*) <b>connection:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection<b> willSendRequest:</b> (<a rel="gsdoc" href="NSURLRequest.html#class$NSURLRequest">NSURLRequest</a>*)request<b> redirectResponse:</b> (<a rel="gsdoc" href="NSURLResponse.html#class$NSURLResponse">NSURLResponse</a>*)response;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Informs the delegate that the <var>connection</var>
must change the URL of the <var>request</var> in order
to continue with the load operation. <br /> This allows
the delegate to ionspect and/or modify a copy of the
<var>request</var> before the <var>connection</var>
continues loading it. Normally the delegate can
return the <var>request</var> unmodifield. <br />
The redirection can be rejectected by the delegate
calling
<a rel="gsdoc" href="#method$NSURLConnection-cancel">
-cancel
</a>
or returning <code>nil</code>. <br /> Cancelling the
load will simply stop it, but returning
<code>nil</code> will cause it to complete with a
redirection failure. <br /> As a special case,
this method may be called with a <code>nil</code>
<var>response</var>, indicating a change of URL made
internally by the system rather than due to a
<var>response</var> from the server.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSURLConnectionDelegate)-connectionDidFinishLoading$">connectionDidFinishLoading: </a></h3>
- (void) <b>connectionDidFinishLoading:</b> (<a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>*)connection;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Called when an NSURLConnection has finished loading
successfully.
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="003000000000">
Software documentation for the
NSURLConnection(NSURLConnectionSynchronousLoading)
category
</a></h1>
<h2><a rel="gsdoc" href="#class$NSURLConnection">NSURLConnection</a>(<a name="category$NSURLConnection(NSURLConnectionSynchronousLoading)">NSURLConnectionSynchronousLoading</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSURLConnection.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
An interface to perform synchronous loading of URL
requests.
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSURLConnection.html#method$NSURLConnection(NSURLConnectionSynchronousLoading)+sendSynchronousRequest$returningResponse$error$">+sendSynchronousRequest:returningResponse:error:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSURLConnection(NSURLConnectionSynchronousLoading)+sendSynchronousRequest$returningResponse$error$">sendSynchronousRequest: returningResponse: error: </a></h3>
+ (<a rel="gsdoc" href="NSData.html#class$NSData">NSData</a>*) <b>sendSynchronousRequest:</b> (<a rel="gsdoc" href="NSURLRequest.html#class$NSURLRequest">NSURLRequest</a>*)request<b> returningResponse:</b> (<a rel="gsdoc" href="NSURLResponse.html#class$NSURLResponse">NSURLResponse</a>**)response<b> error:</b> (<a rel="gsdoc" href="NSError.html#class$NSError">NSError</a>**)error;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.2.0, Base 1.13.0</div>
<br />
<div class="desc">
Performs a synchronous load of <var>request</var>
and returns the
<a rel="gsdoc" href="NSURLResponse.html#class$NSURLResponse">NSURLResponse</a>
in <var>response</var>. <br /> Returns the result of
the load or <code>nil</code> if the load failed.
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="004000000000">
Software documentation for the NSURLConnectionDelegate
protocol
</a></h1>
<h2><a name="protocol$(NSURLConnectionDelegate)">NSURLConnectionDelegate</a></h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>Foundation/NSURLConnection.h</dd>
</dl>
</blockquote>
<blockquote>
<dl>
<dt><b>Conforms to:</b></dt>
<dd><a rel="gsdoc" href="NSObject.html#protocol$(NSObject)">NSObject</a></dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.7.0, Base 1.13.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<br />
<a href="Base.html">Up</a>
</font>
</body>
</html>
Server : Apache/2.4.41 (Ubuntu)