antaŭparolo – Ĉi tiu afiŝo estas parto de la SAP ABAP OData Tutorial serio.

Enkonduko

En nia antaŭa artikolo ni diskutis, kio estas API. Estas malsamaj specoj de API-vokoj ekz. Simpla Objekta Aliro-Protokolo (SOAP), Remote Procedure Call (RPC) kaj Representational State Transfer (REST). Ĉiuj ĉi tiuj API-vokoj havas la saman celon, tio estas transdoni datumojn sekure inter du aŭ pli da sistemoj. En ĉi tiu artikolo ni nur esploros la Restful Retajn Servojn.

Kio estas REST

Kiel dirite antaŭe, REST signifas Representational State Transfer. Ĝi estas simpla maniero sendi kaj ricevi datumojn inter kliento kaj servilo. Ĝi ne postulas ajnan programaron aŭ normojn por transdoni datumojn. Ĝi havas antaŭdifinitan strukturon por fari la API-vokon. Programistoj nur bezonas uzi la antaŭdifinitan manieron kaj transdoni siajn datumojn kiel JSON-utilan ŝarĝon.

Atributoj de Restful Web Services

RESTful retservo havas jenajn ses limojn/atributojn:

1. Kliento-Servilo: Ĝi estas tre grava aspekto de REST-APIoj. REST-API sekvas klient-servilan arkitekturon kaj ĉi tiuj ambaŭ devus esti apartaj. Ĝi signifas kaj la servilo kaj la kliento ne povas esti sama servilo. Se ĝi estas sama, vi ricevos CORS-eraron.
2. Sennacia: En REST, ĉiuj vokoj estas traktataj kiel nova voko kaj ajna antaŭa voka stato ne donos ajnan avantaĝon al la nova voko. Tial dum ĉiu voko, necesas konservi ĉiujn necesajn aŭtentikaĵojn kaj aliajn informojn.
3. Kaŝmemoro: REST API instigas la retumilon kaj servilan kaŝmemorprocezon por plibonigi ĝian pretigan rapidecon.
4. Uniforma Interfaco: La interfaco inter la Kliento kaj Servilo restas unuforma, tial ajnaj ŝanĝoj en ambaŭ flankoj ne influos la API-funkciecon. Ĉi tiu helpo en disvolviĝo de Kliento kaj Servilo sistemo sendepende.
5. Tavoligita Sistemo: REST permesas uzadon de tavoligita strukturo en servilo te vi povas havi datumojn sur malsama servilo, aŭtentikigon sur malsama servilo dum la API sur malsama servilo. La kliento neniam ekscios, ke ĝi ricevas la datumojn de kiu servilo.
6. Kodo laŭ Postulo: Ĝi estas laŭvola trajto de REST API kie servilo eĉ povas sendi ruleblan kodon al la kliento, kiu povas funkcii rekte dum rultempo.

Metodoj en Restful Web Services

Uzante Restful-retservojn, ni povas plenumi ĉi tiujn bazajn kvar operaciojn:

1. GET: Ĉi tiu metodo estas uzata por akiri liston de datumoj de servilo.
2. POST: Ĉi tiu metodo estas uzata por afiŝi/krei novan rekordon en servilo.
3. PUT: Ĉi tiu metodo estas uzata por ĝisdatigi ekzistantan registron de servilo.
4. FORIGI: Ĉi tiu metodo estas uzata por forigi rekordon ĉe servilo.

Noto: Nur voki la ĉi-supran metodon ne garantias, ke la operacioj estos faritaj ĝis ĉi tiuj operacioj ankaŭ estas efektivigitaj ĉe la servilo.

Avantaĝoj de Restful Web Services

Jen la ĉefaj avantaĝoj de RESTful API:

• Ili estas pli simplaj kaj flekseblaj por efektivigi
• Ĝi subtenas pli grandan varion de datumformatoj ekz. JSON, XML, YAML, ktp.
• Ĝi estas pli rapida kaj provizas pli bonan rendimenton

Malavantaĝoj de Restful Retaj Servoj

Kvankam REST-servoj tendencas disponigi plurajn avantaĝojn, tamen ĝi donis demeritojn:

• Por efektivigi ŝtatrilatan demandon la REST-Titoloj estas bezonataj, kio estas mallerta laboro
• La operacioj PUT kaj DELETE ne estas uzeblaj per fajroŝirmiloj aŭ en iuj retumiloj.