django 1.8 官方文档翻译: 3-3-4 管理文件
2015-09-05 12:04
465 查看
管理文件
这篇文档描述了Django为那些用户上传文件准备的文件访问API。底层的API足够通用,你可以使用为其它目的来使用它们。如果你想要处理静态文件(JS,CSS,以及其他),参见管理静态文件(CSS和图像)。通常,Django使用
MEDIA_ROOT和
MEDIA_URL设置在本地储存文件。下面的例子假设你使用这些默认值。
然而,Django提供了一些方法来编写自定义的 文件储存系统,允许你完全自定义Django在哪里以及如何储存文件。这篇文档的另一部分描述了这些储存系统如何工作。
在模型中使用文件
当你使用FileField或者
ImageField的时候,Django为你提供了一系列的API用来处理文件。
考虑下面的模型,它使用
ImageField来储存一张照片:
from django.db import models 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')
任何
Car的实例都有一个
photo字段,你可以通过它来获取附加图片的详细信息:
>>> car = Car.objects.get(name="57 Chevy") >>> car.photo <ImageFieldFile: chevy.jpg> >>> car.photo.name 'cars/chevy.jpg' >>> car.photo.path '/media/cars/chevy.jpg' >>> car.photo.url 'http://media.example.com/cars/chevy.jpg'
例子中的
car.photo对象是一个
File对象,这意味着它拥有下面描述的所有方法和属性。
注意
文件保存是数据库模型保存的一部分,所以磁盘上真实的文件名在模型保存之前并不可靠。
例如,你可以通过设置文件的
name属性为一个和文件储存位置 (
MEDIA_ROOT,如果你使用默认的
FileSystemStorage)相关的路径,来修改文件名称。
>>> import os >>> from django.conf import settings >>> initial_path = car.photo.path >>> car.photo.name = 'cars/chevy_ii.jpg' >>> new_path = settings.MEDIA_ROOT + car.photo.name >>> # Move the file on the filesystem >>> os.rename(initial_path, new_path) >>> car.save() >>> car.photo.path '/media/cars/chevy_ii.jpg' >>> car.photo.path == new_path True
File
当Django需要表示一个文件的时候,它在内部使用django.core.files.File实例。这个对象是 Python 内建文件对象的一个简单封装,并带有一些Django特定的附加功能。
大多数情况你可以简单地使用Django提供给你的
File对象(例如像上面那样把文件附加到模型,或者是上传的文件)。
如果你需要自行构造一个
File对象,最简单的方法是使用Python内建的
file对象来创建一个:
>>> from django.core.files import File # Create a Python file object using open() >>> f = open('/tmp/hello.world', 'w') >>> myfile = File(f)
现在你可以使用
File类的任何文档中记录的属性和方法了。
注意这种方法创建的文件并不会自动关闭。以下步骤可以用于自动关闭文件:
>>> from django.core.files import File # Create a Python file object using open() and the with statement >>> with open('/tmp/hello.world', 'w') as f: ... myfile = File(f) ... myfile.write('Hello World') ... >>> myfile.closed True >>> f.closed True
在处理大量对象的循环中访问文件字段时,关闭文件极其重要。如果文件在访问之后没有手动关闭,会有消耗完文件描述符的风险。这可能导致如下错误:
IOError: [Errno 24] Too many open files
文件储存
在背后,Django需要决定在哪里以及如何将文件储存到文件系统。这是一个对象,它实际上理解一些东西,比如文件系统,打开和读取文件,以及其他。Django的默认文件储存由
DEFAULT_FILE_STORAGE设置提供。如果你没有显式提供一个储存系统,就会使用它。
关于内建的默认文件储存系统的细节,请参见下面一节。另外,关于编写你自己的文件储存系统的一些信息,请见编写自定义的文件系统。
储存对象
大多数情况你可能并不想使用File对象(它向文件提供适当的存储功能),你可以直接使用文件储存系统。你可以创建一些自定义文件储存类的实例,或者 – 大多数情况更加有用的 – 你可以使用全局的默认储存系统:
>>> 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 '/path/to/file' >>> default_storage.size(path) 11 >>> default_storage.open(path).read() 'new content' >>> default_storage.delete(path) >>> default_storage.exists(path) False
关于文件储存API,参见 文件储存API。
内建的文件系统储存类
Django自带了django.core.files.storage.FileSystemStorage类,它实现了基本的本地文件系统中的文件储存。
例如,下面的代码会在
/media/photos目录下储存上传的文件,无论
MEDIA_ROOT设置是什么:
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)
自定义储存系统 以相同方式工作:你可以把它们作为
storage参数传递给
FileField。
译者:Django 文档协作翻译小组,原文:Managing files。
本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。
相关文章推荐
- django 1.8 官方文档翻译: 3-3-3 文件储存API
- django-admin.py startproject 无法创建项目
- history.go(-1)无法获取表单数据的解决方法
- dragonbones插件编译
- 我的Logo设计简史
- go基本数据类型与运算符
- HDU 1533 二分图最小权匹配 Going Home
- go语言学习杂记
- 第四章 Django 基础
- django 1.8 官方文档翻译: 3-5-2 使用Django输出PDF
- 关于lingo的积累
- django 1.8 官方文档翻译: 3-5-1 使用Django输出CSV
- HDU 3966 Aragorn's Story(树链剖分)
- 总结django form
- 【英语】Bingo口语笔记(65) - 我也是系列
- 【英语】Bingo口语笔记(64) - Beat系列
- django的get和filter方法的区别
- 提高django model效率的几个小方法
- Algorithms - Week 1-1 Analysis of Algorithms
- 第三章 Getting Ready to Tango