mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-27 02:30:53 +00:00
0a86bba7b0
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@9698 72102866-910b-0410-8b05-ffd578937521
565 lines
19 KiB
HTML
565 lines
19 KiB
HTML
<html><head>
|
|
<title>NSURLHandle</title>
|
|
</head>
|
|
<body>
|
|
<a href ="NSURL.html">[Previous] </a>
|
|
<a href ="Base.html">[Up] </a>
|
|
<a href ="NSUnarchiver.html">[Next] </a>
|
|
<h1>NSURLHandle</h1>
|
|
<h3>Authors </h3>
|
|
<dl>
|
|
<dt><a href ="http://www.gnustep.org/developers/whoiswho.html">Richard Frith-Macdonald</a>
|
|
<dd>
|
|
<dt><a href ="http://www.brainstorm.co.uk">Mark Allison</a>
|
|
<dd>
|
|
</dl>
|
|
<p>Version: $Revision$</p>
|
|
<p>Date: $Date$</p>
|
|
<h2><a name ="cont-0">NSURLHandle</a></h2>
|
|
<h2><a name ="NSURLHandle">NSURLHandle</a></h2>
|
|
<p><b>Declared in: </b> Foundation/NSURLHandle.h</p>
|
|
<p><b>Inherits from: </b> NSObject</p>
|
|
<hr>
|
|
|
|
<p>
|
|
|
|
An NSURLHandle instance is used to manage the resource data
|
|
corresponding to an NSURL object. A single NSURLHandle can
|
|
be used to manage multiple NSURL objects as long as those
|
|
objects all refer to the same resource.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
Different NSURLHandle subclasses are used to manage different
|
|
types of URL (usually based on the scheme of the URL), and you
|
|
can register new subclasses to extend (or replace) the
|
|
standard ones.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
GNUstep comes with private subclasses to handle the common
|
|
URL schemes -
|
|
</p>
|
|
|
|
<ul>
|
|
<li >
|
|
<a href ="#GSFileURLHandle">GSFileURLHandle</a> for
|
|
<code>file:</code> (local file I/O)
|
|
|
|
<li >
|
|
<a href ="#GSHTTPURLHandle">GSHTTPURLHandle</a> for
|
|
<code>http</code> and <code>shttp</code> (webserver) access.
|
|
|
|
</ul>
|
|
|
|
|
|
<h2>Instance Variables </h2>
|
|
<ul>
|
|
</ul>
|
|
<h2>Methods </h2>
|
|
<ul>
|
|
<li ><a href ="NSURLHandle.html#method-0">+URLHandleClassForURL:</a>
|
|
<li ><a href ="NSURLHandle.html#method-1">+cachedHandleForURL:</a>
|
|
<li ><a href ="NSURLHandle.html#canInitWithURL:">+canInitWithURL:</a>
|
|
<li ><a href ="NSURLHandle.html#method-2">+registerURLHandleClass:</a>
|
|
<li ><a href ="NSURLHandle.html#method-3">-addClient:</a>
|
|
<li ><a href ="NSURLHandle.html#method-4">-availableResourceData</a>
|
|
<li ><a href ="NSURLHandle.html#method-5">-backgroundLoadDidFailWithReason:</a>
|
|
<li ><a href ="NSURLHandle.html#method-6">-beginLoadInBackground</a>
|
|
<li ><a href ="NSURLHandle.html#cancelLoadInBackground">-cancelLoadInBackground</a>
|
|
<li ><a href ="NSURLHandle.html#method-7">-didLoadBytes:loadComplete:</a>
|
|
<li ><a href ="NSURLHandle.html#endLoadInBackground">-endLoadInBackground</a>
|
|
<li ><a href ="NSURLHandle.html#method-8">-failureReason</a>
|
|
<li ><a href ="NSURLHandle.html#method-9">-flushCachedData</a>
|
|
<li ><a href ="NSURLHandle.html#method-10">-initWithURL:cached:</a>
|
|
<li ><a href ="NSURLHandle.html#method-11">-loadInBackground</a>
|
|
<li ><a href ="NSURLHandle.html#loadInForeground">-loadInForeground</a>
|
|
<li ><a href ="NSURLHandle.html#method-12">-propertyForKey:</a>
|
|
<li ><a href ="NSURLHandle.html#method-13">-propertyForKeyIfAvailable:</a>
|
|
<li ><a href ="NSURLHandle.html#method-14">-removeClient:</a>
|
|
<li ><a href ="NSURLHandle.html#method-15">-resourceData</a>
|
|
<li ><a href ="NSURLHandle.html#method-16">-status</a>
|
|
<li ><a href ="NSURLHandle.html#method-17">-writeData:</a>
|
|
<li ><a href ="NSURLHandle.html#method-18">-writeProperty:forKey:</a>
|
|
</ul>
|
|
<hr><h2>Class Methods </h2>
|
|
<h3><a name ="method-0">URLHandleClassForURL:</a></h3>
|
|
+ (Class) <b>URLHandleClassForURL:</b> (NSURL*)anURL;<br>
|
|
|
|
Returns the most recently registered NSURLHandle subclass that
|
|
responds to <a href ="#canInitWithURL:">canInitWithURL:</a>
|
|
with <code>YES</code>. If there is no such subclass, returns nil.
|
|
|
|
<hr>
|
|
<h3><a name ="method-1">cachedHandleForURL:</a></h3>
|
|
+ (NSURLHandle*) <b>cachedHandleForURL:</b> (NSURL*)anURL;<br>
|
|
|
|
Returns a previously created object that handles the specified
|
|
URL (if any exists), otherwise returns nil.
|
|
|
|
<hr>
|
|
<h3><a name ="canInitWithURL:">canInitWithURL:</a></h3>
|
|
+ (BOOL) <b>canInitWithURL:</b> (NSURL*)anURL;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Implemented by subclasses to say which URLs they can handle.
|
|
This method is used to determine which subclasses can be used
|
|
to handle a particular URL.
|
|
|
|
<hr>
|
|
<h3><a name ="method-2">registerURLHandleClass:</a></h3>
|
|
+ (void) <b>registerURLHandleClass:</b> (Class)anURLHandleSubclass;<br>
|
|
|
|
Used to register a subclass as being available to handle URLs.
|
|
|
|
<hr>
|
|
<hr><h2>Instances Methods </h2>
|
|
<h3><a name ="method-3">addClient:</a></h3>
|
|
- (void) <b>addClient:</b> (id<NSURLHandleClient>)client;<br>
|
|
|
|
Adds an object conforming to the
|
|
<a href ="#NSURLHandleClient">NSURLHandleClient protocol</a>
|
|
as a client of the URL handle.
|
|
|
|
<hr>
|
|
<h3><a name ="method-4">availableResourceData</a></h3>
|
|
- (NSData*) <b>availableResourceData</b>;<br>
|
|
|
|
Returns the resource data that is currently available for the
|
|
handle. This may be a partially loaded resource or may be
|
|
empty of no data has been loaded yet.
|
|
|
|
<hr>
|
|
<h3><a name ="method-5">backgroundLoadDidFailWithReason:</a></h3>
|
|
- (void) <b>backgroundLoadDidFailWithReason:</b> (NSString*)reason;<br>
|
|
|
|
This method should be called when a background load fails.
|
|
The method passes the failure notification to the clients of
|
|
the handle - so subclasses should call super's implementation
|
|
at the end of their implementation of this method.
|
|
|
|
<hr>
|
|
<h3><a name ="method-6">beginLoadInBackground</a></h3>
|
|
- (void) <b>beginLoadInBackground</b>;<br>
|
|
|
|
This method is called by when a background load begins.
|
|
Subclasses should call super's implementation at
|
|
the end of their implementation of this method.
|
|
|
|
<hr>
|
|
<h3><a name ="cancelLoadInBackground">cancelLoadInBackground</a></h3>
|
|
- (void) <b>cancelLoadInBackground</b>;<br>
|
|
|
|
This method should be called to cancel a load currently in
|
|
progress. The method calls
|
|
<a href ="#endLoadInBackground">endLoadInBackground</a>
|
|
Subclasses should call super's implementation at
|
|
the end of their implementation of this method.
|
|
|
|
<hr>
|
|
<h3><a name ="method-7">didLoadBytes:loadComplete:</a></h3>
|
|
- (void) <b>didLoadBytes:</b> (NSData*)newBytes <b>loadComplete:</b> (BOOL)yorn;<br>
|
|
|
|
This method must be called by subclasses whenever data is
|
|
loaded.
|
|
|
|
<hr>
|
|
<h3><a name ="endLoadInBackground">endLoadInBackground</a></h3>
|
|
- (void) <b>endLoadInBackground</b>;<br>
|
|
|
|
This method is called to stop any background loading process.
|
|
<a href ="NSURLHandle.html#cancelLoadInBackground">cancelLoadInBackground</a>
|
|
uses this method to cancel loading.
|
|
Subclasses should call super's implementation at
|
|
the end of their implementation of this method.
|
|
|
|
<hr>
|
|
<h3><a name ="method-8">failureReason</a></h3>
|
|
- (NSString*) <b>failureReason</b>;<br>
|
|
|
|
Returns the failure reason for the last failure to load
|
|
the resource data.
|
|
|
|
<hr>
|
|
<h3><a name ="method-9">flushCachedData</a></h3>
|
|
- (void) <b>flushCachedData</b>;<br>
|
|
|
|
Flushes any cached resource data.
|
|
|
|
<hr>
|
|
<h3><a name ="method-10">initWithURL:cached:</a></h3>
|
|
<b>This is the designated initialiser </b><br>
|
|
- (init) <b>initWithURL:</b> (NSURL*)url <b>cached:</b> (BOOL)yesno;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Initialises a handle with the specified URL.
|
|
The flag determines whether the handle will cache resource data
|
|
and respond to requests from equivalent URLs for the cached data.
|
|
|
|
<hr>
|
|
<h3><a name ="method-11">loadInBackground</a></h3>
|
|
- (void) <b>loadInBackground</b>;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Starts (or queues) loading of the handle's resource data
|
|
in the background (asynchronously).
|
|
|
|
<hr>
|
|
<h3><a name ="loadInForeground">loadInForeground</a></h3>
|
|
- (NSData*) <b>loadInForeground</b>;<br>
|
|
|
|
Loads the handle's resource data in the foreground (synchronously).
|
|
This may be implemented by starting a background load and
|
|
waiting for it to complete.
|
|
|
|
<hr>
|
|
<h3><a name ="method-12">propertyForKey:</a></h3>
|
|
- (id) <b>propertyForKey:</b> (NSString*)propertyKey;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Returns the property for the specified key, or nil if the
|
|
key does not exist.
|
|
|
|
<hr>
|
|
<h3><a name ="method-13">propertyForKeyIfAvailable:</a></h3>
|
|
- (id) <b>propertyForKeyIfAvailable:</b> (NSString*)propertyKey;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Returns the property for the specified key, but only if the
|
|
handle does not need to do any work to retrieve it.
|
|
|
|
<hr>
|
|
<h3><a name ="method-14">removeClient:</a></h3>
|
|
- (void) <b>removeClient:</b> (id<NSURLHandleClient>)client;<br>
|
|
|
|
Removes an object from them list of clients notified of
|
|
resource loading events by the URL handle.
|
|
|
|
<hr>
|
|
<h3><a name ="method-15">resourceData</a></h3>
|
|
- (NSData*) <b>resourceData</b>;<br>
|
|
|
|
Returns the resource data belonging to the handler.
|
|
Calls <a href ="NSURLHandle.html#loadInForeground">loadInForeground</a> if
|
|
necessary.
|
|
|
|
<hr>
|
|
<h3><a name ="method-16">status</a></h3>
|
|
- (NSURLHandleStatus) <b>status</b>;<br>
|
|
|
|
Returns the current status of the handle.
|
|
|
|
<hr>
|
|
<h3><a name ="method-17">writeData:</a></h3>
|
|
- (BOOL) <b>writeData:</b> (NSData*)data;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Writes resource data to the handle. Returns YES on success,
|
|
NO on failure.
|
|
|
|
<hr>
|
|
<h3><a name ="method-18">writeProperty:forKey:</a></h3>
|
|
- (BOOL) <b>writeProperty:</b> (id)propertyValue <b>forKey:</b> (NSString*)key;<br>
|
|
Your subclass <em>must </em> override this abstract method.<br>
|
|
|
|
Attempts to set property for handle.
|
|
|
|
<hr>
|
|
<h2><a name ="NSURLHandleClient">NSURLHandleClient Protocol </a></h2>
|
|
<p><b>Declared in: </b> Foundation/NSURLHandle.h</p>
|
|
<hr>
|
|
|
|
|
|
<ul>
|
|
<li ><a href ="NSURLHandle.html#method-22">-URLHandle:resourceDidBecomeAvailable:</a>
|
|
<li ><a href ="NSURLHandle.html#method-23">-URLHandle:resourceDidFailLoadingWithReason:</a>
|
|
<li ><a href ="NSURLHandle.html#method-19">-URLHandleResourceDidBeginLoading:</a>
|
|
<li ><a href ="NSURLHandle.html#method-20">-URLHandleResourceDidCancelLoading:</a>
|
|
<li ><a href ="NSURLHandle.html#method-21">-URLHandleResourceDidFinishLoading:</a>
|
|
</ul>
|
|
<hr>
|
|
<h3><a name ="method-19">URLHandleResourceDidBeginLoading:</a></h3>
|
|
- (void) <b>URLHandleResourceDidBeginLoading:</b> (NSURLHandle*)sender;<br>
|
|
|
|
Sent by the NSURLHandle object when it begins loading
|
|
resource data.
|
|
|
|
<hr>
|
|
<h3><a name ="method-20">URLHandleResourceDidCancelLoading:</a></h3>
|
|
- (void) <b>URLHandleResourceDidCancelLoading:</b> (NSURLHandle*)sender;<br>
|
|
|
|
Sent by the NSURLHandle object when resource loading is canceled
|
|
by programmatic request (rather than by failure).
|
|
|
|
<hr>
|
|
<h3><a name ="method-21">URLHandleResourceDidFinishLoading:</a></h3>
|
|
- (void) <b>URLHandleResourceDidFinishLoading:</b> (NSURLHandle*)sender;<br>
|
|
|
|
Sent by the NSURLHandle object when it completes loading
|
|
resource data.
|
|
|
|
<hr>
|
|
<h3><a name ="method-22">URLHandle:resourceDidBecomeAvailable:</a></h3>
|
|
- (void) <b>URLHandle:</b> (NSURLHandle*)sender <b>resourceDidBecomeAvailable:</b> (NSData*)data;<br>
|
|
|
|
Sent by the NSURLHandle object when some data becomes available
|
|
from the handle.
|
|
|
|
<hr>
|
|
<h3><a name ="method-23">URLHandle:resourceDidFailLoadingWithReason:</a></h3>
|
|
- (void) <b>URLHandle:</b> (NSURLHandle*)sender <b>resourceDidFailLoadingWithReason:</b> (NSString*)reason;<br>
|
|
|
|
Sent by the NSURLHandle object on resource load failure.
|
|
Supplies a human readable failure reason.
|
|
|
|
<hr>
|
|
<h3><a name ="NSURLHandleStatus">NSURLHandleStatus</a></h3>
|
|
<p><b>Declared in: </b> Foundation/NSURLHandle.h</p>
|
|
<b>typedef </b> int NSURLHandleStatus<br>
|
|
|
|
|
|
An NSURLHandleStatus is used to report the current state of an
|
|
NSURLHandle object, it can take the following values -
|
|
<ul>
|
|
<li >NSURLHandleNotLoaded
|
|
<li >NSURLHandleLoadSucceeded
|
|
<li >NSURLHandleLoadInProgress
|
|
<li >NSURLHandleLoadFailed
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
<h2><a name ="cont-1">GSFileURLHandle</a></h2>
|
|
<h2><a name ="GSFileURLHandle">GSFileURLHandle</a></h2>
|
|
<p><b>Inherits from: </b> NSURLHandle</p>
|
|
<hr>
|
|
|
|
<p>
|
|
|
|
This is a <em>PRIVATE</em> subclass of NSURLHandle.
|
|
It is documented here in order to give you information about the
|
|
default behavior of an NSURLHandle created to deal with a URL
|
|
that has the FILE scheme. The name and/or other
|
|
implementation details of this class may be changed at any time.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
A GSFileURLHandle instance is used to manage files on the local
|
|
file-system of your machine.
|
|
</p>
|
|
|
|
|
|
<h2>Instance Variables </h2>
|
|
<ul>
|
|
</ul>
|
|
<h2>Methods </h2>
|
|
<ul>
|
|
<li ><a href ="NSURLHandle.html#method-24">-propertyForKey:</a>
|
|
<li ><a href ="NSURLHandle.html#method-25">-writeData:</a>
|
|
<li ><a href ="NSURLHandle.html#method-26">-writeProperty:forKey:</a>
|
|
</ul>
|
|
<hr><h2>Instances Methods </h2>
|
|
<h3><a name ="method-24">propertyForKey:</a></h3>
|
|
- (id) <b>propertyForKey:</b> (NSString*)propertyKey;<br>
|
|
|
|
Gets file attribute information for the file represented by
|
|
the handle, using the same dictionary keys as the
|
|
NSFileManager class.
|
|
|
|
<hr>
|
|
<h3><a name ="method-25">writeData:</a></h3>
|
|
- (BOOL) <b>writeData:</b> (NSData*)data;<br>
|
|
|
|
Writes the specified data as the contents of the file
|
|
represented by the handle.
|
|
|
|
<hr>
|
|
<h3><a name ="method-26">writeProperty:forKey:</a></h3>
|
|
- (BOOL) <b>writeProperty:</b> (id)propertyValue <b>forKey:</b> (NSString*)key;<br>
|
|
|
|
Changes the attributes of the file represented by this handle.
|
|
This method uses the same dictionary keys as the NSFileManger
|
|
class.
|
|
|
|
<hr>
|
|
<h2><a name ="cont-2">GSHTTPURLHandle</a></h2>
|
|
<h2><a name ="GSHTTPURLHandle">GSHTTPURLHandle</a></h2>
|
|
<p><b>Inherits from: </b> NSURLHandle</p>
|
|
<hr>
|
|
|
|
<p>
|
|
|
|
This is a <em>PRIVATE</em> subclass of NSURLHandle.
|
|
It is documented here in order to give you information about the
|
|
default behavior of an NSURLHandle created to deal with a URL
|
|
that has either the <code>http</code> or <code>https</code> scheme.
|
|
The name and/or other implementation details of this class
|
|
may be changed at any time.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
A GSHTTPURLHandle instance is used to manage connections to
|
|
<code>http</code> and <code>https</code> URLs.
|
|
Secure connections are handled automatically
|
|
(using openSSL) for URLs with the scheme <code>https</code>.
|
|
Connection via proxy server is supported, as is proxy tunneling
|
|
for secure connections. Basic parsing of <code>http</code>
|
|
headers is performed to extract <code>http</code> status
|
|
information, cookies etc. Cookies are
|
|
retained and automatically sent during subsequent requests where
|
|
the cookie is valid.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
Header information from the current page may be obtained using
|
|
-propertyForKey and -propertyForKeyIfAvailable. <code>HTTP</code>
|
|
status information can be retrieved as by calling either of these
|
|
methods specifying one of the following keys:
|
|
</p>
|
|
|
|
<ul>
|
|
<li >
|
|
NSHTTPPropertyStatusCodeKey - numeric status code
|
|
|
|
<li >
|
|
NSHTTPPropertyStatusReasonKey - text describing status
|
|
|
|
<li >
|
|
NSHTTPPropertyServerHTTPVersionKey - <code>http</code>
|
|
version supported by remote server
|
|
|
|
</ul>
|
|
|
|
<p>
|
|
|
|
According to MacOS-X headers, the following should also
|
|
be supported, but currently are not:
|
|
</p>
|
|
|
|
<ul>
|
|
<li >NSHTTPPropertyRedirectionHeadersKey
|
|
<li >NSHTTPPropertyErrorPageDataKey
|
|
</ul>
|
|
|
|
<p>
|
|
|
|
The omission of these headers is not viewed as important at
|
|
present, since the MacOS-X public beta implementation doesn't
|
|
work either.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
Other calls to -propertyForKey and -propertyForKeyIfAvailable may
|
|
be made specifying a <code>http</code> header field name.
|
|
For example specifying a key name of "Content-Length"
|
|
would return the value of the "Content-Length" header
|
|
field.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
<a href ="#GSHTTPURLHandle-writeProperty:forKey:">
|
|
-writeProperty:forKey:</a> can be used to specify the parameters
|
|
for the <code>http</code> request. The default request uses the
|
|
"GET" method when fetching a page, and the
|
|
"POST" method when using -writeData:.
|
|
This can be over-ridden by calling -writeProperty:forKey: with
|
|
the key name "GSHTTPPropertyMethodKey" and specifying an
|
|
alternative method (i.e "PUT").
|
|
</p>
|
|
|
|
<p>
|
|
|
|
A Proxy may be specified by calling -writeProperty:forKey:
|
|
with the keys "GSHTTPPropertyProxyHostKey" and
|
|
"GSHTTPPropertyProxyPortKey" to set the host and port
|
|
of the proxy server respectively. The GSHTTPPropertyProxyHostKey
|
|
property can be set to either the IP address or the hostname of
|
|
the proxy server. If an attempt is made to load a page via a
|
|
secure connection when a proxy is specified, GSHTTPURLHandle will
|
|
attempt to open an SSL Tunnel through the proxy.
|
|
</p>
|
|
|
|
|
|
<h2>Instance Variables </h2>
|
|
<ul>
|
|
</ul>
|
|
<h2>Methods </h2>
|
|
<ul>
|
|
<li ><a href ="NSURLHandle.html#method-27">-propertyForKey:</a>
|
|
<li ><a href ="NSURLHandle.html#method-28">-writeData:</a>
|
|
<li ><a href ="NSURLHandle.html#GSHTTPURLHandle-writeProperty:forKey:">-writeProperty:forKey:</a>
|
|
</ul>
|
|
<hr><h2>Instances Methods </h2>
|
|
<h3><a name ="method-27">propertyForKey:</a></h3>
|
|
- (id) <b>propertyForKey:</b> (NSString*)propertyKey;<br>
|
|
|
|
If necessary, this method calls -loadInForeground to send a
|
|
request to the webserver, and get a page back. It then returns
|
|
the property for the specified key -
|
|
<ul>
|
|
<li >
|
|
NSHTTPPropertyStatusCodeKey - numeric status code returned
|
|
by the last request.
|
|
|
|
<li >
|
|
NSHTTPPropertyStatusReasonKey - text describing status of
|
|
the last request
|
|
|
|
<li >
|
|
NSHTTPPropertyServerHTTPVersionKey - <code>http</code>
|
|
version supported by remote server
|
|
|
|
<li >
|
|
Other keys are taken to be the names of <code>http</code>
|
|
headers and the corresponding header value (or nil if there
|
|
is none) is returned.
|
|
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-28">writeData:</a></h3>
|
|
- (BOOL) <b>writeData:</b> (NSData*)data;<br>
|
|
|
|
Writes the specified data as the body of an <code>http</code>
|
|
or <code>https</code> request to the web server.
|
|
Returns YES on success,
|
|
NO on failure. By default, this method performs a POST operation.
|
|
On completion, the resource data for this handle is set to the
|
|
page returned by the request.
|
|
|
|
<hr>
|
|
<h3><a name ="GSHTTPURLHandle-writeProperty:forKey:">writeProperty:forKey:</a></h3>
|
|
- (BOOL) <b>writeProperty:</b> (id)propertyValue <b>forKey:</b> (NSString*)key;<br>
|
|
|
|
Sets a property to be used in the next request made by this handle.
|
|
The property is set as a header in the next request, unless it is
|
|
one of the following -
|
|
<ul>
|
|
<li >
|
|
GSHTTPPropertyMethodKey - override the default method of
|
|
the request (eg. "PUT").
|
|
|
|
<li >
|
|
GSHTTPPropertyProxyHostKey - specify the name or IP address
|
|
of a host to proxy through.
|
|
|
|
<li >
|
|
GSHTTPPropertyProxyPortKey - specify the port number to
|
|
connect to on the proxy host. If not give, this defaults
|
|
to 8080 for <code>http</code> and 4430 for <code>https</code>.
|
|
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
</body>
|
|
|
|
</html>
|