FilePathField – Modelos de Django

FilePathField es un CharField cuyas opciones están limitadas a los nombres de archivo en un directorio determinado en el sistema de archivos. Las instancias de FilePathField se crean en su base de datos como varcharcolumnas con una longitud máxima predeterminada de 100 caracteres.

Sintaxis:

field_name = models.FilePathField(ruta=Ninguna, coincidencia=Ninguna, recursivo=Falso, max_length=100, **opciones )

FilePathField tiene los siguientes argumentos especiales, de los cuales se requiere el primero:

  • FilePathField.path : este atributo es obligatorio. La ruta absoluta del sistema de archivos a un directorio desde el cual este FilePathField debería obtener sus opciones. Ejemplo: "/home/images".
  • FilePathField.match : una expresión regular, como una string, que FilePathField usará para filtrar nombres de archivo. Tenga en cuenta que la expresión regular se aplicará al nombre de archivo base, no a la ruta completa. Ejemplo: “ foo.*\.txt$” , que coincidirá con un archivo llamado foo23.txt pero no con bar.txt o foo23.png .
  • FilePathField.recursive : verdadero o falso . El valor predeterminado es Falso . Especifica si se deben incluir todos los subdirectorios de ruta
  • FilePathField.allow_files : verdadero o falso . El valor predeterminado es Verdadero . Especifica si se deben incluir los archivos en la ubicación especificada. O esto o allow_foldersdebe ser Verdadero.
  • FilePathField.allow_folders : verdadero o falso . El valor predeterminado es Falso . Especifica si se deben incluir las carpetas en la ubicación especificada. O esto o allow_filesdebe ser Verdadero.

El único punto importante a considerar es que la coincidencia se aplica al nombre de archivo base, no a la ruta completa. Entonces, este ejemplo:

FilePathField(path ="/home/images",
              match ="foo.*", 
              recursive = True)

…coincidirá con /home/images/foo.png pero no con /home/images/foo/bar.png porque la coincidencia se aplica al nombre de archivo base ( foo.png y bar.png ).

Django Modelo FilePathField Explicación

Ilustración de FilePathField utilizando un ejemplo. Considere un proyecto llamado geeksforgeeksque tiene una aplicación llamada geeks.

Consulte los siguientes artículos para comprobar cómo crear un proyecto y una aplicación en Django.

Ingrese el siguiente código en models.pyel archivo de la aplicación geeks .

from django.db import models
from django.db.models import Model
# Create your models here.
  
class GeeksModel(Model):
    geeks_field = models.FilePathField(path ="/home/naveen/projects/geeksforgeeks/images")

Agregue la aplicación geeks aINSTALLED_APPS

# Application definition
  
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'geeks',
]

Ahora, cuando ejecutamos makemigrationsel comando desde la terminal,

Python manage.py makemigrations

Se crearía una nueva carpeta llamada migraciones en el geeksdirectorio con un archivo llamado0001_initial.py

# Generated by Django 2.2.5 on 2019-09-25 06:00
  
from django.db import migrations, models
  
class Migration(migrations.Migration):
  
    initial = True
  
    dependencies = [
    ]
  
    operations = [
        migrations.CreateModel(
            name ='GeeksModel',
            fields =[
                ('id', 
                  models.AutoField(
                  auto_created = True,
                  primary_key = True,
                  serialize = False, 
                  verbose_name ='ID'
                )),
                ('geeks_field', models.FilePathField(
                 path ="/home/naveen/projects/geeksforgeeks/images")),
            ],
        ),
    ]

Ahora corre,

Python manage.py migrate

Por lo tanto, se crea un geeks_field FilePathField cuando ejecuta migraciones en el proyecto. Es un campo para almacenar cualquier tipo de archivo en la base de datos.

¿Cómo usar FilePathField?

FilePathField se utiliza para almacenar archivos en la base de datos. Uno puede cualquier tipo de archivo en FilePathField. Intentemos almacenar una imagen en el modelo creado anteriormente.

  • Para comenzar a crear instancias de modelo, cree una cuenta de administrador con el siguiente comando.
    Python manage.py createsuperuser
  • Introduzca un nombre de usuario, correo electrónico y una contraseña segura. Luego, en su navegador ingrese la siguiente URL.
    http://localhost:8000/admin/

    filefield-django-models-1

  • Ir a agregar frente a Geeks Models .
    django-filepathfield-models
  • Elija el archivo que desea cargar y haga clic en guardar. Ahora vamos a comprobarlo en el servidor de administración. Hemos creado una instancia de GeeksModel.
    FilePathField django models

Opciones de campo

Las opciones de campo son los argumentos dados a cada campo para aplicar alguna restricción o impartir una característica particular a un campo en particular. Por ejemplo, agregar un argumento null = Truea FilePathField le permitirá almacenar valores vacíos para esa tabla en la base de datos relacional.
Estas son las opciones de campo y los atributos que puede usar un FilePathField.

Opciones de campo Descripción
Nulo Si es True , Django almacenará valores vacíos como NULL en la base de datos. El valor predeterminado es Falso .
Vacío Si es True , el campo puede estar en blanco. El valor predeterminado es Falso .
columna_db El nombre de la columna de la base de datos que se usará para este campo. Si no se proporciona, Django usará el nombre del campo.
Defecto El valor predeterminado para el campo. Puede ser un valor o un objeto invocable. Si es invocable, se llamará cada vez que se cree un nuevo objeto.
texto de ayuda Texto adicional de «ayuda» que se mostrará con el widget de formulario. Es útil para la documentación incluso si su campo no se usa en un formulario.
Clave primaria Si es Verdadero, este campo es la clave principal para el modelo.
editable Si es False , el campo no se mostrará en el administrador ni en ningún otro ModelForm. También se omiten durante la validación del modelo. El valor predeterminado es Verdadero .
error de mensajes El argumento error_messages le permite anular los mensajes predeterminados que generará el campo. Pase un diccionario con claves que coincidan con los mensajes de error que desea anular.
texto de ayuda Texto adicional de «ayuda» que se mostrará con el widget de formulario. Es útil para la documentación incluso si su campo no se usa en un formulario.
nombre_verbose Un nombre legible por humanos para el campo. Si no se proporciona el nombre detallado, Django lo creará automáticamente utilizando el nombre del atributo del campo, convirtiendo los guiones bajos en espacios.
validadores Una lista de validadores para ejecutar para este campo. Consulte la documentación de los validadores para obtener más información.
Único Si es Verdadero, este campo debe ser único en toda la tabla.

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 *