Tangguh adalah sebuah aplikasi yang sesuai Django ke Negara Transfer (REST).
Penggunaan
Cat dasar
Tangguh dipengaruhi oleh Ruby on Rails, meskipun dalam semangat Python itu tidak hampir sama "ajaib". Ini akan, bagaimanapun, menghemat banyak kode:
# Berita / models.py
dari model impor django.db
Kelas Pasal (models.Model):
& Nbsp; title = models.CharField (max_length = 255)
& Nbsp; content = models.TextField ()
& Nbsp; diterbitkan = True
& Nbsp; created_at = models.DateTimeField (auto_now_add = True)
# Berita / urls.py
dari django.conf.urls.defaults impor *
dari sumber daya impor respite.urls
dari pandangan impor ArticleView
urlpatterns = sumber daya (
& Nbsp; prefix = 'berita / artikel',
& Nbsp; view = ArticleView
)
# Berita / views.py
dari tangguh impor View
dari model impor Pasal
kelas ArticleView (Lihat):
& Nbsp; Model = Pasal
& Nbsp; template_path = 'berita / artikel'
& Nbsp; supported_formats = ['html', 'json']
# Templates / berita / artikel / index.html


& Nbsp;
& Nbsp;
& Nbsp;
& Nbsp;
& Nbsp; {% untuk artikel di artikel%}
& Nbsp;

& Nbsp;

{{}} article.title

& Nbsp; {{}} article.created_at
& Nbsp;

& Nbsp; {{}} article.content
& Nbsp;

& Nbsp;

& Nbsp; {% endfor%}
& Nbsp;

# Templates / berita / artikel / index.json
# ...
Tindakan standar
Tangguh ini View kelas mendefinisikan tindakan untuk melihat dan memanipulasi kasus Model; Indeks, acara, baru, membuat, mengedit & sbquo; memperbarui dan menghancurkan.
HTTP metode HTTP jalur Fungsi Tujuan
GET artikel / index Render daftar artikel
GET artikel / baru baru Render formulir untuk membuat artikel baru
Artikel POST / buat Buat artikel baru
GET artikel / 1 acara Render artikel tertentu
GET artikel / 1 / mengedit mengedit Render formulir untuk mengedit artikel tertentu
PUT artikel / 1 update Mengedit artikel tertentu
DELETE artikel / 1 menghancurkan Menghapus artikel tertentu
Singkatnya, tangguh menyediakan Anda dengan koleksi fitur yang Anda mungkin perlu untuk sebagian besar model dan rute mereka RESTfully. Anda dapat mengganti salah satu atau semua fungsi dan menyesuaikan mereka seperti yang Anda inginkan. Misalnya, Anda hanya bisa daftar artikel yang telah diterbitkan:
# Berita / views.py
kelas ArticleView (Lihat):
& Nbsp; Model = Pasal
& Nbsp; template_path = 'berita / artikel'
& Nbsp; supported_formats = ['html', 'json']
& Nbsp; indeks def (diri, permintaan):
& Nbsp; artikel = self.model.objects.filter (diterbitkan = True)
& Nbsp; kembali self._render (
& Nbsp; request = permintaan,
& Nbsp; 'index' Template =,
& Nbsp; context = {
& Nbsp; artikel ': artikel,
& Nbsp;},
& Nbsp; status = 200
& Nbsp;)
Anda juga dapat menghilangkan salah satu atau beberapa tindakan standar sama sekali. Misalnya, Anda hanya bisa menerapkan indeks dan menunjukkan tindakan:
# Berita / urls.py
dari django.conf.urls.defaults impor *
dari sumber daya impor respite.urls
dari pandangan impor ArticleView
urlpatterns = sumber daya (
& Nbsp; prefix = 'berita / artikel',
& Nbsp; view = ArticleView,
& Nbsp; tindakan = ['index', 'show']
)
Tindakan kustom
Anda tidak terbatas pada tujuh tindakan yang telah ditetapkan tangguh Anak; Anda dapat menambahkan sejumlah tindakan kustom dan rute mereka namun Anda suka:
# Berita / urls.py
dari django.conf.urls.defaults impor *
dari respite.urls mengimpor sumber daya, tindakan
dari pandangan impor ArticleView
urlpatterns = sumber daya (
& Nbsp; prefix = 'berita / artikel',
& Nbsp; view = ArticleView,
& Nbsp; custom_actions = [
& Nbsp; tindakan (
& Nbsp; regex = r '(? P [0-9] +).? / Pratinjau [a-zA-Z] * $',
& Nbsp; function = 'preview',
& Nbsp; metode = ['GET'],
& Nbsp; nama = 'preview_news_article'
& Nbsp;)
& Nbsp;]
)
# Berita / views.py
dari tangguh impor View
dari model impor Pasal
kelas ArticleView (Lihat):
& Nbsp; Model = Pasal
& Nbsp; template_path = 'berita / artikel'
& Nbsp; supported_formats = ['html', 'json']
& Nbsp; pratinjau def (diri, permintaan, id):
& Nbsp; Artikel = Article.objects.get (id = id)
& Nbsp; kembali self._render (
& Nbsp; request = permintaan,
& Nbsp; Template = 'preview',
& Nbsp; context = {
& Nbsp; 'artikel': Artikel
& Nbsp;},
& Nbsp; status = 200
& Nbsp;)
Instalasi
- Pip install git + http: //github.com/jgorset/respite.git
- Tambahkan tangguh untuk INSTALLED_APPS dalam file pengaturan Anda
- Tambahkan respite.middleware.HTTPPUTMiddleware ke MIDDLEWARE_CLASSES dalam file pengaturan Anda
Jika Anda tidak hanya membangun API, Anda juga mungkin ingin menambahkan respite.middleware.HTTPMethodOverrideMiddleware untuk kelas middleware Anda; memfasilitasi untuk override metode HTTP dengan header X-HTTP-Metode-Override atau parameter POST _method HTTP, yang merupakan satu-satunya cara untuk memperbarui (HTTP PUT) dan menghapus (HTTP DELETE) sumber daya dari web browser.

Persyaratan :

• Python
• Django