HTTP server pro C++ a Qt

2.3.2015 06:30 | Přečteno: 1668× | Počítače | | poslední úprava: 2.3.2015 06:24

V článku se popisuje jednovláknový embedded http server postavený nad knihovnou Qt. Originál článku včetně dokumentace vyšel na našem webu: Hobrasoft.cz

Poděkování

Http server, který zde popisuji, je založený na tomto projektu, autorem je Stefan Frings:
http://stefanfrings.de/qtwebapp/index-en.html.
Tímto bych rád autorovi poděkoval.

Odkazy

Koukněte se, jak to běhá
Dokumentace
Download

Proč jiný server?

Pro jeden z našich projektů jsem hledal nějaký vhodný webový server. První nápad byl samozřejmě server QtWebapp, už s ním mám většinou dobré zkušenosti z jiného projektu: Fotobot. Ale už v prvním projektu jsem narazil na některé nepříjemné vlastnosti: parametry se v mnoha místech předávají jako reference (ač reference je skoro totéž, co odkaz, není to tak docela odkaz), server je vícevláknový a počet vláken je předem daný v konfiguračním souboru. Omezení počtu vláken dělalo občas problémy už v prvním projektu, v dalším projektu se daly očekávat problémy řádově horší.

Vyzkoušeli jsme i jiný http server, ale tam jsme na vícevláknovost a omezený počet vláken narazili taky.

Aby to nevypadalo, že mám něco proti vícevláknovým aplikacím - ne tak docela. Ale Qt je knihovna hodně orientovaná na událostní zpracování, a pokud je celá aplikace řízená událostmi, je vícevláknový web server zbytečná komplikace (je nutné začít zamykat a podobně).

Lidé na internetu opisují nápady jeden od druhého. Apache jednou ukázal cestu, které se nyní lidé drží zuby nehty, a když je Apache takto úspěšný, nelze přeci udělat chybu, když se pro další servery zvolí podobné řešení. Použitelný jednovláknový server jsme nenašli.

Naštěstí jsou tady servery jako je Nginx, Lightttpd a HobrasoftHttpd.

Požadavky na server

Embedded

Spousta našich aplikací běží v prostředí malých ARM počítačů BeagleBone. Je nesmysl psát v C++ malinké rutiny pro bitové žonglování s jednotlivými vývody procesoru a pro publikaci výsledků pak použít kombajn typu Apache a PHP. I když Apache na BeagleBone samozřejmě chodí, chceme mít celé prostředí jednoduché, včetně instalace. Ideální instalace vypadá takto:

apt-get install fotobot

Nechce se mi psát sáhodlouhé návody "Apache nakonfigureje takto: 1. apt-get... 2. cd /etc/apache2/vhost.conf... 3. vi default_vhost.conf.... 99. /etc/init.d/apache restart".

Windows

Napsat podrobný návod na instalaci si dovedu představit, pokud je cílovou skupinou zkušený linuxový administrátor nebo můj vlastní zaměstanec. Ale nedovedu si představit, že bych vyráběl produkt, který by měl poskytovat nějaké informace přes HTTP rozhraní na Windows a nemohl bych použít embedded http server. Instalace na Windows spočívá v klikání na "Další... další... další..." a přes to vlak nejede.

Neomezený počet spojení

