După citirea acestui articol vei obține:
- O înțelegere completă a serviciilor web și a scopului lor
- O lista a beneficiilor și tehnologiile de bază (arhitectura REST, protocolul de mesaje SOAP).
Indiferent dacă ești nou în domeniul serviciilor web sau vrei să-ți extinzi cunoștințele, acest ghid te va echipa cu informațiile necesare pentru a începe.
Ce sunt serviciile web?
Odată cu evoluția internetului, a apărut și conceptul de serviciu web. Un serviciu web constă într-o colecție de operațiuni accesibile prin rețea și protocolul HTTP. Odată ce devin disponibile public sau printr-o listă de acces, beneficiile sunt accesibile de către una sau mai multe aplicații.
Acesta asigură comunicarea între diferite aplicații software care pot rula pe platforme diferite. În cazurile generale, reprezintă interfața web către o bază de date. Serviciile web moderne suportă atât funcționalități sincrone, cât și asincrone.
Conceptul REST
Este un stil arhitectural simplu, bazat pe standardele Web și HTTP, care a devenit chiar mai utilizat decât modelul SOAP.
Există cinci metode principale HTTP utilizate pentru definirea operațiunilor unui serviciu web RESTful:
- POST – crearea unui resurs;
- PUT – actualizarea stării unei resurse;
- PATCH – actualizare parțială a resursei;
- GET – citirea / returnarea unei resurse fără a o modifica;
- DELETE – ștergerea unei resurse.
Resursele pot fi reprezentate în mai multe formate: JSON sau XML.
Serviciile Web sunt o arhitectură scalabilă deoarece separă responsabilitățile aplicației client de cele ale serverului. Este un model fără stare deoarece serverul nu păstrează starea clientului.
Serviciile Web sunt adesea folosite cu un sistem de caching pentru entitățile care nu suferă modificări semnificative. Acest lucru duce la o creștere a vitezei de răspuns a serviciului web.
Exemplu de mesaj JSON:
{
“first_name”: ”Ioan”,
“last_name”: ”Pop”,
“age”: 32,
“benefits”: [“scalabilitate”, “interoperabilitate”, “distribuție”],
“address”: {
“city”: ”Baia Mare”,
“street”: “Mihai Eminescu”,
“number”: 23
}
}
Despre SOAP
SOAP a fost primul protocol pentru conectarea la serviciile web SOA (Service Oriented Architecture). SOAP este construit pe specificația XML și folosește HTTP pentru transport.
Un mesaj SOAP este definit ca o structură de antet și un element de corp. Antetul poate conține informații de autentificare sau definiția tipurilor complexe de date. Elementul de corp descrie metodele web și informațiile despre parametrii acestora.
Envelope SOAP:
<soap:Envelope xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance>
<soap:Body>
<AWeserviceResponse xmls=http://tempuri.org/>
<AWebServiceResult>string</AWebServiceResul>
<AWebserviceResponse>
<soap:Body>
</soap:Envelope>
Cele mai bune practici de dezvoltare
1. Versionare
Lansarea unei noi versiuni a serviciului web care nu este compatibilă cu versiunea anterioară necesită versionarea serviciului web și menținerea ambelor versiuni atâta timp cât clienții adoptă noua versiune.
2. Documentație
Serviciile web ar trebui să afișeze informații despre metadatele operațiunilor pe care le pot efectua. Fiecare metodă web ar trebui să fie descrisă prin metoda HTTP, URI, anteturile HTTP Accept și Content-Type, coduri posibile ale răspunsurilor HTTP, anteturi personalizate, exemplu de răspuns și exemple de corpuri de solicitare.
3. Logare
Informațiile de logare ar trebui să fie grupate în aceeași secțiune a cererii și imprimate la final pentru a facilita găsirea acestora în fișierele de log.
4. Gestionarea erorilor
Erorile trebuie raportate clientului prin coduri de stare HTTP:
- 200 Ok – Succes
- 400 – Cerere incorectă
- 401 – Neautorizat
- 403 – Interzis
- 404 – Negăsit
- 405 – Metodă nepermisă
- 500 – Eroare internă de server
- 503 – Serviciu indisponibil
5. Design URI
UR-urile ar trebui să fie concise, ușor de reținut, neambigue în privința resursei gestionate și construite din substantive care descriu resursa, nu verbe care descriu acțiunea. Acțiunea este descrisă de metodele de cerere HTTP care implicite descriu tipul de acțiune realizată asupra resursei. Este mai greu să schimbi URI-urile unui serviciu web odată ce acestea sunt publicate și utilizate de clienți. URI /client/{id}/message/{msg_id}
Beneficii
Interoperabilitate
Integrarea cu serviciile web oferă o soluție viabilă atunci când lucrezi cu diferite sisteme, sisteme legate sau aplicații în alte limbaje de programare. Această problemă a fost mult discutată încă din anii 2000.
Ușurința utilizării
Serviciile web sunt construite pentru a fi accesibile prin web, la fel ca o pagină HTML accesibilă prin Internet.
Reutilizare
O aplicație client poate folosi mai multe servicii web, adăugând valoare managementului informațiilor. Prin serviciile web, poți integra aplicații diferite, în special sisteme legate.
Distribuție
Distribuirea unui serviciu web utilizând un server cu funcționalități sincrone sau asincrone este simplă. În același timp, o nouă versiune a serviciului poate fi instalată și deveni accesibilă într-un timp scurt.
Calitate
Odată construit, serviciul web este testat independent de aplicațiile client, ceea ce se face într-un timp mai scurt decât aplicațiile monolitice.
Cost
Odată ce un set de servicii web este expus, aplicațiile client sunt dezvoltate mult mai ușor și la costuri mai mici datorită timpului mai scurt de dezvoltare și integrare.
De ce să folosești servicii web
- Pentru a oferi integrare punct-cu-punct;
- Pentru a gestiona activele legate;
- Pentru a vinde Software-as-a-Service clienților tăi;
- Pentru a oferi API-uri web pentru afacerea ta către diferite aplicații din organizația ta;
- Pentru a reduce costurile de dezvoltare.
