REST के माध्यम से वेब सेवा अंतर

आधुनिक वेब सेवाओं को विकसित करते समय, सवाल अक्सर उठता है कि कई विषम प्रणालियों की एक सरल और पारदर्शी बातचीत कैसे प्रदान की जाए। सौभाग्य से, चुनाव विस्तृत है: यहाँ SOAP , CORBA , DCE / RPC हैं , और निश्चित रूप से, REST । इसके आधार पर एक क्रॉस-प्लेटफॉर्म एपीआई के निर्माण पर चर्चा की जाएगी।

क्यों करते हैं?

वास्तव में, क्यों "बगीचे की बाड़" और विषम प्रणालियों का उपयोग करें यदि आप एक बार एक उपकरण चुन सकते हैं - या तो पर्ल (अपनी पसंद के लिए एक ढांचा) या रेल, और उस पर सब कुछ करें? उसी कारण से हम स्लेटेड स्क्रू के लिए स्लेटेड स्क्रूड्राइवर का उपयोग करते हैं, और फिलिप्स स्क्रू के लिए फिलिप्स पेचकश, और इसके विपरीत नहीं (यह संभव है, निश्चित रूप से, लेकिन यह प्रभावी नहीं है)। प्रत्येक उपकरण कार्यों के एक विशेष सेट के लिए बेहतर अनुकूल है।

मान लीजिए हमारे पास एक वेब सेवा है जो दूरस्थ रूप से स्थापित एजेंटों का उपयोग करके कुछ जानकारी एकत्र करती है। मान लीजिए कि यह एक बॉटनेट नहीं है (और वे अब अलग तरह से काम करते हैं), लेकिन YouTube जैसे ऑनलाइन संसाधनों से वीडियो सामग्री डाउनलोड करने के लिए एक प्रणाली।

चैनल हमेशा अच्छे नहीं होते हैं, और ऑपरेटर कभी-कभी थ्रॉटलिंग करते हैं। लेकिन तेज गति से नियमित HTTP / FTP के माध्यम से तैयार फाइलों को डाउनलोड करने के लिए "एजेंटों" को कार्य देना अच्छा है।

यही कारण है कि, सादगी और सुविधा के लिए, मुख्य वेब सेवा रेल पर विकसित करने के लिए समझ में आता है, और एजेंटों को बहुत "पतली" भाषा में बनाता है, जो लगभग सभी यूनिक्स और कुछ विंडोज सर्वरों पर उपलब्ध है: पर्ल।

क्या करें?

जैसा कि मैंने लेख की शुरुआत में उल्लेख किया है, सेवाओं के बीच एपीआई को लागू करने के लिए अब कई प्रोटोकॉल हैं। इस मामले में पहले, मैंने सोचा नहीं था, और क्लासिक SOAP (अनिवार्य रूप से: XML + HTTP) का उपयोग किया। सौभाग्य से, पर्ल और रेल दोनों के लिए अच्छे कार्यान्वयन उपकरण हैं।

लेकिन अब RESTful API अधिक से अधिक लोकप्रियता प्राप्त कर रहा है, और अच्छे कारण के लिए। इसके लिए किसी भी योजना, परिभाषा, अतिरिक्त डब्लूएसडीएल फ़ाइलों और अन्य कठिनाइयों की आवश्यकता नहीं है। इसी URI के संयोजन में HTTP कमांड (GET, PUT, POST, DELETE) का उपयोग करने का सार है। कमांड और यूआरआई के आधार पर, एक कार्रवाई की जाती है। प्रतिक्रिया उसी HTTP प्रतिसाद का उपयोग करके आती है। अधिक विवरण, संकेतों और उदाहरणों के साथ, यहां पाया जा सकता है ।

हमारे उदाहरण में, पर्ल सर्वर के रूप में कार्य करेगा, और ग्राहक के रूप में रेल करेगा।
तो, क्या लागू करने के साथ?

पर्ल पक्ष

पर्ल, बिना मॉड्यूल के, बहुत सीमित उपकरण है। इसलिए, अपनी सभी शक्ति और सुविधा का उपयोग करने के लिए, हमें Mojolicious मॉड्यूल की आवश्यकता है, जो खुद को "पर्ल प्रोग्रामिंग भाषा के लिए एक अगली पीढ़ी के वेब फ्रेमवर्क" के रूप में स्थान दे।

इसके आधार पर, आप एक RESTful सर्वर और RESTful क्लाइंट दोनों बना सकते हैं।

रेल की तरफ

