The Django Rest Framework, a django framework, is a toolkit used to build APIs (Application Program Interface) in Django models which is very powerful and flexible. An API is a collection of protocols, routines and tools used in building applications. Other known django frameworks include Tastypie and Piston.
The REST framework works well with the following versions of java python and django:
A very easy to understand framework; Sometimes you might find yourself working with a framework that is most certainly limited or out of date, which ends up giving you a lot of issues. However, with DRF, you will be able to avoid all these issues due to:
Easy requirements, details and quick installation
Best scalable practices with API development
API guide for all the development work
While still on the course of developing your app, you might want to test the responses of JSON and your endpoints before the app is complete. DRF allows you to use the browsable API to see the results on the web, getting the response just the same way you would get it on the application.
A framework that is customizable and browsable; The source code of this framework is collected into components that allows one to simply import them into the project easily.
Some important components in DRF include:
Serializer classes; This allows the developer to model serialization from rest_framework import serializersfrom rest_framework import routers, serializers Router Classes; This allows the developer to extend a class to be able to get pagination for their application. from rest_framework import routers, pagination, serializers
When we want to extend to other frameworks, the import statements that we would use would be:
from framework.apps.serializers import model_serializers, default_serializers
from framework.apps.routers import api_routers
from framework.apps.utils import pagination
When we simplify the structure of the framework, it means that we would find it easy to use the extensions of all the components and classes as well as the importation itself.
Adding DRF into your project
The Django Rest Framewrok can be installed using two different methods:
The first method is by using pip. Open the terminal and run the following commands, one at a time:
After completing the steps above, you have now successfuly installed DRF. You will now need to add the rest framework. You can do this by adding rest_framework to the INSTALLED_APPS settings. You can do this by adding this line to the settings:
INSTALLED_APPS = (
Most developers prefer using the API that is browsable. For one to be able to do that, you will have to add the login and logout views for the REST framework. You can do this by adding the following code to the urls.py file in the root folder:
Note: It is important to note that the path of the URL can be anything that the developer wants, however, one must add the rest_framework.urls together with the rest_framework.
How DRF works
The REST framework consists of some building blocks that make it work properly. They include:
Class based views
Permissions and Authentication
Viewsets and routers
Relationships and hyperlinked APIs
Responses and Requests
Client libraries and schemas
Class Based Views
This enables the developer to use class based views when writing the API views, instead of using views based on functions. One of the advantages of this is that it allows the developer to use most functionalities again and again, enabling them to have a dry code.
Permission and Authentication
This enables the developer to add restrictions to the API, which determine who can work on the code snippet. It gives restrictions on editing, deleting or updating the code. Some more functionalities of permissions and authentication include:
Restrictions on who can create snippets of code
All snippets belong to the creator alone, although can be shared by the creator
Read only access is granted to all unauthenticated requests
Updating and deleting permissions of a code snippet is only granted to the creator
Instances of the snippet are serialized or deserialized to get representations such as those for xml and Json.
Using serialization, model instances and complex data are able to be converted to data types in native python language, enabling them to be easily rendered to other languages like XML and Python. It also allows deserialization, which is the back process of getting the date back to its original complex form.
Responses and Requests
The Django Rest Framework has a request object whose function is to extend the normal HttpRequest, providing a request parsing that is more flexible and easy to use. The request.data attribute is the major function of this object. We also have the request.data which works with arbitrary data.
Response objects are of the type TemplateResponse. Their work is to use content that has not been rendered, and then use negotiation of the content to get the right form of the content to be given to a client.
Relationships and hyperlinked API’s
A relationship in entities can be represented in different ways, these include:
Hyperlink in between entities
Use of a slug field on the entities
Using a string to represent the entities
All the above styles are supported by this framework, however, we would prefer the hyperlink method, which enables discoverability and cohesion of the API.
Viewsets and routers
Viewsets are used to allow the developer pay more attention on developing the interactions and states of the API, making the URL construction and automatic affair of the framework. The ViewSet class provides more features including update, read, put and get which are not available in the view classes.
Schemas and Client Libraries
A schema is a document that is machine readable, and is used to give a description of all the API endpoints available with their URLs and their supported operations. Schemas are very important when working with documentation that is automatically generated.
This tutorial has taken you through introduction, installation and building blocks of a Django Rest Framework. Having understood this, you are on your way to been a good and competent developer in DRF.
Looking for the right web hosting solution for your website can be an intimidating task. Options nowadays are more diversified than ever, and each year brings new developments in the web hosting market. If you have no clue of what to look out for, you can find yourself overwhelmed with...
Content marketing continues to be one of the most valuable tools for today’s online businesses. With content, you can improve your chances of reaching your target audience, boost your search engine standing, and even unlock new opportunities for sales. The more content you produce, the more you can strengthen your...
User Experience (UX) is one of the most crucial factors to consider in web design. As the number of websites and applications in the world today continues to accelerate, businesses are under more pressure than ever to impress customers straight away. If a user visits your website and finds slow-loading...