Ns http
Jump to navigation
Jump to search
<manpage>ns_http</manpage>
NAME
- ns_http - Simple HTTP client functionality
SYNOPSIS
- ns_http option ?arg arg ...?
DESCRIPTION
- This command provides a simple HTTP client mechanism.
- The legal options (which may be abbreviated) are:
- ns_http cancel id
- ns_http cleanup
- ns_http queue method url ?body? ?headers?
- body is the value which will be sent as the HTTP request body. headers is the ns_set ID containing the additional headers to include in the HTTP request.
- ns_http wait id resultsVar ?timeout? ?headers? ?-servicetime svcTime?
- resultsVar is the name of a variable that should be used to store the HTTP response body. Default timeout is "2:0" (2s, 0usec). headers is the ns_set ID which will receive the headers from the HTTP response.
EXAMPLES
Valid HTTP GET:
% set id [ns_http queue GET http://aolserver.com/] http0 % set status [ns_http wait $id results] 1 % string range $results 0 60 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN
Timed out HTTP GET:
% set id [ns_http queue GET http://aolserver.com:12345/] http0 % set status [ns_http wait $id results 0] 0 % set results timeout
Bogus HTTP GET:
% catch {ns_http queue GET http://nonexistant.domain/} err
1
% set err
could not connect to : http://nonexistant.domain/
SEE ALSO
