Formularios Django

Atributo

Descripción

path

La ruta completa de la página solicitada, sin incluir el dominio—por ejemplo, "/hello/".

method

Representación de cadena del método HTTP utilizado en la solicitud. En mayúsculas. Por ejemplo:

if request.method == 'GET':
    do_something()
elif request.method == 'POST':
    do_something_else()

GET

Objeto similar a diccionario que contiene todos los parámetros HTTP GET. Consulta la documentación de QueryDict.

POST

Objeto similar a diccionario que contiene todos los parámetros HTTP POST. Consulta la documentación de QueryDict.

Es posible que el servidor reciba una solicitud POST vacía. Es decir, el formulario envía la solicitud mediante el método HTTP POST, pero el formulario puede no contener datos. Por lo tanto, no se puede usar la sentencia if request.POST para determinar si se utiliza el método HTTP POST; se debe usar if request.method == "POST" (consulta el atributo method de esta tabla).

Nota: POST no incluye información de carga de archivos. Consulta el atributo FILES.

REQUEST

Por conveniencia, este atributo es una combinación de los atributos POST y GET, pero tiene una particularidad: busca primero en el atributo POST y luego en el atributo GET. Se basa en el $_REQUEST de PHP.

Por ejemplo, si GET = {"name": "john"} y POST = {"age": '34'}, entonces el valor de REQUEST["name"] es "john" y el valor de REQUEST["age"] es "34".

Se recomienda encarecidamente usar GET y POST, porque estos dos atributos son más explícitos y el código escrito es más fácil de entender.

COOKIES

Objeto de diccionario estándar de Python que contiene todas las cookies. Las claves y los valores son cadenas.

FILES

Objeto similar a diccionario que contiene todos los archivos subidos. Cada clave en FILES es el valor del atributo name en la etiqueta <input type="file" name="" />. Cada valor en FILES también es un objeto de diccionario estándar de Python que contiene las siguientes tres claves:

• filename: nombre del archivo subido, representado como una cadena de Python.
• content-type: tipo de contenido del archivo subido.
• content: contenido original del archivo subido.

Nota: FILES solo tiene datos si el método de solicitud es POST y la página de solicitud tiene el atributo enctype="multipart/form-data" en el <form>. De lo contrario, FILES es un diccionario vacío.

META

Diccionario que contiene toda la información disponible de los encabezados HTTP. Por ejemplo:

• CONTENT_LENGTH
• CONTENT_TYPE
• QUERY_STRING: la cadena de consulta original sin analizar.
• REMOTE_ADDR: dirección IP del cliente.
• REMOTE_HOST: nombre de host del cliente.
• SERVER_NAME: nombre de host del servidor.
• SERVER_PORT: puerto del servidor.

En META, estos encabezados con el prefijoHTTP_como clave, y lo que sigue a los dos puntos (:) es el valor. Por ejemplo:

• HTTP_ACCEPT_ENCODING
• HTTP_ACCEPT_LANGUAGE
• HTTP_HOST: información del encabezado HTTP Host enviada por el cliente.
• HTTP_REFERER: página de referencia.
• HTTP_USER_AGENT: cadena user-agent del cliente.
• HTTP_X_BENDER: información del encabezado X-Bender.

user

Es un objeto django.contrib.auth.models.User que representa al usuario actualmente conectado.

Si el usuario visitante no ha iniciado sesión, user se inicializará como una instancia de django.contrib.auth.models.AnonymousUser.

Puedes determinar si el usuario ha iniciado sesión mediante el método is_authenticated() de user:

if request.user.is_authenticated():
    # Do something for logged-in users.
else:
    # Do something for anonymous users.

Este atributo solo está disponible cuando AuthenticationMiddleware de Django está activado.

session

El único atributo de lectura y escritura, representa el objeto de diccionario de la sesión actual. Este atributo solo está disponible cuando el soporte de sesiones de Django está activado.

raw_post_data

Datos HTTP POST originales, sin analizar. Son útiles para el procesamiento avanzado.

__getitem__

Hay una pequeña diferencia con el manejo del diccionario estándar: si la clave corresponde a múltiples valores, __getitem__() devuelve el último valor.

__setitem__

Establece la lista de valores (una lista de Python) para la clave especificada por el parámetro. Nota: solo se puede llamar en un objeto QueryDict mutable (es decir, una copia de un objeto QueryDict creada mediante copy()).

get()

Si la clave corresponde a múltiples valores, get() devuelve el último valor.

update()

El parámetro puede ser un QueryDict o un diccionario estándar. A diferencia del método update del diccionario estándar, este método agrega los items del diccionario, en lugar de reemplazarlos:

>>> q = QueryDict('a=1')

>>> q = q.copy() # to make it mutable

>>> q.update({'a': '2'})

>>> q.getlist('a')

 ['1', '2']

>>> q['a'] # returns the last

['2']

items()

Hay una pequeña diferencia con el método items() del diccionario estándar: este método utiliza __getitem__() con lógica de valor único:

>>> q = QueryDict('a=1&a=2&a=3')

>>> q.items()

[('a', '3')]

values()

Hay una pequeña diferencia con el método values() del diccionario estándar: este método utiliza __getitem__() con lógica de valor único:

copy()

Devuelve una copia del objeto, implementada internamente con copy.deepcopy() de la biblioteca estándar de Python. Esta copia es mutable (modificable), es decir, se pueden cambiar los valores de la copia.

getlist(key)

Devuelve todos los valores correspondientes a la clave del parámetro, como una lista de Python. Si la clave no existe, devuelve una lista vacía. Se garantiza que devuelve una lista de algún tipo.

setlist(key,list_)

Establece el valor de la clave como list_ (a diferencia de __setitem__()).

appendlist(key,item)

Agrega un item a la lista interna asociada con la clave.

setlistdefault(key,list)

Hay una pequeña diferencia con setdefault: acepta una lista en lugar de un solo valor como parámetro.

lists()

Hay una pequeña diferencia con items(): devuelve todos los valores de la clave, como una lista, por ejemplo:

>>> q = QueryDict('a=1&a=2&a=3')

>>> q.lists()

[('a', ['1', '2', '3'])]

urlencode()

Devuelve una cadena formateada como cadena de consulta (por ejemplo: "a=2&b=3&b=5").