Proxy (HttpRequest property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 2: Line 2:


This settable method permits the use of proxy servers with the
This settable method permits the use of proxy servers with the
<var>HTTPRequest</var> object.
<var>HttpRequest</var> object.


If you specify a proxy server by setting Proxy,
If you specify a proxy server by setting Proxy,
subsequent Get, Post, and Send calls use this proxy server.
subsequent Get, Post, and Send calls use this proxy server.
If referenced by an <var>HTTPRequest</var> object, <var>Proxy</var> returns the
If referenced by an <var>HttpRequest</var> object, <var>Proxy</var> returns the
current proxy server (or a zero length string, if no proxy was set).
current proxy server (or a zero length string, if no proxy was set).
==Syntax==
==Syntax==
Line 13: Line 13:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%httpreq</th>
<tr><th>%httpreq</th>
<td>A previously defined and instantiated <var>HTTPRequest</var> object.
<td>A previously defined and instantiated <var>HttpRequest</var> object.
</td></tr>
</td></tr>
<tr><th><var>ProxyServer</var></th>
<tr><th><var>ProxyServer</var></th>

Revision as of 20:17, 16 June 2011

Permit use of proxy server? (HttpRequest class)


This settable method permits the use of proxy servers with the HttpRequest object.

If you specify a proxy server by setting Proxy, subsequent Get, Post, and Send calls use this proxy server. If referenced by an HttpRequest object, Proxy returns the current proxy server (or a zero length string, if no proxy was set).

Syntax

%currentString = httpRequest:Proxy httpRequest:Proxy = newString

Syntax terms

%httpreq A previously defined and instantiated HttpRequest object.
ProxyServer Identifies the proxy server to use, and is of form:

[Protocol://]Host[:Port]

  • Protocol is http or https and defaults to http. It controls the protocol used for the connection to the proxy server.
  • Host specifies either the IP number or the DNS name of the proxy server. It must be specified or the request is cancelled.
  • Port specifies the port number for the proxy server. If it is not specified, the default for the protocol (http is 80, and https is 443) is used.
%curr The string or longstring variable for the assignment of the current value of Proxy. If no Proxy value has been set, %curr is assigned a zero-length string.

Usage notes

If Proxy is set multiple times, the most recent setting is used as the proxy server.

See also