«Á Õ è«rest ว ตถ ประสงค การเร ยนร

Transcription

1 225 Ë 12 ทรงฤทธ ล ม คเดช «Á Õ è«rest ว ตถ ประสงค การเร ยนร ช ยโย เตโชน ม ตร ผ เร ยนจะทำความเข าใจก บเว บเซอร ว สแบบ REST ในเช งล ก ตลอดจนสา มารถใช เคร องม อในการแปลงข อม ลบนหน าเว บไซต ในร ป HTML ให อย ในร ป XML และให บร การแบบ REST ได ตลอดจนการพ ฒนาเว บเซอร ว สของตน โดย ใช ภาษา Ruby REST (Representational State Transfer) เป นแนวค ดในการมองเว บท งหลายเป น ทร พยากรของเรา เราสามารถท จะใช ร ปแบบใดๆ ในการต ดต อก บทร พยากรเหล าน และ สามารถร บร ปแบบใดๆ ก ได เช น การใช เว บไซต ผ านทางเบราเซอร ก ถ อเป น REST แบบ หน ง การเร ยกใช REST แบบเว บเซอร ว สโดยท วไป ม กจะส งคำร องตามด วยค า input เช น q=currency+exchange ทางเคร องเม อประมวลผลเสร จ ก จะส งข อม ลตอบกล บมาในร ปแบบต างๆ เช น HTML, XML, JS, JSON แล วแต สถานการณ จ ดอ อนของ REST ในอด ตค อไม ม ศ นย ข อม ลกลางท เก บบร การไว จ งต องค นหาด วย ว ธ ปรกต ค อใช Search Engine ต างๆ ช วย เช น Google, Yahoo โดยท วไปเราจะค นหาบร การโดยใช คำว า API (Application Programming Interface) แต ในป จจ บ นเร มม การเก บ บร การเหล าน ไว มากแล ว เช น

2 หร อในสหร ฐอเมร กา ม การทำเว บท าเก บเว บเซอร ว สของร ฐท การทำงานของ REST จะม 2 ส วนค อโปรแกรมฝ งผ ร บบร การ (Client) ส งคำร อง ด วยว ธ การ 4 ว ธ ค อ GET, PUT, DELETE, POST ไปย งฝ งผ ให บร การ (Server) ซ ง จะประมวลผลแล วให คำตอบกล บมา เราสามารถนำโครงสร างน ไปประย กต ใช อย างไร ก ได เช น ส งข อม ล ร บข อม ล ควบค มอ ปกรณ เคร องจ กร ฯลฯ 12.1 ª ª ß «Á μè ªöπ REST ในต างประเทศ การใช เว บเซอร ว สแบบ REST ม การใช งานอย างกว างขวาง แต ใน ประเทศไทย ผ ให บร การย งม ความค ดการทำ e-commerce แบบเก าๆ ค อ พยายามด งคนมา เข าหน าเว บเพจมากๆ เพ อเพ มฮ ต ทำให ม การทำแต เพ ยงเว บไซต แต ไม ม การทำเว บเซอร ว ส ในโครงสร างแบบ REST เร องน ไม เป นป ญหา เพราะการส งเว บเพจกล บมา ก เหม อน ก บการได ร บคำตอบ (Response) เป น HTML แทนท จะเป น XML เท าน นเอง เราสามารถ ใช เคร องม อท จะด งข อม ลท ซ อนอย ในหน าเว บเพจเหล าน มาใช ประโยชน ได เช น Hpricot หร อ Scrubyt ในบทน จะขอแนะนำ Scrubyt ซ งเป น gem ต วหน งม เว บไซต อย ท ว ธ การต ดต งก เช นเด ยวก บ gem ต วอ น เช นบน Window ใช command line จาก หน า DOS ส ง gem install scrubyt หร อถ าบนล น กซ ก ส ง sudo gem install scrubyt โดยต ว Scrubyt ม gem ท ต องใช เพ มอ ก 2 ต ว ค อ Hpricot และ Mechanize ซ งจะถ กต ดต ง โดยอ ตโนม ต เม อเราต ดต ง Scrubyt เราสามารถใช Scrubyt ในโปรแกรม Ruby ท วไปก ได ไม จำเป นต องใช ร วมก บ Rails ต วอย างต อไปน เป นการค นหาคำว า ruby จากหน าเว บเพจ Google โดยตรง เราใช คำส ง fetch แล วสร างกล มข อม ลท ต องการภายใน block ของ Scrubyt::Extractor.define โดยในกรณ น เราต งช อแท กข นมาเองเป น link_title และ link_url

