Send (HttpRequest function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 16: Line 16:
<td>An instantiated <var>HttpRequest</var> object that contains the request (its methods were used to create the request).
<td>An instantiated <var>HttpRequest</var> object that contains the request (its methods were used to create the request).
</td></tr>
</td></tr>
<tr><th>Port</th>
<tr><th><var>Port</var></th>
<td>A string expression that identifies a previously defined <var>CLSOCK</var> port. The ''name'' default is the [[MASTER]] port, if any is defined. However, if you omit ''name'' and no <var>MASTER</var> port is defined, the request is canceled.
<td>A string expression that identifies a previously defined <var>CLSOCK</var> port. The ''name'' default is the [[MASTER]] port, if any is defined. However, if you omit ''name'' and no <var>MASTER</var> port is defined, the request is canceled.
This is an optional and (as of <var class="product">[[Sirius Mods]]</var> version 7.2) [[Notation conventions for methods#Named parameters|name-allowed]] parameter.  If you specify a value, you may (but don't have to) specify the parameter name, <var>Port</var> (case not important) if you wish.
This is an optional and (as of <var class="product">[[Sirius Mods]]</var> version 7.2) [[Notation conventions for methods#Named parameters|name-allowed]] parameter.  If you specify a value, you may (but don't have to) specify the parameter name, <var>Port</var> (case not important).
</td></tr>
</td></tr>
<tr><th>Cancel</th>
<tr><th><var>Cancel</var></th>
<td>A numeric expression that controls whether the request is cancelled if a communication/socket error occurs. If zero, the request is not cancelled on these errors. If non-zero, the request is cancelled (though a message is still issued). If not specified, it defaults to 1 (cancel). See "Usage notes," below, for further discussion of error handling.
<td>A numeric expression that controls whether the request is cancelled if a communication/socket error occurs. If zero, the request is not cancelled on these errors. If non-zero, the request is cancelled (though a message is still issued). If not specified, it defaults to 1 (cancel). See "Usage notes," below, for further discussion of error handling.
This is an optional and (as of <var class="product">Sirius Mods</var> version 7.2) name-allowed parameter.  If you specify a value, you may (but don't have to) specify the parameter name, <var>Cancel</var> (case not important) if you wish.
This is an optional and (as of <var class="product">Sirius Mods</var> version 7.2) name-allowed parameter.  If you specify a value, you may (but don't have to) specify the parameter name, <var>Cancel</var> (case not important) if you wish.
</td></tr>
</td></tr>
<tr><th>Method</th>
<tr><th><var>Method</var></th>
<td><var class="term>Method</var> is both a required and <var>[[Methods#Named parameters|Name-Required]]</var> parameter specifying the quoted name of any HTTP method type (for example, 'GET', 'PUT', 'MOVE').
<td><var class="term>Method</var> is both a required and [[Methods#Named parameters|name required]] parameter that specifies the quoted name of any HTTP method type (for example, 'GET', 'PUT', 'MOVE').
The <var class="term>Method</var> name is not case sensitive, but must be supplied; while the method <i>string</i> must be less than or equal to 16 characters long, all uppercase.
The parameter name, <var class="term>Method</var>, is not case sensitive, but it must be supplied. The type <var class="term">name</var> must be less than or equal to 16 characters, all uppercase.
</td></tr>
</td></tr>
</table>
</table>
Line 38: Line 38:


==Examples==
==Examples==
<ol>
<li>
<var>Send</var> statements with argument variations are shown below:
<var>Send</var> statements with argument variations are shown below:
<p class="code"> %resp = %req:send(method='DELETE')
<p class="code"> %resp = %req:send(method='DELETE')
Line 47: Line 45:
  %resp = %req:send(method='POST', port='CLPORT', cancel=1)
  %resp = %req:send(method='POST', port='CLPORT', cancel=1)
</p>
</p>
</ol>


==See also==
==See also==

Revision as of 21:46, 21 June 2011

Send an HTTP request to the server (HttpRequest class)

The Send function sends an HTTP request to an HTTP server using a parameter value to identify which of the HTTP method types (GET, POST, DELETE, and so on) you want the function to perform. Any HTTP method type is valid as long as its name is 16 characters or less.

The HTTP method type is specified with the Method (name required) parameter. If the Method value is GET or POST, the Send method invocation becomes equivalent to the Get or Post method.

Prior to the addition of the Send method in Sirius Mods Version 7.2, the HttpRequest class had methods only for HTTP GETs and POSTs. The Send method is the only way to carry out HTTP methods other than GET or POST.

Syntax

%httpResponse = httpRequest:Send( [[Port=] string], [[Cancel=] number], - [CertificateCheck= certificateChecker], - [CheckKeepAliveCertificate= boolean], - Method= name)

Syntax terms

%httpresponse A reference to the HTTPResponse object instantiated and returned by this Send method.
httpRequest An instantiated HttpRequest object that contains the request (its methods were used to create the request).
Port A string expression that identifies a previously defined CLSOCK port. The name default is the MASTER port, if any is defined. However, if you omit name and no MASTER port is defined, the request is canceled.

This is an optional and (as of Sirius Mods version 7.2) name-allowed parameter. If you specify a value, you may (but don't have to) specify the parameter name, Port (case not important).

Cancel A numeric expression that controls whether the request is cancelled if a communication/socket error occurs. If zero, the request is not cancelled on these errors. If non-zero, the request is cancelled (though a message is still issued). If not specified, it defaults to 1 (cancel). See "Usage notes," below, for further discussion of error handling.

This is an optional and (as of Sirius Mods version 7.2) name-allowed parameter. If you specify a value, you may (but don't have to) specify the parameter name, Cancel (case not important) if you wish.

Method Method is both a required and name required parameter that specifies the quoted name of any HTTP method type (for example, 'GET', 'PUT', 'MOVE').

The parameter name, Method, is not case sensitive, but it must be supplied. The type name must be less than or equal to 16 characters, all uppercase.

Usage notes

  • Although you may specify the Method parameter before the optional parameters, you receive a compilation error if you do so without also specifying the optional parameter names with the optional parameters.
  • For information about error handling, see the Get function "Usage notes".
  • To send an HTTP GET or POST, you can also use the Get method or the Post method, respectively.

Examples

Send statements with argument variations are shown below:

%resp = %req:send(method='DELETE') %resp = %req:send('CLPORT', method='DELETE') %resp = %req:send(method='POST', port='CLPORT', cancel=1)

See also