RESTful Examples. RESTful Examples 1 Apache 3 Jersey 5 JAX-RS 7 ApplicationConfig.java 7 HelloGregg.java 8

Size: px

Start display at page:

Download "RESTful Examples. RESTful Examples 1 Apache 3 Jersey 5 JAX-RS 7 ApplicationConfig.java 7 HelloGregg.java 8"

Amanda Manning
5 years ago
Views:

1 RESTful Examples RESTful Examples 1 Apache 3 Jersey 5 JAX-RS 7 ApplicationConfig.java 7 HelloGregg.java 8 REST in JavaScript 9 #1) createrequest with XMLHttpRequest 9 #2) Must supply a Callback function onreadystatechange 9 #3) Sending the Request 10 Python/Django 11.user 11.auth 11 Standard HttpRequest attributes 11 Responses 11 Creating Responses 11 Class Based Views 11 Python/Django Example 12 Testing our PYTHON API 12 Or directly through the browser Types of Routers 14 Serialization and Deserialization important parts of Django-rest-framework 14 Requests and Responses 14 Request objects: 14 Issuing GET Requests 14 Issuing POST Requests 14

2 REST in Java Simple REST client in Java 3 methods 1) Apache HttpClient 2) Jersey 3) JAX-RS (Java API for RESTful Web Services)

