Karena Django dikembangkan dalam lingkungan cepat, dia telah dirancang untuk membuat tugas Pengembangan-jaringan umum cepat dan mudah. Ini adalah sebuah ikhstisar tidak resmi dari bagaimana menulis aplikasi Jaringan basisdata dengan Django.
\nTujuan dari dokumen ini adalah memberikan anda spesifik teknik yang cukup untuk memahami bagaimana Django bekerja, tetapi ini tidak diperuntukkan menjadi tutorial atau acuan -- tetapi kami telah mendapatkan keduanya! Ketika anda siap memulai proyek, anda dapat:doc:start with the tutorial </intro/tutorial01> atau dive right into more detailed documentation.
\nMeskipun anda dapat menggunakan Django tanpa basisdata, dia datang dengan object-relational mapper dimana anda menggambarkan tata letak basisdata anda di kode Phyton.
\ndata-model syntax menawarkan banyak jalan kaya dari mewakilkan model anda -- sejauh ini, dia telah menyelesaikan banyak tahun berharga dari masalah skema-basisdata. Ini adalah contoh cepat:
\nmysite/news/models.pyfrom 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\nSelanjutnya, jalankan kegunaan baris-perintah Django untuk membuat tabel basisdata otomatis:
\n$ python manage.py migrate\nPerintah migrate mencari semua model tersedia anda dan membuat tabel di basisdata anda untuk tabel manapun yang tidak ada, serta pilihan menyediakan lebih kaya kendali skema.
Dengan itu, anda telah mendapatkan bebas, dan kaya, API Python untuk mengakses data anda. API dibuat dengan cepat, tidak ada pembangkitan kode yang dibutuhkan:
\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()\nSekali model anda ditentukan, Django dapat otomatis membuat profesional, siap produksi administrative interface -- sebuah situs jaringan yang membiarkan pengguna dibuktikan menambah, merubah dan menghapus obyek. Dia semudah mendaftarkan model anda di situs admin:
\nmysite/news/models.pyfrom 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)\nmysite/news/admin.pyfrom django.contrib import admin\n\nfrom . import models\n\nadmin.site.register(models.Article)\nFilosofi disini adalah bahwa situs anda disunting oleh staf, atau klien, atau mungkin hanya anda -- dan anda tidak ingin mempunyai persetujuan dengan membuat antarmuka belakang hanya untuk mengelola isi.
\nSatu alurkerja khas dalam membuat aplikasi Django adalah membuat model dan mendapatkan situs admin hidup dan berjalan secepat mungkin, jadi staf anda 9atau klien) dapat mulai mengumpulkan data. Lalu, mengembangkan jalur data dihadirkan ke umum.
\nBersih, skema URL anggun adalah rincian penting dalam aplikasi Jaringan kualitas-tinggi. Django mendorong perancangan URL indah dan tidak menaruh sesuatu yang ada di URL, seperti .php or .asp.
Untuk merancang URL untuk sebuah apliaksi, anda membuat modul Phyton disebut URLconf. Sebuah tabel isi untuk aplikasi anda, dia mengandung pemetaan sederhana diantara pola URL dan fungsi Phyton memanggil kembali. URLconf juga melayani untuk memisahkan URL dari kode Phyton.
\nIni adalah apa URLconf mungkin terlihat seperti untuk Reporter`/Article contoh diatas:
mysite/news/urls.pyfrom 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]\nKode diatas memetakan jalur URL pada fungsi callback Python ("views"). String jalur menggunakan etiket parameter untuk "menangkap" nilai-nilai dari URL. Ketika seorang pengguna meminta sebuah halaman, Django menjalankan setiap jalur, dalam urutan, dan berhenti pada satu pertama uang cocok dengan URL diminta. (Jika tidak ada dari mereka cocok, Django memanggil tampilan kasus-khusus 404). Ini sangat cepat, karena jalur disusun kedalam reguler expression pada waktu muat.
\nKetika satu dari pola URL cocok, Django memanggil tampilan yang diberikan, yaitu sebuah fungsi Python. Setiap tampilan mendapatkan perlewatan sebuah permintaan obyek -- yang mengandung permintaan metadata -- dan nilai-nilai ditangkap dalam pola.
\nSebagai contoh, jika sebuah pengguna meminta URL "/articles/2005/05/39323/", Django akan memanggil fungsi news.views.article_detail(request, year=2005, month=5, pk=39323).
Setiap tampilan bertanggung jawab untuk melalukan satu dari dua hal: Mengembalikan sebuah obyek HttpResponse mengandung isi untuk halaman diminta, atau menerbitkan pengecualian seperti Http404. Sisanya terserah anda.
Umumnya, tampilan mengambil data menurut parameter, memuat cetakan dan menjadikan cetakan dengan data terambil. Disini adalah sebuah contoh tampilan untuk year_archive dari atas:
mysite/news/views.pyfrom 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)\nIni contoh menggunakan template system Django, yang mempunyai beberapa fitur kuat tetapi bekerja keras untuk tetap cukup sederhana untuk digunakan bagi bukan-programmer.
\nKode diatas memuat cetakan news/year_archive.html.
Django mempunyai sebuah cetakan jalur pencarian, yang mengizinkan anda mengecilkan kelebihan antara cetakan. Di pengaturan Django anda, anda menjelaskan daftar direktori untuk memeriksa untuk cetakan dengan DIRS. Jika cetakan tidak ada di direktori pertama, dia memeriksa yang kedua, dan selanjutnya.
Mari kita katakan cetakan news/year_archive.html telah ditemukan. Disini apa yang mungkin terlihat seperti:
mysite/news/templates/news/year_archive.html{% 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 %}\nVariabel dikelilingi oleh kurung kurawal ganda. {{ article.headline }} berarti "Nilai keluaran dari atribut kepala berita artikel." Tetapi titik tidak digunakan hanya untuk mencari atribut. Mereka juga dapat melakukan mencari kuncu-kamus, mencari index dan pemanggilan fungsi.
Catat {{ article.pub_date|date:"F j, Y" }} menggunakan gaya-Unix "pipe" (karakter "|"). Ini dipanggil saringan cetakan, dan itu adalah jalan untuk menyaring nilai dari variabel. Di kasus ini, tanggal menyaring membentuk obyek tanggal waktu Phyton di bentuk yang fiberikan (seperti ditemukan di fungsi tanggal PHP).
Anda dapat merantai bersama sebanyak saringan yang anda suka. Anda dapat menulis saringan cetakan penyesuaian. Anda dapat menulis label cetakan penyesuaian, yang menjalankan kode Phyton disesuaikan dibelakang layar.
\nAkhirnya, Django menggunakan konsep dari "cetakan turunan". Itu apa yang {% extends "base.html" %} lakukan. Dia berarti "Pertama muat cetakan disebut 'base', yang menentukan segerombolan blok, dan isi blok dengan blok berikut." Pendeknya, itu membiarkan anda secara dramatis memotong kelebihan di cetakan: setiap cetakan harus menentukan hanya apa yang unik ke cetakan tersebut.
Disini adalah apa cetakan "base.html", termasuk penggunaan berkas statis, mungkin terlihat seperti:
\nmysite/templates/base.html{% 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>\nSecara sederhana, itu menentukan kelihatan-dan-rasa dari situs (dengan logo situs), dan menyediakan lubang untuk cetakan anak untuk diisi. Ini membuat situs dirancang kembali semudah merubah berkas tunggal -- cetakan dasar.
\nDia juga membiarkan anda membuat versi banyak dari situs, dengan cetakan dasar berbeda, selama menggunakan kembali cetakan anak. Pembuat Django telah menggunakan teknik ini untuk membuat dengan cara menyolok versi berjalan berbeda dari situs -- mudah dengan membuat cetakan dasar baru.
\nCatatan bahwa anda tidak harus menggunakan sistem cetakan Django jika anda memilih sistem lain. Selama sistem cetakan Django terutama terpadu-baik dengan lapisan model Django, tidak ada paksaan anda menggunakannya. untuk keadaan itu, anda tidak harus menggunakan API basisdata Django, salah satu. Anda dapat menggunakan lapisan abstraksi basisdata lain, anda dapat membaca berkas XML, anda dapat membaca berkas cakram. Setiap potongan Django -- model, tampilan, cetakan -- dipisahkan dari selanjutnya.
\nIni hanya ikhtisar cepat dari fungsi Django. Beberapa fitur lebih berguna:
\nSebuah kerangka tembolok yang dipadukan dengan memcache atau backend lain.
Sebuah kerangka kongsi yang membuat menciptakan RSS dan umpan Atom semudah menulis kelas Phyton kecil.
Lebih otomatis menggairahkan-fitur admin dibangkitkan -- ikhtisar ini hampir tidak tergores permukaan.
Langkah jelas selanjutnya adalah untuk anda untuk download Django, baca tutorial dan gabung komunitas. Terima kasih untuk minat anda!
\n