Campos numéricos en serializadores – Django REST Framework

En Django REST Framework, el concepto mismo de Serialización es convertir datos de base de datos a un tipo de datos que pueda ser utilizado por javascript. Cada serializador viene con algunos campos (entradas) que se van a procesar. Por ejemplo, si tiene una clase con el nombre Empleado y sus campos como Employee_id, Employee_name, is_admin, etc. Entonces, necesitará AutoField, CharField y BooleanField para almacenar y manipular datos a través de Django. De manera similar, el serializador también funciona con el mismo principio y tiene campos que se usan para crear un serializador. 
Este artículo gira en torno a los campos numéricos en serializadores en Django REST Framework. Hay tres campos principales: IntegerField, FloatField y DecimalField.
 

CampoEntero

IntegerField es básicamente un campo entero que valida la entrada contra la instancia int de Python. Es lo mismo que IntegerField – Django Models
Tiene los siguientes argumentos – 
 

  • max_value Valida que el número proporcionado no sea mayor que este valor.
  • min_value Valida que el número proporcionado no sea inferior a este valor.

Sintaxis – 
 

field_name = serializers.IntegerField(*args, **kwargs)

campo flotante

FloatField es básicamente un campo flotante que valida la entrada contra la instancia flotante de Python. Es lo mismo que FloatField – Django Models
Tiene los siguientes argumentos – 
 

  • max_value Valida que el número proporcionado no sea mayor que este valor.
  • min_value Valida que el número proporcionado no sea inferior a este valor.

Sintaxis – 
 

field_name = serializers.FloatField(*args, **kwargs)

campo decimal

DecimalField es básicamente un campo decimal que valida la entrada contra la instancia decimal de Python. Es lo mismo que DecimalField – Django Models
Tiene los siguientes argumentos – 
 

  • max_digits El número máximo de dígitos permitidos en el número. Debe ser Ninguno o un número entero mayor o igual que decimal_places.
  • decimal_places El número de lugares decimales para almacenar con el número.
  • max_value Valida que el número proporcionado no sea mayor que este valor.
  • min_value Valida que el número proporcionado no sea inferior a este valor.
  • localizar Establézcalo en Verdadero para habilitar la localización de entrada y salida en función de la configuración regional actual.

Sintaxis – 
 

field_name = serializers.DecimalField(*args, **kwargs)

¿Cómo usar campos numéricos en serializadores?

Para explicar el uso de los campos numéricos, usemos la misma configuración de proyecto de: ¿Cómo crear una API básica usando Django Rest Framework?
Ahora que tiene un archivo llamado serializadores en su proyecto, creemos un serializador con IntegerField, FloatField y DecimalField como campos. 
 

Python3

# import serializer from rest_framework
from rest_framework import serializers
 
class Geeks(object):
    def __init__(self, integer, float_number, decimal_number):
        self.integer = integer
        self.float_number = float_number
        self.decimal_number = decimal_number
 
# create a serializer
class GeeksSerializer(serializers.Serializer):
    # initialize fields
    integer = serializers.IntegerField()
    float_number = serializers.FloatField()
    decimal_number = serializers.DecimalField()

Ahora vamos a crear algunos objetos e intentar serializarlos y verificar si realmente funcionan, Ejecutar, – 
 

Python manage.py shell

Ahora, ejecute los siguientes comandos de python en el shell 
 

# import everything from serializers
>>> from apis.serializers import *

# create a object of type Geeks
>>> obj = Geeks(123, 123.10, 123.123)

# serialize the object
>>> serializer = GeeksSerializer(obj)

# print serialized data
>>> serializer.data
{'integer': 123, 'float_number': 123.1, 'decimal_number': '123.1230'}

Aquí está el resultado de todas estas operaciones en la terminal: 
 

numeric-fields-in-serializers-Django-REST-Framework

Validación en campos numéricos

Tenga en cuenta que el lema principal de estos campos es impartir validaciones, como IntegerField valida los datos solo para Python. Verifiquemos si estas validaciones funcionan o no: 
 

# Create a dictionary and add invalid values
>>> data={}
>>> data['integer'] = 10
>>> data['float_number'] = "String"
>>> data['decimal_number'] = 123

# dictionary created
>>> data
{'integer': 10, 'float_number': 'String', 'decimal_number': 123}

# deserialize the data
>>> serializer = GeeksSerializer(data=data)

# check if data is valid
>>> serializer.is_valid()
False

# check the errors
>>> serializer.errors
{'float_number': [ErrorDetail(string='A valid number is required.', 
code='invalid')]}
}

Aquí está el resultado de estos comandos que muestra claramente que el correo electrónico y el número de teléfono no son válidos: 
 

numeric-fields-in-serializres-Django-REST-Framework

Conceptos avanzados

Las validaciones son parte de la deserialización y no de la serialización. Como se explicó anteriormente, la serialización es un proceso de conversión de datos ya creados en otro tipo de datos, por lo que no se requieren estas validaciones predeterminadas. La deserialización requiere validaciones ya que los datos deben guardarse en la base de datos o cualquier otra operación según lo especificado. Entonces, si serializa datos usando estos campos, eso funcionaría.
 

Argumentos centrales en los campos del serializador

.math-table { borde-colapso: colapsar; ancho: 100%; } .math-table td { borde: 1px sólido #5fb962; alineación de texto: izquierda! importante; relleno: 8px; } .math-table th { borde: 1px sólido #5fb962; relleno: 8px; } .math-table tr>th{ color de fondo: #c6ebd9; alineación vertical: medio; } .math-table tr:nth-child(odd) { background-color: #ffffff; } 

Argumento Descripción
solo lectura Establézcalo en True para asegurarse de que el campo se use al serializar una representación, pero no al crear o actualizar una instancia durante la deserialización.
escribir solamente Establézcalo en True para asegurarse de que el campo se pueda usar al actualizar o crear una instancia, pero no se incluya al serializar la representación.
requerido Establecer esto en False también permite omitir el atributo del objeto o la clave del diccionario de la salida al serializar la instancia.
defecto Si se establece, proporciona el valor predeterminado que se utilizará para el campo si no se proporciona ningún valor de entrada.
permitir nula Normalmente, se generará un error si se pasa Ninguno a un campo serializador. Establezca este argumento de palabra clave en Verdadero si Ninguno debe considerarse un valor válido.
fuente El nombre del atributo que se utilizará para rellenar el campo.
validadores Una lista de funciones de validación que deben aplicarse a la entrada de campo entrante y que generan un error de validación o simplemente regresan.
error de mensajes Un diccionario de códigos de error a mensajes de error.
etiqueta Una string de texto corta que se puede usar como el nombre del campo en campos de formulario HTML u otros elementos descriptivos.
texto de ayuda Una string de texto que se puede utilizar como descripción del campo en campos de formulario HTML u otros elementos descriptivos.
inicial Un valor que debe usarse para completar previamente el valor de los campos de formulario HTML.

Publicación traducida automáticamente

Artículo escrito por NaveenArora y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *