Dokumentace třídy Httpd::ControllerDepartmentEmployees

Diagram dědičnosti pro třídu Httpd::ControllerDepartmentEmployees:

Veřejné metody
	ControllerDepartmentEmployees (HobrasoftHttpd::HttpConnection *parent)
Veřejné metody dědí se z Httpd::AbstractController
	AbstractController (HobrasoftHttpd::HttpConnection *parent)
	Konstruktor.
void	setCheckId (bool x)
	Nastavuje kontrolu položky ID v datech při PUT a POST.
void	setAuthorizer (RequestAuthorizer *authorizer)
AuthenticatedUser *	authenticatedUser () const
bool	checkId () const
	Vrací stav kontroly položky ID v datech při PUT a POST.
Db::Database *	db ()

Chráněné metody
void	service (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response) Q_DECL_OVERRIDE
	Obsluha požadavku.
void	serviceGet (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, int department, int employee)
void	servicePut (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, int department, const QVariantMap &data)
void	serviceDelete (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, int department, int employee)
Chráněné metody dědí se z Httpd::AbstractController
virtual bool	exists (const QString &id)
	Kontrola existence zadaného ID.
virtual bool	exists (HobrasoftHttpd::HttpRequest *request, const QString &id)
	Kontrola existence zadaného ID.
virtual void	serviceOK (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QVariant &data=QVariant())
	Pošle odpověď 200 OK.
virtual void	serviceList (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response)
	Pošle chybovou odpověď
virtual void	serviceEvents (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response)
	Pošle v odpovědi kompletní seznam všech objektů ve třídě a následně
virtual void	serviceIdEvents (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QString &id)
	Pošle v odpovědi proud událostí spojených se všemi objekty ve třídě
virtual void	serviceIdGet (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QString &id)
	Pošle odpověď na požadavek konkrétního ID metodou GET.
virtual void	serviceIdDelete (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QString &id)
	Pošle odpověď na požadavek konkrétního ID metodou DELETE - obvykle objekt smaže.
virtual void	serviceIdPut (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QVariantMap &data)
	Pošle odpověď na požadavek konkrétního ID metodou PUT - obvykle vloží nový objekt nebo přepíše existující objekt.
virtual void	serviceIdPost (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QVariantMap &data)
	Pošle odpověď na požadavek konkrétního ID metodou PUT - obvykle vloží nový objekt nebo přepíše existující objekt.
virtual void	serviceEvent (HobrasoftHttpd::HttpRequest *request, HobrasoftHttpd::HttpResponse *response, const QVariant &data)
	Pošle do otevřeného proudu událostí jednu událost.
virtual bool	isAuthorized (Security::Permissions::Permission)
HobrasoftHttpd::HttpRequest *	request () const
	Vrací ukazatel na aktuální request.
HobrasoftHttpd::HttpConnection *	connection () const
	Vrací ukazatel na aktuální connection.

Další zděděné členy
Statické chráněné metody dědí se z Httpd::AbstractController
static QVariantMap	putKey (const QVariant &key)

Detailní popis

Definice je uvedena na řádku 8 v souboru controllerdepartmentemployees.h.

Dokumentace konstruktoru a destruktoru

ControllerDepartmentEmployees()

ControllerDepartmentEmployees::ControllerDepartmentEmployees

(

HobrasoftHttpd::HttpConnection *

parent

)

Definice je uvedena na řádku 10 v souboru controllerdepartmentemployees.cpp.

    : AbstractController(parent) {}

Dokumentace členských funkcí

service()

void ControllerDepartmentEmployees::service ( HobrasoftHttpd::HttpRequest * request, HobrasoftHttpd::HttpResponse * response )

protectedvirtual

Obsluha požadavku.

Reimplementuje stejnojmenný prvek z Httpd::AbstractController.

Definice je uvedena na řádku 13 v souboru controllerdepartmentemployees.cpp.

{
    static const QRegularExpression re("^/api/v1/departments/(\\d+)/employees(?:/(\\d+))?/?$");
    auto m = re.match(request->path());
    if (!m.hasMatch()) {
        serviceError(request, response, 405, "bad-request", "Invalid request");
        return;
    }
 
    int department = m.captured(1).toInt();
    int employee = m.captured(2).isEmpty() ? -1 : m.captured(2).toInt();
 
    if (request->method() == "GET") {
        serviceGet(request, response, department, employee);
        return;
    }
 
    if (request->method() == "PUT") {
        bool ok = false;
        QVariantMap data = JSON::data(request->body(), &ok).toMap();
        if (!ok) {
            serviceError(request, response, 400, "bad-request", "Could not parse JSON data");
            return;
        }
        servicePut(request, response, department, data);
        return;
    }
 
    if (request->method() == "DELETE") {
        if (employee <= 0) {
            serviceError(request, response, 400, "bad-request", "Employee id required");
            return;
        }
        serviceDelete(request, response, department, employee);
        return;
    }
 
    serviceError(request, response, 405, "bad-request", "Invalid request");
}

serviceDelete()

void ControllerDepartmentEmployees::serviceDelete ( HobrasoftHttpd::HttpRequest * request, HobrasoftHttpd::HttpResponse * response, int department, int employee )

protected

Definice je uvedena na řádku 78 v souboru controllerdepartmentemployees.cpp.

{
    db()->remove(Dbt::DepartmentHasMember(department, employee));
    serviceOK(request, response);
}

serviceGet()

void ControllerDepartmentEmployees::serviceGet ( HobrasoftHttpd::HttpRequest * request, HobrasoftHttpd::HttpResponse * response, int department, int employee )

protected

Definice je uvedena na řádku 53 v souboru controllerdepartmentemployees.cpp.

{
    Dbt::DepartmentHasMember filter;
    filter.department = department;
    filter.employee = employee > 0 ? employee : 0;
    auto list = db()->departmentHasMember(filter);
    if (employee > 0) {
        if (list.isEmpty()) {
            serviceError(request, response, 404, "not-found", "NotFound");
            return;
        }
        serviceOK(request, response, list.first().toMap());
    } else {
        serviceOK(request, response, toList(list));
    }
}

servicePut()

void ControllerDepartmentEmployees::servicePut ( HobrasoftHttpd::HttpRequest * request, HobrasoftHttpd::HttpResponse * response, int department, const QVariantMap & data )

protected

Definice je uvedena na řádku 70 v souboru controllerdepartmentemployees.cpp.

{
    QVariantMap d = data;
    d["department"] = department;
    db()->save(Dbt::DepartmentHasMember::fromMap(d));
    serviceOK(request, response);
}

---

Dokumentace pro tuto třídu byla vygenerována z následujících souborů:

• httpd/controllerdepartmentemployees.h
• httpd/controllerdepartmentemployees.cpp