3 227 require rubygems require scrubyt google_data = Scrubyt::Extractor.define do fetch link_title //a[@class= l ], :write_text => true do link_url print google_data.to_hash print google_data.to_xml ต วอย างแรกผ พ ฒนาต องร ตำแหน งท แน นอนของข อม ลท ต องการ เช น a[@class= l ] แต ในกรณ ท หน าเว บม ข อม ลเป นตาราง ม ห วข อช ดเจน ก สามารถสร าง ร ปแบบต วอย าง (Pattern) ให ก บ Scrubyt ได ต วอย างต อไปน แสดงการโต ตอบก บ เว บไซต Ebay โดยข นแรก เข าไปท เว บด วยคำส ง fetch จากน นกรอกข อม ลด วยคำส ง fill_textfield แล วคล กป ม submit เม อได หน าต อไปก ทำการเก บข อม ลด วยคำส ง record แล วกดด หน าต อไปด วยคำส ง next_page ebay_data = Scrubyt::Extractor.define do fetch fill_textfield satitle, ipod submit click_link Apple ipod record do item_name APPLE NEW IPOD MINI 6GB MP3 PLAYER SILVER price $71.99 next_page Next >, :limit => 5

4 228 Workshop 12.1 ให สร างเว บเซอร ว สด วยภาษา Ruby โดยร บ input เป นเคร องหมายหล กทร พย เช น PTTEP แล วให ส งค าไปให เว บไซต ของตลาดหล กทร พย แห งประเทศไทย แล วส งราคาซ อขายล าส ด, ปร มาณ, ราคาส งส ด, ต ำส ด กล บมาในร ปแบบของ XML ข อม ลจาก Workshop 12.2 สร างเว บเซอร ว สด วยภาษา Ruby เพ อร บช อผ ใช Twitter แล วส งข อม ลออกในร ปแบบ XML ช อ ท อย เว บไซต ประว ต ทดสอบเซอร ว สท สร างก บช อเหล าน songrit, iamnadia, algore, BarackObama 12.2 REST using RoR ใน Ruby on Rails ม เคร องม อในการช วยสร างเว บเซอร ว สแบบ REST มากมาย เร ม ต งแต ง ายๆ เช นการแปลงข อม ลจาก ActiveRecord เป น XML ใช เมธอด to_xml เช น print Book.first.to_xml

5 229 คำส ง to_xml ม คำขยายความ (options) อ กมาก เช น :only=>[...] :skip_instruct=>true :root=> books :indent=>4 :dasherize=>false :skip_types=>true :include=>chapters Hash ก สามารถใช ก บ to_xmlได เช น print ({:name=> song, :lname=> lee }.to_xml) ส วนการแปลงข อม ลจาก XML มาเข าต วแปร Hash ใช เมธอด from_xml เช น h = Hash.from_xml(File.new( abc.xml )) Workshop 12.3 x = <<-EOT <export> <mineral>20_000</mineral> <electronic>300_000</electronic> <fishery>50_000</fishery> </export> EOT Hash.from_xml(x)

