responses.md

HTTP Responses

• Creating Responses
  • Attaching Headers To Responses
  • Attaching Cookies To Responses
  • JSON Responses
  • STRING Responses
  • HTML Responses

Creating Responses

Returning a full Response instance allows you to customize the response's HTTP status code and headers.

Attaching Headers To Responses

Keep in mind that most response methods are chainable, allowing for the fluent construction of response instances. For example, you may use the header method to add a series of headers to the response before sending it back to the user:

@Action
Response myaction5()
{
    // chained access
    response.html("<h1>show profile </h1>")
    .setHeader("X-Custom-Info", "hello world");

    return response;
}

Attaching Cookies To Responses

The cookie method on response instances allows you to easily attach cookies to the response. For example, you may use the cookie method to generate a cookie and fluently attach it to the response instance like so:

@Action
Response myaction5()
{
    // chained access
    response.html("<h1>show profile </h1>")
    .setCookie("name", "value", 10000)
    .setCookie("name1", "value", 10000, "/path")
    .setCookie("name2", "value", 10000)

    return response;
}

JSON Responses

The json method will automatically set the Content-Type header to application/json, as well as convert the given array to JSON using the json_encode ：

@Action
Response myaction1()
{
    auto user = new User;
    user.id = 9;
    user.name = "zoujiaqing";

    return new JsonResponse(user); // respond to a json object
}

String Responses

The framework will automatically convert the string into a full HTTP response:

@Action
Response myaction3()
{
    return response.plain("just text"); // return string text
}

Html Responses

The framework will automatically convert the html into a full HTTP response:

@Action
Response myaction4()
{
    return response.html("<h1>show profile </h1>"); // return html
}