/usr/include/Wt/Http/Response is in libwt-dev 3.1.10-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 | // This may look like C code, but it's really -*- C++ -*-
/*
* Copyright (C) 2009 Emweb bvba, Kessel-Lo, Belgium.
*
* See the LICENSE file for terms of use.
*/
#ifndef HTTP_RESPONSE_H_
#define HTTP_RESPONSE_H_
#include <string>
#include <Wt/WGlobal>
#include <Wt/Http/ResponseContinuation>
#include <ostream>
namespace Wt {
class WResource;
class WebSession;
namespace Http {
/*! \class Response Wt/Http/Response Wt/Http/Response
* \brief An HTTP response.
*
* Use the HTTP response to format a response to an HTTP request (see
* Request).
*
* More specifically you can:
* - set the content mime type using setMimeType()
* - add HTTP headers using addHeader()
* - stream content into out()
*
* You may chose to provide only a partial response. In that case, use
* createContinuation() to create a continuation object to which you
* can annotate information for the next request to process the
* response further.
*
* \sa WResource::handleRequest()
*/
class WT_API Response
{
public:
/*! \brief Sets the response status.
*
* Unless a overriden, 200 OK will be assumed.
*/
void setStatus(int status);
/*! \brief Sets the content length
*
* If content length is known, use this method to set it. File downloads
* will see progress bars. If not set, Wt will use chunked transfers.
*
* Always use this method instead of setting the Content-Length header
* with addHeader().
*
* Headers may be added only before setting the content mime-type
* (setMimeType()), and before streaming any data to the out()
* stream.
*/
void setContentLength(::uint64_t length);
/*! \brief Set the content mime type.
*
* The content mimetype is used by the browser to correctly interpret
* the resource.
*/
void setMimeType(const std::string& mimeType);
/*! \brief Add an HTTP header.
*
* Headers may be added only before setting the content mime-type
* (setMimeType()), and before streaming any data to the out()
* stream.
*/
void addHeader(const std::string& name, const std::string& value);
/*! \brief Create a continuation object for this response.
*
* By creating a continuation object, a new request will be made for
* the resource to retrieve more data, after the current data has
* been sent out.
*
* \sa continuation()
*/
ResponseContinuation *createContinuation();
/*! \brief Return the continuation, if one was created for this response.
*
* Returns the continuation that was previously created using
* createContinuation(), or 0 if no continuation was created yet.
*
* \sa createContinuation()
*/
ResponseContinuation *continuation() const;
/*! \brief Returns the stream for getting the response output.
*/
std::ostream& out();
WT_BOSTREAM& bout() { return out(); }
private:
WResource *resource_;
WebResponse *response_;
ResponseContinuation *continuation_;
WT_BOSTREAM *out_;
Response(WResource *resource, WebResponse *response,
ResponseContinuation *continuation);
Response(WResource *resource, WT_BOSTREAM& out);
friend class Wt::WResource;
friend class Wt::WebSession;
};
}
}
#endif // HTTP_RESPONSE_H_
|