Difference between revisions of "Generic application"

From Random Stuff
Jump to navigation Jump to search
 
Line 86: Line 86:
  
 
===timere===
 
===timere===
−
  api pt creare timere
+
  A se crea doua metode in clasa de baza care sa permita pornirea unui timer: one_shot/periodic, asociat cu un callback.
−
(acoperit: chrono, lambda, bind)
 
  
 
===choose an app===
 
===choose an app===

Latest revision as of 22:50, 25 August 2020

Am putea implementa o aplicatie simpla pe care sa cadem de comun acord. (ex. multiplayer snake, sudoku, ...)
In functie de progres ar trebui sa decidem daca lucram cu totii la aceeasi aplicatie in comun sau individual.
Lucru la comun ar accelera terminarea implementarii dar dezavantajul este ca nu am avea destul de multe taskuri in aceleasi arii astfel incat fiecare sa abordeze un anumit subiect. Astfel eu sunt pentru lucru individual si dezbatut solutii, deoarece cred ca notiuniile nu-s extrem de complicate, dar mai importanta e practica.


Ca si parte practica, as merge pe ideea de dezvoltare de componente intr-o aplicatie monolitica, unde o componenta contine:

  • surse
  • teste unitare folosind gtest
  • documentatie in stil doxygen, plus un Readme.md

Dat fiind ca am putea merge pe ideea de generic application, am putea implementa un mini-framework care sa ne permita sa facem debug pe aplicatie, iar mai tarziu sa alegem o tema mai precisa.


Tasks

config parser

Sa se scrie o componenta care va permite parsarea unui fisier.
- se va crea un Dockerfile care sa permita compilarea si rularea aplicatiei.
- se va testa integrarea librariei avand ca date de intrare atat un fisier valid cat si un fisier invalid folosind gtest.
- se va exemplifica citirea unui nod
A se implementa pt:
 - json
 - xml
 - yaml
(libjson, libxml, libyaml, ... sau alte librarii)

loggere

Se se defineasca/scrie un modul care permite logarea de informatii.
- functiile exportate vor trebui sa permita extragerea urmatoarelor date: 
  - fisierul si linia de unde a fost apelata functia de logare.
  - nivelul logului (verbose, info, warning, error, wtf <- what a terrible failure.  primit ca parametru)
  - timpul curent
  - modulul (string primit ca parametru)
  - un mesaj (string primit ca parametru)
  - (bonus) 
      - overload operatorul "<<" ex. sa putem scrie: Log_info(MODUL) << "Hello World nbr. " << 7;
      sau
      - variadic argument. ex. asemeni sprintf(<format>, ...)
- se va scrie o metoda prin care un consumator poate inregistra un callback
- datele extrase vor fi trimise catre consumatorii inregistrati, sau printate pe consola, daca nu exista consumatori.
Note: recomandarea este ca parametrul dat la functia de callback sa fie de tip shared_ptr
Sa se scrie un modul care consuma datele extrase de logger si le printeaza pe consola
Sa se scrie un modul care consuma datele produse de logger si le printeaza intr-un fisier atunci cand apare o eroare.
- datele primite vor fi salvate intr-un buffer circular de o dimensiune fixa.
- la aparitia mesajului de eroare bufferul va fi copiat intr-un fisier si curatat.
- configurabil:
     - dimensiunea bufferului
     - calea catre fisierul de iesire (fisierul va avea in nume: numele modulului care a generat eroarea, cat si un timestamp)
Sa se scrie un modul care consuma datele produse de logger si le printeaza in fisiere prin rotatie.
- configurabil:
     - nivelul minim al logurilor
     - numarul de fisiere
     - dimensiunea maxima pentru un fisier
     - calea catre fisierul de iesire
     - cazuri speciale: dimensiune=0, numarul de fisiere=0 => nelimitat
     - la fiecare pornire aplicatia va continua scrierea din ultimul fisier editat(verificare timestamp)
ex.
  log level minim = warning => se vor printa doar mesaje de: warning, error, wtf
  dimensiune maxima = 5MB => un fisier de log va avea maxim 5MB, o data ce dimensiunea este atinsa se va trece la un alt fisier. ex. file1.log (5MB) => trecem la file2.log. cand aceasta va fi plin, trecem la file3.log
 odata ce numarul maxim de fisiere e atins ex. 3, sarim inapoi la primul fisier si il suprascriem.

