mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2025-02-23 21:27:14 +01:00
4a6bfc086c
Switched to POCO library for unified platform/library interface. Deprecated the external module API. It was creating more problems than solving. Removed most built-in libraries in favor of system libraries for easier maintenance. Cleaned and secured code with help from static analyzers.
140 lines
3.6 KiB
C++
140 lines
3.6 KiB
C++
//
|
|
// HTTPServerResponseImpl.h
|
|
//
|
|
// Library: Net
|
|
// Package: HTTPServer
|
|
// Module: HTTPServerResponseImpl
|
|
//
|
|
// Definition of the HTTPServerResponseImpl class.
|
|
//
|
|
// Copyright (c) 2005-2006, Applied Informatics Software Engineering GmbH.
|
|
// and Contributors.
|
|
//
|
|
// SPDX-License-Identifier: BSL-1.0
|
|
//
|
|
|
|
|
|
#ifndef Net_HTTPServerResponseImpl_INCLUDED
|
|
#define Net_HTTPServerResponseImpl_INCLUDED
|
|
|
|
|
|
#include "Poco/Net/Net.h"
|
|
#include "Poco/Net/HTTPServerResponse.h"
|
|
|
|
|
|
namespace Poco {
|
|
namespace Net {
|
|
|
|
|
|
class HTTPServerSession;
|
|
class HTTPServerRequestImpl;
|
|
|
|
|
|
class Net_API HTTPServerResponseImpl: public HTTPServerResponse
|
|
/// This subclass of HTTPServerResponse is used for
|
|
/// representing server-side HTTP responses.
|
|
///
|
|
/// A HTTPServerResponse is passed to the
|
|
/// handleRequest() method of HTTPRequestHandler.
|
|
///
|
|
/// handleRequest() must set a status code
|
|
/// and optional reason phrase, set headers
|
|
/// as necessary, and provide a message body.
|
|
{
|
|
public:
|
|
HTTPServerResponseImpl(HTTPServerSession& session);
|
|
/// Creates the HTTPServerResponseImpl.
|
|
|
|
~HTTPServerResponseImpl();
|
|
/// Destroys the HTTPServerResponseImpl.
|
|
|
|
void sendContinue();
|
|
/// Sends a 100 Continue response to the
|
|
/// client.
|
|
|
|
std::ostream& send();
|
|
/// Sends the response header to the client and
|
|
/// returns an output stream for sending the
|
|
/// response body.
|
|
///
|
|
/// The returned stream is valid until the response
|
|
/// object is destroyed.
|
|
///
|
|
/// Must not be called after sendFile(), sendBuffer()
|
|
/// or redirect() has been called.
|
|
|
|
void sendFile(const std::string& path, const std::string& mediaType);
|
|
/// Sends the response header to the client, followed
|
|
/// by the content of the given file.
|
|
///
|
|
/// Must not be called after send(), sendBuffer()
|
|
/// or redirect() has been called.
|
|
///
|
|
/// Throws a FileNotFoundException if the file
|
|
/// cannot be found, or an OpenFileException if
|
|
/// the file cannot be opened.
|
|
|
|
void sendBuffer(const void* pBuffer, std::size_t length);
|
|
/// Sends the response header to the client, followed
|
|
/// by the contents of the given buffer.
|
|
///
|
|
/// The Content-Length header of the response is set
|
|
/// to length and chunked transfer encoding is disabled.
|
|
///
|
|
/// If both the HTTP message header and body (from the
|
|
/// given buffer) fit into one single network packet, the
|
|
/// complete response can be sent in one network packet.
|
|
///
|
|
/// Must not be called after send(), sendFile()
|
|
/// or redirect() has been called.
|
|
|
|
void redirect(const std::string& uri, HTTPStatus status = HTTP_FOUND);
|
|
/// Sets the status code, which must be one of
|
|
/// HTTP_MOVED_PERMANENTLY (301), HTTP_FOUND (302),
|
|
/// or HTTP_SEE_OTHER (303),
|
|
/// and sets the "Location" header field
|
|
/// to the given URI, which according to
|
|
/// the HTTP specification, must be absolute.
|
|
///
|
|
/// Must not be called after send() has been called.
|
|
|
|
void requireAuthentication(const std::string& realm);
|
|
/// Sets the status code to 401 (Unauthorized)
|
|
/// and sets the "WWW-Authenticate" header field
|
|
/// according to the given realm.
|
|
|
|
bool sent() const;
|
|
/// Returns true if the response (header) has been sent.
|
|
|
|
protected:
|
|
void attachRequest(HTTPServerRequestImpl* pRequest);
|
|
|
|
private:
|
|
HTTPServerSession& _session;
|
|
HTTPServerRequestImpl* _pRequest;
|
|
std::ostream* _pStream;
|
|
|
|
friend class HTTPServerRequestImpl;
|
|
};
|
|
|
|
|
|
//
|
|
// inlines
|
|
//
|
|
inline bool HTTPServerResponseImpl::sent() const
|
|
{
|
|
return _pStream != 0;
|
|
}
|
|
|
|
|
|
inline void HTTPServerResponseImpl::attachRequest(HTTPServerRequestImpl* pRequest)
|
|
{
|
|
_pRequest = pRequest;
|
|
}
|
|
|
|
|
|
} } // namespace Poco::Net
|
|
|
|
|
|
#endif // Net_HTTPServerResponseImpl_INCLUDED
|