Aplikace, které poslední dobou děláme, otevírají na každé stránce hned několik spojení a nepouštějí je. Dokud je stránka v prohlížeči aktivní, je otevřené i spojení. Deset vláken je málo - s deseti vlákny zablokuje webový server už druhý uživatel. (Neomezený počet spojení mě samozřejmě přejde - hned jak mi někdo položí server

Jednovláknový

V jednovláknové aplikaci chci používat jednovláknový http server. Více vláken vede k zamykání, kód se stává složitějším a náchylnějším k chybám - jeden chybějící mutex v kritickém místě dovede klidně shodit aplikaci, v horším případě pak i vyrobit nesmysly v datech.

Řízený událostmi

Knihovna Qt je řízená událostmi. I když psaní vícevláknových aplikací je v Qt snadné, psaní aplikací řízených událostmi je snazší. Nechci se ubírat trnitými cestami, pokud existuje asfaltka.

Jak to používat

Stačí-li vám servírovat pouze statický obsah, je použití serveru ve vašem vlastním kódu takto jednoduché:

#include <QCoreApplication>
#include "httpd.h"
using namespace HobrasoftHttpd;
int main(int argc, char *argv[]) {
    QCoreApplication app(argc, argv);
    new HttpServer(0); // Server can serve static file from current directory
    return app.exec();
}

Konfigurace celého serveru je obsažená v samostatné třídě, načítá se z klasického objektu třídy QSettings. Pokud chcete použít jiný konfigurační soubor, můžete to udělat třeba takto:

    QSettings qsettings("/etc/http.conf", QSettings::IniFormat);
    HttpSettings settings(&qsettings, 0);
    new HttpServer(&settings,0);

Pokud potřebujete, aby vaše aplikace generovala obsah dynamicky, musíte rozšířit třídu HttpServer a reimplementovat metodu HttpServer::requestHandler() tak, aby vracela ukazatel na váš vlastní request mapper:

#include "httpserver.h"
#include "httprequesthandler.h"
#include "myclass.h"

using namespace HobrasoftHttpd;

class RequestMapper : public HttpRequestHandler {
    Q_OBJECT
  public:
    RequestMapper(HttpConnection *parent);
    void service(HttpRequest *request, HttpResponse *response) {
        if (request->path().startsWith("/my-function")) {
            HttpRequestHandler controller = new MyClass(connection());
            controller->service(request, response);
            return;
            }
        // call default handler - static html pages, shtml pages, images, javascript, styles...
        HttpRequestHandler::service(request, response);
        }
};

class MyHttpd : public HttpServer {
    Q_OBJECT
  public:
    Httpd(QObject *parent) : QObject(parent) { }
    // The method returns pointer to new instance of your own request mapper
    // The request mapper maps requests like "/my-function" to call your own classes
    HttpRequestHandler *requestHandler(HttpConnection *connection) {
        return new RequestMapper(connection);
        }
};

Více se dočtete v dokumentaci: http://www.hobrasoft.cz/en/httpserver/doc/

Součástí balíku ke stažení je i zdokumentovaný příklad - doporučuji prostudovat třídu AbstractController a její použití. Tato třída vám dovolí snadno implementovat velmi častou třídu úloh:

• načíst seznam objektů jedné skupiny (například seznam pokojů)
• načíst konkrétní objekt skupiny (pokoj)
• vytvořit, změnit nebo smazat objekt
• hlásit změny v konkrétním objektu nebo v celé skupině

Celá třída komunikuje přes JSON, změny se předávají přes HTML5 proudy událostí.

       

Komentáře

[ET]

nejsem programator (a neber to nikterak spatne), ale neni QT a embedded ( male ARM PC BeagleBone) protimluv?

viz. Qt is a cross-platform application and UI framework for developers using C++ or QML, a CSS & JavaScript like language. zdroj

[victor8]

Urcite nie.

Nas lokalny IPTV provider v tom ma napr. napisane komplet cele GUI jeho STB, a funguje im to :)

[luky]

QT neni jedna knihovna, ale skupina knihoven, takze to, co neni potreba (GUI atd.) se nemusi vubec instalovat.

[ET]

ok, jen mi to prislo (tak jak ja chapu QT) jako kanon na vrabce, paklize vyhovuje a lze to osekat, tak proc ne ;)

[Josef Kufner]

Ono to není o tom Qt osekat, ale o tom nepoužít modul QtGui.

Jinak velikost Qt je v rozsáhlosti, nikoliv v náročnosti. Když se podíváš na zdrojáky, kódy jednotlivých komponent jsou povětšinou celkem krátké a nenáročné, narozdíl od mnoha jiných knihoven.

[Petr Bravenec]

Qt a embedded rozhodně není protimluv.

Jak už kdosi uvedl, je Qt hodně modulární. Mám aplikace, kde vůbec nepoužívám GUI, pouze uvedený webový server. Mám jiné aplikace, které GUI mají - je zde knoflík "Spustit import" a vevnitř je webový klient postavený na webkitu a importuje data ze stránky plné javascriptu. Kdybych nahradil dnešní GUI webovým serverem a nacpal to na Beaglebone, je z toho embedded aplikace. Beaglebone to v pohodě utáhne (ale není pro to důvod, běží to na běžném PC s velikou databází za zadkem na samostatném serveru).

Qt může být hodně nenáročné a hodně usnadňuje práci. Samozřejmě na ARM-M0 to asi nepojede... ale to je zase jiná level "embedded" aplikací.

[ET]

jo diky za vysvetleni, viz vyse - tak at to slape ;)

[mirec]

Na embedded je to pomerne rýchle. Ja vyvíjam vo voľnom čase pre malé ARM dosky - ukážka virtuálnej klávesnice. Kompletný boot je pomerne rýchly (bootovať začína až od výpisu starting kernel, dovtedy je tam bootloader s nejakým timeoutom nech to môžem zastaviť a nabootovať zo siete keď niečo pokašlem). Obraz disku s meulátorom aj kompletným Qt a tonou zbytočností aby sa mi na tom dobre vyvíjalo má cca 40MB.

[vlastikroot]

QML je nejlepsi vec na embedded GUI, co jsem kdy videl. Javascript rulezz

[Rezza]

Na rozdeleni zacala delat jeste Nokia, kdy prave Qt potrebovali dostat do low end zarizeni. Takze dneska je celkem slusne modularni. Na podobne veci je Qt Network super.