Dateien in Models nutzen¶

Wenn du ein FileField oder ein ImageField benutzt, kannst du die Django-API benutzen. Django bietet dir eine Reihe an APIs, die du benutzen kannst, um die Datei zu verwalten.

Wir nehmen folgendes Modell an, in dem ein FileField benutzt wird um, ein Foto abzuspeichern:

class Car(models.Model):
    name = models.CharField(max_length=255)
    price = models.DecimalField(max_digits=5, decimal_places=2)
    photo = models.ImageField(upload_to='cars')

Jedes Car-Exemplar hat ein photo-Attribut, über das Du das zugeordnete Photo ansprechen kannst:

>>> car = Car.objects.get(name="57 Chevy")
>>> car.photo
<ImageFieldFile: chevy.jpg>
>>> car.photo.name
u'cars/chevy.jpg'
>>> car.photo.path
u'/media/cars/chevy.jpg'
>>> car.photo.url
u'http://media.example.com/cars/chevy.jpg'

Dieses Objekt -- hier car.photo -- ist ein File-Objekt, das alle Methoden und Attribute besitzt, die im folgenden beschrieben werden:

Das File-Objekt¶

Django benutzt intern django.core.files.File, wenn es eine Datei abbilden will. Dies ist ein Adapter um Pythons eingebautes file-Objekt mit einigen Django-spezifischen Ergänzungen:

Meist wirst du das File-Objekt einfach benutzen (heißt, als Datei die wie oben zu einem Model gehört, oder beispielsweise eine hochgeladene Datei)

Wenn du selbst ein File erstellen möchtest, führt der einfachste Weg über Pythons eingebautes file-Objekt:

>>> from django.core.files import File
# Erstelle ein Python-file-Objekt durch open()
>>> f = open('/tmp/hello.world', 'w')
>>> myfile = File(f)

Jetzt kannst du alle File-Attribute und -Methoden, wie in ref-files-file dokumentiert, benutzen.

Datei-Speicher¶

Im Hintergrund delegiert Django die eigentliche Arbeit (wie und wo Dateien gespeichert werden) an einen Datei-Speicher. Dieser kümmert sich um Details wie Dateisysteme, das Öffnen und Schreiben der Dateien, etc.

Djangos Standard-Datei-Speicher wird durch die DEFAULT_FILE_STORAGE-Einstellung festgelegt. Wenn du nicht explizit einen anderen angibst, wird dieser benutzt.

Weiter unten findest du Details, wie du den eingebauten Standard-Datei-Speicher benutzen kannst; unter Ein eigenes Dateispeichersystem schreiben findest du Informationen darüber, wie du einen eigenen Datei-Speicher schreiben kannst.

>>> from django.core.files.storage import default_storage
>>> from django.core.files.base import ContentFile

>>> path = default_storage.save('/path/to/file', ContentFile('new content'))
>>> path
u'/path/to/file'

>>> default_storage.filesize(path)
11
>>> default_storage.open(path).read()
'new content'

>>> default_storage.delete(path)
>>> default_storage.exists(path)
False

from django.db import models
from django.core.files.storage import FileSystemStorage

fs = FileSystemStorage(location='/media/photos')

class Car(models.Model):
    ...
    photo = models.ImageField(storage=fs)