Protocol (HttpRequest property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 11: Line 11:
<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>protocolval</th>
<tr><th>protocolval</th>
Line 28: Line 28:
and <var>[[SSLOPT]]</var> parameters.
and <var>[[SSLOPT]]</var> parameters.
<li>Setting the TCP/IP protocol to <code>https</code> automatically
<li>Setting the TCP/IP protocol to <code>https</code> automatically
sets the <var>[[Port (HTTPRequest property)|Port]]</var> property to the
sets the <var>[[Port (HttpRequest property)|Port]]</var> property to the
standard SSL port (443).
standard SSL port (443).
Setting the protocol to <code>http</code>
Setting the protocol to <code>http</code>

Revision as of 20:17, 16 June 2011

HTTP request protocol (HttpRequest class)


This property sets and returns the TCP/IP protocol for the HTTP request. The protocols supported are http (standard web protocol) and https (Secure Sockets Layer, or, SSL). If left unset, it defaults to http.

Syntax

%currentString = httpRequest:Protocol httpRequest:Protocol = newString

Syntax terms

%httpreq A previously defined and instantiated HttpRequest object.
protocolval A string expression that identifies the protocol to use. It must have a value of http or https. It is case insensitive. If the value is not http or https, the request is cancelled.
%curr A string or longstring variable for the assignment of the current value of Protocol.

Usage notes

  • You must not set a Protocol value that conflicts with the protocol specified on the JANUS CLSOCK port definition your HTTP request will reference. For example, to successfully use https as the Protocol value, the Janus port definition must specify both the SSL and SSLOPT parameters.
  • Setting the TCP/IP protocol to https automatically sets the Port property to the standard SSL port (443). Setting the protocol to http automatically sets Port to the standard HTTP port (80).

See also