Week6 Examples: Web Services

1. Web Services:
   • SOAP: Simple Object Access Protocol: Wikipedia page. Examples
     • Search: "Free SOAP services" (e.g., http://www.service-repository.com/)
     • Locate the WSDL page (Web Service Description Language) for the SOAP web-service (http://www.webservicex.com/globalweather.asmx?WSDL)
     • An example code: In your IDE: (Thanks to Albert Gardner for showing me the following):
       • Right-Mouse-Button over: References: Add Service Reference
       • Address: Enter the WSDL path, (edit and set an appropriate name space, e.g., WeatherService), press GO
       • Here is the link to the example source code.
   • REST: REpresentational State Transfer: Wikipedia page. Examples
     • Weather service (from NOAA: http://graphical.weather.gov/xml/rest.php), e.g.,  http://graphical.weather.gov/xml/sample_products/browser_interface/ndfdXMLclient.php?lat=38.99&lon=-77.01&product=time-series&begin=2004-01-01T00:00:00&end=2013-04-20T00:00:00&maxt=maxt&mint=mint
     • http://www.bing.com/maps/default.aspx?cp=47.64483~-122.141197&lvl=17&style=h
     • https://graph.facebook.com/me/friends?access_token=<yourAccessToken>
     • http://api.twitter.com/1/statuses/user_timeline.xml?screen_name=kelvincss   
     • Notice: how RESTful results can be cut/pass around as a simple URI link :-)
   • Some on-line discussions/opinions:
     • http://www.ajaxonomy.com/2008/xml/web-services-part-1-soap-vs-rest
     • http://stackoverflow.com/questions/76595/soap-or-rest-for-web-services
     • SOAP: Complete specification on how to compute the data. Input information packaged in well defined SOAP envelop. Client sends the envolope to obtain data (typically via programming code).
     • REST: URI's are input to the WebServie programs, convenient to pass the input (URI) around, anyone wants the ultimate data can simply send the input to the program (WebService) (e.g., via web-browser).
        
2. Imagine a RESTful web service: (a href="http://faculty.washington.edu/ksung/Test/">http://faculty.washington.edu/ksung/Test/)
   • Webservers: Apache and IIS
   • php: Some helpful tutorials: http://www.phphelp.com/
   • Very simple php script: nothing fancy just a new scripting language (for most of us)
   • Here is how you can initiate a download. Notice the header() functions construct trigger for browser download!
   • Here is how you can upload a file, from html to the php script.
     • Credit: thanks to Devin McBride for pointing me to this page, this example is almost a 1 to 1 copy from: http://www.w3schools.com/php/php_file_upload.asp)
        
3. My stupid service: http://faculty.washington.edu/ksung/Test/MyService/MyService.php
   • Stupid print out: with out parameters, or with "parm=4"
   • Download: "cmd=dlnd" optional "&dfile=fileName"
   • Upload: "cmd=upld" <-- how to get this to work?
      
4. Create a simple web-client for our service:
   • Pretty stupid, but gives us some sense of how RESTful web-service is doing at the backend.
   • Upload of file does not work. Sorry