{"id":2139,"date":"2025-09-11T07:34:57","date_gmt":"2025-09-11T07:34:57","guid":{"rendered":"https:\/\/vladislavkudriashev23.thkit.ee\/WP\/?page_id=2139"},"modified":"2025-09-11T07:39:27","modified_gmt":"2025-09-11T07:39:27","slug":"veebiteenused","status":"publish","type":"page","link":"https:\/\/vladislavkudriashev23.thkit.ee\/WP\/veebiteenused\/","title":{"rendered":"Veebiteenused"},"content":{"rendered":"\n

1. Veebiteenus vs API<\/h3>

<\/span><\/p>

Programmeerimisliides ehk API<\/a> on moodus, mis v\u00f5imaldab kahel rakendusel omavahel andmeid vahetada, kusjuures need rakendused v\u00f5ivad olla kirjutatud t\u00e4iesti erinevates keeltes.<\/span><\/p>


\"\"<\/div>
Joonis 1: API<\/a> kasutamine on nagu kaks rakendust vestleksid omavahel s\u00f5numirakenduses<\/em>


<\/div>

Veebiteenus<\/strong> on selline API<\/a>, mis kasutab HTTP protokolli<\/strong> nagu veebiserveridki (Apache, Nginx) brauseritega suheldes (Firefox, Google Chrome), mist\u00f5ttu saab neid ka brauseriga m\u00f5ningasel m\u00e4\u00e4ral (ainult GET p\u00e4ringute osas) kasutada.<\/p>

K\u00f5ik veebiteenused on API<\/a>-d, aga k\u00f5ik API<\/a>-d ei ole veebiteenused. N\u00e4iteks on olemas Windows API<\/a>, mida k\u00f5ik Windowsi t\u00f6\u00f6lauarakendused kasutavad ja mis v\u00f5imaldab neil kasutada operatsioonis\u00fcsteemi sisse ehitatud funktsionaalsust, n\u00e4iteks paluda operatsioonis\u00fcsteemil kuvada kasutajale mingi teade. Ja riistvaraga suhtlemiseks on eraldi API<\/a>-d (OpenGL<\/a>, Metal<\/a>, Direct3D<\/a>).<\/p>

Kaks k\u00f5ige levinumat viisi veebiteenuse tegemiseks on SOAP<\/a> ja REST<\/a>.<\/strong><\/p>

Mis on nende erinevus? SOAP<\/a> on standard<\/strong>, mis kirjeldab s\u00f5numite vormingut, mida veebiteenus ja selle klient \u00fcksteisega vahetavad. REST<\/a> on aga kogumik<\/strong> mittekohustuslikke soovitusi<\/strong> (best practices<\/em>), kuidas h\u00e4stik\u00e4ituvad rakendused v\u00f5iksid<\/em> andmeid \u00fcle veebi (see t\u00e4hendab kasutades HTTP protokolli) vahetada ja igal veebiteenuse ehitajal on RESTist oma spetsiifiline n\u00e4gemus, kuigi suures osas nad kattuvad.<\/p>

J\u00e4rgnevalt vaatleme kumbagi l\u00e4hemalt.<\/p>

<\/p><\/div><\/div>\n\n\n\n

2. SOAP<\/h3>

<\/span><\/span><\/p>

SOAP<\/a> (l\u00fchend on tuletatud fraasist Simple Object Access Protocol<\/em>, kuid versioonist 1.2 on \u00f6eldud, et SOAP<\/a> ole enam akron\u00fc\u00fcm, vaid lihtsalt nimi) on natuke vanem veebiteenuste loomise viis, mis leidis varem laialdast kasutust. SOAP<\/a> on v\u00e4ga ulatuslik, kuid keeruline standardite kogum. Nimelt Microsofti meeskond, kes kavandas SOAPi, tegi selle \u00e4\u00e4rmiselt paindlikuks, et see v\u00f5imaldaks suhtlemist nii privaatv\u00f5rkudes, internetis kui ka isegi elektronposti vahendusel. <\/p>

UDDI ja WSDL<\/h4>

SOAP<\/a>-i esialgne versioon oli osa spetsifikatsioonist, mis sisaldas ka Universal Description, Discovery and Integration (UDDI) nimelist standardit, mis oli m\u00f5eldud SOAP<\/a> teenuste leidmiseks ja Web Services Description Language (WSDL), mis oli m\u00f5eldud SOAP<\/a> teenuste dokumentatsiooniks. UDDI ei levinud nii laialdaselt kui selle loojad lootsid ja 2006. aasta jaanuaris teatasid IBM, Microsoft ja SAP, et nad sulgevad oma avalikud UDDI serverid. 2007. aasta l\u00f5pus sulges ka UDDI-d m\u00e4\u00e4ratlev r\u00fchm oma uksed ehk UDDI-t enam edasi ei arendatud ja 2010. aasta septembris teatas Microsoft, et nad eemaldavad UDDI teenused Windows Serveri operatsioonis\u00fcsteemi tulevastest versioonidest.<\/p>

SOAP<\/a> s\u00e4testab sisuliselt \u00fcmbriku ehk XML<\/a> struktuuri veebiteenustega andmede vahetamiseks. Arhitektuur ise on loodud selleks, et aidata kaasa erinevate operatsioonide sooritamisele tarkvaraprogrammide vahel. Programmide vaheline suhtlus toimub tavaliselt XML<\/a>-p\u00f5histe p\u00e4ringute ja HTTP-p\u00f5histe vastuste kaudu. Enamasti kasutatakse HTTP suhtlusprotokolli, kuid v\u00f5ib kasutada ka muid protokolle.<\/p>

SOAP<\/a>-s\u00f5num sisaldab m\u00f5ningaid kohustuslikke osi, nagu ENVELOPE, HEADER, BODY ja FAULT. ENVELOPE objekt m\u00e4\u00e4ratleb XML<\/a>-s\u00f5numi taotluse alguse ja l\u00f5pu, HEADER sisaldab k\u00f5iki serveri poolt t\u00f6\u00f6deldavaid p\u00e4iseelemente ja BODY sisaldab \u00fclej\u00e4\u00e4nud XML<\/a>-objekti, mis moodustab taotluse. FAULT-objekti kasutatakse vigade k\u00e4sitlemiseks.<\/span><\/p>

<\/p><\/div><\/div>\n\n\n\n

3. REST<\/h3>

<\/span><\/p>

REST<\/a>-i (Representational State Transfer<\/em>) on tavaliselt nimetatud pigem veebiteenuste arhitektuuristiiliks kui protokolliks v\u00f5i standardiks. See tuleneb sellest, et REST<\/a> ei m\u00e4\u00e4ratle s\u00f5numi sisu, vaid ainult teatud tingimusi, millele eeskujulik veebiteenus, mida on lihtne ja mugav kasutada, peaks vastama. Ka REST<\/a> v\u00f5imaldab suhtlust kahe tarkvaraprogrammi vahel: \u00fcks programm saab teiselt programmilt ressursse taotleda ja nendega manipuleerida. REST<\/a> on \u00fcles ehitatud HTTP-protokollile, kasutades URL-ile sarnaseid viiteid ressurssidele, mida nimetatakse URI-deks (Uniform Resource Identifier<\/em>) ja HTTP verbe nagu GET, POST, PUT<\/a> ja DELETE, mis n\u00e4itavad, millist tegevust klient ressursiga soovib teha. REST<\/a> kasutab andmete edastamiseks kodeerimisformaate nagu XML<\/a>, HTML v\u00f5i JSON<\/a>. K\u00f5ige eelistatum on JSON<\/a>, kuna see on k\u00f5ige \u00fchilduvam ja lihtsamini kasutatav. <\/p>

REST<\/a> on v\u00e4ga arendajas\u00f5bralik, sest selle kasutamine on palju lihtsam kui SOAP<\/a>. Lisaks on REST<\/a> v\u00e4hem s\u00f5narikkam ja kahe l\u00f5pp-punkti vahelisel suhtlemisel saadetakse v\u00e4hem andmemahtu. REST<\/a> lahendas SOAPi keerukuse probleemid ja n\u00fc\u00fcd on praktiliselt k\u00f5ik avalikud API<\/a>-d REST<\/a> API<\/a>-d.<\/p>

\"\"
<\/p>

REST<\/a> veebiteenusega saab suhelda kasutades HTTP protokolli. Antud joonisel esitab REST<\/a> veebiteenus k\u00fcsitud andmete hetkeoleku JSON<\/a> formaadis.<\/p>

<\/p><\/div><\/div>\n\n\n\n

4. Mida t\u00e4hendab RESTful?<\/h3>

Enamik API<\/a><\/strong>-sid maailmas on RESTful<\/strong>, mis t\u00e4hendab, et nad j\u00e4rgivad suures osas teatud reeglite v\u00f5i \u00f5ieti piirangute kogumit, mida tuntakse kui Representational State Transfer<\/em> ehk REST<\/a><\/strong>, mis on alates 2000. aastate algusest olnud de facto<\/em> standard API<\/a><\/strong>-de arendamisel. De facto<\/em> sellep\u00e4rast, et ametlikult ei ole REST<\/a><\/strong> standard, vaid Roy Fieldingu poolt doktorikraadi v\u00e4itekirjas kirja pandud parimate praktikate kirjeldus, millele on aegade jooksul lisandunud ka teisi h\u00e4id tavasid.<\/span><\/p><\/div><\/div>\n\n\n\n

5. Kuidas valida SOAPi ja REST-i vahel?<\/h3>

<\/span><\/p>

<\/strong><\/p>

<\/p>

SOAP<\/a><\/strong>i ja REST<\/a><\/strong>i vahel tuleb valida vastavalt projekti n\u00f5uetele. M\u00f5nedel programmeerimiskeeltel (nt Java) on v\u00e4ga hea SOAP<\/a><\/strong> tugi ja selle kasutuselev\u00f5tt on lihtne. Muus keeles pole see nii lihtne (nt Javascriptis pole keelde sisse ehitatud tuge ja tuleb kasutada v\u00e4liseid teeke, mis on kohmakas). Samuti on REST<\/a><\/strong> v\u00e4ga palju rohkem levinud ja suvalisel arendajal on suure t\u00f5en\u00e4osusega REST<\/a><\/strong>ist mingisugune arusaam juba olemas, mist\u00f5ttu on \u00fcldjuhul REST<\/a><\/strong> parem valik.
V\u00f5rreldes REST<\/a><\/strong>iga on SOAP<\/a><\/strong> kindlasti keerulisem ja kasutab rohkem andmemahtu, aga SOAP<\/a><\/strong> pakub ka eeliseid: 
<\/p>