Stellarium  23.4
Data Structures | Typedefs | Functions
QtWebApp library

Data Structures

struct  HttpConnectionHandlerSettings
 Contains all settings for the connection handler. More...
 
class  HttpConnectionHandler
 The connection handler accepts incoming connections and dispatches incoming requests to to a request mapper. More...
 
struct  HttpConnectionHandlerPoolSettings
 Contains all settings for the connection handler pool and the child connection handlers. More...
 
class  HttpConnectionHandlerPool
 Pool of http connection handlers. More...
 
class  HttpCookie
 HTTP cookie as defined in RFC 2109. More...
 
struct  HttpListenerSettings
 Contains all settings for HttpListener and supporting classes. More...
 
class  HttpListener
 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...
 
class  HttpRequest
 This object represents a single HTTP request. More...
 
class  HttpRequestHandler
 The request handler generates a response for each HTTP request. More...
 
class  HttpResponse
 This object represents a HTTP response, used to return something to the web client. More...
 
struct  StaticFileControllerSettings
 Contains all the settings for the StaticFileController. More...
 
class  StaticFileController
 Delivers static files. More...
 
class  ITemplateTranslationProvider
 Interface for Template::translate calls. More...
 

Typedefs

typedef int tSocketDescriptor
 Alias type definition, for compatibility to different Qt versions.
 
typedef QSslConfiguration HttpSslConfiguration
 Alias for QSslConfiguration if OpenSSL is not supported.
 

Functions

DECLSPEC const char * getQtWebAppLibVersion ()
 Get the library version number.
 

Detailed Description

