File オブジェクト¶django.core.files モジュールとそのサブモジュールでは、Django の基本的なファイルハンドリングに関するビルトインクラスが定義されています。
File クラス¶File クラスは、Python の file object に Django 特有の追加機能を付け加えた薄いラッパーです。内部的でファイルを表現する必要がある場合には、Django はこのクラスを使います。
File オブジェクトには次の属性とメソッドを持ちます。
MEDIA_ROOT からの相対パスを含むファイル名です。
このクラスがラッピングしている、素の file object クラスです。
この属性をサブクラスで扱う場合には注意が必要です。
ContentFile や FieldFile など File のサブクラスは、この属性を Python の file object 以外のオブジェクトに置き換えることがあります。このような場合には、この属性自体は File のサブクラスであるかもしれません (が、同じサブクラスとは限りません)。そのため、可能な限り、サブクラスの file 属性ではなく、サブクラス自身が持つ属性やメソッドを使用するようにしてください。
ファイルの読み込み/書き込みのモードです。
ファイルを開くか再オープンします(これは File.seek(0) も行います)。 mode 引数は、Python の組み込み関数 open() と同じ値を許可します。 *args と **kwargs は、mode の後に、Python の組み込み関数 open() に渡されます。
ファイルを再オープンする際、 mode はファイルが元々開かれていたモードを上書きします。 None はオリジナルのモードで再オープンすることを意味します。
コンテキストマネージャとして使用できます。たとえば、 with file.open() as f: のようにです。
*args と **kwargs を渡すためのサポートが追加されました。
ファイルをイテレートし、指定されたサイズの「チャンク」を生成します。 chunk_size のデフォルトは 64 KB です。
これは非常に大きなファイルに特に便利であり、ディスクからストリーミングしてメモリ全体にファイルを保存することを避けることができます。
chunk_size (一括サイズ) で指定されたファイルの全内容にアクセスするために複数のチャンクが必要な場合は True を返します。
リストされたメソッドに加えて、File は、その file オブジェクトの以下の属性とメソッドを公開しています: encoding, fileno, flush, isatty, newlines, read, readinto, readline, readlines, seek, tell, truncate, write, writelines, readable(), writable(), および seekable() 。
ContentFile クラス¶ImageFile クラス¶オブジェクト(以下の Car.photo のように)に関連付けられた File には、いくつかの追加メソッドも用意されています。
提供されたファイル名と内容で新しいファイルを保存します。これは既存のファイルを置き換えるものではありませんが、新しいファイルを作成し、オブジェクトがそれを指すように更新します。 save が True の場合、ファイルが保存されたらモデルの save() メソッドが一度呼び出されます。つまり、次の二行です:
>>> car.photo.save("myphoto.jpg", content, save=False)
>>> car.save()
これは以下と同等です:
>>> car.photo.save("myphoto.jpg", content, save=True)
content 引数は、 File または File のサブクラス(例えば、 ContentFile など)のインスタンスでなければなりません。
モデルインスタンスからファイルを削除し、基になるファイルも削除します。 save が True の場合、ファイルが削除された後にモデルの save() メソッドが一度呼び出されます。
4月 02, 2025