Come costruire un'app CRUD con ReactJS?
In questo tutorial, costruirai un'applicazione CRUD (crea, leggi, aggiorna e cancella) completa utilizzando ReactJS.
Questa guida è progettata per eseguire le operazioni di base di un'applicazione software dimostrando come costruire app CRUD che gestiscono e aggiornano efficacemente i dati.
Inizierai creando e configurando un progetto Back4app chiamato Basic-CRUD-App-ReactJS, che funge da robusto sistema backend per la tua applicazione web.
Successivamente, progetterai uno schema di database scalabile definendo collezioni e campi dettagliati—sia manualmente che con l'aiuto dell'Agente AI di Back4app.
Poi, sfrutterai l'App di Amministrazione di Back4app—uno strumento di gestione user-friendly con un'interfaccia drag and drop—per gestire facilmente i tuoi dati nelle collezioni.
Questa interfaccia di amministrazione migliora l'esperienza dell'utente e semplifica l'interfaccia utente, consentendo agli utenti di eseguire rapidamente operazioni CRUD.
Infine, distribuirai il tuo frontend ReactJS e lo integrerai con Back4app utilizzando REST/GraphQL (o il Parse SDK, dove disponibile), il tutto mentre proteggi il tuo backend con controlli di accesso avanzati.
Entro la fine di questa guida, avrai costruito un'applicazione web pronta per la produzione che non solo supporta le operazioni CRUD di base, ma include anche l'autenticazione degli utenti e robuste capacità di aggiornamento dei dati.
- Impara a costruire applicazioni CRUD che gestiscono i dati in modo efficiente utilizzando un sistema di gestione database affidabile.
- Acquisisci intuizioni pratiche sulla progettazione di un backend scalabile e sulla sua integrazione con un frontend ReactJS per migliorare l'esperienza utente.
- Scopri come utilizzare uno strumento di gestione drag and drop (l'app Back4app Admin) per semplificare le operazioni di creazione, lettura, aggiornamento e cancellazione.
- Comprendi le tecniche di distribuzione, inclusa la containerizzazione Docker, per lanciare rapidamente la tua applicazione web.
Prima di iniziare, assicurati di avere quanto segue:
- Un account Back4app e un nuovo progetto impostato. Se hai bisogno di aiuto, fai riferimento a Iniziare con Back4app.
- Un ambiente di sviluppo ReactJS. Usa Create React App o uno strumento simile. Assicurati che Node.js (versione 14 o superiore) sia installato.
- Comprensione di base di JavaScript, ReactJS e REST API. Rivedi la documentazione di ReactJS se necessario.
- Accedi al tuo account Back4app.
- Clicca sul pulsante “Nuova App” nella tua dashboard.
- Inserisci il nome del progetto: Basic-CRUD-App-ReactJS e segui le istruzioni per creare il tuo progetto.
![Crea Nuovo Progetto Crea Nuovo Progetto](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/drXO0UqsgxhFvRDiVmsMb_image.png?format=webp)
Una volta creato, il tuo nuovo progetto apparirà sulla tua dashboard di Back4app, fornendo una solida base per la configurazione del backend e la gestione del progetto.
Per l'app CRUD di base, creerai diverse collezioni.
Di seguito sono riportati alcuni esempi delle collezioni di cui avrai bisogno, che delineano i campi e i tipi di dati necessari per aiutarti a configurare efficacemente lo schema del tuo database.
Queste collezioni sono progettate per eseguire le fondamentali operazioni CRUD che consentono agli utenti di creare, leggere, aggiornare e eliminare dati.
Questa collezione memorizza informazioni su ciascun articolo.
Campo | Tipo di Dati | Descrizione |
---|---|---|
_id | ObjectId | Chiave primaria generata automaticamente. |
titolo | Stringa | Il titolo dell'elemento. |
descrizione | Stringa | Una breve descrizione dell'oggetto. |
creato_il | Data | Timestamp quando l'elemento è stato creato. |
aggiornato_il | Data | Timestamp dell'ultima aggiornamento dell'elemento. |
Questa collezione memorizza le informazioni degli utenti e i dettagli di autenticazione.
Campo | Tipo di dato | Descrizione |
---|---|---|
_id | ObjectId | Chiave primaria generata automaticamente. |
nome utente | Stringa | Nome utente unico per l'utente. |
Stringa | Indirizzo email unico. | |
hash_password | Stringa | Password hash per l'autenticazione. |
creato_il | Data | Timestamp in cui è stato creato l'account utente. |
aggiornato_a | Data | Timestamp quando l'account utente è stato aggiornato. |
Puoi impostare queste collezioni manualmente nel dashboard di Back4app creando una nuova classe per ogni collezione e aggiungendo colonne per definire i campi.
![Crea Nuova Classe Crea Nuova Classe](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/iaZ_P-7epc_LSMFIPlaZV_image.png?format=webp)
Puoi facilmente creare campi per il tuo database selezionando un tipo di dato, nominando il campo, impostando un valore predefinito e definendo se è obbligatorio.
![Crea Colonna Crea Colonna](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/DEh9vyxdBTZcslXxkVQMA_image.png?format=webp)
L'agente AI di Back4app è uno strumento potente disponibile direttamente dal tuo dashboard di Back4app.
Consente di generare automaticamente lo schema del database in base a un prompt che descrive le collezioni e i campi desiderati.
Questa funzionalità è un notevole risparmio di tempo per la gestione dei progetti e aiuta a garantire che il sistema di gestione del database sia configurato per eseguire le operazioni di base richieste dalla tua applicazione web.
- Apri l'agente AI: Accedi al tuo dashboard di Back4app e individua l'agente AI nel menu o nelle impostazioni del tuo progetto.
- Descrivi il tuo modello di dati: Nell'interfaccia dell'agente AI, incolla un prompt dettagliato che delinea le collezioni e i campi di cui hai bisogno.
- Rivedi e applica: Una volta inviato, l'agente AI genererà le collezioni e le definizioni dei campi. Rivedi queste proposte e applicale al tuo progetto.
Utilizzare l'agente AI in questo modo fa risparmiare tempo e garantisce che il tuo schema sia coerente e ottimizzato per le esigenze della tua applicazione.
L'App Admin di Back4app è un'interfaccia potente e senza codice che ti consente di gestire i tuoi dati di backend.
Questo strumento di gestione fornisce un'interfaccia utente drag and drop che consente agli utenti di eseguire facilmente operazioni CRUD come creare, leggere, aggiornare ed eliminare record.
- Naviga nel menu “Altro nel tuo dashboard di Back4app.
- Clicca su “App Admin” e poi su “Abilita App Admin.”
- Configura le tue credenziali admin creando il tuo primo utente admin. Questo processo imposta anche i ruoli (ad es., B4aAdminUser) e le collezioni di sistema.
![Abilita App Admin Abilita App Admin](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/5BTk1ntDh9JLXurObmm_o_image.png?format=webp)
Dopo aver abilitato, accedi all'App Admin per gestire i tuoi dati.
![Dashboard dell'app Admin Dashboard dell'app Admin](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/jOFU8C0qiFm6wiVZXS9l0_image.png?format=webp)
All'interno dell'app Admin puoi:
- Creare record: Fai clic sul pulsante “Aggiungi record” all'interno di una collezione (ad es., Articoli) per creare nuove voci.
- Leggere/Aggiornare record: Seleziona un record per visualizzarne i dettagli o modificare i campi, assicurando un aggiornamento dei dati fluido.
- Eliminare record: Usa l'opzione di eliminazione per rimuovere i record che non sono più necessari. Questo strumento di gestione facile da usare migliora l'esperienza complessiva dell'utente fornendo un'interfaccia semplice di trascinamento e rilascio per le funzioni CRUD.
Ora che il tuo backend è impostato e gestito tramite l'app Admin, è tempo di collegare il tuo frontend ReactJS a Back4app.
Installa il Parse SDK:
Inizializza Parse nella tua app React: Crea un file (ad esempio, src/parseConfig.js):
Usa Parse in un componente React: Ad esempio, crea un componente per recuperare e visualizzare gli elementi:
Se il tuo ambiente non supporta il Parse SDK, puoi eseguire operazioni CRUD utilizzando REST o GraphQL. Ad esempio, per recuperare elementi utilizzando REST:
Integra queste chiamate API nei tuoi componenti React secondo necessità.
Proteggi i tuoi dati assegnando ACL agli oggetti. Ad esempio, per creare un elemento privato:
Nel dashboard di Back4app, configura i CLP per ogni collezione per impostare le regole di accesso predefinite. Questo assicura che solo gli utenti autenticati o autorizzati possano accedere ai dati sensibili.
Back4app sfrutta la classe User di Parse per l'autenticazione. Nella tua app React, gestisci la registrazione e il login degli utenti come segue:
Un approccio simile può essere utilizzato per il login e la gestione delle sessioni. Funzionalità aggiuntive come i login social, la verifica dell'email e il ripristino della password possono essere configurate nel dashboard di Back4app.
La funzionalità di Web Deployment di Back4app ti consente di ospitare il tuo frontend ReactJS senza problemi distribuendo il tuo codice da un repository GitHub.
In questa sezione, imparerai come preparare la tua build di produzione, impegnare il tuo codice sorgente su GitHub, integrare il tuo repository con Web Deployment e distribuire il tuo sito.
- Apri la cartella del tuo progetto in un terminale.
Esegui il comando di build:
- Verifica la Build: Assicurati che la build cartella contenga un index.html file insieme alle necessarie sottodirectory di asset.
Il tuo repository dovrebbe includere il codice sorgente completo per il tuo frontend ReactJS. Una struttura di file tipica potrebbe apparire così:
src/parseConfig.js
src/App.js
Aggiungi i tuoi file sorgente:
Esegui il commit delle tue modifiche:
- Crea un repository GitHub: Ad esempio, crea un repository chiamato Basic-CRUD-App-ReactJS-Frontend su GitHub.
Invia il tuo codice a GitHub:
- Accedi al Web Deployment: Accedi al tuo dashboard di Back4app, naviga al tuo progetto (Basic-CRUD-App-ReactJS) e clicca sulla funzione Web Deployment.
- Collegati a GitHub: Se non lo hai già fatto, integra il tuo account GitHub seguendo le istruzioni sullo schermo. Questa connessione consente a Back4app di accedere al tuo repository.
- Seleziona il tuo repository e branch: Scegli il repository che hai creato (ad esempio, Basic-CRUD-App-ReactJS-Frontend) e seleziona il branch (ad esempio, main) che contiene il tuo codice ReactJS.
Fornisci dettagli di configurazione aggiuntivi:
- Comando di Build: Se il tuo repository non include una build precompilata, specifica il comando di build (ad es., npm run build). Back4app eseguirà questo comando durante il deployment.
- Directory di Output: Imposta la directory di output su build in modo che Back4app sappia quale cartella contiene i file del tuo sito statico.
- Variabili d'Ambiente: Se la tua applicazione dipende da variabili d'ambiente (ad es., chiavi API), aggiungile nelle impostazioni di configurazione.
Se preferisci utilizzare Docker per il deployment, puoi containerizzare la tua applicazione ReactJS. Includi un Dockerfile nel tuo repository con contenuti simili ai seguenti:
Includi questo Dockerfile nel tuo repository. Poi, nella tua configurazione di distribuzione web, seleziona l'opzione di distribuzione Docker per costruire e distribuire la tua applicazione containerizzata.
- Clicca sul pulsante di distribuzione: Una volta configurate le impostazioni di distribuzione, clicca sul Distribuisci pulsante.
- Monitora il processo di costruzione: Back4app preleverà il tuo codice da GitHub, eseguirà il comando di costruzione (se configurato) e distribuirà la tua app all'interno di un container.
- Ottieni il tuo URL: Dopo il completamento della distribuzione, Back4app fornirà un URL dove è ospitata la tua applicazione ReactJS.
- Visita l'URL fornito: Apri l'URL nel tuo browser per visualizzare il tuo sito distribuito.
- Testa l'applicazione: Verifica che la tua applicazione si carichi correttamente, che tutte le rotte funzionino come previsto e che tutte le risorse (CSS, JavaScript, immagini) siano servite correttamente.
- Risolvi i problemi se necessario: Usa gli strumenti per sviluppatori del tuo browser per controllare eventuali errori. Se si verificano problemi, rivedi i log di distribuzione in Back4app e verifica l'integrazione con GitHub e le impostazioni di costruzione.
Congratulazioni! Hai costruito un'app CRUD di base completa utilizzando ReactJS e Back4app.
Hai configurato un progetto chiamato Basic-CRUD-App-ReactJS, progettato collezioni di database dettagliate per Articoli e Utenti, e gestito i tuoi dati tramite il potente Admin App.
Hai anche integrato il tuo frontend ReactJS con il tuo backend e protetto i tuoi dati con controlli di accesso robusti.
Prossimi Passi:
- Migliora il tuo Frontend: Estendi la tua app ReactJS con funzionalità come visualizzazioni dettagliate degli articoli, funzionalità di ricerca e notifiche in tempo reale.
- Integra Funzionalità Aggiuntive: Considera di aggiungere logica backend più avanzata (ad es., Cloud Functions), integrazioni API di terze parti o controlli di accesso basati sui ruoli.
- Esplora Risorse Aggiuntive: Rivedi la documentazione di Back4app e tutorial aggiuntivi per approfondimenti sull'ottimizzazione delle prestazioni e integrazioni personalizzate.
Seguendo questo tutorial, ora hai le competenze per creare un backend CRUD robusto e scalabile per la tua applicazione ReactJS utilizzando Back4app. Buon coding!
![Doc contributor](https://s3.amazonaws.com/archbee-animals/cat.png)