Stellarium 0.15.2
List of all members | Signals | Public Member Functions | Protected Member Functions
HttpListener Class Reference

Listens for incoming TCP connections and and passes all incoming HTTP requests to your implementation of HttpRequestHandler, which processes the request and generates the response (usually a HTML document). More...

#include <httplistener.h>

+ Inheritance diagram for HttpListener:
+ Collaboration diagram for HttpListener:

Signals

void handleConnection (tSocketDescriptor socketDescriptor)
 Sent to the connection handler to process a new incoming connection. More...
 

Public Member Functions

 HttpListener (const HttpListenerSettings &settings, HttpRequestHandler *requestHandler, QObject *parent=NULL)
 Constructor. More...
 
virtual ~HttpListener ()
 Destructor. More...
 
void listen ()
 Restart listeing after close(). More...
 
void close ()
 Closes the listener, waits until all pending requests are processed, then closes the connection pool. More...
 

Protected Member Functions

void incomingConnection (tSocketDescriptor socketDescriptor)
 Serves new incoming connection requests. More...
 

Detailed Description

Listens for incoming TCP connections and and passes all incoming HTTP requests to your implementation of HttpRequestHandler, which processes the request and generates the response (usually a HTML document).

Example for the required settings in the config file:

;host=192.168.0.100
port=8080
minThreads=1
maxThreads=10
cleanupInterval=1000
readTimeout=60000
;sslKeyFile=ssl/my.key
;sslCertFile=ssl/my.cert
maxRequestSize=16000
maxMultiPartSize=1000000

The optional host parameter binds the listener to one network interface. The listener handles all network interfaces if no host is configured. The port number specifies the incoming TCP port that this listener listens to.

See also
HttpConnectionHandlerPool for description of config settings minThreads, maxThreads, cleanupInterval and ssl settings
HttpConnectionHandler for description of the readTimeout
HttpRequest for description of config settings maxRequestSize and maxMultiPartSize

Definition at line 57 of file httplistener.h.

Constructor & Destructor Documentation

HttpListener::HttpListener ( const HttpListenerSettings settings,
HttpRequestHandler requestHandler,
QObject *  parent = NULL 
)

Constructor.

Creates a connection pool and starts listening on the configured host and port.

Parameters
settingsConfiguration settings for the HTTP server. Must not be 0.
requestHandlerProcesses each received HTTP request, usually by dispatching to controller classes.
parentParent object.
Warning
Ensure to close or delete the listener before deleting the request handler.
virtual HttpListener::~HttpListener ( )
virtual

Destructor.

Member Function Documentation

void HttpListener::close ( )

Closes the listener, waits until all pending requests are processed, then closes the connection pool.

void HttpListener::handleConnection ( tSocketDescriptor  socketDescriptor)
signal

Sent to the connection handler to process a new incoming connection.

Parameters
socketDescriptorreferences the accepted connection.
void HttpListener::incomingConnection ( tSocketDescriptor  socketDescriptor)
protected

Serves new incoming connection requests.

void HttpListener::listen ( )

Restart listeing after close().


The documentation for this class was generated from the following file: