Quickstarters

Wie man eine CRUD-App mit ReactJS erstellt?

42min

Einführung

In diesem Tutorial werden Sie eine umfassende CRUD-Anwendung (erstellen, lesen, aktualisieren und löschen) mit ReactJS erstellen.

Dieser Leitfaden ist darauf ausgelegt, die grundlegenden Operationen einer Softwareanwendung durch die Demonstration des Aufbaus von CRUD-Apps, die Daten effektiv verwalten und aktualisieren, durchzuführen.

Sie beginnen mit der Erstellung und Konfiguration eines Back4app-Projekts mit dem Namen Basic-CRUD-App-ReactJS, das als robustes Backend-System für Ihre Webanwendung fungiert.

Als Nächstes entwerfen Sie ein skalierbares Datenbankschema, indem Sie detaillierte Sammlungen und Felder definieren – entweder manuell oder mit Hilfe des Back4app AI-Agenten.

Dann nutzen Sie die Back4app Admin App – ein benutzerfreundliches Verwaltungstool mit einer Drag-and-Drop-Oberfläche – um Ihre Sammlungen einfach zu verwalten.

Diese Admin-Oberfläche verbessert die Benutzererfahrung und vereinfacht die Benutzeroberfläche, sodass Benutzer CRUD-Operationen schnell durchführen können.

Schließlich werden Sie Ihr ReactJS-Frontend bereitstellen und es mit Back4app unter Verwendung von REST/GraphQL (oder dem Parse SDK, wo verfügbar) integrieren, während Sie Ihr Backend mit fortschrittlichen Zugriffskontrollen sichern.

Am Ende dieses Leitfadens haben Sie eine produktionsbereite Webanwendung erstellt, die nicht nur grundlegende CRUD-Operationen unterstützt, sondern auch die Benutzerauthentifizierung und robuste Datenaktualisierungsfunktionen umfasst.

Wichtige Erkenntnisse

  • Erfahren Sie, wie Sie CRUD-Anwendungen erstellen, die Daten effizient mit einem zuverlässigen Datenbankverwaltungssystem verwalten.
  • Gewinnen Sie praktische Einblicke in das Design eines skalierbaren Backends und dessen Integration mit einem ReactJS-Frontend, um die Benutzererfahrung zu verbessern.
  • Entdecken Sie, wie Sie ein Drag-and-Drop-Management-Tool (die Back4app Admin App) verwenden, um die Erstellung, das Lesen, die Aktualisierung und das Löschen von Operationen zu vereinfachen.
  • Verstehen Sie Bereitstellungstechniken, einschließlich Docker-Containerisierung, um Ihre Webanwendung schnell zu starten.


Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Ein Back4app-Konto und ein neues Projekt eingerichtet. Wenn Sie Hilfe benötigen, beziehen Sie sich auf Erste Schritte mit Back4app.
  • Eine ReactJS-Entwicklungsumgebung. Verwenden Sie Create React App oder ein ähnliches Tool. Stellen Sie sicher, dass Node.js (Version 14 oder höher) installiert ist.
  • Grundlegendes Verständnis von JavaScript, ReactJS und REST-APIs. Überprüfen Sie die ReactJS-Dokumentation falls erforderlich.


Schritt 1 – Projektsetup

Erstellen eines neuen Back4app-Projekts

  1. Melden Sie sich bei Ihrem Back4app-Konto an.
  2. Klicken Sie auf die Schaltfläche „Neue App“ in Ihrem Dashboard.
  3. Geben Sie den Projektnamen ein: Basic-CRUD-App-ReactJS und folgen Sie den Anweisungen, um Ihr Projekt zu erstellen.
Neues Projekt erstellen
Neues Projekt erstellen


Sobald Ihr neues Projekt erstellt ist, wird es auf Ihrem Back4app-Dashboard angezeigt und bietet eine solide Grundlage für Ihre Backend-Konfiguration und Projektverwaltung.



Schritt 2 – Datenbankschema-Design

Entwurf Ihres Datenmodells

Für die grundlegende CRUD-App werden Sie mehrere Sammlungen erstellen.

Im Folgenden finden Sie einige Beispiele für die Sammlungen, die Sie benötigen, sowie die erforderlichen Felder und Datentypen, um Ihnen bei der effektiven Einrichtung Ihres Datenbankschemas zu helfen.

Diese Sammlungen sind so konzipiert, dass sie die grundlegenden CRUD-Operationen ausführen, die es Benutzern ermöglichen, Daten zu erstellen, zu lesen, zu aktualisieren und zu löschen.

1. Artikel-Sammlung

Diese Sammlung speichert Informationen über jeden Artikel.

Feld

Datentyp

Beschreibung

_id

Objekt-ID

Automatisch generierter Primärschlüssel.

Titel

Zeichenfolge

Der Titel des Elements.

Beschreibung

Zeichenfolge

Eine kurze Beschreibung des Artikels.

erstellt_am

Datum

Zeitstempel, wann der Artikel erstellt wurde.

aktualisiert_am

Datum

Zeitstempel, wann der Artikel zuletzt aktualisiert wurde.

2. Benutzersammlung

Diese Sammlung speichert Benutzerinformationen und Authentifizierungsdetails.

Feld

Datentyp

Beschreibung

_id

Objekt-ID

Automatisch generierter Primärschlüssel.

Benutzername

Zeichenfolge

Einzigartiger Benutzername für den Benutzer.

E-Mail

Zeichenfolge

Eindeutige E-Mail-Adresse.

passwort_hash

Zeichenfolge

Gehashtes Passwort zur Authentifizierung.

erstellt_am

Datum

Zeitstempel, wann das Benutzerkonto erstellt wurde.

aktualisiert_am

Datum

Zeitstempel, wann das Benutzerkonto aktualisiert wurde.

Sie können diese Sammlungen manuell im Back4app-Dashboard einrichten, indem Sie eine neue Klasse für jede Sammlung erstellen und Spalten hinzufügen, um die Felder zu definieren.

Neue Klasse erstellen
Neue Klasse erstellen


Sie können ganz einfach Felder für Ihre Datenbank erstellen, indem Sie einen Datentyp auswählen, das Feld benennen, einen Standardwert festlegen und definieren, ob es erforderlich ist.

Spalte erstellen
Spalte erstellen



Verwendung des Back4app AI-Agenten zur Schema-Generierung

Der Back4app AI-Agent ist ein leistungsstarkes Tool, das direkt von Ihrem Back4app-Dashboard aus verfügbar ist.

Es ermöglicht Ihnen, Ihr Datenbankschema automatisch basierend auf einem Prompt zu generieren, der Ihre gewünschten Sammlungen und Felder beschreibt.

Diese Funktionalität spart erheblich Zeit im Projektmanagement und hilft sicherzustellen, dass Ihr Datenbankverwaltungssystem so eingerichtet ist, dass es die grundlegenden Operationen ausführen kann, die von Ihrer Webanwendung benötigt werden.

So verwenden Sie den KI-Agenten:

  1. Öffnen Sie den KI-Agenten: Melden Sie sich bei Ihrem Back4app-Dashboard an und suchen Sie den KI-Agenten im Menü oder in Ihren Projekteinstellungen.
  2. Beschreiben Sie Ihr Datenmodell: Fügen Sie in der Benutzeroberfläche des KI-Agenten einen detaillierten Prompt ein, der die Sammlungen und Felder beschreibt, die Sie benötigen.
  3. Überprüfen und Anwenden: Sobald Sie es eingereicht haben, wird der KI-Agent die Sammlungen und Felddefinitionen generieren. Überprüfen Sie diese Vorschläge und wenden Sie sie auf Ihr Projekt an.

Beispiel-Prompt

Text


Die Verwendung des KI-Agenten auf diese Weise spart Zeit und stellt sicher, dass Ihr Schema konsistent und optimiert für die Bedürfnisse Ihrer Anwendung ist.



Schritt 3 – Aktivierung der Admin-App & CRUD-Operationen

Übersicht über die Admin-App

Die Back4app Admin-App ist eine leistungsstarke, codefreie Schnittstelle, die es Ihnen ermöglicht, Ihre Backend-Daten zu verwalten.

Dieses Verwaltungstool bietet eine Drag-and-Drop-Benutzeroberfläche, die es Benutzern ermöglicht, CRUD-Operationen wie Erstellen, Lesen, Aktualisieren und Löschen von Datensätzen einfach durchzuführen.

Aktivierung der Admin-App

  1. Navigieren Sie zum Menü „Mehr“ in Ihrem Back4app-Dashboard.
  2. Klicken Sie auf „Admin-App“ und dann auf „Admin-App aktivieren.“
  3. Konfigurieren Sie Ihre Admin-Anmeldeinformationen indem Sie Ihren ersten Admin-Benutzer erstellen. Dieser Prozess richtet auch Rollen ein (z. B. B4aAdminUser) und Systemkollektionen.
Admin-App aktivieren
Admin-App aktivieren


Nach der Aktivierung melden Sie sich bei der Admin-App an, um Ihre Daten zu verwalten.

Admin App Dashboard
Admin App Dashboard


Verwendung der Admin-App für CRUD-Operationen

Innerhalb der Admin-App können Sie:

  • Datensätze erstellen: Klicken Sie auf die Schaltfläche „Datensatz hinzufügen“ innerhalb einer Sammlung (z. B. Artikel), um neue Einträge zu erstellen.
  • Datensätze lesen/aktualisieren: Wählen Sie einen beliebigen Datensatz aus, um dessen Details anzuzeigen oder Felder zu bearbeiten, um eine reibungslose Datenaktualisierung zu gewährleisten.
  • Datensätze löschen: Verwenden Sie die Löschoption, um Datensätze zu entfernen, die nicht mehr benötigt werden. Dieses benutzerfreundliche Verwaltungstool verbessert das Gesamterlebnis der Benutzer, indem es eine einfache Drag-and-Drop-Oberfläche für CRUD-Funktionen bietet.


Schritt 4 – Integration von ReactJS mit Back4app

Jetzt, da Ihr Backend eingerichtet und über die Admin-App verwaltet wird, ist es an der Zeit, Ihr ReactJS-Frontend mit Back4app zu verbinden.

Option A: Verwendung des Parse SDK

  1. Installieren Sie das Parse SDK:

    Bash
    
  2. Initialisieren Sie Parse in Ihrer React-App: Erstellen Sie eine Datei (z.B. src/parseConfig.js):

    JS
    
  3. Verwenden Sie Parse in einer React-Komponente: Erstellen Sie beispielsweise eine Komponente, um Elemente abzurufen und anzuzeigen:

    JS
    

Option B: Verwendung von REST oder GraphQL

Wenn Ihre Umgebung das Parse SDK nicht unterstützt, können Sie CRUD-Operationen mit REST oder GraphQL durchführen. Zum Beispiel, um Elemente mit REST abzurufen:

JS


Integrieren Sie diese API-Aufrufe nach Bedarf in Ihre React-Komponenten.



Schritt 5 – Sicherung Ihres Backends

Zugriffskontrolllisten (ACLs)

Sichern Sie Ihre Daten, indem Sie ACLs Objekten zuweisen. Zum Beispiel, um ein privates Element zu erstellen:

JS


Klassenebene Berechtigungen (CLPs)

Konfigurieren Sie im Back4app-Dashboard CLPs für jede Sammlung, um Standardzugriffsregeln festzulegen. Dies stellt sicher, dass nur authentifizierte oder autorisierte Benutzer auf sensible Daten zugreifen können.



Schritt 6 – Benutzerauthentifizierung

Einrichten von Benutzerkonten

Back4app nutzt die Benutzerklasse von Parse für die Authentifizierung. In Ihrer React-App behandeln Sie die Benutzerregistrierung und den Login wie folgt:

JS


Ein ähnlicher Ansatz kann für den Login und das Sitzungsmanagement verwendet werden. Zusätzliche Funktionen wie soziale Logins, E-Mail-Verifizierung und Passwortzurücksetzungen können im Back4app-Dashboard konfiguriert werden.



Schritt 7 – Bereitstellung Ihres ReactJS-Frontends mit Web-Bereitstellung

Die Web-Bereitstellungsfunktion von Back4app ermöglicht es Ihnen, Ihr ReactJS-Frontend nahtlos zu hosten, indem Sie Ihren Code aus einem GitHub-Repository bereitstellen.

In diesem Abschnitt lernen Sie, wie Sie Ihren Produktionsbuild vorbereiten, Ihren Quellcode in GitHub einpflegen, Ihr Repository mit der Web-Bereitstellung integrieren und Ihre Website bereitstellen.

7.1 Bereiten Sie Ihren Produktionsbuild vor

  1. Öffnen Sie Ihren Projektordner in einem Terminal.
  2. Führen Sie den Build-Befehl aus:

    Bash
    

    Dieser Befehl erstellt einen build-Ordner, der alle optimierten statischen Dateien enthält (einschließlich index.html, JavaScript, CSS und Bilder).

  3. Überprüfen Sie den Build: Stellen Sie sicher, dass der build-Ordner eine index.html-Datei sowie die erforderlichen Asset-Unterverzeichnisse enthält.


7.2 Organisieren und Hochladen Ihres Quellcodes

Ihr Repository sollte den vollständigen Quellcode für Ihr ReactJS-Frontend enthalten. Eine typische Dateistruktur könnte so aussehen:

Text


Beispiel-Quellcodedateien

src/parseConfig.js

JS


src/App.js

JS

  1. Fügen Sie Ihre Quelldateien hinzu:

    Bash
    
  2. Übernehmen Sie Ihre Änderungen:

    Bash
    
  3. Erstellen Sie ein GitHub-Repository: Zum Beispiel, erstellen Sie ein Repository mit dem Namen Basic-CRUD-App-ReactJS-Frontend auf GitHub.
  4. Pushen Sie Ihren Code zu GitHub:

    Bash
    


7.3 Integrieren Sie Ihr GitHub-Repository mit der Webbereitstellung

  1. Zugriff auf die Webbereitstellung: Melden Sie sich bei Ihrem Back4app-Dashboard an, navigieren Sie zu Ihrem Projekt (Basic-CRUD-App-ReactJS) und klicken Sie auf die Webbereitstellungs-Funktion.
  2. Mit GitHub verbinden: Wenn Sie dies noch nicht getan haben, integrieren Sie Ihr GitHub-Konto, indem Sie den Anweisungen auf dem Bildschirm folgen. Diese Verbindung ermöglicht es Back4app, auf Ihr Repository zuzugreifen.
  3. Wählen Sie Ihr Repository und Branch aus: Wählen Sie das Repository aus, das Sie erstellt haben (z. B. Basic-CRUD-App-ReactJS-Frontend) und wählen Sie den Branch (z. B. main) aus, der Ihren ReactJS-Code enthält.


7.4 Konfigurieren Sie Ihr Deployment

Geben Sie zusätzliche Konfigurationsdetails an:

  • Build-Befehl: Wenn Ihr Repository keinen vorgefertigten build-Ordner enthält, geben Sie den Build-Befehl an (z. B. npm run build). Back4app wird diesen Befehl während des Deployments ausführen.
  • Ausgabeverzeichnis: Setzen Sie das Ausgabeverzeichnis auf build damit Back4app weiß, welcher Ordner Ihre statischen Site-Dateien enthält.
  • Umgebungsvariablen: Wenn Ihre Anwendung von Umgebungsvariablen abhängt (z. B. API-Schlüssel), fügen Sie diese in den Konfigurationseinstellungen hinzu.


7.5 Dockerisieren Sie Ihr ReactJS-Anwendungsprojekt

Wenn Sie Docker für das Deployment bevorzugen, können Sie Ihre ReactJS-Anwendung containerisieren. Fügen Sie eine Dockerfile in Ihr Repository mit Inhalten ähnlich den folgenden hinzu:

Dockerfile


Fügen Sie dieses Dockerfile in Ihr Repository ein. Wählen Sie dann in Ihrer Webbereitstellungskonfiguration die Docker-Bereitstellungsoption aus, um Ihre containerisierte Anwendung zu erstellen und bereitzustellen.



7.6 Bereitstellung Ihrer Anwendung

  1. Klicken Sie auf die Schaltfläche Bereitstellen: Nachdem Sie die Bereitstellungseinstellungen konfiguriert haben, klicken Sie auf die Bereitstellen-Schaltfläche.
  2. Überwachen Sie den Build-Prozess: Back4app wird Ihren Code von GitHub abrufen, den Build-Befehl ausführen (falls konfiguriert) und Ihre App in einem Container bereitstellen.
  3. Erhalten Sie Ihre URL: Nachdem die Bereitstellung abgeschlossen ist, stellt Back4app eine URL zur Verfügung, unter der Ihre ReactJS-Anwendung gehostet wird.


7.7 Überprüfen Sie Ihre Bereitstellung

  1. Besuchen Sie die bereitgestellte URL: Öffnen Sie die URL in Ihrem Webbrowser, um Ihre bereitgestellte Seite anzuzeigen.
  2. Testen Sie die Anwendung: Überprüfen Sie, ob Ihre Anwendung korrekt geladen wird, alle Routen wie erwartet funktionieren und alle Assets (CSS, JavaScript, Bilder) ordnungsgemäß bereitgestellt werden.
  3. Fehlerbehebung bei Bedarf: Verwenden Sie die Entwicklertools Ihres Browsers, um nach Fehlern zu suchen. Wenn Probleme auftreten, überprüfen Sie die Bereitstellungsprotokolle in Back4app und verifizieren Sie Ihre GitHub-Integration und die Build-Einstellungen.


Schritt 8 – Fazit und nächste Schritte

Herzlichen Glückwunsch! Sie haben eine vollständige grundlegende CRUD-App mit ReactJS und Back4app erstellt.

Sie haben ein Projekt mit dem Namen Basic-CRUD-App-ReactJS, detaillierte Datenbankkollektionen für Artikel und Benutzer entworfen und Ihre Daten über die leistungsstarke Admin-App verwaltet.

Sie haben auch Ihr ReactJS-Frontend mit Ihrem Backend integriert und Ihre Daten mit robusten Zugriffskontrollen gesichert.

Nächste Schritte:

  • Verbessern Sie Ihr Frontend: Erweitern Sie Ihre ReactJS-App um Funktionen wie detaillierte Artikelansichten, Suchfunktionen und Echtzeitbenachrichtigungen.
  • Integrieren Sie zusätzliche Funktionen: Erwägen Sie, fortgeschrittenere Backend-Logik (z. B. Cloud-Funktionen), Integrationen von Drittanbieter-APIs oder rollenbasierte Zugriffskontrollen hinzuzufügen.
  • Weitere Ressourcen erkunden: Überprüfen Sie die Back4app-Dokumentation und zusätzliche Tutorials für tiefere Einblicke in die Leistungsoptimierung und benutzerdefinierte Integrationen.

Indem Sie dieses Tutorial befolgt haben, verfügen Sie nun über die Fähigkeiten, um ein robustes, skalierbares CRUD-Backend für Ihre ReactJS-Anwendung mit Back4app zu erstellen. Viel Spaß beim Programmieren!