3 Apache HTTP GET method: import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import org.apache.http.httpresponse; import org.apache.http.client.clientprotocolexception; import org.apache.http.client.httpclient; import org.apache.http.client.methods.httpget; import org.apache.http.impl.client.defaulthttpclient; public class Test { public static void main(string[] args) throws ClientProtocolException, IOException { HttpClient client = new DefaultHttpClient(); HttpGet request = new HttpGet(' HttpResponse response = client.execute(request); BufferedReader rd = new BufferedReader (new InputStreamReader(response.getEntity().getContent())); String line = ''; while ((line = rd.readline())!= null) { System.out.println(line); HTTP POST method; for sending simple string import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import org.apache.http.httpresponse; import org.apache.http.client.clientprotocolexception; import org.apache.http.client.httpclient; import org.apache.http.client.methods.httppost; import org.apache.http.entity.stringentity; import org.apache.http.impl.client.defaulthttpclient; public class Test { public static void main(string[] args) throws ClientProtocolException, IOException { HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost(' StringEntity input = new StringEntity('product'); post.setentity(input); HttpResponse response = client.execute(post); BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent())); String line = ''; while ((line = rd.readline())!= null) { System.out.println(line);

4 For JSON you can use JSONObject to create string representation of JSON. JSONObject json = new JSONObject(); json.put('name', 'value'); json.put('name', 'value'); StringEntity se = new StringEntity( json.tostring()); POST request with multiple parameters: import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import java.util.arraylist; import java.util.list; import org.apache.http.httpresponse; import org.apache.http.client.clientprotocolexception; import org.apache.http.client.httpclient; import org.apache.http.client.entity.urlencodedformentity; import org.apache.http.client.methods.httppost; import org.apache.http.impl.client.defaulthttpclient; import org.apache.http.message.basicnamevaluepair; public class Test { public static void main(string[] args) throws ClientProtocolException, IOException { HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost(' List namevaluepairs = new ArrayList(); namevaluepairs.add(new BasicNameValuePair('name', 'value')); //you can as many name value pair as you want in the list. post.setentity(new UrlEncodedFormEntity(nameValuePairs)); HttpResponse response = client.execute(post); BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent())); String line = ''; while ((line = rd.readline())!= null) { System.out.println(line);

5 Jersey the specification of REST support in Java. Jersey contains basically a REST server and a REST client. i HTTP GET method: import java.io.ioexception; import javax.ws.rs.core.mediatype; import javax.ws.rs.core.uribuilder; import org.apache.http.client.clientprotocolexception; import com.sun.jersey.api.client.client; import com.sun.jersey.api.client.webresource; import com.sun.jersey.api.client.config.clientconfig; import com.sun.jersey.api.client.config.defaultclientconfig; public class Test { public static void main(string[] args) throws ClientProtocolException, IOException { ClientConfig config = new DefaultClientConfig(); Client client = Client.create(config); WebResource service = client.resource(uribuilder.fromuri(' HTTP POST method: // getting XML data System.out.println(service. path('restpath').path('resourcepath'). accept(mediatype.application_json).get(string.class)); // getting JSON data System.out.println(service. path('restpath').path('resourcepath').accept(mediatype.applica TION_XML).get(String.class)); import java.io.ioexception; import javax.ws.rs.core.mediatype; import javax.ws.rs.core.multivaluedmap; import javax.ws.rs.core.uribuilder; import org.apache.http.client.clientprotocolexception; import com.sun.jersey.api.client.client; import com.sun.jersey.api.client.clientresponse; import com.sun.jersey.api.client.webresource; import com.sun.jersey.api.client.config.clientconfig; import com.sun.jersey.api.client.config.defaultclientconfig; import com.sun.jersey.core.util.multivaluedmapimpl; public class Test { public static void main(string[] args) throws ClientProtocolException, IOException { ClientConfig config = new DefaultClientConfig(); Client client = Client.create(config); WebResource webresource = client.resource(uribuilder.fromuri(' MultivaluedMap formdata = new MultivaluedMapImpl(); formdata.add('name', 'val'); formdata.add('name', 'val'); ClientResponse response = webresource.type(mediatype.application_form_urlencoded_type).post(clientresponse.class, formdata); System.out.println('Response ' +

6 response.getentity(string.class)); POST request, Form class submit multiple parameters: import java.io.ioexception; import javax.ws.rs.core.mediatype; import javax.ws.rs.core.uribuilder; import org.apache.http.client.clientprotocolexception; import com.sun.jersey.api.client.client; import com.sun.jersey.api.client.clientresponse; import com.sun.jersey.api.client.webresource; import com.sun.jersey.api.client.config.clientconfig; import com.sun.jersey.api.client.config.defaultclientconfig; import com.sun.jersey.api.representation.form; public class Test { public static void main(string[] args) throws ClientProtocolException, IOException { ClientConfig config = new DefaultClientConfig(); Client client = Client.create(config); WebResource service = client.resource(uribuilder.fromuri(' Form form = new Form(); form.add('name', 'value'); form.add('name', 'value'); ClientResponse response = service.path('restpath').path('resourcepath'). type(mediatype.application_form_urlencoded).post(clientresponse.class, form); System.out.println('Response ' + response.getentity(string.class)); Posted by: Harsh Raval in Enterprise Java September 11th, 2012

7 JAX-RS ApplicationConfig.java /* * To change this license header, choose License Headers in Project Properties. * To change this template file, choose Tools Templates * and open the template in the editor. package hellogregg; import java.util.set; import javax.ws.rs.core.application; /** * public class ApplicationConfig extends Application public Set<Class<?>> getclasses() { Set<Class<?>> resources = new java.util.hashset<>(); addrestresourceclasses(resources); return resources; /** * Do not modify addrestresourceclasses() method. * It is automatically populated with * all resources defined in the project. * If required, comment out calling this method in getclasses(). private void addrestresourceclasses(set<class<?>> resources) { resources.add(hellogregg.hellogregg.class);

8 HelloGregg.java /* * To change this license header, choose License Headers in Project Properties. * To change this template file, choose Tools Templates * and open the template in the editor. package hellogregg; import javax.ws.rs.core.context; import javax.ws.rs.core.uriinfo; import javax.ws.rs.produces; import javax.ws.rs.consumes; import javax.ws.rs.get; import javax.ws.rs.path; import javax.ws.rs.put; import javax.ws.rs.core.mediatype; /** * REST Web Service * public class HelloGregg private UriInfo context; /** * Creates a new instance of HelloGregg public HelloGregg() { /** * Retrieves representation of an instance of hellogregg.hellogregg an instance public String gethtml() { return "<html><body><h1>hello, Gregg!!</h1>RESTful using javax.ws.rs, RESTful Java API</body></html>"; /** * PUT method for updating or creating an instance of HelloGregg content representation for public void puthtml(string content) {

9 REST in JavaScript XMLHttpRequest object allows you to send a request, either GET or POST; client-side (in-browser) JavaScript. AJAX applications are RESTful, every AJAX request is an HTTP request, Creating XMLHttpRequest Objects Create request, create callback function then issue the actual GET or POST #1) createrequest with XMLHttpRequest no standard way to create XMLHttpRequest objects allows you to send a request, either GET or POST. cross-browser solution: Diff for each Browser function () { var result = null; if (window.xmlhttprequest) { // FireFox, Safari, etc. result = new XMLHttpRequest(); if (typeof xmlhttp.overridemimetype!= 'undefined') { result.overridemimetype('text/xml'); // Or anything else else if (window.activexobject) { // MSIE result = new ActiveXObject("Microsoft.XMLHTTP"); else { // No known mechanism -- consider aborting the application return result; #2) Must supply a Callback function onreadystatechange XMLHttpRequest does not immediately return a value. Rather, you have to supply a callback function createrequest that will be invoked when the request completes. Confusingly, you callback is actually invoked several times (up to four times, depending on the browser), during different stages of the client/server interaction. It is only the fourth and final stage that interests us; var req = createrequest(); // defined above // Create the callback: req.onreadystatechange = function() { if (req.readystate!= 4) return; // Not there yet if (req.status!= 200) { // Handle request failure here... return; // Request successful, read the response var resp = req.responsetext; //... and use it as needed by your app. Note that if the response is an XML response (denoted by the server using MIME type text/xml), it can also be read using the responsexml property. This property contains an XML document, and can be used as such using JavaScript's DOM

10 navigation facilities. #3) Sending the Request Once we have created the request object and set up its callback function, it is time to issue the request: req.open("get", url, true); req.send(); For POST requests, use: req.open("post", url, true); req.setrequestheader("content-type", "application/x-www-form-urlencoded"); req.send(form-encoded request body);

11 Authentication Python/Django Use different authentication policies for different parts of your API. Provide both user and token information associated with the incoming request..user request.user typically returns an instance of django.contrib.auth.models.user, although the behavior depends on the authentication policy being used. If the request is unauthenticated the default value of request.user is an instance of django.contrib.auth.models.anonymoususer..auth request.auth returns any additional authentication context.method request.method returns the uppercased string representation of the request's HTTP method. Standard HttpRequest attributes Request extends Django's HttpRequest, all the other standard attributes and methods are also available. For example the request.meta and request.session dictionaries are available as normal. Responses Response class which allows you to return content that can be rendered into multiple content types, depending on the client request. Response class subclasses Django's SimpleTemplateResponse. Response objects are initialised with data, which should consist of native Python primitives. Creating Responses Unlike regular HttpResponse objects, you do not instantiate Response objects with rendered content. Instead you pass in unrendered data, which may consist of any Python primitives. Class Based Views APIView class, which subclasses Django's View class. APIView classes are different from regular View classes in the following ways: Requests passed to the handler methods will be REST framework's Request instances, not Django's HttpRequest instances. Handler methods may return REST framework's Response, instead of Django's HttpResponse. The view will manage content negotiation and setting the correct renderer on the response

12 Python/Django Example from rest_framework.views import APIView from rest_framework.response import Response from rest_framework import authentication, permissions class ListUsers(APIView): """ View to list all users in the system. * Requires token authentication. * Only admin users are able to access this view. """ authentication_classes = (authentication.tokenauthentication,) permission_classes = (permissions.isadminuser,) def get(self, request, format=none): """ Return a list of all users. """ usernames = [user.username for user in User.objects.all()] return Response(usernames) Testing our PYTHON API We're now ready to test the API we've built. Let's fire up the server from the command line. python./manage.py runserver We can now access our API, both from the command-line, using tools like curl... bash: curl -H 'Accept: application/json; indent=4' -u admin:password { "count": 2, "next": null, "previous": null, "results": [ { " ": "admin@example.com", "groups": [], "url": " "username": "admin", { " ": "tom@example.com", "groups": [ ], "url": " "username": "tom" ] Or using the httpie, command line tool... bash: http -a username:password HTTP/ OK... { "count": 2, "next": null, "previous": null, "results": [ { " ": "admin@example.com",

13 ] "groups": [], "url": " "username": "paul", { " ": "tom@example.com", "groups": [ ], "url": " "username": "tom" Or directly through the browser...

14 Django REST framework (DRF) - REST adds support for auto URL routing to Django Types of Routers Simple Default Custom Serialization and Deserialization important parts of Django-rest-framework 1. Serializing data with JSONRenderer: process of making a streamable representation A JSONRenderer converts the request data into JSON using utf-8 encoding. Normally we use this when we want our data to be streamable. >>> data {'cal_id': u'2', 'username': u'tester' >>> content = JSONRenderer().render(data) >>> content '{"cal_id": "2", "username": "tester"' 2. Deserializing data with JSONParser: A JSONParser parses the JSON request content. building an API we render data into JSON format. Firstly, we parse a stream into Python native datatypes with BytesIO >>> content '{"cal_id": "2", "username": "tester"' >>> stream = BytesIO(content) >>> data = JSONParser().parse(stream) >>> data {u'username': u'tester', u'cal_id': u'2' Requests and Responses Request objects: The request object in REST framework has more abilities. request.data in Request object is similar to Request.POST added with the capabilities of handling arbitrary data which works for 'POST', 'PUT' and 'PATCH' methods. request.files, request.query_params, request.parsers, request.stream which will help in dealing with the request a hassle free task. REST in Python Issuing GET Requests The Python module urllib2 makes reading URLs trivial: import urllib2 url = ' response = urllib2.urlopen(url).read() Issuing POST Requests A POST request is just as easy, simply passing (encoded) request data as an extra parameter to urlopen, thus: import urllib import urllib2

15 url = ' params = urllib.urlencode({ 'firstname': 'John', 'lastname': 'Doe' ) response = urllib2.urlopen(url, params).read()

Session 12. RESTful Services. Lecture Objectives

Session 12. RESTful Services. Lecture Objectives Session 12 RESTful Services 1 Lecture Objectives Understand the fundamental concepts of Web services Become familiar with JAX-RS annotations Be able to build a simple Web service 2 10/21/2018 1 Reading