The QtWebApp library is developed by Stefan Frings (http://stefanfrings.de/qtwebapp/index-en.html). It is used by the Stellarium Remote Control Plug-in to provide the HTTP server that serves the plugin's API.

Some changes have been made to the library to fit it better into Stellarium. The main differences are:

Author
Stefan Frings, Florian Schaukowitsch

Data Structure Documentation

◆ HttpConnectionHandlerSettings

struct HttpConnectionHandlerSettings

Contains all settings for the connection handler.

Data Fields

int readTimeout
 Defines the maximum time to wait for a complete HTTP request in msec. More...
 
int maxRequestSize
 Maximum size of a request in bytes. More...
 
int maxMultipartSize
 Maximum size of a multipart request in bytes. More...
 

Field Documentation

◆ maxMultipartSize

int HttpConnectionHandlerSettings::maxMultipartSize

Maximum size of a multipart request in bytes.

Default 1048576 (1MB)

◆ maxRequestSize

int HttpConnectionHandlerSettings::maxRequestSize

Maximum size of a request in bytes.

Default 16384.

◆ readTimeout

int HttpConnectionHandlerSettings::readTimeout

Defines the maximum time to wait for a complete HTTP request in msec.

Default 10000.

◆ HttpConnectionHandler

class HttpConnectionHandler

The connection handler accepts incoming connections and dispatches incoming requests to to a request mapper.

Since HTTP clients can send multiple requests before waiting for the response, the incoming requests are queued and processed one after the other.

Example for the required configuration settings:

readTimeout=60000
maxRequestSize=16000
maxMultiPartSize=1000000

The readTimeout value defines the maximum time to wait for a complete HTTP request.

See also
HttpRequest for description of config settings maxRequestSize and maxMultiPartSize.

Public Slots

void handleConnection (tSocketDescriptor socketDescriptor)
 Received from from the listener, when the handler shall start processing a new connection. More...
 

Public Member Functions

 HttpConnectionHandler (const HttpConnectionHandlerSettings &settings, HttpRequestHandler *requestHandler, HttpSslConfiguration *sslConfiguration=Q_NULLPTR)
 Constructor. More...
 
virtual ~HttpConnectionHandler ()
 Destructor.
 
bool isBusy ()
 Returns true, if this handler is in use.
 
void setBusy ()
 Mark this handler as busy.
 

Constructor & Destructor Documentation

◆ HttpConnectionHandler()

HttpConnectionHandler::HttpConnectionHandler ( const HttpConnectionHandlerSettings settings,
HttpRequestHandler requestHandler,
HttpSslConfiguration sslConfiguration = Q_NULLPTR 
)

Constructor.

Parameters
settingsConfiguration settings of the HTTP webserver
requestHandlerHandler that will process each incoming HTTP request
sslConfigurationSSL (HTTPS) will be used if not Q_NULLPTR

Member Function Documentation

◆ handleConnection

void HttpConnectionHandler::handleConnection ( tSocketDescriptor  socketDescriptor)
slot

Received from from the listener, when the handler shall start processing a new connection.

Parameters
socketDescriptorreferences the accepted connection.

◆ HttpConnectionHandlerPoolSettings

struct HttpConnectionHandlerPoolSettings

Contains all settings for the connection handler pool and the child connection handlers.

Data Fields

int minThreads
 The minimal number of threads kept in the pool at all times. More...
 
int maxThreads
 The maximal number of threads. More...
 
int cleanupInterval
 The time after which inactive threads are stopped in msec. More...
 
QString sslKeyFile
 The file path to the SSL key file. More...
 
QString sslCertFile
 The file path to the SSL cert file. More...
 
- Data Fields inherited from HttpConnectionHandlerSettings
int readTimeout
 Defines the maximum time to wait for a complete HTTP request in msec. More...
 
int maxRequestSize
 Maximum size of a request in bytes. More...
 
int maxMultipartSize
 Maximum size of a multipart request in bytes. More...
 

Field Documentation

◆ cleanupInterval

int HttpConnectionHandlerPoolSettings::cleanupInterval

The time after which inactive threads are stopped in msec.

Default 1000.

◆ maxThreads

int HttpConnectionHandlerPoolSettings::maxThreads

The maximal number of threads.

If a new connection arrives when this amount of threads is already busy, the new connection will be dropped. Default 100.

◆ minThreads

int HttpConnectionHandlerPoolSettings::minThreads

The minimal number of threads kept in the pool at all times.

Default 1.

◆ sslCertFile

QString HttpConnectionHandlerPoolSettings::sslCertFile

The file path to the SSL cert file.

Default empty.

◆ sslKeyFile

QString HttpConnectionHandlerPoolSettings::sslKeyFile

The file path to the SSL key file.

Default empty.

◆ HttpConnectionHandlerPool

class HttpConnectionHandlerPool

Pool of http connection handlers.

The size of the pool grows and shrinks on demand.

Example for the required configuration settings:

minThreads=4
maxThreads=100
cleanupInterval=60000
readTimeout=60000
;sslKeyFile=ssl/my.key
;sslCertFile=ssl/my.cert
maxRequestSize=16000
maxMultiPartSize=1000000

After server start, the size of the thread pool is always 0. Threads are started on demand when requests come in. The cleanup timer reduces the number of idle threads slowly by closing one thread in each interval. But the configured minimum number of threads are kept running.

For SSL support, you need an OpenSSL certificate file and a key file. Both can be created with the command

    openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout my.key -out my.cert

Visit http://slproweb.com/products/Win32OpenSSL.html to download the Light version of OpenSSL for Windows.

Please note that a listener with SSL settings can only handle HTTPS protocol. To support both HTTP and HTTPS simultaneously, you need to start two listeners on different ports - one with SLL and one without SSL.

See also
HttpConnectionHandler for description of the readTimeout
HttpRequest for description of config settings maxRequestSize and maxMultiPartSize

Public Member Functions

 HttpConnectionHandlerPool (const HttpConnectionHandlerPoolSettings &settings, HttpRequestHandler *requestHandler)
 Constructor. More...
 
virtual ~HttpConnectionHandlerPool ()
 Destructor.
 
HttpConnectionHandlergetConnectionHandler ()
 Get a free connection handler, or 0 if not available.
 

Constructor & Destructor Documentation

◆ HttpConnectionHandlerPool()

HttpConnectionHandlerPool::HttpConnectionHandlerPool ( const HttpConnectionHandlerPoolSettings settings,
HttpRequestHandler requestHandler 
)

Constructor.

Parameters
settingsConfiguration settings for the HTTP server. Must not be 0.
requestHandlerThe handler that will process each received HTTP request.
Warning
The requestMapper gets deleted by the destructor of this pool

◆ HttpCookie

class HttpCookie

HTTP cookie as defined in RFC 2109.

This class can also parse RFC 2965 cookies, but skips fields that are not defined in RFC 2109.

Public Member Functions

 HttpCookie ()
 Creates an empty cookie.
 
 HttpCookie (const QByteArray name, const QByteArray value, const int maxAge, const QByteArray path="/", const QByteArray comment=QByteArray(), const QByteArray domain=QByteArray(), const bool secure=false)
 Create a cookie and set name/value pair. More...
 
 HttpCookie (const QByteArray source)
 Create a cookie from a string. More...
 
QByteArray toByteArray () const
 Convert this cookie to a string that may be used in a Set-Cookie header.
 
void setName (const QByteArray name)
 Set the name of this cookie.
 
void setValue (const QByteArray value)
 Set the value of this cookie.
 
void setComment (const QByteArray comment)
 Set the comment of this cookie.
 
void setDomain (const QByteArray domain)
 Set the domain of this cookie.
 
void setMaxAge (const int maxAge)
 Set the maximum age of this cookie in seconds. More...
 
void setPath (const QByteArray path)
 Set the path for that the cookie will be sent, default="/" which means the whole domain.
 
void setSecure (const bool secure)
 Set secure mode, so that the cookie will only be sent on secure connections.
 
QByteArray getName () const
 Get the name of this cookie.
 
QByteArray getValue () const
 Get the value of this cookie.
 
QByteArray getComment () const
 Get the comment of this cookie.
 
QByteArray getDomain () const
 Get the domain of this cookie.
 
int getMaxAge () const
 Set the maximum age of this cookie in seconds.
 
QByteArray getPath () const
 Set the path of this cookie.
 
bool getSecure () const
 Get the secure flag of this cookie.
 
int getVersion () const
 Returns always 1.
 

Static Public Member Functions

static QList< QByteArray > splitCSV (const QByteArray source)
 Split a string list into parts, where each part is delimited by semicolon. More...
 

Constructor & Destructor Documentation

◆ HttpCookie() [1/2]

HttpCookie::HttpCookie ( const QByteArray  name,
const QByteArray  value,
const int  maxAge,
const QByteArray  path = "/",
const QByteArray  comment = QByteArray(),
const QByteArray  domain = QByteArray(),
const bool  secure = false 
)

Create a cookie and set name/value pair.

Parameters
namename of the cookie
valuevalue of the cookie
maxAgemaximum age of the cookie in seconds. 0=discard immediately
pathPath for that the cookie will be sent, default="/" which means the whole domain
commentOptional comment, may be displayed by the web browser somewhere
domainOptional domain for that the cookie will be sent. Defaults to the current domain
secureIf true, the cookie will only be sent on secure connections

◆ HttpCookie() [2/2]

HttpCookie::HttpCookie ( const QByteArray  source)

Create a cookie from a string.

Parameters
sourceString as received in a HTTP Cookie2 header.

Member Function Documentation

◆ setMaxAge()

void HttpCookie::setMaxAge ( const int  maxAge)

Set the maximum age of this cookie in seconds.

0=discard immediately

◆ splitCSV()

static QList<QByteArray> HttpCookie::splitCSV ( const QByteArray  source)
static

Split a string list into parts, where each part is delimited by semicolon.

Semicolons within double quotes are skipped. Double quotes are removed.

◆ HttpListenerSettings

struct HttpListenerSettings

Contains all settings for HttpListener and supporting classes.

Data Fields

QString host
 The local IP address to bind to. More...
 
int port
 The HTTP port to use. More...
 
- Data Fields inherited from HttpConnectionHandlerPoolSettings
int minThreads
 The minimal number of threads kept in the pool at all times. More...
 
int maxThreads
 The maximal number of threads. More...
 
int cleanupInterval
 The time after which inactive threads are stopped in msec. More...
 
QString sslKeyFile
 The file path to the SSL key file. More...
 
QString sslCertFile
 The file path to the SSL cert file. More...
 
- Data Fields inherited from HttpConnectionHandlerSettings
int readTimeout
 Defines the maximum time to wait for a complete HTTP request in msec. More...
 
int maxRequestSize
 Maximum size of a request in bytes. More...
 
int maxMultipartSize
 Maximum size of a multipart request in bytes. More...
 

Field Documentation

◆ host

QString HttpListenerSettings::host

The local IP address to bind to.

Default empty (listen on all interfaces).

◆ port

int HttpListenerSettings::port

The HTTP port to use.

Default 8080.

◆ HttpListener

class HttpListener

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

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=Q_NULLPTR)
 Constructor. More...
 
