Campos de selección de elección 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 de selección de opciones en serializadores en Django REST Framework. Hay dos campos principales: Choice y MultipleChioceField.
 

campo de elección

ChoiceField es básicamente un CharField que valida la entrada contra un valor de un conjunto limitado de opciones. Este campo es el mismo que ChoiceField – Django Forms .
Tiene los siguientes argumentos: 
 

• opciones : una lista de valores válidos o una lista de tuplas (clave, nombre_de_visualización).
• allow_blank : si se establece en True, la string vacía debe considerarse un valor válido. Si se establece en False, la string vacía se considera no válida y generará un error de validación. El valor predeterminado es falso.
• html_cutoff : si se establece, esta será la cantidad máxima de opciones que se mostrarán en un menú desplegable de selección de HTML. Se puede utilizar para garantizar que los ChoiceFields generados automáticamente con selecciones posibles muy grandes no impidan que se represente una plantilla. El valor predeterminado es Ninguno.
• html_cutoff_text : si se establece, se mostrará un indicador de texto si se ha cortado el número máximo de elementos en un menú desplegable de selección de HTML. El valor predeterminado es «Más de {count} artículos…»

Sintaxis – 
 

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

campo de elección múltiple

ChoiceField es básicamente un CharField que valida la entrada contra un conjunto de cero, uno o muchos valores, elegidos de un conjunto limitado de opciones. Este campo es el mismo que MultipleChoiceField – Django Forms .
Sintaxis – 
 

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

¿Cómo usar campos de selección de elección en serializadores?

Para explicar el uso de los campos de selección de elección, 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 ChoiceField y MultipleChoiceField como campos. 
 

# import serializer from rest_framework
from rest_framework import serializers
  
class Geeks(object):
    def __init__(self, choices, multiplechoices):
        self.choices = choices
        self.multiplechoices = multiplechoices
  
# create a tuple
GEEKS_CHOICES =( 
    ("1", "One"), 
    ("2", "Two"), 
    ("3", "Three"), 
    ("4", "Four"), 
    ("5", "Five"), 
)
  
# create a serializer
class GeeksSerializer(serializers.Serializer):
    # initialize fields
    choices = serializers.ChoiceField(
                        choices = GEEKS_CHOICES)
    multiplechoices = serializers.MultipleChoiceField(
                        choices = GEEKS_CHOICES)

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("One", ["One", "Two"])

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

# print serialized data
>>> serializer.data
{'choices': 'One', 'multiplechoices': {'Two', 'One'}}

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

Validación en campos de selección de elección

Tenga en cuenta que el lema principal de estos campos es impartir validaciones, como ChoiceField valida los datos solo para una selección de opciones seleccionadas. Verifiquemos si estas validaciones funcionan o no: 
 

# Create a dictionary and add invalid values
>>> data={}
>>> data['choices'] = "Naveen"
>>> data['multiplechoices'] = ["One", "Two"]

# dictionary created
>>> data
{'choices': 'Naveen', 'multiplechoices': ['One', 'Two']}

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

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

# check the errors
>>> serializer.errors
{'choices': [ErrorDetail(string='"Naveen" is not a valid choice.', code='invalid_choice')],
'multiplechoices': [ErrorDetail(string='"One" is not a valid choice.', code='invalid_choice')]}

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: 
 

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