Modelos y Serialización de Datos en Django Rest

Uso de Django Rest Framework para construir una API

En Django Rest Framework (DRF), los modelos son clases de Python que definen la estructura y comportamiento de los datos que se van a manipular. Los modelos también se encargan de la validación y la persistencia de los datos en la base de datos. Para definir un modelo en DRF, se utiliza la misma sintaxis que en Django.

Por ejemplo, la siguiente clase define un modelo para una tabla de usuarios:

from django.db import models

class User(models.Model):
    username = models.CharField(max_length=50)
    first_name = models.CharField(max_length=50)
    last_name = models.CharField(max_length=50)
    email = models.EmailField()
    date_joined = models.DateTimeField(auto_now_add=True)

Una vez definido el modelo, DRF brinda herramientas para serializar los datos del modelo a diferentes formatos, como JSON, XML y HTML. La serialización se realiza mediante clases denominadas serializers.

Para definir un serializer en DRF, se define una clase que hereda de serializers.ModelSerializer y se utiliza el atributo Meta para especificar el modelo y los campos que se incluirán en la respuesta. Por ejemplo:

from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['id', 'username', 'first_name', 'last_name', 'email', 'date_joined']

Este serializer incluirá los campos id, username, first_name, last_name, email, y date_joined en la respuesta.

Una vez que se ha definido un modelo y su correspondiente serializer, podemos utilizarlos para crear una vista que permita interactuar con los datos de la tabla. Por ejemplo, una vista que permita listar los usuarios y crear nuevos usuarios sería:

from rest_framework import generics
from .models import User
from .serializers import UserSerializer

class UserList(generics.ListCreateAPIView):
    queryset = User.objects.all()
    serializer_class = UserSerializer

En este caso, generics.ListCreateAPIView es una vista genérica proporcionada por DRF que permite listar y crear objetos de un modelo. La vista utiliza el queryset User.objects.all() para obtener todos los usuarios de la base de datos y el serializer UserSerializer para serializar los datos obtenidos.

En resumen, para utilizar Django Rest Framework para construir una API, se definen modelos de Django para representar la estructura de los datos y luego se crean serializadores para convertir los datos de Django en formatos API compatibles. Estos modelos y serializadores se usan para definir vistas genéricas que permiten interactuar con los datos a través de la API.

Creación de una API para una aplicación de notas usando Django Rest Framework

Empezamos definiendo un modelo para nuestras notas. Este modelo incluirá campos para el título, el contenido y las fechas de creación y actualización:

class Nota(models.Model):
    titulo = models.CharField(max_length=100)
    contenido = models.TextField()
    fecha_creacion = models.DateTimeField(auto_now_add=True)
    fecha_actualizacion = models.DateTimeField(auto_now=True)

Para serializar los datos de este modelo a un formato compatible con REST, definimos una clase de serializador. Este serializador indicará qué campos del modelo se incluirán en la representación serializada:

class NotaSerializer(serializers.ModelSerializer):
    class Meta:
        model = Nota
        fields = ('id', 'titulo', 'contenido', 'fecha_creacion', 'fecha_actualizacion')

Con esta configuración del serializador, estamos incluyendo el campo 'id', que Django genera automáticamente para cada instancia del modelo.

Finalmente, para exponer estos datos serializados a través de nuestra API, podemos crear una vista que muestre todas las notas. En este ejemplo, utilizamos una vista que maneja solicitudes GET para devolver una lista de todas las notas en formato JSON:

class ListaNotasView(generics.ListAPIView):
    queryset = Nota.objects.all()
    serializer_class = NotaSerializer

Con esta vista, cuando un cliente realiza una petición GET a la URL correspondiente, recibirá una lista de todas las notas, serializadas según nuestro serializador.

Creación de una API para gestionar una tienda en línea con Django Rest Framework

Para comenzar, definimos nuestro modelo de productos en el archivo models.py. Este modelo incluirá campos para el nombre, descripción, precio, imagen y fecha de publicación:

from django.db import models

class Producto(models.Model):
    nombre = models.CharField(max_length=100)
    descripcion = models.TextField(blank=True)
    precio = models.DecimalField(max_digits=6, decimal_places=2)
    imagen = models.ImageField(upload_to='productos', blank=True)
    fecha_publicacion = models.DateTimeField(auto_now_add=True)

Una vez definido el modelo Producto, procedemos a la serialización de los datos para convertirlos en un formato compatible con nuestra API. Esto lo hacemos en el archivo serializers.py:

from rest_framework import serializers
from .models import Producto

class ProductoSerializer(serializers.ModelSerializer):
    class Meta:
        model = Producto
        fields = ('id', 'nombre', 'descripcion', 'precio', 'imagen', 'fecha_publicacion')

El uso de ModelSerializer facilita la definición de la serialización, permitiendo especificar simplemente el modelo y los campos que queremos incluir.

Para exponer estos datos, creamos las vistas en el archivo views.py. Utilizamos vistas genéricas que permiten listar, crear, actualizar y eliminar los productos:

from rest_framework import generics
from .models import Producto
from .serializers import ProductoSerializer

class ProductoList(generics.ListCreateAPIView):
    queryset = Producto.objects.all()
    serializer_class = ProductoSerializer

class ProductoDetail(generics.RetrieveUpdateDestroyAPIView):
    queryset = Producto.objects.all()
    serializer_class = ProductoSerializer

Finalmente, integramos estas vistas en las rutas de nuestra aplicación mediante el archivo urls.py:

from django.urls import path
from .views import ProductoList, ProductoDetail

urlpatterns = [
    path('productos/', ProductoList.as_view()),
    path('productos//', ProductoDetail.as_view()),
]

Con estas configuraciones, hemos creado una API robusta para gestionar los productos en nuestra tienda en línea, utilizando Django Rest Framework para manejar tanto la lógica de los datos como las interacciones con los usuarios.