Eines der starken Merkmale von Django Forms ist die Validierung. Sie überprüft automatisch die vom Benutzer eingegebenen Daten, bevor sie an den Server gesendet werden, um Sicherheit und Genauigkeit zu gewährleisten. In diesem Beitrag werden wir den Validierungsmechanismus von Django Forms und die Anpassungsmöglichkeiten näher beleuchten.

1. Grundlegende Validierung

1.1 Was ist Validierung?

Django Forms überprüft, ob die Daten die Anforderungen der Formularfelder erfüllen. Dieser Prozess besteht aus der grundlegenden Prüfung, die vom Formular bereitgestellt wird, und der benutzerdefinierten Validierung, die der Entwickler zusätzlich definiert.

Beispiel für grundlegende Validierung

from django import forms

class RegistrationForm(forms.Form):
    username = forms.CharField(max_length=30, required=True)
    email = forms.EmailField(required=True)
    password = forms.CharField(widget=forms.PasswordInput, required=True)

• username: Begrenzung auf maximal 30 Zeichen.
• email: Überprüfung des E-Mail-Formats.
• password: Eingabe ist erforderlich und Verwendung eines Passwortfeldes.

1.2 Datenvalidierungsfluss

Django Forms speichert die validierten Daten in cleaned_data, die in Form eines Dictionarys mit Feldnamen als Schlüsseln zurückgegeben werden.

• Wenn die Datenvalidierung fehlschlägt, wird die Fehlermeldung im Attribut form.errors in Form eines Dictionarys gespeichert. Jeder Feldname ist der Schlüssel, und die entsprechende Fehlermeldung ist der Wert.

1. Der Benutzer gibt die Daten ein und reicht das Formular ein.
2. Django ruft die is_valid()-Methode auf, um die Daten zu validieren.
3. Wenn die Daten gültig sind, werden sie in cleaned_data gespeichert, andernfalls wird eine Fehlermeldung hinzugefügt.

Beispiel für den Datenvalidierungsfluss

form = RegistrationForm(request.POST)
if form.is_valid():
    username = form.cleaned_data['username']
    email = form.cleaned_data['email']
    password = form.cleaned_data['password']
else:
    print(form.errors)  # Ausgabe von Fehlern bei fehlgeschlagener Validierung

2. Anpassung der Validierung pro Feld

2.1 clean_fieldname()-Methode

Um die Gültigkeit eines bestimmten Feldes anzupassen, definieren Sie die Methode clean_fieldname().

Beispiel: Überprüfung auf doppelte Benutzernamen

class RegistrationForm(forms.Form):
    username = forms.CharField(max_length=30)

    def clean_username(self):
        username = self.cleaned_data['username']
        if username.lower() == 'admin':
            raise forms.ValidationError("'admin' kann nicht als Benutzername verwendet werden.")
        return username

Funktionsweise: Die Methode clean_username() prüft die Gültigkeit des Feldes username und wirft eine Ausnahme, wenn ein Problem vorliegt.

3. Validierung des gesamten Formulars

3.1 clean()-Methode

Wenn die Validierung basierend auf den Daten des gesamten Formulars erforderlich ist, überschreiben Sie die clean()-Methode.

Beispiel: Bestätigung des Passworts

class PasswordChangeForm(forms.Form):
    new_password = forms.CharField(widget=forms.PasswordInput)
    confirm_password = forms.CharField(widget=forms.PasswordInput)

    def clean(self):
        cleaned_data = super().clean()
        password = cleaned_data.get("new_password")
        confirm_password = cleaned_data.get("confirm_password")

        if password != confirm_password:
            raise forms.ValidationError("Die Passwörter stimmen nicht überein.")

        return cleaned_data

Verwendung: Wird verwendet, wenn eine gegenseitige Validierung zwischen mehreren Feldern erforderlich ist.

4. Anpassung von Fehlermeldungen

Django Forms bietet standardmäßige Fehlermeldungen. Diese können jedoch zur Verbesserung der Benutzerfreundlichkeit angepasst werden.

4.1 Änderung der Feld-Fehlermeldungen

Beispiel: Festlegung von Fehlermeldungen pro Feld

class CustomErrorForm(forms.Form):
    email = forms.EmailField(
        error_messages={
            'required': "Bitte geben Sie eine E-Mail-Adresse ein.",
            'invalid': "Bitte geben Sie eine gültige E-Mail-Adresse ein."
        }
    )

4.2 Behandlung von Fehlern im gesamten Formular

Beispiel: Fehlermeldung für Passwortüberprüfung

class LoginForm(forms.Form):
    username = forms.CharField(max_length=30)
    password = forms.CharField(widget=forms.PasswordInput)

    def clean(self):
        cleaned_data = super().clean()
        username = cleaned_data.get('username')
        password = cleaned_data.get('password')

        # Benutzer-Authentifizierungslogik hinzufügen
        if not authenticate(username=username, password=password):
            raise forms.ValidationError("Der Benutzername oder das Passwort ist falsch.")

5. Praxisbeispiel: Komplexe Validierung

5.1 Implementierung eines Registrierungsformulars

Formulardefinition

class SignupForm(forms.Form):
    username = forms.CharField(max_length=30)
    email = forms.EmailField()
    password = forms.CharField(widget=forms.PasswordInput)
    confirm_password = forms.CharField(widget=forms.PasswordInput)

    def clean_username(self):
        username = self.cleaned_data['username']
        if User.objects.filter(username=username).exists():
            raise forms.ValidationError("Dieser Benutzername ist bereits vergeben.")
        return username

    def clean(self):
        cleaned_data = super().clean()
        password = cleaned_data.get('password')
        confirm_password = cleaned_data.get('confirm_password')

        if password != confirm_password:
            raise forms.ValidationError("Die Passwörter stimmen nicht überein.")
        return cleaned_data

Bereichsdefinition

from django.shortcuts import render, redirect
from .forms import SignupForm

def signup_view(request):
    if request.method == 'POST':
        form = SignupForm(request.POST)
        if form.is_valid():
            User.objects.create_user(
                username=form.cleaned_data['username'],
                email=form.cleaned_data['email'],
                password=form.cleaned_data['password']
            )
            return redirect('login')
    else:
        form = SignupForm()
    return render(request, 'signup.html', {'form': form})

6. Fazit

Die Validierung von Django Forms ist eine Schlüsselkomponente zur Gewährleistung der Genauigkeit und Sicherheit bei der Eingabe von Daten. Neben der standardmäßig bereitgestellten Prüfungen können die Validierungen an die Anforderungen des Projekts angepasst werden. Im nächsten Beitrag werden wir über Form-Styling mit Django Forms und CSS sprechen.