{"title":"Skriva din första Django-app, del 2","version":"6.1","locale":"sv","docname":"intro/tutorial02","url":"/sv/6.1/intro/tutorial02/","canonical":"https://djangodocs.dev/sv/6.1/intro/tutorial02/","summary":"Denna tutorial börjar där Tutorial 1 slutade. Vi ställer in databasen, skapar din första modell och får en snabb introduktion till Djangos automatiskt…","html":"

Skriva din första Django-app, del 2Link to this heading#

\n

Denna tutorial börjar där Tutorial 1 slutade. Vi ställer in databasen, skapar din första modell och får en snabb introduktion till Djangos automatiskt genererade administratörssida.

\n\n
\n

Uppsättning av databasLink to this heading#

\n

Öppna nu mysite/settings.py. Det är en vanlig Python-modul med variabler på modulnivå som representerar Django-inställningar.

\n

Som standard använder konfigurationen DATABASER SQLite. Om du är nybörjare på databaser, eller bara är intresserad av att prova Django, är detta det enklaste valet. SQLite ingår i Python, så du behöver inte installera något annat för att stödja din databas. När du startar ditt första riktiga projekt kanske du dock vill använda en mer skalbar databas som PostgreSQL för att undvika huvudvärk för databasbyte längs vägen.

\n

Om du vill använda en annan databas, se detaljer för att anpassa och få igång din databas.

\n

Medan du redigerar mysite/settings.py, ställ in TIME_ZONE till din tidszon.

\n

Lägg också märke till INSTALLED_APPS högst upp i filen. Den innehåller namnen på alla Django-applikationer som är aktiverade i den här Django-instansen. Appar kan användas i flera projekt, och du kan paketera och distribuera dem för användning av andra i deras projekt.

\n

Som standard innehåller INSTALLED_APPS följande appar, som alla levereras med Django:

\n\n

Dessa applikationer ingår som standard som en bekvämlighet för det vanliga fallet.

\n

Vissa av dessa program använder dock minst en databastabell, så vi måste skapa tabellerna i databasen innan vi kan använda dem. Det gör du genom att köra följande kommando:

\n

Linux / macOS

Shell
$ python manage.py migrate\n
\n

Windows

Windows
...\\> py manage.py migrate\n
\n

Kommandot migrate tittar på inställningen INSTALLED_APPS och skapar alla nödvändiga databastabeller enligt databasinställningarna i filen mysite/settings.py och de databasmigreringar som levereras med appen (vi går igenom dem senare). Du kommer att se ett meddelande för varje migrering som den tillämpar. Om du är intresserad kan du köra kommandoradsklienten för din databas och skriva dt (PostgreSQL), SHOW TABLES; (MariaDB, MySQL), .tables (SQLite) eller SELECT TABLE_NAME FROM USER_TABLES; (Oracle) för att visa de tabeller som Django skapade.

\n\n
\n
\n

Skapa modellerLink to this heading#

\n

Nu ska vi definiera dina modeller - i princip din databaslayout, med ytterligare metadata.

\n\n

I vår poll-app skapar vi två modeller: Question och Choice. En Question har en fråga och ett publiceringsdatum. En Choice har två fält: texten i valet och en rösträkning. Varje Choice är associerat med en Question.

\n

Dessa koncept representeras av Python-klasser. Redigera filen polls/models.py så att den ser ut så här:

\n
polls/modeller.py
\n
Python
from django.db import models\n\n\nclass Question(models.Model):\n    question_text = models.CharField(max_length=200)\n    pub_date = models.DateTimeField("date published")\n\n\nclass Choice(models.Model):\n    question = models.ForeignKey(Question, on_delete=models.CASCADE)\n    choice_text = models.CharField(max_length=200)\n    votes = models.IntegerField(default=0)\n
\n

Här representeras varje modell av en klass som subklassar django.db.models.Model. Varje modell har ett antal klassvariabler, som var och en representerar ett databasfält i modellen.

\n

Varje fält representeras av en instans av en Field-klass - t.ex. CharField för teckenfält och DateTimeField för datatider. Detta talar om för Django vilken typ av data varje fält innehåller.

\n

Namnet på varje Field-instans (t.ex. question_text eller pub_date) är fältets namn i ett maskinvänligt format. Du kommer att använda detta värde i din Python-kod och din databas kommer att använda det som kolumnnamn.

\n

Du kan använda ett valfritt första positionellt argument till en Field för att ange ett mänskligt läsbart namn. Det används i ett par introspektiva delar av Django, och det fungerar även som dokumentation. Om detta fält inte tillhandahålls kommer Django att använda det maskinläsbara namnet. I det här exemplet har vi bara definierat ett mänskligt läsbart namn för Question.pub_date. För alla andra fält i denna modell kommer fältets maskinläsbara namn att räcka som dess mänskligt läsbara namn.

\n

Vissa Field-klasser har obligatoriska argument. CharField, till exempel, kräver att du ger den en max_length. Det används inte bara i databasschemat utan även i valideringen, som vi snart ska se.

\n

En Field kan också ha olika valfria argument; i det här fallet har vi satt default-värdet för votes till 0.

\n

Slutligen, notera att ett förhållande definieras med ForeignKey. Det säger till Django att varje Choice är relaterad till en enda Question. Django stöder alla vanliga databasrelationer: många-till-en, många-till-många och en-till-en.

\n
\n
\n

Aktivering av modellerLink to this heading#

\n

Den lilla biten modellkod ger Django en hel del information. Med den kan Django göra följande:

\n\n

Men först måste vi tala om för vårt projekt att appen polls är installerad.

\n\n

För att inkludera appen i vårt projekt måste vi lägga till en referens till dess konfigurationsklass i inställningen INSTALLED_APPS. Klassen PollsConfig finns i filen polls/apps.py, så dess prickade sökväg är 'polls.apps.PollsConfig'. Redigera filen mysite/settings.py och lägg till den prickade sökvägen i inställningen INSTALLED_APPS. Det kommer att se ut så här:

\n
mysite/settings.py
\n
Python
INSTALLED_APPS = [\n    "polls.apps.PollsConfig",\n    "django.contrib.admin",\n    "django.contrib.auth",\n    "django.contrib.contenttypes",\n    "django.contrib.sessions",\n    "django.contrib.messages",\n    "django.contrib.staticfiles",\n]\n
\n

Nu vet Django att appen polls ska inkluderas. Låt oss köra ett annat kommando:

\n

Linux / macOS

Shell
$ python manage.py makemigrations polls\n
\n

Windows

Windows
...\\> py manage.py makemigrations polls\n
\n

Du bör se något som liknar följande:

\n
Text
Migrations for 'polls':\n  polls/migrations/0001_initial.py\n    + Create model Question\n    + Create model Choice\n
\n

Genom att köra makemigrations talar du om för Django att du har gjort några ändringar i dina modeller (i det här fallet har du gjort nya) och att du vill att ändringarna ska lagras som en migration.

\n

Migreringar är hur Django lagrar ändringar i dina modeller (och därmed ditt databasschema) - de är filer på disken. Du kan läsa migreringen för din nya modell om du vill; det är filen polls/migrations/0001_initial.py. Oroa dig inte, du förväntas inte läsa dem varje gång Django gör en, men de är utformade för att vara mänskligt redigerbara om du manuellt vill justera hur Django ändrar saker.

\n

Om du är intresserad kan du också köra python manage.py check; detta kontrollerar eventuella problem i ditt projekt utan att göra migreringar eller röra databasen.

\n

Kör nu migrate igen för att skapa dessa modelltabeller i din databas:

\n

Linux / macOS

Shell
$ python manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, polls, sessions\nRunning migrations:\n  Applying polls.0001_initial... OK\n
\n

Windows

Windows
...\\> py manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, polls, sessions\nRunning migrations:\n  Applying polls.0001_initial... OK\n
\n

Kommandot migrate tar alla migreringar som inte har tillämpats (Django spårar vilka som tillämpas med hjälp av en speciell tabell i din databas som heter django_migrations) och kör dem mot din databas - i huvudsak synkroniserar de ändringar du gjorde i dina modeller med schemat i databasen.

\n

Migreringar är mycket kraftfulla och låter dig ändra dina modeller över tid, när du utvecklar ditt projekt, utan att du behöver ta bort din databas eller tabeller och skapa nya - det är specialiserat på att uppgradera din databas live, utan att förlora data. Vi kommer att gå igenom dem mer ingående i en senare del av handledningen, men för tillfället bör du komma ihåg trestegsguiden för att göra modelländringar:

\n\n

Anledningen till att det finns separata kommandon för att skapa och tillämpa migreringar är att du ska överföra migreringar till ditt versionshanteringssystem och skicka dem med din app; de gör inte bara din utveckling enklare, de kan också användas av andra utvecklare och i produktionen.

\n

See Migreringar for the full details, including how to inspect\nthe SQL a migration will run with sqlmigrate (see\nExecuting sqlmigrate).

\n

Läs django-admin-dokumentationen för fullständig information om vad verktyget manage.py kan göra.

\n
\n
\n

Leka med API:etLink to this heading#

\n

Låt oss nu hoppa in i det interaktiva Python-skalet och leka med det kostnadsfria API som Django ger dig. För att anropa Python-skalet använder du det här kommandot:

\n

Linux / macOS

Shell
$ python manage.py shell\n
\n

Windows

Windows
...\\> py manage.py shell\n
\n

Vi använder detta i stället för att helt enkelt skriva ”python”, eftersom manage.py ställer in miljövariabeln DJANGO_SETTINGS_MODULE, som ger Django Python-importsökvägen till din mysite/settings.py-fil. Som standard importerar kommandot shell automatiskt modellerna från din INSTALLED_APPS.

\n

När du väl är inne i skalet kan du utforska databas-API:

\n
Python console
# No questions are in the system yet.\n>>> Question.objects.all()\n<QuerySet []>\n\n# Create a new Question.\n# Support for time zones is enabled in the default settings file, so\n# Django expects a datetime with tzinfo for pub_date. Use timezone.now()\n# instead of datetime.datetime.now() and it will do the right thing.\n>>> from django.utils import timezone\n>>> q = Question(question_text="What's new?", pub_date=timezone.now())\n\n# Save the object into the database. You have to call save() explicitly.\n>>> q.save()\n\n# Now it has an ID.\n>>> q.id\n1\n\n# Access model field values via Python attributes.\n>>> q.question_text\n"What's new?"\n>>> q.pub_date\ndatetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=datetime.UTC)\n\n# Change values by changing the attributes, then calling save().\n>>> q.question_text = "What's up?"\n>>> q.save()\n\n# objects.all() displays all the questions in the database.\n>>> Question.objects.all()\n<QuerySet [<Question: Question object (1)>]>\n
\n

Vänta lite. <Fråga: Fråga objekt (1)> är inte en användbar representation av detta objekt. Låt oss fixa det genom att redigera modellen Question (i filen polls/models.py) och lägga till en __str__()-metod till både Question och Choice:

\n
polls/modeller.py
\n
Python
from django.db import models\n\n\nclass Question(models.Model):\n    # ...\n    def __str__(self):\n        return self.question_text\n\n\nclass Choice(models.Model):\n    # ...\n    def __str__(self):\n        return self.choice_text\n
\n

Det är viktigt att lägga till __str__()-metoder till dina modeller, inte bara för din egen bekvämlighet när du hanterar den interaktiva prompten, utan också för att objektens representationer används i Djangos automatiskt genererade admin.

\n

Låt oss också lägga till en anpassad metod till den här modellen:

\n
polls/modeller.py
\n
Python
import datetime\n\nfrom django.db import models\nfrom django.utils import timezone\n\n\nclass Question(models.Model):\n    # ...\n    def was_published_recently(self):\n        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)\n
\n

Notera tillägget av import datetime och from django.utils import timezone, för att referera till Pythons standardmodul datetime respektive Djangos tidszonsrelaterade verktyg i django.utils.timezone. Om du inte är bekant med tidszonshantering i Python kan du lära dig mer i time zone support docs.

\n

Spara dessa ändringar och starta ett nytt interaktivt Python-skal. (Om en prompt med tre vinklar (>>>) indikerar att du fortfarande befinner dig i skalet måste du först avsluta med exit()). Kör python manage.py shell igen för att uppdatera modellerna.

\n
Python console
# Make sure our __str__() addition worked.\n>>> Question.objects.all()\n<QuerySet [<Question: What's up?>]>\n\n# Django provides a rich database lookup API that's entirely driven by\n# keyword arguments.\n>>> Question.objects.filter(id=1)\n<QuerySet [<Question: What's up?>]>\n>>> Question.objects.filter(question_text__startswith="What")\n<QuerySet [<Question: What's up?>]>\n\n# Get the question that was published this year.\n>>> from django.utils import timezone\n>>> current_year = timezone.now().year\n>>> Question.objects.get(pub_date__year=current_year)\n<Question: What's up?>\n\n# Request an ID that doesn't exist, this will raise an exception.\n>>> Question.objects.get(id=2)\nTraceback (most recent call last):\n    ...\nDoesNotExist: Question matching query does not exist.\n\n# Lookup by a primary key is the most common case, so Django provides a\n# shortcut for primary-key exact lookups.\n# The following is identical to Question.objects.get(id=1).\n>>> Question.objects.get(pk=1)\n<Question: What's up?>\n\n# Make sure our custom method worked.\n>>> q = Question.objects.get(pk=1)\n>>> q.was_published_recently()\nTrue\n\n# Give the Question a couple of Choices. The create call constructs a new\n# Choice object, does the INSERT statement, adds the choice to the set\n# of available choices and returns the new Choice object. Django creates\n# a set (defined as "choice_set") to hold the "other side" of a ForeignKey\n# relation (e.g. a question's choice) which can be accessed via the API.\n>>> q = Question.objects.get(pk=1)\n\n# Display any choices from the related object set -- none so far.\n>>> q.choice_set.all()\n<QuerySet []>\n\n# Create three choices.\n>>> q.choice_set.create(choice_text="Not much", votes=0)\n<Choice: Not much>\n>>> q.choice_set.create(choice_text="The sky", votes=0)\n<Choice: The sky>\n>>> c = q.choice_set.create(choice_text="Just hacking again", votes=0)\n\n# Choice objects have API access to their related Question objects.\n>>> c.question\n<Question: What's up?>\n\n# And vice versa: Question objects get access to Choice objects.\n>>> q.choice_set.all()\n<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>\n>>> q.choice_set.count()\n3\n\n# The API automatically follows relationships as far as you need.\n# Use double underscores to separate relationships.\n# This works as many levels deep as you want; there's no limit.\n# Find all Choices for any question whose pub_date is in this year\n# (reusing the 'current_year' variable we created above).\n>>> Choice.objects.filter(question__pub_date__year=current_year)\n<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>\n\n# Let's delete one of the choices. Use delete() for that.\n>>> c = q.choice_set.filter(choice_text__startswith="Just hacking")\n>>> c.delete()\n
\n

För mer information om modellrelationer, se Accessing related objects. Mer information om hur du använder dubbla understrykningstecken för att göra fältuppslagningar via API:et finns i Field lookups. För fullständig information om databas-API:et, se vår Database API reference.

\n
\n
\n

Introduktion till Django AdminLink to this heading#

\n\n
\n

Skapa en administratörsanvändareLink to this heading#

\n

Först måste vi skapa en användare som kan logga in på administratörssidan. Kör följande kommando:

\n

Linux / macOS

Shell
$ python manage.py createsuperuser\n
\n

Windows

Windows
...\\> py manage.py createsuperuser\n
\n

Ange önskat användarnamn och tryck på Enter.

\n
Text
Username: admin\n
\n

Du kommer sedan att bli ombedd att ange önskad e-postadress:

\n
Text
Email address: admin@example.com\n
\n

Det sista steget är att ange ditt lösenord. Du kommer att bli ombedd att ange ditt lösenord två gånger, den andra gången som en bekräftelse på den första.

\n
Text
Password: **********\nPassword (again): *********\nSuperuser created successfully.\n
\n
\n
\n

Starta utvecklingsservernLink to this heading#

\n

Django-administratörssidan är aktiverad som standard. Låt oss starta utvecklingsservern och utforska den.

\n

Om servern inte är igång startar du den på följande sätt:

\n

Linux / macOS

Shell
$ python manage.py runserver\n
\n

Windows

Windows
...\\> py manage.py runserver\n
\n

Öppna nu en webbläsare och gå till ”/admin/” på din lokala domän, t.ex. http://127.0.0.1:8000/admin/. Du bör se administratörens inloggningsskärm:

\n\"Django\n

Eftersom translation är aktiverad som standard, om du anger LANGUAGE_CODE, kommer inloggningsskärmen att visas på det angivna språket (om Django har lämpliga översättningar).

\n
\n
\n

Ange administratörens webbplatsLink to this heading#

\n

Försök nu att logga in med det superanvändarkonto som du skapade i föregående steg. Du bör se Django-administratörens indexsida:

\n\"Django\n

Du bör se några typer av redigerbart innehåll: grupper och användare. De tillhandahålls av django.contrib.auth, det autentiseringsramverk som levereras av Django.

\n
\n
\n

Gör röstningsappen ändringsbar i administratörenLink to this heading#

\n

Men var är vår poll-app? Den visas inte på adminindexsidan.

\n

Det är bara en sak kvar att göra: vi måste tala om för administratören att Question-objekt har ett administratörsgränssnitt. För att göra detta, öppna filen polls/admin.py och redigera den så att den ser ut så här:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\nadmin.site.register(Question)\n
\n
\n
\n

Utforska de kostnadsfria adminfunktionernaLink to this heading#

\n

Nu när vi har registrerat Question vet Django att den ska visas på adminindexsidan:

\n\"Django\n

Klicka på ”Frågor”. Nu är du på sidan ”Ändra lista” för frågor. På den här sidan visas alla frågor i databasen och du kan välja en fråga för att ändra den. Det finns frågan ”Vad händer?” som vi skapade tidigare:

\n\"Omröstningar\n

Klicka på frågan ”Vad händer?” för att redigera den:

\n\"Redigering\n

Saker att notera här:

\n\n

Längst ner på sidan finns ett par alternativ:

\n\n

Om värdet för ”Date published” inte stämmer överens med den tidpunkt då du skapade frågan i Tutorial 1, betyder det förmodligen att du har glömt att ange rätt värde för inställningen TIME_ZONE. Ändra den, ladda om sidan och kontrollera att rätt värde visas.

\n

Ändra ”Datum publicerat” genom att klicka på genvägarna ”Idag” och ”Nu”. Klicka sedan på ”Spara och fortsätt redigera” Klicka sedan på ”Historik” längst upp till höger. Du kommer att se en sida som listar alla ändringar som gjorts i detta objekt via Django-admin, med tidsstämpel och användarnamn för den person som gjorde ändringen:

\n\"Historiksida\n

När du känner dig bekväm med API:et för modeller och har bekantat dig med adminwebbplatsen kan du läsa del 3 av denna handledning för att lära dig hur du lägger till fler vyer i vår polls-app.

\n
\n
","rootId":"writing-your-first-django-app-part-2","toc":[{"title":"Uppsättning av databas","anchor":"database-setup","children":[]},{"title":"Skapa modeller","anchor":"creating-models","children":[]},{"title":"Aktivering av modeller","anchor":"activating-models","children":[]},{"title":"Leka med API:et","anchor":"playing-with-the-api","children":[]},{"title":"Introduktion till Django Admin","anchor":"introducing-the-django-admin","children":[{"title":"Skapa en administratörsanvändare","anchor":"creating-an-admin-user","children":[]},{"title":"Starta utvecklingsservern","anchor":"start-the-development-server","children":[]},{"title":"Ange administratörens webbplats","anchor":"enter-the-admin-site","children":[]},{"title":"Gör röstningsappen ändringsbar i administratören","anchor":"make-the-poll-app-modifiable-in-the-admin","children":[]},{"title":"Utforska de kostnadsfria adminfunktionerna","anchor":"explore-the-free-admin-functionality","children":[]}]}],"breadcrumbs":[{"docname":"intro/index","title":"Kom igång","url":"/sv/6.1/intro/"}],"prev":{"docname":"intro/tutorial01","title":"Skriva din första Django-app, del 1","url":"/sv/6.1/intro/tutorial01/"},"next":{"docname":"intro/tutorial03","title":"Skriva din första Django-app, del 3","url":"/sv/6.1/intro/tutorial03/"},"formats":{"html":"/sv/6.1/intro/tutorial02/","markdown":"/sv/6.1/intro/tutorial02.md","json":"/sv/6.1/intro/tutorial02.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/intro/tutorial02.txt","official":"https://docs.djangoproject.com/sv/6.1/intro/tutorial02/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}