Difference between revisions of "LlHTTPResponse"

From Second Life Wiki
Jump to: navigation, search
m (~caveat)
m (<lsl> tag to <source>)
 
(15 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{LSL_Function
 
{{LSL_Function
 +
|inject-2={{Issues/SCR-396}}
 
|func_id=348|func_sleep=0.0|func_energy=10.0|mode
 
|func_id=348|func_sleep=0.0|func_energy=10.0|mode
 
|func=llHTTPResponse
 
|func=llHTTPResponse
|p1_type=key|p1_name=request_id|p1_desc=A valid HTTP request key.
+
|p1_type=key|p1_subtype=handle|p1_name=request_id|p1_desc=A valid HTTP request key.
|p2_type=integer|p2_name=status|p2_desc=HTTP Status (200, 400, 404, etc)
+
|p2_type=integer|p2_name=status|p2_desc={{Wikipedia|List_of_HTTP_status_codes|HTTP Status}} (200, 400, 404, etc)|p2_hover=HTTP Status (200, 400, 404, etc)
 
|p3_type=string|p3_name=body|p3_desc=Contents of the response.
 
|p3_type=string|p3_name=body|p3_desc=Contents of the response.
 
|func_footnote=The response need not be made inside the [[http_request]] event but if it does not happen in a timely fashion the request will time out (within 25 seconds).
 
|func_footnote=The response need not be made inside the [[http_request]] event but if it does not happen in a timely fashion the request will time out (within 25 seconds).
|func_desc=Responds to '''request_id''' with '''status''' and '''body'''.
+
|func_desc=Responds to {{LSLP|request_id}} with {{LSLP|status}} and {{LSLP|body}}.
 
|return_text
 
|return_text
 
|spec
 
|spec
|caveats=* This call must be made by the script containing the [[http_request]] event where the '''request_id''' was received.
+
|caveats=* This call must be made by the script containing the [[http_request]] event where the {{LSLP|request_id}} was received.
* If '''body''' content greater than 2048 bytes, sent in response to [[llHTTPRequest]], will be truncated to 2048 bytes by [[http_response]] in the receiving script
+
* There is no limit, other than script size, to the amount of data that can be sent by this function.
** This limit does not apply to shared media {{HoverText|MOAP|Media On A Prim}}  
+
** [[llHTTPRequest]] can truncate the response length in ''receiving'' scripts. Be aware when using them together for prim-to-prim communications.
 +
* The response by default has <code>{{String|content-type: text/plain}}</code>. Use [[llSetContentType]] to optionally return a different type, like <code>{{String|text/html}}</code>.
 
|constants
 
|constants
 
|examples=
 
|examples=
<lsl>key url_request;
+
<source lang="lsl2">
 +
string url;
  
 
default
 
default
 
{
 
{
 +
    changed(integer change)
 +
    {
 +
        if (change & (CHANGED_REGION_START | CHANGED_REGION | CHANGED_TELEPORT))
 +
            llResetScript();
 +
    }
 +
 
     state_entry()
 
     state_entry()
 
     {
 
     {
         url_request = llRequestURL();
+
         llRequestURL();
 
     }
 
     }
 +
 +
    touch_start(integer num_detected)
 +
    {
 +
    //  PUBLIC_CHANNEL has the integer value 0
 +
        if (url != "")
 +
            llSay(PUBLIC_CHANNEL, "URL: " + url);
 +
    }
 +
 
     http_request(key id, string method, string body)
 
     http_request(key id, string method, string body)
 
     {
 
     {
         if (url_request == id)
+
    //  http://en.wikipedia.org/wiki/Create,_read,_update_and_delete
 +
        list CRUDmethods = ["GET", "POST", "PUT", "DELETE"];
 +
    //  it's bit-wise NOT ( ~ ) !!!
 +
        integer isAllowedMethod = ~llListFindList(CRUDmethods, [method]);
 +
 
 +
         if (isAllowedMethod)
 +
        {
 +
            llHTTPResponse(id, 200, "Body of request below:\n" + body);
 +
        }
 +
        else if (method == URL_REQUEST_GRANTED)
 +
        {
 +
        //  don't forget the trailing slash
 +
            url = body + "/";
 +
 
 +
            llOwnerSay("URL: " + url);
 +
        }
 +
        else if (method == URL_REQUEST_DENIED)
 
         {
 
         {
             url_request = "";
+
             llOwnerSay("Something went wrong, no URL.\n" + body);
            if (method == URL_REQUEST_GRANTED)
+
            {
+
                llSay(0,"URL: " + body);
+
            }
+
            else if (method == URL_REQUEST_DENIED)
+
            {
+
                llSay(0, "Something went wrong, no url. " + body);
+
            }
+
 
         }
 
         }
 
         else
 
         else
 
         {
 
         {
             llHTTPResponse(id, 200, body);
+
             llOwnerSay("Ummm... I have no idea what SL just did. Method=\""+method+"\"\n" + body);
 
         }
 
         }
 
     }
 
     }
}</lsl>
+
}
 +
</source>
 
|helpers
 
|helpers
 +
|also_constants=
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_TEXT}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_HTML}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_XML}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_XHTML}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_ATOM}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_JSON}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_LLSD}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_FORM}}|3={{#var:comment}}}}
 +
{{LSL DefineRow|1=|2={{LSL Const|CONTENT_TYPE_RSS}}|3={{#var:comment}}}}
 
|also_functions=
 
|also_functions=
 
{{LSL DefineRow||[[llGetFreeURLs]]}}
 
{{LSL DefineRow||[[llGetFreeURLs]]}}
Line 49: Line 85:
 
{{LSL DefineRow||[[llReleaseURL]]}}
 
{{LSL DefineRow||[[llReleaseURL]]}}
 
{{LSL DefineRow||[[llGetHTTPHeader]]}}
 
{{LSL DefineRow||[[llGetHTTPHeader]]}}
 +
{{LSL DefineRow||[[llSetContentType]]}}
 
|also_tests
 
|also_tests
 
|also_events=
 
|also_events=
 
{{LSL DefineRow||[[http_request]]}}
 
{{LSL DefineRow||[[http_request]]}}
 +
{{LSL DefineRow||[[http_response]]}}
 
|also_articles=
 
|also_articles=
 
{{LSL DefineRow||[[LSL http server]]}}
 
{{LSL DefineRow||[[LSL http server]]}}

Latest revision as of 10:30, 22 January 2015

Summary

Function: llHTTPResponse( key request_id, integer status, string body );

Responds to request_id with status and body.

• key request_id A valid HTTP request key.
• integer status HTTP Status (200, 400, 404, etc)
• string body Contents of the response.

The response need not be made inside the http_request event but if it does not happen in a timely fashion the request will time out (within 25 seconds).

Caveats

  • This call must be made by the script containing the http_request event where the request_id was received.
  • There is no limit, other than script size, to the amount of data that can be sent by this function.
    • llHTTPRequest can truncate the response length in receiving scripts. Be aware when using them together for prim-to-prim communications.
  • The response by default has "content-type: text/plain". Use llSetContentType to optionally return a different type, like "text/html".
All Issues ~ Search JIRA for related Bugs

Examples

string url;
 
default
{
    changed(integer change)
    {
        if (change & (CHANGED_REGION_START | CHANGED_REGION | CHANGED_TELEPORT))
            llResetScript();
    }
 
    state_entry()
    {
        llRequestURL();
    }
 
    touch_start(integer num_detected)
    {
    //  PUBLIC_CHANNEL has the integer value 0
        if (url != "")
            llSay(PUBLIC_CHANNEL, "URL: " + url);
    }
 
    http_request(key id, string method, string body)
    {
    //  http://en.wikipedia.org/wiki/Create,_read,_update_and_delete
        list CRUDmethods = ["GET", "POST", "PUT", "DELETE"];
    //  it's bit-wise NOT ( ~ ) !!!
        integer isAllowedMethod = ~llListFindList(CRUDmethods, [method]);
 
        if (isAllowedMethod)
        {
            llHTTPResponse(id, 200, "Body of request below:\n" + body);
        }
        else if (method == URL_REQUEST_GRANTED)
        {
        //  don't forget the trailing slash
            url = body + "/";
 
            llOwnerSay("URL: " + url);
        }
        else if (method == URL_REQUEST_DENIED)
        {
            llOwnerSay("Something went wrong, no URL.\n" + body);
        }
        else
        {
            llOwnerSay("Ummm... I have no idea what SL just did. Method=\""+method+"\"\n" + body);
        }
    }
}

Deep Notes

History

All Issues

~ Search JIRA for related Issues
   llHTTPImageResponse() - function for sending image data as a response to an HTTP request

Signature

function void llHTTPResponse( key request_id, integer status, string body );