Poco::Net

class HTTPServer

Library: Net
Package: HTTPServer
Header: Poco/Net/HTTPServer.h

Description

A subclass of TCPServer that implements a full-featured multithreaded HTTP server.

A HTTPRequestHandlerFactory must be supplied. The ServerSocket must be bound and in listening state.

To configure various aspects of the server, a HTTPServerParams object can be passed to the constructor.

The server supports:

  • HTTP/1.0 and HTTP/1.1
  • automatic handling of persistent connections.
  • automatic decoding/encoding of request/response message bodies using chunked transfer encoding.

Please see the TCPServer class for information about connection and thread handling.

See RFC 2616 <http://www.faqs.org/rfcs/rfc2616.html> for more information about the HTTP protocol.

Inheritance

Direct Base Classes: TCPServer

All Base Classes: TCPServer, Poco::Runnable

Member Summary

Member Functions: stopAll

Inherited Functions: currentConnections, currentThreads, getConnectionFilter, maxConcurrentConnections, maxThreads, params, port, queuedConnections, refusedConnections, run, setConnectionFilter, socket, start, stop, threadName, totalConnections

Constructors

HTTPServer

HTTPServer(
    HTTPRequestHandlerFactory::Ptr pFactory,
    Poco::UInt16 portNumber = 80,
    HTTPServerParams::Ptr pParams = new HTTPServerParams
);

Creates HTTPServer listening on the given port (default 80).

The server takes ownership of the HTTPRequstHandlerFactory and deletes it when it's no longer needed.

New threads are taken from the default thread pool.

HTTPServer

HTTPServer(
    HTTPRequestHandlerFactory::Ptr pFactory,
    const ServerSocket & socket,
    HTTPServerParams::Ptr pParams
);

Creates the HTTPServer, using the given ServerSocket.

The server takes ownership of the HTTPRequstHandlerFactory and deletes it when it's no longer needed.

The server also takes ownership of the HTTPServerParams object.

New threads are taken from the default thread pool.

HTTPServer

HTTPServer(
    HTTPRequestHandlerFactory::Ptr pFactory,
    Poco::ThreadPool & threadPool,
    const ServerSocket & socket,
    HTTPServerParams::Ptr pParams
);

Creates the HTTPServer, using the given ServerSocket.

The server takes ownership of the HTTPRequstHandlerFactory and deletes it when it's no longer needed.

The server also takes ownership of the HTTPServerParams object.

New threads are taken from the given thread pool.

Destructor

~HTTPServer virtual

~HTTPServer();

Destroys the HTTPServer and its HTTPRequestHandlerFactory.

Member Functions

stopAll

void stopAll(
    bool abortCurrent = false
);

Stops the server. In contrast to TCPServer::stop(), which also stops the server, but allows all client connections to finish at their pace, this allows finer control over client connections.

If abortCurrent is false, all current requests are allowed to complete. If abortCurrent is true, the underlying sockets of all client connections are shut down, causing all requests to abort.