हाल तक तक, रेल में थर्ड-पार्टी सेवाओं के साथ REST इंटरैक्शन के लिए एक सामान्य तंत्र नहीं था, इस तथ्य के बावजूद कि यह विचारधारा सिर से पैर तक की रूपरेखा को अनुमति देती है। इसलिए, विभिन्न GEMs को इस समस्या को अलग-अलग सफलता की डिग्री के साथ हल करने के लिए बनाया गया था।

सौभाग्य से, अब आप बिल्ट-इन रेल तंत्र का उपयोग कर सकते हैं, अर्थात् ActiveResource वर्ग, जो आपको ActiveRecord के समान दूरस्थ सेवा के साथ काम करने की अनुमति देता है।

कैसे करें?

पर्ल पक्ष

मान लें कि हमारे पास पर्ल पक्ष पर कई डाउनलोड ऑब्जेक्ट हैं, और रेल की तरफ हम उनके साथ निम्नलिखित करना चाहते हैं:

• बनाने
• प्राप्त
• परिवर्तन
• निकालें

Mojolicious का उपयोग करना , हमारे कार्य के लिए एक RESTful वेब सेवा बनाना बहुत आसान है:

#!/usr/bin/perl -w use Mojolicious::Lite; #      #     /  #   : URI     my $downloads = []; foreach my $id (0..10) { $downloads->[$id] = { 'id' => $id, 'uri' => "http://site.com/download_$id", 'name' => "Video $id", 'size' => (int(rand(10000)) + 1) * 1024 }; } #    - #  (create) post '/downloads/' => sub { my $self = shift; #    Rails    JSON # ,    my $params = Mojo::JSON->decode($self->req->body)->{'download'}; #      id  #      my $id = $#{ $downloads } + 1; my $uri = $params->{'uri'} || 'http://localhost/video.mp4'; my $name = $params->{'name'} || "Video $id"; my $size = $params->{'size'} || (int(rand(10000)) + 1) * 1024; $downloads->[$id] = { 'id' => $id, 'uri' => $uri, 'name' => $name, 'size' => $size }; #       $self->render_json($downloads->[$id]); }; #    (index) get '/downloads' => sub { my $self = shift; $self->render_json($downloads); }; #      (find/show) get '/downloads/:id' => sub { my $self = shift; my $id = $self->param('id'); if (!exists($downloads->[$id])) { #     - 404 $self->render_not_found; } else { #  -   $self->render_json($downloads->[$id]); } }; #  (update) put '/downloads/:id' => sub { my $self = shift; my $params = Mojo::JSON->decode($self->req->body)->{'download'}; my $id = $self->param('id'); my $uri = $params->{'uri'} || 'http://localhost/video.mp4'; my $name = $params->{'name'} || "Video $id"; my $size = $params->{'size'} || (int(rand(10000)) + 1) * 1024; if (!exists($downloads->[$id])) { $self->render_not_found; } else { $downloads->[$id] = { 'id' => $id, 'uri' => $uri, 'name' => $name, 'size' => $size }; $self->render_json($downloads->[$id]); } }; #  (delete) del '/downloads/:id' => sub { my $self = shift; my $id = $self->param('id'); if (!exists($downloads->[$id])) { $self->render_not_found; } else { delete $downloads->[$id]; #  HTTP 200 OK -    $self->rendered; } }; #    -   post '/downloads/:id/start' => sub { my $self = shift; my $id = $self->param('id'); if (!exists($downloads->[$id])) { $self->render_not_found; } else { $self->rendered; } }; #    app->start; 

हम सेवा शुरू करते हैं। हम पोर्ट 3001 का उपयोग करते हैं, क्योंकि मानक 3000 आपके रेल स्थापना के साथ संघर्ष की संभावना है:

 ./restful-server.pl daemon --listen=http://*:3001 

रेल की तरफ

इस उदाहरण के भाग के रूप में, हमारे RESTful पर्ल सर्वर के साथ ActiveResource वर्ग की कार्यक्षमता की जांच करने के लिए सभी रेल कम हो जाएंगे।

वांछित वर्ग बनाएं:

 class Download < ActiveResource::Base #  Perl- self.site = 'http://localhost:3001' end 

अब हम इस वर्ग के साथ रेल के लिए सामान्य क्रिया कर सकते हैं।

