Content (HttpResponse function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
m (move footer template to actual end; match syntax table to syntax template; edits, tags and links) |
||
| Line 1: | Line 1: | ||
{{Template:HttpResponse:Content subtitle}} | {{Template:HttpResponse:Content subtitle}} | ||
The <var>Content</var> method lets you access the document/content from <var>[[Get (HttpRequest function)|Get]]</var>, <var>[[Post (HttpRequest function)|Post]]</var>, and <var>[[Send (HttpRequest function)|Send]]</var> operations. <var>Content</var> returns the entire document into a <var>[[longstrings|Longstring]]</var> with no parsing: you receive the raw bytes as they were returned from the HTTP request, with the option of ASCII-to-EBCDIC translation. | |||
==Syntax== | ==Syntax== | ||
{{Template:HttpResponse:Content syntax}} | {{Template:HttpResponse:Content syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%string</th> | ||
<td>A longstring variable. | <td>A <var>longstring</var> variable to receive the current document/content. | ||
</td></tr> | </td></tr> | ||
<tr><th> | <tr><th>httpResponse</th> | ||
<td>A reference to an | <td>A reference to an <var>[[HttpResponse_class|HttpResponse]]</var> object that was returned by a <var>Get</var>, <var>Post</var>, or <var>Send</var> method of an <var>[[HttpRequest_class|HttpRequest]]</var> object. | ||
</td></tr> | </td></tr> | ||
<tr><th> | <tr><th>number</th> | ||
<td> | <td>An, optional, numeric expression that, if nonzero, indicates binary data. Setting this option overrides the default behavior, which is to translate ASCII data to EBCDIC.</td></tr> | ||
</table> | |||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li>Invoke <var>Content</var> only | <li>Invoke <var>Content</var> only if a successful HTTP transaction has occurred, that is, if the <var>[[Success (HttpResponse function)|Success]]</var> value is <var>True</var>. If <var>Content</var> is called after an unsuccessful operation, the request is cancelled. | ||
if a successful HTTP transaction has occurred, that is, if | <li>If the content type header indicates HTML, XML, or plain text, ASCII-to-EBCDIC translation is performed. If the <var>Clsock</var> port definition specifies a translation table for ASCII-to-EBCDIC, that table is used instead of the default. | ||
the <var>[[Success (HttpResponse function)|Success]]</var> value | |||
is <var>True</var>. | |||
If <var>Content</var> is called | |||
after an unsuccessful operation, the request is cancelled. | |||
<li>If the content type header indicates HTML, XML, or plain text, | |||
ASCII-to-EBCDIC translation is performed. | |||
If the <var>Clsock</var> port definition specifies a translation table for ASCII-to-EBCDIC, | |||
that table is used instead of the default. | |||
</ul> | </ul> | ||
==Example== | ==Example== | ||
<ol> | |||
<li>In the following fragment, an <var>HTTPResponse</var> object receives a .PDF file from a remote URL into a <var>Longstring</var>, leaving the data in binary format: | |||
<p class="code"> %httpreq is object httpRequest | |||
%httpresp is object httpResponse | |||
%pdf is longstring | |||
%url is longstring | |||
... | |||
%httpreq = [[New_(HttpRequest_constructor)|new]] | |||
%httpreq:[[URL_(HttpRequest_property)|url]] = %url | |||
%httpresp = %httpreq:[[Get_(HttpRequest_function)|get]] | |||
if (%httpresp:Success) then | |||
%pdf = %httpresp:content(1) | |||
... | |||
</p></ol> | |||
==See also== | ==See also== | ||
<ul> | <ul> | ||
<li>For information about returning response contents into a <var>Stringlist</var>, | <li>For information about returning response contents into a <var>Stringlist</var>, see the <var>[[ContentToStringlist (HttpResponse function)|ContentToStringlist]]</var> method. | ||
see the <var>[[ContentToStringlist (HttpResponse function)|ContentToStringlist]]</var> method. | |||
</ul> | </ul> | ||
{{Template:HttpResponse:Content footer}} | |||
Revision as of 05:33, 19 June 2011
Get raw HTTP response data (HttpResponse class)
The Content method lets you access the document/content from Get, Post, and Send operations. Content returns the entire document into a Longstring with no parsing: you receive the raw bytes as they were returned from the HTTP request, with the option of ASCII-to-EBCDIC translation.
Syntax
%string = httpResponse:Content[( [number])]
Syntax terms
| %string | A longstring variable to receive the current document/content. |
|---|---|
| httpResponse | A reference to an HttpResponse object that was returned by a Get, Post, or Send method of an HttpRequest object. |
| number | An, optional, numeric expression that, if nonzero, indicates binary data. Setting this option overrides the default behavior, which is to translate ASCII data to EBCDIC. |
Usage notes
- Invoke Content only if a successful HTTP transaction has occurred, that is, if the Success value is True. If Content is called after an unsuccessful operation, the request is cancelled.
- If the content type header indicates HTML, XML, or plain text, ASCII-to-EBCDIC translation is performed. If the Clsock port definition specifies a translation table for ASCII-to-EBCDIC, that table is used instead of the default.
Example
- In the following fragment, an HTTPResponse object receives a .PDF file from a remote URL into a Longstring, leaving the data in binary format:
%httpreq is object httpRequest %httpresp is object httpResponse %pdf is longstring %url is longstring ... %httpreq = new %httpreq:url = %url %httpresp = %httpreq:get if (%httpresp:Success) then %pdf = %httpresp:content(1) ...
See also
- For information about returning response contents into a Stringlist, see the ContentToStringlist method.