Menulis sistem penyimpanan disesuaikan¶
Jika anda butuh untuk menyediakan penyimpanan berkas disesuaikan -- contoh umum adalah menyimpan berkas di beberapa sistem terpencil -- anda dapat melakukannya dengan menentukan kelas penyimpanan disesuaikan. Anda akan butuh mengikuti langkah-langkah ini:
Sistem penyimpanan disesuaikan anda harus subkelas dari
django.core.files.storage.Storage
:from django.core.files.storage import Storage class MyStorage(Storage): ...
Django harus dapat memberikan contoh sistem penyimanan disesuaikan anda tanpa argumen apapun. Ini berarti bahwa setiap pengaturan harus diambil dari
django.conf.settings
:from django.conf import settings from django.core.files.storage import Storage class MyStorage(Storage): def __init__(self, option=None): if not option: option = settings.CUSTOM_STORAGE_OPTIONS ...
Kelas penyimpanan anda harus menerapkan metode
_open()
dan_save()
, bersama dengan cara lainnya sesuai pada kelas penyimpanan anda. Lihat dibawah untuk lebih pada cara ini.Sebagai tambahan, jika kelas anda menyediakan penyimpanan berkas lokal, itu harus menimpa metode
path()
.Kelas penyimpanan anda harus deconstructible sehingga dia dapat di serialkan ketika digunakan pada bidang dalam sebuah perpindahan. Selama bidang anda mempunyai argumen yang mereka sendiri serializable, anda dapat menggunakan kelas decorator untuk ini (itu mengapa Django digunakan pada FileSystemStorage).
Secara awalan, metode berikut memunculkan NotImplementedError
dan akan khususnya ditimpa:
Catat bagaimanapun bahwa tidak semua metode ini diwajibkan dan mungkin sengaja dihilangkan. Ketika itu terjadi, itu memungkinkan meninggalkan setiap cara tidak diterapkan dan masih memiliki Penyimpanan bekerja.
By way of example, if listing the contents of certain storage backends turns
out to be expensive, you might decide not to implement Storage.listdir()
.
Cara lain akan menjadi backend yang ahnya menangani penulisan ke berkas. Dalam kasus ini, anda tidak akan butuh menerapkan apapun metode diatas.
Akhirnya, metode mana yang anda terapkan terserah anda. Meninggalkan beberapa cara tidak diterapkan akan menghasilkan antarmuka sebagian (kemungkinan rusak).
Anda akan juga ingin menggunakan penghubung khususnya dirancang untuk obyek penyimpanan disesuaikan. Ini adalah:
-
_open
(name, mode='rb')¶
Wajib.
Dipanggil oleh Storage.open()
, ini adalah mekanisme sesungguhnya kelas penyimpanan digunakan untuk membuka berkas. Ini harus mengembalikan sebuah obyek File
, meskipun dalam kebanyakan kasus, anda ingin mengembalikan beberapa subkelas disini yang menerapkan logika spesifik ke sistem penyimpanan belakang.
-
_save
(name, content)¶
Dipanggil oleh Storage.save()
, name
sudah telah melalui get_valid_name()
dan get_available_name()
, dan content
akan menjadi obyek File
itu sendiri.
Harus mengembalikan nama sebenarnya dari nama dari berkas tersimpan (biasanya name
disahkan, tetapi jika penyimpanan butuh merubah nama berkas mengembalikan nama baru sebagai gantinya).
-
get_valid_name
(name)¶
Mengembalikan sebuah nama berkas yang cocok untuk digunakan dengan sistem penyimpanan pokok. Argumen name
dilewati ke cara ini antara berkas nama asli dikirim ke peladen atau, jika upload_to
adalah callable, nama berkas dikembalikan oleh cara tersebut setelah informasi jalur dipindahkan. Kesampingkan ini untuk menyesuaikan bagaimana karakter bukan-standar dirubah ke nama berkas aman.
Kode disediakan di Storage
hanya mempertahankan karakter alpanumerik, titik dan garis bawah dari nama berkas asli, memindahkan semua yang lainnya.
-
get_alternative_name
(file_root, file_ext)¶
Mengembalikan nama berkas lain berdasarkan pada parameter file_root
dan file_ext
. Secara awalan, sebuah garis bawah ditambah 7 karakter string alfanumerik acak ditambahkan ke nama berkas sebelum ekstensi.
-
get_available_name
(name, max_length=None)¶
Mengembalikan nama berkas yang tersedia di mekanisme penyimpanan, barangkali mengambil nama berkas tersedia ke dalam akun. argumen name
dilewati ke cara ini akan sudah dibersihkan ke nama berkas sah untuk sistem penyimpanan, menurut cara get_valid_name()
digambarkan diatas.
Panjang dari nama berkas tidak melebihi max_length
, jika disediakan. Jika nama berkas unik bebas tidak dapat ditemukan, sebuah pengecualian SuspiciousFileOperation
muncul.
Jika sebuah berkas dengan name
sudah ada, get_alternative_name()
dipanggil untuk mendapatkan nama alternatif.