virtual ~HttpListener ()
 Destructor.
 
void listen ()
 Restart listening after close().
 
void close ()
 Closes the listener, waits until all pending requests are processed, then closes the connection pool.
 

Protected Member Functions

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

Constructor & Destructor Documentation

◆ HttpListener()

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

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.

Member Function Documentation

◆ handleConnection

void HttpListener::handleConnection ( tSocketDescriptor  socketDescriptor)
signal

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

Parameters
socketDescriptorreferences the accepted connection.

◆ HttpRequest

class HttpRequest

This object represents a single HTTP request.

It reads the request from a TCP socket and provides getters for the individual parts of the request.

The following config settings are required:

maxRequestSize=16000
maxMultiPartSize=1000000

MaxRequestSize is the maximum size of a HTTP request. In case of multipart/form-data requests (also known as file-upload), the maximum size of the body must not exceed maxMultiPartSize. The body is always a little larger than the file itself.

Public Types

enum  RequestStatus {
  waitForRequest , waitForHeader , waitForBody , complete ,
  abort
}
 Values for getStatus()
 

Public Member Functions

 HttpRequest (const int maxRequestSize, const int maxMultiPartSize)
 Constructor. More...
 
virtual ~HttpRequest ()
 Destructor.
 
void readFromSocket (QTcpSocket *socket)
 Read the HTTP request from a socket. More...
 
