一、表示已经上传的文件(uploaded files)的类
表示已经上传的文件的类有下面几个:
class UploadedFile
在文件上传的期间,实际的文件数据被存储在request.FILES。在这个字典中的每一项都是一个UploadedFile对象或者是子类的对象。这是一个对已经上传文件的简单封装,你可以通过以下方法进行访问上传的内容。
方法:
read()
从该文件中读取整块上传的数据,使用这个方法必须小心,如果该上传的文件特别大,它将使得你的系统崩溃,相反你可以使用chunks()方法来一小块小块的读取到内存中。
multiple_chunks(chunk_size=None)
如果上传的文件足够大需要在多个块(chunks)中进行读取,将会返回True。默认情况下,这将会是任何大于2.5 MB的文件,但是这个是可以配置的。
chunks()
这个一个返回文件chunks的生成器。如果multiple_chunks()为True,你应该在循环中使用这个方法而不是read()。
实际上,经常最简单的使用方法是总是使用chunks()。然后循环这个chunks()方法而不是使用read(),这样确保大文件不会过分占用你的系统内存。
属性 :
name
上传过的文件的文件名
size
上传过的文件的文件大小
content_type
伴随这个上传文件的content-type头部。(例如:text/plain或者application/pdf)。与用户提供的任何数据一样,您不应该相信上传的文件实际上是这种类型的。您仍然需要验证该文件包含的内容是否是content-type头部声明的。trust but verify。
content_type_extra
这是一个字典,包含了额外的传入content-type的参数。这个通常是由诸如Google App Engine服务提供的,这将拦截这个文件并代表你处理这个文件。结果是你的处理器可能不会接收到上传文件的内容,相反是一个URL或者其他指向这个文件的指针。
charset
字符集,对于text/* content-types,这个设置(例如 utf-8)由浏览器提供。trust but verify。
注意:
例如常规的Python文件,你可以仅仅迭代这个上传的文件来一行一行读取这个文件。
for line in uploadedfile
do_someting_with(line)
UploadFile的子类包括:
class TemporaryloadedFile
一个上传至临时文件的(i.e. stream-to-disk)位置。这个类通常被TemporaryFileUploadHandler。除了UploadedFile的方法外,还有一个额外的方法。
方法:
temporary_file_path()
返回这个临时上传文件的完整路径。
class InMemoryUploadedFile
放入内存中上传过的文件。(i.e. stream-to-memoey)。这个类通常由MemoryFileUploadHandler使用。
二、内建的上传处理器
MemoryFileUploadHandler和TemporaryFileUploadHandler这个两个处理器分别提供django上传的文件默认行为,读取小文件到内存中,读取大文件到磁盘中。
他们都位于django.core.files.uploadhandler中,前者用于小文件,该处理器流上传至内存中,后者使用TemporaryUploadFile,将数据流入一个临时的文件。
三、自定义上传处理器
class FileUploadHandler,自定义处理器必须是该子类,位于django.core.files.uploadedhandler.FileUploadHander。