Η ανάπαυλα είναι μια εφαρμογή που συμμορφώνεται με τις παραστατικές Django κατάσταση μεταφοράς (REST).
Χρήση
Αλφαβητάρι
Η ανάπαυλα επηρεάζεται από το Ruby on Rails, αν και σύμφωνα με το πνεύμα της Python δεν είναι σχεδόν ως "μαγεία". Θα πρέπει, ωστόσο, μπορείτε να αποθηκεύσετε πολύ κώδικα:
# Νέα / models.py
από django.db μοντέλα εισαγωγής
τάξη άρθρο (models.Model):
& Nbsp? Title = models.CharField (MAX_LENGTH = 255)
& Nbsp? Περιεχόμενο = models.TextField ()
& Nbsp? Δημοσιεύονται = True
& Nbsp? Created_at = models.DateTimeField (auto_now_add = True)
# Νέα / urls.py
από django.conf.urls.defaults εισαγωγή *
από respite.urls πόρων εισαγωγής
από τις απόψεις ArticleView εισαγωγής
urlpatterns = πόρων (
& Nbsp? Prefix = "Νέα / Άρθρα»,
& Nbsp? Θέα = ArticleView
)
# Νέα / views.py
από ανάπαυλα εισαγωγή Προβολή
από τα μοντέλα εισαγωγής Άρθρο
κατηγορία ArticleView (View):
& Nbsp? Μοντέλο = άρθρο
& Nbsp? Template_path = "Νέα / Άρθρα»
& Nbsp? Supported_formats = ['html', 'JSON »]
# Templates / Νέα / Άρθρα / index.html


& Nbsp?
& Nbsp? <Τίτλος> {{}} article.title
& Nbsp?
& Nbsp?
& Nbsp? {% Για το άρθρο στα άρθρα%}
& Nbsp?

& Nbsp?

{{}} article.title

& Nbsp? <Χρόνο datetime = "{{}} article.created_at.isoformat"> {{}} article.created_at
& Nbsp?

& Nbsp? {{}} Article.content
& Nbsp?

& Nbsp?

& Nbsp? {%} EndFor%
& Nbsp?

# Templates / Νέα / Άρθρα / index.json
# ...
Προεπιλογή δράσεις
Προβολή τάξη ανάπαυλας που καθορίζει τις δράσεις για την προβολή και το χειρισμό μοντέλο περιπτώσεις? δείκτης, δείχνουν, νέα, δημιουργία, επεξεργασία & sbquo? ενημερώνει και να καταστρέψουν.
HTTP μέθοδο HTTP Σκοπός Λειτουργία μονοπάτι
GET άρθρα / index Render μια λίστα άρθρων
GET άρθρα / νέα νέα Render μια φόρμα για να δημιουργήσετε ένα νέο άρθρο
Δημοσίευση άρθρων / Δημιουργία Δημιουργήστε ένα νέο άρθρο
GET άρθρα / 1 δείχνουν Render ένα ειδικό άρθρο
GET άρθρα / 1 / Επεξεργασία Επεξεργασία Render μια φόρμα για να επεξεργαστείτε ένα ειδικό άρθρο
Άρθρα PUT / 1 ενημέρωση Επεξεργασία συγκεκριμένο άρθρο
DELETE άρθρα / 1 καταστρέψει Διαγραφή ειδικό άρθρο
Με λίγα λόγια, ανάπαυλας σας παρέχει μια συλλογή από χαρακτηριστικά που ίσως χρειαστείτε για την πλειοψηφία των μοντέλων και των διαδρομών τους σας ήρεμα. Μπορείτε να παρακάμψετε οποιαδήποτε ή όλες αυτές τις λειτουργίες και να προσαρμόσετε τους όπως θα θέλατε. Για παράδειγμα, θα μπορούσαμε να αναφέρουμε μόνο τα άρθρα που έχουν δημοσιευθεί:
# Νέα / views.py
κατηγορία ArticleView (View):
& Nbsp? Μοντέλο = άρθρο
& Nbsp? Template_path = "Νέα / Άρθρα»
& Nbsp? Supported_formats = ['html', 'JSON »]
& Nbsp? Def δείκτης (self, αίτηση):
& Nbsp? Άρθρα = self.model.objects.filter (δημοσιεύθηκε = True)
& Nbsp? Self._render επιστροφής (
& Nbsp? Αίτημα = αίτηση,
& Nbsp? «Δείκτης» πρότυπο =,
& Nbsp? Context = {
& Nbsp? «Είδη»: είδη,
& Nbsp?},
& Nbsp? Κατάστασης = 200
& Nbsp?)
Μπορείτε, επίσης, μπορεί να παραλείψει μία ή περισσότερες από τις προεπιλεγμένες ενέργειες εντελώς. Για παράδειγμα, θα μπορούσε να εφαρμόσει μόνο τις ενέργειες του δείκτη και δείχνουν:
# Νέα / urls.py
από django.conf.urls.defaults εισαγωγή *
από respite.urls πόρων εισαγωγής
από τις απόψεις ArticleView εισαγωγής
urlpatterns = πόρων (
& Nbsp? Prefix = "Νέα / Άρθρα»,
& Nbsp? Θέα = ArticleView,
& Nbsp? Ενέργειες = [«δείκτης», «δείχνουν»]
)
Ειδικές δράσεις
Δεν περιορίζονται σε επτά προκαθορισμένες ενέργειες ανάπαυλας του? μπορείτε να προσθέσετε οποιοδήποτε αριθμό των προσαρμοσμένες ενέργειες και πορεία τους όπως θέλετε:
# Νέα / urls.py
από django.conf.urls.defaults εισαγωγή *
από respite.urls εισαγωγή των πόρων, η δράση
από τις απόψεις ArticleView εισαγωγής
urlpatterns = πόρων (
& Nbsp? Prefix = "Νέα / Άρθρα»,
& Nbsp? Θέα = ArticleView,
& Nbsp? Custom_actions = [
& Nbsp? Δράσης (
& Nbsp? Regex = r '(; ​​P [0-9] +).; / Προεπισκόπησης [α-ΖΑ-Z] * $ »,
& Nbsp? Συνάρτηση = 'προεπισκόπηση',
& Nbsp? Μέθοδοι = ['get'],
& Nbsp? Name = "preview_news_article»
& Nbsp?)
& Nbsp?]
)
# Νέα / views.py
από ανάπαυλα εισαγωγή Προβολή
από τα μοντέλα εισαγωγής Άρθρο
κατηγορία ArticleView (View):
& Nbsp? Μοντέλο = άρθρο
& Nbsp? Template_path = "Νέα / Άρθρα»
& Nbsp? Supported_formats = ['html', 'JSON »]
& Nbsp? Προεπισκόπηση def (self, αίτημα, id):
& Nbsp? Άρθρου = Article.objects.get (id = id)
& Nbsp? Self._render επιστροφής (
& Nbsp? Αίτημα = αίτηση,
& Nbsp? Template = 'προεπισκόπηση',
& Nbsp? Context = {
& Nbsp? «Αντικείμενο»: άρθρο
& Nbsp?},
& Nbsp? Κατάστασης = 200
& Nbsp?)
installation
- PIP εγκαταστήσετε git + http: //github.com/jgorset/respite.git
- Προσθέστε ανάπαυλα για INSTALLED_APPS στο αρχείο ρυθμίσεων σας
- Προσθέστε respite.middleware.HTTPPUTMiddleware να MIDDLEWARE_CLASSES στο αρχείο ρυθμίσεων σας
Αν δεν είστε μόνο την οικοδόμηση μιας API, μπορεί επίσης να θέλετε να προσθέσετε respite.middleware.HTTPMethodOverrideMiddleware στις κατηγορίες middleware σας? διευκολύνει για επιτακτικούς τη μέθοδο HTTP με την κεφαλίδα X-HTTP-Μέθοδος-Παράκαμψη ή μια παράμετρο POST _method HTTP, ο οποίος είναι ο μόνος τρόπος για να ενημερώσετε (HTTP PUT) και να διαγράψετε (HTTP DELETE) πόρους από ένα web browser.

Απαιτήσεις :

• Python
• Django