सभी ऑब्जेक्ट खोजें:

 > Download.find(:all) => [#<Download:0x00000004b77060 @attributes={"name"=>"Video 0", "id"=>"0", "size"=>7654400, "uri"=>"http://site.com/download_0"}, @prefix_options={}, @persisted=true>, #<Download:0x0000000446f740 @attributes={"name"=>"Video 1", "id"=>"1", "size"=>8672256, "uri"=>"http://site.com/download_1"}, @prefix_options={}, @persisted=true>, #<Download:0x0000000446d300 @attributes={"name"=>"Video 2", "id"=>"2", "size"=>5931008, "uri"=>"http://site.com/download_2"}, @prefix_options={}, @persisted=true>, #<Download:0x0000000446c888 @attributes={"name"=>"Video 3", "id"=>"3", "size"=>2273280, "uri"=>"http://site.com/download_3"}, @prefix_options={}, @persisted=true>, #<Download:0x000000045c7c50 @attributes={"name"=>"Video 4", "id"=>"4", "size"=>8466432, "uri"=>"http://site.com/download_4"}, @prefix_options={}, @persisted=true>, #<Download:0x000000045c6ee0 @attributes={"name"=>"Video 5", "id"=>"5", "size"=>7057408, "uri"=>"http://site.com/download_5"}, @prefix_options={}, @persisted=true>, #<Download:0x000000045c5d60 @attributes={"name"=>"Video 6", "id"=>"6", "size"=>2351104, "uri"=>"http://site.com/download_6"}, @prefix_options={}, @persisted=true>, #<Download:0x00000004116058 @attributes={"name"=>"Video 7", "id"=>"7", "size"=>5640192, "uri"=>"http://site.com/download_7"}, @prefix_options={}, @persisted=true>, #<Download:0x00000004114320 @attributes={"name"=>"Video 8", "id"=>"8", "size"=>9701376, "uri"=>"http://site.com/download_8"}, @prefix_options={}, @persisted=true>, #<Download:0x0000000411b080 @attributes={"name"=>"Video 9", "id"=>"9", "size"=>9717760, "uri"=>"http://site.com/download_9"}, @prefix_options={}, @persisted=true>, #<Download:0x00000004a46330 @attributes={"name"=>"Video 10", "id"=>"10", "size"=>6734848, "uri"=>"http://site.com/download_10"}, @prefix_options={}, @persisted=true>] 

किसी विशिष्ट वस्तु की खोज करें:

 > Download.find(5) => #<Download:0x00000004aa5420 @attributes={"name"=>"Video 5", "id"=>"5", "size"=>7057408, "uri"=>"http://site.com/download_5"}, @prefix_options={}, @persisted=true> 

एक अविवेकी वस्तु के लिए खोजें। ध्यान दें कि कैसे_ प्रस्तुत करना_फाउंड काम करता है:

 > Download.find(100) ActiveResource::ResourceNotFound: Failed. Response code = 404. Response message = Not Found. 

वस्तु निर्माण:

 > download = Download.new => #<Download:0x00000004802380 @attributes={}, @prefix_options={}, @persisted=false> > download.name = "New Video" => "New Video" > download.uri = "http://site.com/video.mp4" => "http://site.com/video.mp4" > download.size = 23452363 => 23452363 > download.save => true > Download.last => #<Download:0x000000049408f0 @attributes={"name"=>"New Video", "id"=>11, "size"=>23452363, "uri"=>"http://site.com/video.mp4"}, @prefix_options={}, @persisted=true> 

वस्तु परिवर्तन:

 > download = Download.find(5) => #<Download:0x0000000473ee30 @attributes={"name"=>"Video 5", "id"=>"5", "size"=>7057408, "uri"=>"http://site.com/download_5"}, @prefix_options={}, @persisted=true> > download.name = "New Video 5" => "New Video 5" > download.save => true > Download.find(5) => #<Download:0x000000043dade8 @attributes={"name"=>"New Video 5", "id"=>"5", "size"=>7057408, "uri"=>"http://site.com/download_5"}, @prefix_options={}, @persisted=true> 

ऑब्जेक्ट हटाएं:

 > Download.find(5).destroy => #<Net::HTTPOK 200 OK readbody=true> > Download.find(5) ActiveResource::ResourceNotFound: Failed. Response code = 404. Response message = Not Found. 

एक गैर-मानक समारोह का आह्वान:

 > Download.find(1).post(:start) => #<Net::HTTPOK 200 OK readbody=true> 

आगे क्या है?

इस उदाहरण को निम्नलिखित दिशाओं में विकसित किया जा सकता है:

• ActiveResource में एक कठोर डेटा मॉडल नहीं है, लेकिन आप स्कीमा का उपयोग करके इसे वैकल्पिक रूप से सेट कर सकते हैं। यह, उदाहरण के लिए, आईडी स्ट्रिंग मान के मैनुअल असाइनमेंट को बाहर करने की अनुमति देगा।
• मोजो :: UserAgent मॉड्यूल का उपयोग करके एक प्रतिष्ठित क्लाइंट के रूप में पर्ल
• प्रमाणीकरण / प्राधिकरण

प्रयुक्त संस्करण

• CentOS Linux 6.2
• पर्ल 5.10.1
• मझौली 2.97
• रूबी 1.9.3p125
• रेलगाड़ी ३.२.१