metoda initializare componente

A se defini si crea o procedura/componenta ce exemplifica prototype pattern.
Se va permite initializarea unui numar maxim predefinit de componente. (will see from the document - initializare statica obiecte)
Noile componente vor primi ca si parametru un obiect de tip json. Acest obiect se va presupune ca ar contine date de configurare
A se adapta consumatorii definiti la pasul anterior.
Resurse: http://www.cs.sjsu.edu/faculty/pearce/modules/lectures/oop/types/reflection/prototype.htm

integrare

A se defini o structura pentru un fisier de intrare care sa permita identificarea componentelor cat si a parametrilor asociati.
A se scrie o functie care parseaza structura definita anterior pornind de la prototipul din task-ul 1 - config parser - si creaza copii pt componentele identificate conform prototipului din task-ul 3 - prototype pattern -

implementarea unui dispatcher

Se vor implementa urmatoarele metode: publish(MESSAGE_ID, STRUCT)/subscribe(MESSAGE_ID, CALLBACK)
Aceste metode vor face parte dintr-o clasa de baza ce va fi mostenita de catre fiecare componenta.

Metoda subscribe ii va permite unei componente sa inregistrese un callback, asociat cu un id de mesaj.
Metoda publish va avea rolul unui dispatcher care va trimite niste date componentelor inregistrate pt un anumit id de mesaj.
A se defini o structura ce permite transmiterea de date variabile(ie. string, int, {string, string, int}. hint: map)

timere

A se crea doua metode in clasa de baza care sa permita pornirea unui timer: one_shot/periodic, asociat cu un callback.

choose an app

start dezvoltare componente folosind api-ul anterior
I. componenta ce deschide un socket si primeste comenzi pe care le transmite mai departe folosind mecanismul de la pasul 5.
(acoperit: boost:asio, rest, cgi?)
II. implementarea unor componente ce pot persista date: 1. in fisier, 2, intr-o baza de date.
(acoperit: sql)
III. componenta care sa ne permita sa citim o variabila din memorie data fiind o adresa.
(acoperit: objdump)
IV. componenta ce deschide un stream (ne putem imagina o aplicatie de remote desktop sau vizualizat un filmulet)
(acoperit: gstreamear)
V. componenta de autentificare pe baza de token
....


Vedere de ansamblu

Vom folosi prototype pattern pt a crea copii de obiecte si a putea activa dinamic diverse trasaturi suportate de aplicatia noastra fara a adauga modificari in cod. Trasaturile vor fi suportate automat fara a adauga cod explicit de initializare intr-o functie comuna, prin simpla includere a surselor in procesul de compilare.

Sa presupunem ca am avea un fisier de configurare:

{
   "logging": {
      "enabled": {"console", "error"},
      "level": DEBUG
   },
   "components" : {
       "streamer": {
          "source": "screen",
          "dest": "message",
          "dest-msg-id": "JPG_FRAME_IN"
       },
       "converter": {
          "filter": "bw",
          "source": "message",
          "src-msg-id": "JPG_FRAME_IN",
          "dst-msg-id": "JPG_FRAME_OUT"
       },
       "streamer": {
          "source": "message",
          "src-msg-id": "H264_FRAME_OUT",
          "dest": "network",
          "dest-port": 8080
       },
       "viewer": {
          "src-msg-id": "H264_FRAME_OUT"
       }
   }
 }

Chiar daca aplicatia noastra suporta mai multe componente, conform fisierului de configurare se vor activa 2 loggere("console", "error") si inca 3 componente distincte. O componenta de tip 'streamer' care conform fisierului va face o captura de ecran si o va transmite mai departe in cadrul aplicatiei prin intermediul dispatcherului, la o componenta de tip 'converter', care va aplica un filtru si va lansa un mesaj ce va fi interceptat atat de o alta componenta de tip streamer(care va transmite in retea rezultatul), cat si de o componenta de tip viewer care ar putea sa-i afiseze utilizatorului rezultatul transmis.
Exemplu e putin exagerat, dar ideea este ca ceea ce o sa faca aplicatia poate fi configurat dintr-un fisier text. Putem avea aplicatii multiple care consuma aceleasi mesaje dar fac lucruri total diferite.