6 Builder ภาษา Ruby ม เคร องม อภายในท ช วยในการสร างข อม ล XML ท สล บซ บซ อนด วย การใช Builder ซ ง Rails สน บสน นการสร าง XML โดยการระบ นามสก ลของไฟล ให เป น rxml หร อ xml.builder เช นถ าเราม การกำหนดเมธอด (action) ไว ใน Controller เป น def show... เราเพ ยงแต สร างไฟล ช อ show.xml.builder อย ใน View เม อเวลาแสดงผล Rails ก จะ ด งไฟล น มาสร าง XML โดยอ ตโนม ต การสร างไฟล XML ด วย Builder ใน Rails ใช ต ว แปรช อ xml แล วตามด วยเมธอดอะไรก ได ระบบจะสร างแท กตามช อเมธอดท เราใส เข า ไป ยกเว นบางเมธอดท เป นคำส งพ เศษ จะลงท ายด วยเคร องหมาย! เช น instruct! หร อ comment! ทดลองศ กษาจากต วอย างน xml.instruct! xml.comment! a comment xml.feed xmlns => do xml.title My Atom Feed xml.subtitle h(@feed.subtitle), type => html xml.link url_for( :only_path => false, :controller => feed, :action => atom do entry xml.entry do xml.title entry.title xml.link href => url_for ( :only_path => false, :controller => entries, :action => show, :id => entry ) xml.id entry.urn xml.updated entry.updated.iso8601 xml.summary h(entry.summary)

7 231 Builder เป นเคร องม อท ช วยให เราสร าง Web service server ได อย างง าย โดยเราเพ ยง แต เข ยน Controller ตามว ธ ปรกต เพ ยงแต เปล ยน View จาก rhtml เป น rxml Yahoo API ในกรณ ท เราเป นผ ใช บร การ นอกจากคำส ง from_xml ท แปลง XML ให อย ใน ร ป Hash ง ายๆ แล ว เราย งม เคร องม อท เร ยกว า REXML เพ อเข ามาช วยจ ดการ XML ท ม โครงสร างซ บซ อนข น ในกรณ ศ กษาน เราจะใช บร การค นหาผ านเว บไซต ของ Yahoo ซ งม รายละเอ ยดอย ท ทดลองค นหาเปร ยบเท ยบระหว างแบบเว บไซต และเว บเซอร ว สด วยการใช เบราเซอร เป ดไปท จากน น ใช Browser เป ดไปท websearch?appid=songrit_gdi&query=gdi ท ง 2 หน าเป นผลล พธ จากการค นหาคำว า gdi เช นเด ยวก น โดยในหน าแรกเป นการ ค นหาผ านหน าเว บไซต และในหน าท 2 เป นร ปแบบ XML ของเว บเซอร ว ส ด งน นในการ เร ยกใช เว บเซอร ว ส ก ค อ การเร ยกไปท V1/webSearch โดยส งพาราม เตอร ให 2 ต ว ต วแรกค อ appid โดยปรกต จะต องไปลง ทะเบ ยนก อนแล ว Yahoo จะให เรากำหนดรห สท จะใช มาให และต วท สอง ค อ query เป น ข อความท เราต องการค นหา

8 232 Controller class CodeController < ApplicationController def yahootest query = CGI.escape( SEARCH TEXT ) yahookey = songrit_gdi url = + WebSearchService/V1/webSearch? + appid=#{yahookey}&query=#{query} + &results=3&start=1 result = = REXML::Document.new result View do res %> <b>title:</b> <%= res[0].text.to_s %><br> <b>summary:</b> <%= res[1].text.to_s %><br> <b>link:</b> <a href= <%= res[2].text.to_s %> ><%= res[2].text.to_s % /> <br><br> <% %>

9 12.3 å REST Google Maps ต วอย างท เห นได ช ดในการใช งาน REST ค อ ในกรณ ของ Google Maps ม การส ง คำร องแบบ Ajax และม การร บค ากล บมาเป นคำส ง JavaScript ซ งใน SOAP ไม สามารถ รองร บร ปแบบท ง 2 อย างน ได อย างส นเช ง การใช งาน Google Maps เร มต นเราต องไปลงทะเบ ยนโดเมนของเราก อนท จากน น ระบบจะให รห สเรามาต วหน งเพ อใช ระบ โปรแกรมของเรา จากน นต ดต งปล กอ น gmaps_on_rails ด วยคำส ง 233 ruby script/plugin install git://github.com/joergbattermann/gmaps_on_rails.git ในส วน environment.rb ให เราไปต งค าคงท ไว โดยนำรห สท เราลงทะเบ ยนไว ไปใส ตามต วอย างน ลงทะเบ ยนให ใช สำหร บโดเมน localhost:3000 GOOGLE_APPLICATION_ID = ABQIAAAA3HdfrnxFAPWyYaiJUxmqRTJQa0g3IQ9GZqIMmInSLzwtGDKaBQ0KYLwBEKS M7F9gCevcsIf6WPuIQ จากน นใน View ก สามารถใช งานได ตามต วอย างน <% map = GoogleMap.new map.markers << GoogleMapMarker.new( :map => map, :lat => , :lng => , :html => My House ) %> <%= map.to_html %> <div style= width: 500px; height: 500px; > <%= map.div %> </div>

10 234 Workshop 12.4 เร ยกข อม ลการใช จ ายภาคร ฐจากเว บไซต แล วนำมาแสดงผลผ ร บเหมาท ม ยอดส งส ด 10 ลำด บแรกพร อมงบประมาณในร ฐแคล ฟอร เน ย 12.4 ã REST Web Services จากเน อหาในบทแรกๆ ทำให เราทราบว า Web Services แบบ REST แท จร งแล วก ค อ Web page ท ม ล กษณะเป น XML น นเอง ด งน นการด งเอาข อม ลจาก Web Services แบบน มาใช งานจ งเป นเทคน กท ว าด วยการอ านค าข อม ลท ต องการจาก XML ท ได ร บมา ยก ต วอย างเช น ม XML ท ได จาก Web Services ด งน <Students> <Person id= 1 > <name>สมชาย</name> <lastname>ร กเร ยน</lastname> <ger>ชาย</ger> </Person> <Person id= 2 > <name>สมหญ ง</name> <lastname>ร กด </lastname> <ger>หญ ง</ger> </Person> </Students> สมมต ว าเราต องการทราบเพศของน กเร ยนคนแรก คำถามก ค อเราจะด งค าอย างไร เน อหาส วนต อไปน จะทำให เราทราบถ งเทคน กของภาษาคอมพ วเตอร Ruby ในการจ ดการ ก บ XML เพ อเข าถ งข อม ลท ต องการได อย างถ กต อง อย างไรก ตาม ไม ได หมายความว าเราต องใช แต ภาษา ruby ในการจ ดการก บ XML ใน ความจร งเราสามารถเล อกใช ภาษาใดๆ ก ได ตามแต ถน ด สาระสำค ญจร งๆ น นอย ท การใช XPath (อ นเป น keyword สำค ญในการอ านค าจาก XML) ร วมก บการเข ยนโปรแกรมตามปกต

11 235 เพ อให สอดคล องก บว ตถ ประสงค ของหน งส อน จะใช Web Services ในร ปแบบ statxml มาเป นต วอย างประกอบการอธ บาย ข างล างน เป น Web Services บอกข อม ล จำนวนน กท องเท ยวต างชาต <?xml version= 1.0" encoding= UTF-8"?> <StatData> <Header> <ID>4264</ID> <Test>false</Test> <Name>ข อม ลน กท องเท ยว</Name> <Ser> <Name>การท องเท ยวแห งประเทศไทย กระทรวงการท องเท ยวและก ฬา</Name> <Contact> <Name>motsstat motsstat motsstat</name> <Department> </Department> <Role></Role> <Telephone></Telephone> < >motsstat</ > </Contact> </Ser> </Header> <DataSet> <Series> <SeriesKey> <Value concept= ËÑÇ ŒÍ value= จำนวนน กท องเท ยวต างประเทศ /> <Value concept= FREQ value= รายป /> <Value concept= PUB_FREQ value= รายป /> </SeriesKey> <Attributes> <Value concept= UNIT value= พ นคน /> <Value concept= BUDGET_PLAN value= "/>

12 236 <Value concept= STORAGE_FORMAT value= /> <Value concept= DATA_EXTENT value= ประเทศ /> <Value concept= WS_AVAILABILITY value= Y /> </Attributes> <Obs> <Time> </Time> <ObsValue starttime= " value= "/> </Obs> <Obs> <Time> </Time> <ObsValue starttime= " value= "/> </Obs> <Obs> <Time> </Time> <ObsValue starttime= " value= "/> </Obs> </Series> <Annotations> <Annotation> <AnnotationTitle>DESCRIPTION</AnnotationTitle> <AnnotationText></AnnotationText> </Annotation> </Annotations> </DataSet> </StatData> «åÿ XPath XPath เป นภาษาสำหร บช ตำแหน งเฉพาะเจาะจงลงไปใน XML ท กำหนด ม กฎง ายๆ ด งต อไปน 1. ข นต น path ด วย / 2. การระบ path ท ต องการจะใช เคร องหมาย / ข นระหว างช อ element ล กลงไป

13 237 เร อยๆ เช น /StatData/Header/Name จะได ค า ข อม ลน กท องเท ยว 3. ผลล พธ ท ได จากการระบ path ถ า path น นม หลายต ว ให ใช [index] ต อท าย เพ อระบ path ท ต องการ เช น /StatData/Dataset/Series/Obs[2]/Time จะได ค า ส ญล ใช นำหน าช อท เป น attribute 5. สามารถระบ เง อนไข path ท ต องการในล กษณะค าของ attribute ท ตรงตามต อง การเช น /StatData/Dataset/Series/SeriesKey/Value[@concept= FREG ]@value จะได ค า รายป Ë π ª REST Web Services จากต วอย าง Web Services ข างต นเราสามารถเข ยนภาษา Ruby มาทำการร บค าต างๆ ได ด งต วอย างต อไปน 1. ด งค า ข อม ลน กท องเท ยว def getwsname url = # ด ง Web Services ตาม URL result = Net::HTTP.get(URI(url)) # จ บ XML ท ได จาก URL doc = REXML::Document.new result # ไปย งelement ท ระบ ใน XPath doc.elements.each( /StatData/Header/Name ) do = entry.text#ด งค าจาก element rer :text Workshop 12.5 ลองด งค าหน วยน บ<Value concept= UNIT value= พ นคน /> Hint : การด งค าจาก attribute จะไม ใช entry.text แต จะใช entry.attributes[ ช อ attribute ]

14 ด งจำนวนน กท องเท ยวท กป เก บใส Array def getwsname url = # ด ง Web Services ตาม URL result = Net::HTTP.get(URI(url)) # เตร ยม array สำหร บเก บค า value_array = Array.new # จ บ XML ท ได จาก URL doc = REXML::Document.new result # ไปย ง element ท ระบ ใน XPath doc.elements.each( /StatData/DataSet/Series/Obs/ ObsValue ) do e value = e.attribute[ value ]# ด งค าจาก attribute ช อ value value_array.push(value)# เก บค าเข าส array return value_array åß π XPath å«õ æ «μõ èõ ËπÊ πõ Àπ Õ Ruby เพ อแสดงให เห นว าการด งค าจาก Web Services ด วยภาษาอ นๆ น นไม แตกต างก น ลองส งเกตจากการด งค าด วยภาษา PHP ด านล างน ซ งเป นการด งช อของ Web Services ต ว น ( ข อม ลน กท องเท ยว )

15 239 $string = file_get_content( wservice/public/4264 ); $xml = simplexml_load_string($string); $result = $xml->xpath( /StatData/Header/Name ); while(list(, $node) = each($result)) { echo $node; }