Jako że Django było rozwijane w dynamicznym środowisku prasowego newsroomu, zostało zaprojektowane w taki sposób, aby robić częste web-deweloperskie zadania szybko i prosto. Poniżej przedstawiamy nieformalny opis jak napisać opartą na bazie danych aplikację webową z Django.
\nCelem tego dokumentu jest prezentacja takiej ilości technicznej specyfiki, abyś zrozumiał jak Django działa, ale nie jest on przeznaczony do bycia tutorialem lub dokumentacją – mamy ich oboje! Kiedy będziesz gotowy, aby zacząć projekt, możesz rozpocząć tutorial lub zanurzyć się w bardziej szczegółowej dokumentacji.
\nPomimo że możesz używać Django bez bazy danych, ma on wbudowany mapper obiektowo-relacyjny, za pomocą którego możesz opisać układ swojej bazy danych pythonowym kodem.
\nSkładnia modeli danych oferuje wiele bogatych sposobów przedstawiania modeli – do tej pory było to rozwiązywanie trwających wiele lat problemów schematu bazy danych. Oto krótki przykład:
\nfrom django.db import models\n\nclass Reporter(models.Model):\n full_name = models.CharField(max_length=70)\n\n def __str__(self):\n return self.full_name\n\nclass Article(models.Model):\n pub_date = models.DateField()\n headline = models.CharField(max_length=200)\n content = models.TextField()\n reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)\n\n def __str__(self):\n return self.headline\nNastępnie uruchom narzędzie linii poleceń Django, aby automatycznie stworzyć tabele w bazie danych:
\nLinux / macOS
$ python manage.py migrate\nWindows
...\\> py manage.py migrate\nKomenda migrate spogląda na wszystkie dostępne modele i tworzy tabele w bazie danych, jeśli jeszcze nie istnieją, oraz opcjonalnie daje wiele bogatszą kontrolę nad schematem </topics/migrations>.
Przez wolne i bogate pythonowe API masz dostęp do swoich danych. API jest tworzone w locie, nie wymaga generowania kodu:
\n# Import the models we created from our "news" app\n>>> from news.models import Article, Reporter\n\n# No reporters are in the system yet.\n>>> Reporter.objects.all()\n<QuerySet []>\n\n# Create a new Reporter.\n>>> r = Reporter(full_name='John Smith')\n\n# Save the object into the database. You have to call save() explicitly.\n>>> r.save()\n\n# Now it has an ID.\n>>> r.id\n1\n\n# Now the new reporter is in the database.\n>>> Reporter.objects.all()\n<QuerySet [<Reporter: John Smith>]>\n\n# Fields are represented as attributes on the Python object.\n>>> r.full_name\n'John Smith'\n\n# Django provides a rich database lookup API.\n>>> Reporter.objects.get(id=1)\n<Reporter: John Smith>\n>>> Reporter.objects.get(full_name__startswith='John')\n<Reporter: John Smith>\n>>> Reporter.objects.get(full_name__contains='mith')\n<Reporter: John Smith>\n>>> Reporter.objects.get(id=2)\nTraceback (most recent call last):\n ...\nDoesNotExist: Reporter matching query does not exist.\n\n# Create an article.\n>>> from datetime import date\n>>> a = Article(pub_date=date.today(), headline='Django is cool',\n... content='Yeah.', reporter=r)\n>>> a.save()\n\n# Now the article is in the database.\n>>> Article.objects.all()\n<QuerySet [<Article: Django is cool>]>\n\n# Article objects get API access to related Reporter objects.\n>>> r = a.reporter\n>>> r.full_name\n'John Smith'\n\n# And vice versa: Reporter objects get API access to Article objects.\n>>> r.article_set.all()\n<QuerySet [<Article: Django is cool>]>\n\n# The API follows relationships as far as you need, performing efficient\n# JOINs for you behind the scenes.\n# This finds all articles by a reporter whose name starts with "John".\n>>> Article.objects.filter(reporter__full_name__startswith='John')\n<QuerySet [<Article: Django is cool>]>\n\n# Change an object by altering its attributes and calling save().\n>>> r.full_name = 'Billy Goat'\n>>> r.save()\n\n# Delete an object with delete().\n>>> r.delete()\nGdy twoje modele są już zdefiniowane, Django może automatycznie stworzyć profesjonalny, gotowy na produkcję interfejs administracyjny – witrynę, która pozwala uwierzytelnionym użytkownikom dodawać, zmieniać i usuwać obiekty. Wystarczy tylko zarejestrować model w witrynie administracyjnej:
\nfrom django.db import models\n\nclass Article(models.Model):\n pub_date = models.DateField()\n headline = models.CharField(max_length=200)\n content = models.TextField()\n reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)\nfrom django.contrib import admin\n\nfrom . import models\n\nadmin.site.register(models.Article)\nFilozofia tutaj jest następująca: twoja strona jest edytowana przez obsługę, klienta lub może po prostu ciebie – i nie chcesz musieć tworzyć backendowych interfejsów tylko do zarządzania treścią.
\nJednym z typowych workflow w tworzeniu aplikacji Django jest stworzenie modelu i uruchomienie administracji tak szybko jak to możliwe, aby obsługa (lub klienci) mogli zacząć uzupełniać dane. Następnie, skupienie się na sposobie prezentacji tych danych odbiorcom.
\nProsty, elegancki schemat URL-i jest ważnym detalem w wysokiej jakości aplikacji webowej. Django wspiera piękne projekty URL i nie dodaje żadnych wstawek do URL-i, typu .php lub .asp.
Aby zaprojektować URL-e dla aplikacji, tworzysz moduł Pythona zwany URLconf. Spis treści dla twojej aplikacji, zawiera proste mapowanie pomiędzy wzorcami URL i pythonowymi funkcjami callback. Pliki URLconf służą również do oddzielania URL-i z kodu Python.
\nTak mógłby wyglądać URLconf dla powyższego przykładu Reporter/Article:
from django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path('articles/<int:year>/', views.year_archive),\n path('articles/<int:year>/<int:month>/', views.month_archive),\n path('articles/<int:year>/<int:month>/<int:pk>/', views.article_detail),\n]\nKod powyżej mapuje ścieżki URL do pythonowych funkcji callback („widoków”). Ciągi znaków ścieżek używają parametrowych tagów, aby „zebrać” wartości z URL-i. Gdy użytkownik żąda strony, Django przelatuje przez wszystkie ścieżki, po kolei, i zatrzymuje się na pierwszej, która spełnia żądany URL. (Jeśli żadna z nich nie pasuje, Django wywołuje specjalny widok 404.) Działa to niesamowicie szybko, gdyż ścieżki są kompilowane do wyrażeń regularnych w czasie ładowania.
\nGdy któryś z wzorców URL pasuje, Django wywołuje podany widok, który jest pythonową funkcją. Każdy widok dostaje w parametrze obiekt „request” – który zawiera metadane żądania – i wartości zebrane we wzorcu.
\nNa przykład, jeśli użytkownik zażądałby URL-a „/articles/2005/05/39323/”, Django wywołałoby funkcję news.views.article_detail(request, year=2005, month=5, pk=39323).
Każdy widok jest odpowiedzialny za zrobienie jednej z dwóch rzeczy: Zwrócenie obiektu HttpResponse zawierającego treść dla żądanej strony lub rzucenie wyjątku takiego jak Http404. Reszta zależy od ciebie.
W ogólności, widok pobiera dane stosowne do parametrów, ładuje szablon i renderuje go z pobranymi danymi. Tutaj jest przykładowy widok dla year_archive z powyżej:
from django.shortcuts import render\n\nfrom .models import Article\n\ndef year_archive(request, year):\n a_list = Article.objects.filter(pub_date__year=year)\n context = {'year': year, 'article_list': a_list}\n return render(request, 'news/year_archive.html', context)\nTen przykład wykorzystuje system szablonów Django, który ma kilka potężnych funkcji, ale stara się pozostać wystarczająco prosty w użyciu dla nie-programistów.
\nKod powyżej ładuje szablon news/year_archive.html.
Django ma ścieżkę wyszukiwania szablonów, która pozwala ci minimalizować redundancję pomiędzy szablonami. W swoich ustawieniach Django podajesz listę katalogów do szukania w nich szablonów z DIRS. Jeśli szablon nie istnieje w pierwszym katalogu, sprawdzany jest drugi i tak dalej.
Powiedzmy, że szablon news/year_archive.html został odnaleziony. Tak mógłby wyglądać:
{% extends "base.html" %}\n\n{% block title %}Articles for {{ year }}{% endblock %}\n\n{% block content %}\n<h1>Articles for {{ year }}</h1>\n\n{% for article in article_list %}\n <p>{{ article.headline }}</p>\n <p>By {{ article.reporter.full_name }}</p>\n <p>Published {{ article.pub_date|date:"F j, Y" }}</p>\n{% endfor %}\n{% endblock %}\nZmienne są otoczone podwójnymi nawiasami klamrowymi. {{ article.headline }} znaczy „wypisz wartość atrybutu »headline« artykułu”. Ale kropki nie są używane tylko do odwoływania się do atrybutów. Mogą one być odwołaniami do klucza w słowniku, do indeksu tablicy i wywołaniami funkcji.
Zwróć uwagę, że {{ article.pub_date|date:"F j, Y" }} używa uniksowego „pipe” (znak „|”). Jest on nazywany filtrem szablonu i jest sposobem na przefiltrowanie wartości zmiennej. W tym przypadku filtr „date” formatuje pythonowy obiekt datetime do żądanego formatu (tak jak w funkcji „date” w PHP).
Możesz układać w łańcuchy tyle filtrów, na ile masz ochotę. Możesz napisać własne filtry szablonów, które uruchamiają pod spodem własny kod Pythona.
\nI na koniec, Django wykorzystuje koncept „dziedziczenia szablonów”. To to co robi {% extends "base.html" %}. To znaczy „najpierw załaduj szablon nazwany »base«, który definiuje zestaw bloków i wypełnij te bloki poniższymi blokami”. W skrócie, pozwoli to drastycznie wyciąć powtórzenia w szablonach: każdy szablon musi definiować tylko to, co jest dla niego unikalne.
Tak może wyglądać szablon „base.html”, wliczając użycie plików statycznych:
\n{% load static %}\n<html>\n<head>\n <title>{% block title %}{% endblock %}</title>\n</head>\n<body>\n <img src="{% static "images/sitelogo.png" %}" alt="Logo">\n {% block content %}{% endblock %}\n</body>\n</html>\nProstszymi słowami, definiuje on look-and-feel strony (z logiem strony) i zawiera „dziury” do wypełnienia przez szablony-dzieci. To powoduje, że redesign strony sprowadza się do zmiany w jednym pliku – szablonie bazowym.
\nPozwala ci także stworzyć wiele wersji strony, z różnymi szablonami bazowymi, w czasie gdy wykorzystujesz te same szablony-dzieci. Twórcy Django użyli tej techniki, by stworzyć kompletnie inne mobilne wersje stron – po prostu przez stworzenie nowych szablonów bazowych.
\nZwróć uwgę, że nie musisz używać systemu szablonów Django jeśli wolisz inny system. Pomimo że system szablonów Django jest szczególnie dobrze zintegrowany z warstwą modelu Django, nic nie zmusza cię do jego używania. Tak naprawdę nie musisz używać też bazodanowego API Django. Możesz użyć inną warstwę abstrakcji bazy danych, możesz czytać pliki XML, możesz czytać pliki z dysku lub cokolwiek co chcesz. Każdy kawałek Django – modele, widoki, szablony – jest rozdzielony od następnego.
\nTo był tylko szybki przegląd funkcjonalności Django. Niektóre bardziej przydatne funkcje:
\nFramework cache’owania, który integruje się z Memcached lub innymi back-endami.
Framework syndykacyjny, który sprowadza tworzenie feedów RSS i Atom do napisania małej klasy w Pythonie.
Bardziej seksowne automatycznie wygenerowane funkcje panelu administracyjnego – ten przegląd ledwo musnął powierzchnię.
Następne kroki w sposób oczywisty to pobranie Django, przeczytanie tutoriala i dołączenie do społeczności. Dziękujemy za zainteresowanie!
\n