RequestStatus getStatus () const
 Get the status of this request. More...
 
QByteArray getMethod () const
 Get the method of the HTTP request (e.g. More...
 
QByteArray getPath () const
 Get the decoded path of the HTPP request (e.g. More...
 
const QByteArray & getRawPath () const
 Get the raw path of the HTTP request (e.g. More...
 
QByteArray getVersion () const
 Get the version of the HTPP request (e.g. More...
 
QByteArray getHeader (const QByteArray &name) const
 Get the value of a HTTP request header. More...
 
QList< QByteArray > getHeaders (const QByteArray &name) const
 Get the values of a HTTP request header. More...
 
QMultiMap< QByteArray, QByteArray > getHeaderMap () const
 Get all HTTP request headers.
 
QByteArray getParameter (const QByteArray &name) const
 Get the value of a HTTP request parameter. More...
 
QList< QByteArray > getParameters (const QByteArray &name) const
 Get the values of a HTTP request parameter. More...
 
QMultiMap< QByteArray, QByteArray > getParameterMap () const
 Get all HTTP request parameters.
 
QByteArray getBody () const
 Get the HTTP request body. More...
 
QTemporaryFile * getUploadedFile (const QByteArray fieldName) const
 Get an uploaded file. More...
 
QByteArray getCookie (const QByteArray &name) const
 Get the value of a cookie. More...
 
QMap< QByteArray, QByteArray > & getCookieMap ()
 Get all cookies.
 
QHostAddress getPeerAddress () const
 Get the address of the connected client. More...
 

Static Public Member Functions

static QByteArray urlDecode (const QByteArray source)
 Decode an URL parameter. More...
 

Friends

class HttpSessionStore
 

Constructor & Destructor Documentation

◆ HttpRequest()

HttpRequest::HttpRequest ( const int  maxRequestSize,
const int  maxMultiPartSize 
)

Constructor.

Parameters
settingsConfiguration settings

Member Function Documentation

◆ getBody()

QByteArray HttpRequest::getBody ( ) const

Get the HTTP request body.


◆ getCookie()

QByteArray HttpRequest::getCookie ( const QByteArray &  name) const

Get the value of a cookie.

Parameters
nameName of the cookie

◆ getHeader()

QByteArray HttpRequest::getHeader ( const QByteArray &  name) const

Get the value of a HTTP request header.

Parameters
nameName of the header
Returns
If the header occurs multiple times, only the last one is returned.

◆ getHeaders()

QList<QByteArray> HttpRequest::getHeaders ( const QByteArray &  name) const

Get the values of a HTTP request header.

Parameters
nameName of the header

◆ getMethod()

QByteArray HttpRequest::getMethod ( ) const

Get the method of the HTTP request (e.g.

"GET")

◆ getParameter()

QByteArray HttpRequest::getParameter ( const QByteArray &  name) const

Get the value of a HTTP request parameter.

Parameters
nameName of the parameter
Returns
If the parameter occurs multiple times, only the last one is returned.

◆ getParameters()

QList<QByteArray> HttpRequest::getParameters ( const QByteArray &  name) const

Get the values of a HTTP request parameter.

Parameters
nameName of the parameter

◆ getPath()

QByteArray HttpRequest::getPath ( ) const

Get the decoded path of the HTPP request (e.g.

"/index.html")

◆ getPeerAddress()

QHostAddress HttpRequest::getPeerAddress ( ) const

Get the address of the connected client.

Note that multiple clients may have the same IP address, if they share an internet connection (which is very common).

◆ getRawPath()

const QByteArray& HttpRequest::getRawPath ( ) const

Get the raw path of the HTTP request (e.g.

"/file%20with%20spaces.html")

◆ getStatus()

RequestStatus HttpRequest::getStatus ( ) const

Get the status of this request.

See also
RequestStatus

◆ getUploadedFile()

QTemporaryFile* HttpRequest::getUploadedFile ( const QByteArray  fieldName) const

Get an uploaded file.

The file is already open. It will be closed and deleted by the destructor of this HttpRequest object (after processing the request).

For uploaded files, the method getParameters() returns the original fileName as provided by the calling web browser.

◆ getVersion()

QByteArray HttpRequest::getVersion ( ) const

Get the version of the HTPP request (e.g.

"HTTP/1.1")

◆ readFromSocket()

void HttpRequest::readFromSocket ( QTcpSocket *  socket)

Read the HTTP request from a socket.

This method is called by the connection handler repeatedly until the status is RequestStatus::complete or RequestStatus::abort.

Parameters
socketSource of the data

◆ urlDecode()

static QByteArray HttpRequest::urlDecode ( const QByteArray  source)
static

Decode an URL parameter.

E.g. replace "%23" by '#' and replace '+' by ' '.

Parameters
sourceThe url encoded strings
See also
QUrl::toPercentEncoding for the reverse direction

◆ HttpRequestHandler

class HttpRequestHandler

The request handler generates a response for each HTTP request.

Web Applications usually have one central request handler that maps incoming requests to several controllers (servlets) based on the requested path.

You need to override the service() method or you will always get an HTTP error 501.

Warning
Be aware that the main request handler instance must be created on the heap and that it is used by multiple threads simultaneously.
See also
StaticFileController which delivers static local files.

Public Member Functions

 HttpRequestHandler (QObject *parent=Q_NULLPTR)
 Constructor. More...
 
virtual ~HttpRequestHandler ()
 Destructor.
 
virtual void service (HttpRequest &request, HttpResponse &response)
 Generate a response for an incoming HTTP request. More...
 

Constructor & Destructor Documentation

◆ HttpRequestHandler()

HttpRequestHandler::HttpRequestHandler ( QObject *  parent = Q_NULLPTR)

Constructor.

Parameters
parentParent object.

Member Function Documentation

◆ service()

virtual void HttpRequestHandler::service ( HttpRequest request,
HttpResponse response 
)
virtual

Generate a response for an incoming HTTP request.

Parameters
requestThe received HTTP request
responseMust be used to return the response
Warning
This method must be thread safe

Reimplemented in RequestHandler, APIController, and StaticFileController.

◆ HttpResponse

class HttpResponse

This object represents a HTTP response, used to return something to the web client.

  response.setStatus(200,"OK"); // optional, because this is the default
  response.writeBody("Hello");
  response.writeBody("World!",true);

Example how to return an error:

  response.setStatus(500,"server error");
  response.write("The request cannot be processed because the servers is broken",true);

In case of large responses (e.g. file downloads), a Content-Length header should be set before calling write(). Web Browsers use that information to display a progress bar.

Public Member Functions

 HttpResponse (QTcpSocket *socket)
 Constructor. More...
 
void setHeader (QByteArray name, QByteArray value)
 Set a HTTP response header. More...
 
void setHeader (QByteArray name, int value)
 Set a HTTP response header. More...
 
bool hasHeader (const QByteArray name) const
 Returns whether this header has already been set.
 
QMap< QByteArray, QByteArray > & getHeaders ()
 Get the map of HTTP response headers.
 
QMap< QByteArray, HttpCookie > & getCookies ()
 Get the map of cookies.
 
void setStatus (int statusCode, QByteArray description=QByteArray())
 Set status code and description. More...
 
int getStatusCode () const
 Return the status code.
 
void write (QByteArray data, bool lastPart=false)
 Write body data to the socket. More...
 
bool hasSentLastPart () const
 Indicates whether the body has been sent completely (write() has been called with lastPart=true).
 
void setCookie (const HttpCookie &cookie)
 Set a cookie. More...
 
void redirect (const QByteArray &url)
 Send a redirect response to the browser. More...
 
void flush ()
 Flush the output buffer (of the underlying socket). More...
 
bool isConnected () const
 May be used to check whether the connection to the web client has been lost. More...
 

Constructor & Destructor Documentation

◆ HttpResponse()

HttpResponse::HttpResponse ( QTcpSocket *  socket)

Constructor.

Parameters
socketused to write the response

Member Function Documentation

◆ flush()

void HttpResponse::flush ( )

Flush the output buffer (of the underlying socket).

You normally don't need to call this method because flush is automatically called after HttpRequestHandler::service() returns.

◆ isConnected()

bool HttpResponse::isConnected ( ) const

May be used to check whether the connection to the web client has been lost.

This might be useful to cancel the generation of large or slow responses.

◆ redirect()

void HttpResponse::redirect ( const QByteArray &  url)

Send a redirect response to the browser.

Cannot be combined with write().

Parameters
urlDestination URL

◆ setCookie()

void HttpResponse::setCookie ( const HttpCookie cookie)

Set a cookie.

You must call this method before the first write().

◆ setHeader() [1/2]

void HttpResponse::setHeader ( QByteArray  name,
int  value 
)

Set a HTTP response header.

You must call this method before the first write().

Parameters
namename of the header
valuevalue of the header

◆ setHeader() [2/2]

void HttpResponse::setHeader ( QByteArray  name,
QByteArray  value 
)

Set a HTTP response header.

You must call this method before the first write().

Parameters
namename of the header
valuevalue of the header

◆ setStatus()

void HttpResponse::setStatus ( int  statusCode,
QByteArray  description = QByteArray() 
)

Set status code and description.

The default is 200,OK. You must call this method before the first write().

◆ write()

void HttpResponse::write ( QByteArray  data,
bool  lastPart = false 
)

Write body data to the socket.

The HTTP status line, headers and cookies are sent automatically before the body.

If the response contains only a single chunk (indicated by lastPart=true), then a Content-Length header is automatically set.

Chunked mode is automatically selected if there is no Content-Length header and also no Connection:close header.

Parameters
dataData bytes of the body
lastPartIndicates that this is the last chunk of data and flushes the output buffer.

◆ StaticFileControllerSettings

struct StaticFileControllerSettings

Contains all the settings for the StaticFileController.

Data Fields

QString path
 The path to the document root. More...
 
QString encoding
 The assumed encoding of textual files (txt, html). More...
 
int maxAge
 Maximum age of files in the browser cache (HTTP Cache-Control: max-age), in seconds. More...
 
int cacheTime
 Maximum age of files in the serverside cache (in msec). More...
 
int cacheSize
 Total serverside cache size in bytes. More...
 
int maxCachedFileSize
 Maximum size of a single file in the serverside cache. More...
 

Field Documentation

◆ cacheSize

int StaticFileControllerSettings::cacheSize

Total serverside cache size in bytes.

Default 1048576 (1MB)

◆ cacheTime

int StaticFileControllerSettings::cacheTime

Maximum age of files in the serverside cache (in msec).

Default 60000.

◆ encoding

QString StaticFileControllerSettings::encoding

The assumed encoding of textual files (txt, html).

Default UTF-8

◆ maxAge

int StaticFileControllerSettings::maxAge

Maximum age of files in the browser cache (HTTP Cache-Control: max-age), in seconds.

Default 60.

◆ maxCachedFileSize

int StaticFileControllerSettings::maxCachedFileSize

Maximum size of a single file in the serverside cache.

Default 65536 (64KB)

◆ path

QString StaticFileControllerSettings::path

The path to the document root.

Default empty (= current working directory).

◆ StaticFileController

class StaticFileController

Delivers static files.

It is usually called by the applications main request handler when the caller requests a path that is mapped to static files.

The following settings are required in the config file:

path=../docroot
encoding=UTF-8
maxAge=60000
cacheTime=60000
cacheSize=1000000
maxCachedFileSize=65536

The path is relative to the directory of the config file. In case of windows, if the settings are in the registry, the path is relative to the current working directory.

The encoding is sent to the web browser in case of text and html files.

The cache improves performance of small files when loaded from a network drive. Large files are not cached. Files are cached as long as possible, when cacheTime=0. The maxAge value (in msec!) controls the remote browsers cache.

Do not instantiate this class in each request, because this would make the file cache useless. Better create one instance during start-up and call it when the application received a related HTTP request.

Public Member Functions

 StaticFileController (const StaticFileControllerSettings &settings, QObject *parent=Q_NULLPTR)
 Constructor.
 
void service (HttpRequest &request, HttpResponse &response)
 Generates the response.
 
QString getDocRoot () const
 
- Public Member Functions inherited from HttpRequestHandler
 HttpRequestHandler (QObject *parent=Q_NULLPTR)
 Constructor. More...
 
virtual ~HttpRequestHandler ()
 Destructor.
 

Static Public Member Functions

static QByteArray getContentType (QString fileName, QString encoding)
 Returns the content type of this file. More...
 

Member Function Documentation

◆ getContentType()

static QByteArray StaticFileController::getContentType ( QString  fileName,
QString  encoding 
)
static

Returns the content type of this file.

This is currently only determined by file name.

◆ ITemplateTranslationProvider

class ITemplateTranslationProvider

Interface for Template::translate calls.

Public Member Functions

virtual QString getTranslation (const QString &key)=0
 Implement this method to provide a translated string for a given key.