Respite egy alkalmazás, amely megfelel Django reprezentációs State Transfer (REST).
Használat
Primer
Haladékot befolyásolja Ruby on Rails, de a szelleme Python ez közel sem olyan "mágikus". Ez azonban menteni egy csomó kód:
# News / models.py
a django.db import modellek
class cikk (models.Model):
& Nbsp; title = models.CharField (MAX_LENGTH = 255)
& Nbsp; content = models.TextField ()
& Nbsp; közzé = True
& Nbsp; created_at = models.DateTimeField (auto_now_add = True)
# News / urls.py
a django.conf.urls.defaults import *
a respite.urls import forrás
a nézetek import ArticleView
urlpatterns = erőforrás (
& Nbsp; prefix = "news / cikkek",
& Nbsp; view = ArticleView
)
# News / views.py
a haladékot import megtekintése
a modellek behozatali cikk
osztály ArticleView (View):
& Nbsp; Modell = cikke
& Nbsp; sablon_útvonal = "news / cikkek"
& Nbsp; supported_formats = ['html', 'json "]
# Sablonok / Hírek / cikkek / index.html


& Nbsp;
& Nbsp;
& Nbsp;
& Nbsp;
& Nbsp; {% a cikket cikkek%}
& Nbsp;

& Nbsp;

{{article.title}}

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

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

& Nbsp;

& Nbsp; {% endfor%}
& Nbsp;

# Sablonok / Hírek / cikkek / index.json
# ...
Alapértelmezett akciók
Haladékot szemszögéből osztály határozza akciók megtekintésére és módosítására modell esetekben; index, show, új, létrehozni, szerkeszteni és sbquo; frissíteni, és elpusztítsa.
HTTP módszer HTTP utat funkció Purpose
GET cikkek / index Render a cikkek listája
GET cikkek / new új elem egy űrlapot, hogy hozzon létre egy új cikket
POST cikkek / Create Új cikk
GET cikkek / 1 mutat Render egy külön cikk
GET cikkek / 1 / szerkesztés szerkesztés Render formában szerkeszteni egy külön cikk
PUT cikkek / 1 frissítést Szerkesztés külön cikk
DELETE cikkek / 1 elpusztítani törlése egy külön cikk
Dióhéjban, Respite nyújt Önnek gyűjteménye funkciók akkor valószínűleg szükség van a legtöbb a modellek és irányítja őket, restfully. Lehet felülírja bármelyik vagy az összes ezeket a funkciókat, és testre azokat szeretné. Például, akkor csak olyan cikkeket, hogy már megjelent:
# News / views.py
osztály ArticleView (View):
& Nbsp; Modell = cikke
& Nbsp; sablon_útvonal = "news / cikkek"
& Nbsp; supported_formats = ['html', 'json "]
& Nbsp; def index (self, igény szerint):
& Nbsp; cikkeket = self.model.objects.filter (közzétett = True)
& Nbsp; visszatérő self._render (
& Nbsp; request = kérelmet,
& Nbsp; template = "index",
& Nbsp; context = {
& Nbsp; "tárgyak": cikkek,
& Nbsp;},
& Nbsp; status = 200
& Nbsp;)
Ön is kihagyjon egy vagy több alapértelmezett műveletek összesen. Például, ha csak végrehajtja az index és a show-akciók:
# News / urls.py
a django.conf.urls.defaults import *
a respite.urls import forrás
a nézetek import ArticleView
urlpatterns = erőforrás (
& Nbsp; prefix = "news / cikkek",
& Nbsp; view = ArticleView,
& Nbsp; actions = ['index', 'show']
)
Egyéni akciók
Ön nem csak a Respite hét előre meghatározott intézkedések; Ön is megadhat tetszőleges számú egyéni cselekvések és fektesse viszont tetszik:
# News / urls.py
a django.conf.urls.defaults import *
a respite.urls importálni erőforrás, akció
a nézetek import ArticleView
urlpatterns = erőforrás (
& Nbsp; prefix = "news / cikkek",
& Nbsp; view = ArticleView,
& Nbsp; custom_actions = [
& Nbsp; fellépés (
& Nbsp; regex = r '(? P [0-9] +) / preview .? [A-zA-Z] * $ ",
& Nbsp; funkció = "preview",
& Nbsp; módszerekkel = ['get'],
& Nbsp; name = "preview_news_article"
& Nbsp;)
& Nbsp;]
)
# News / views.py
a haladékot import megtekintése
a modellek behozatali cikk
osztály ArticleView (View):
& Nbsp; Modell = cikke
& Nbsp; sablon_útvonal = "news / cikkek"
& Nbsp; supported_formats = ['html', 'json "]
& Nbsp; def előnézet (self, kérésre, id):
& Nbsp; article = Article.objects.get (id = id)
& Nbsp; visszatérő self._render (
& Nbsp; request = kérelmet,
& Nbsp; template = "preview",
& Nbsp; context = {
& Nbsp; "árucikk": a cikk
& Nbsp;},
& Nbsp; status = 200
& Nbsp;)
Telepítés
- Pip telepíteni git + http: //github.com/jgorset/respite.git
- Add haladékot, hogy INSTALLED_APPS a beállítások fájl
- Add respite.middleware.HTTPPUTMiddleware a MIDDLEWARE_CLASSES a beállítások fájl
Ha nem csak az épület egy API, akkor is szeretnénk felvenni respite.middleware.HTTPMethodOverrideMiddleware a middleware osztályokba; számára megkönnyíti felülírja a HTTP módszer az X-HTTP-Method-elhagyás fejlécet vagy _method HTTP POST paraméter, amely az egyetlen módja annak, hogy frissíteni (HTTP PUT) és törlés (HTTP DELETE) származó források egy böngészőt.

követelmények :

• Python
• Django