Come costruire un backend per Elm?
In questo tutorial, imparerai come costruire un backend completo per un'applicazione Elm utilizzando Back4App.
Esploreremo l'integrazione delle funzionalità essenziali di Back4app – come la gestione del database, le Funzioni Cloud Code, le API REST e GraphQL, l'autenticazione degli utenti e le query in tempo reale (Live Queries) – per creare un backend sicuro, scalabile e robusto che comunica senza problemi con il tuo frontend Elm.
Vedrai anche come la rapida configurazione e l'ambiente intuitivo di Back4app possano ridurre drasticamente il tempo e lo sforzo rispetto alla configurazione manuale di server e database.
Lungo il percorso, acquisirai esperienza pratica con funzionalità chiave, inclusi avanzati strumenti di sicurezza, programmazione di attività con Cloud Jobs e configurazione di webhook per integrazioni esterne.
Entro la fine di questo tutorial, sarai ben preparato per migliorare questa configurazione fondamentale in un'applicazione pronta per la produzione o per incorporare facilmente logica personalizzata e API di terze parti secondo necessità.
Per completare questo tutorial, avrai bisogno di:
- Un account Back4App e un nuovo progetto Back4app Iniziare con Back4app. Se non hai un account, puoi crearne uno gratuitamente. Segui la guida sopra per preparare il tuo progetto.
- Ambiente di sviluppo Elm di base Puoi configurarlo installando Elm. Assicurati di avere Elm (0.19 o superiore) installato sul tuo computer.
- Familiarità con Elm Documentazione ufficiale di Elm. Se sei nuovo in Elm, rivedi la documentazione ufficiale o un tutorial per principianti prima di iniziare.
- Libreria per richieste HTTP o approccio GraphQL per Elm Utilizzeremo chiamate REST e GraphQL da Elm, poiché non esiste un SDK ufficiale di Parse per Elm. Assicurati di avere la elm/http e, se necessario, una libreria GraphQL configurata.
Assicurati di avere tutti questi requisiti in atto prima di iniziare. Avere il tuo progetto Back4app configurato e il tuo ambiente Elm locale pronto ti aiuterà a seguire più facilmente.
Il primo passo per costruire il tuo backend Elm su Back4app è creare un nuovo progetto. Se non ne hai già creato uno, segui questi passaggi:
- Accedi al tuo account Back4app.
- Clicca sul pulsante “Nuova App” nel tuo dashboard di Back4app.
- Dai un nome alla tua app (ad esempio, “Elm-Backend-Tutorial”).
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/drXO0UqsgxhFvRDiVmsMb_image.png?format=webp)
Una volta creato il progetto, lo vedrai elencato nel tuo dashboard di Back4app. Questo progetto sarà la base per tutte le configurazioni del backend discusse in questo tutorial.
Back4app si basa sulla Parse Platform per gestire i tuoi dati, fornire funzionalità in tempo reale, gestire l'autenticazione degli utenti e altro ancora. Poiché non esiste un SDK ufficiale di Elm per Parse, utilizzeremo REST o GraphQL chiamate dalla nostra applicazione Elm per comunicare con il backend di Back4app.
Recupera le tue Chiavi Parse: Nel tuo dashboard di Back4app, vai alla sezione “Impostazioni App” o “Sicurezza e Chiavi” della tua app per trovare il tuo ID Applicazione, Chiave API REST, e Endpoint GraphQL. Troverai anche l'URL del Server Parse (spesso https://parseapi.back4app.com).
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/F9teHXd_M8ERn1OPGirbi_image.png?format=webp)
Da Elm, puoi memorizzare queste credenziali in un file di configurazione o in un modulo. Ad esempio:
Utilizzerai questi valori ogni volta che effettui richieste HTTP a Back4app da Elm. Completando questo passaggio, hai stabilito come connettere in modo sicuro il tuo front end Elm con il backend di Back4app.
Con il tuo progetto Back4app impostato, puoi ora iniziare a salvare e recuperare dati tramite REST o GraphQL da Elm. Per un esempio semplice, dimostreremo come creare e recuperare un Todo.
Utilizzeremo elm/http per effettuare richieste REST. Ecco un esempio semplificato per creare un elemento Todo:
Puoi quindi chiamare createTodo o fetchTodos nella tua funzione di aggiornamento Elm, gestire le Http risposte e integrare i dati nel modello della tua applicazione.
Se preferisci testare o vuoi fare chiamate rapide al di fuori di Elm, puoi usare cURL:
Back4app fornisce anche un'interfaccia GraphQL. Di seguito è riportata una mutazione GraphQL di esempio per creare un Todo:
In Elm, puoi utilizzare una libreria GraphQL o creare manualmente le tue richieste HTTP per inviare queste mutazioni e query, molto simile a come abbiamo usato elm/http sopra.
Per impostazione predefinita, Parse consente la creazione di schemi al volo, ma puoi anche definire le tue classi e tipi di dati nel dashboard di Back4app per avere maggiore controllo.
- Naviga nella sezione “Database” nel tuo dashboard di Back4app.
- Crea una nuova classe (ad esempio, “Todo”) e aggiungi colonne pertinenti, come titolo (String) e isCompleted (Boolean).
![Crea Nuova Classe Crea Nuova Classe](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/iaZ_P-7epc_LSMFIPlaZV_image.png?format=webp)
Back4app supporta anche vari tipi di dati: String, Number, Boolean, Object, Date, File, Pointer, Array, Relation, GeoPoint, e Polygon. Puoi scegliere il tipo appropriato per ciascun campo o lasciare che Parse crei automaticamente queste colonne quando salvi per la prima volta un oggetto dalla tua app Elm utilizzando l'approccio REST o GraphQL.
![Crea Colonna Crea Colonna](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/DEh9vyxdBTZcslXxkVQMA_image.png?format=webp)
Back4app offre un Agente AI che può aiutarti a progettare il tuo modello di dati:
- Apri l'Agente AI dal tuo Dashboard App o dal menu.
- Descrivi il tuo modello di dati in linguaggio semplice (ad esempio, “Per favore, crea una nuova App ToDo su back4app con uno schema di classe completo.”).
- Lascia che l'Agente AI crei lo Schema per te.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/0snNZwHWzxuXlNu30n7IA_image.png?format=webp)
Utilizzare l'Agente AI può farti risparmiare tempo nella configurazione della tua architettura dati e garantire coerenza nella tua applicazione.
Se hai dati relazionali – ad esempio, un oggetto Categoria che punta a più elementi Todo – puoi utilizzare Puntatori o Relazioni in Parse. Da Elm, puoi gestire queste relazioni includendo i campi di puntatore o relazione nelle tue chiamate REST o GraphQL.
Ad esempio, per aggiungere un puntatore tramite REST:
Quando esegui una query, puoi anche includere i dati del puntatore utilizzando il parametro ?include=category in REST o utilizzando include nelle query GraphQL.
Per aggiornamenti in tempo reale, Back4app fornisce Query Live. Anche se non esiste un pacchetto Elm nativo per le Query Live di Parse, puoi comunque abilitarlo nel tuo dashboard di Back4app:
- Abilita le Query Live nelle Impostazioni del Server della tua app.
- Usa l'endpoint WebSocket per le Query Live in un client specializzato.
Se desideri integrare le Query Live con Elm, potresti sfruttare elm-websocket (o un altro approccio personalizzato) per iscriverti ai cambiamenti. Tuttavia, questo richiede una configurazione più avanzata poiché attualmente non esiste un client ufficiale per le Query Live di Elm.
Back4app prende sul serio la sicurezza fornendo Access Control Lists (ACLs) e Class-Level Permissions (CLPs). Queste funzionalità ti consentono di limitare chi può leggere o scrivere dati su base per oggetto o per classe, garantendo che solo gli utenti autorizzati possano modificare i tuoi dati.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/PdAyrw1nqA1QQJFuCc-4t_image.png?format=webp)
Un ACL è applicato a singoli oggetti per determinare quali utenti, ruoli o il pubblico possono eseguire operazioni di lettura/scrittura. Puoi configurare gli ACL da Elm includendo la _ACL proprietà nel tuo JSON quando crei o aggiorni oggetti tramite REST o GraphQL.
Ad esempio, per creare un Todo privato, potresti impostare:
Questo impedisce a chiunque tranne quell'utente di leggere o modificare l'oggetto.
![Modifica ACL Modifica ACL](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/3YNfxEcv7CKdLC6ca8my6_image.png?format=webp)
CLPs governano le autorizzazioni predefinite di un'intera classe, come se la classe sia leggibile o scrivibile pubblicamente, o se solo determinati ruoli possano accedervi.
- Vai al tuo Dashboard di Back4app, seleziona la tua app e apri la Database sezione.
- Seleziona una classe (ad esempio, “Todo”).
- Apri le autorizzazioni a livello di classe tab.
- Configura i tuoi predefiniti, come “Richiede autenticazione” per la lettura o la scrittura, o “Nessun accesso” per il pubblico.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/MF1Uf7HSJF03Xg6djap9m_image.png?format=webp)
Queste autorizzazioni impostano la base, mentre le ACL affinano le autorizzazioni per oggetti individuali. Un modello di sicurezza robusto combina tipicamente sia CLPs (restrizioni ampie) che ACLs (restrizioni dettagliate per oggetto). Per ulteriori informazioni, vai a Linee guida sulla sicurezza delle app.
Il Cloud Code è una funzionalità dell'ambiente Parse Server che consente di eseguire codice JavaScript personalizzato sul lato server – senza dover gestire server o infrastrutture. Scrivendo Cloud Code, puoi estendere il tuo backend di Back4app con logica aziendale aggiuntiva, validazioni, trigger e integrazioni che vengono eseguite in modo sicuro ed efficiente sul Parse Server.
Quando scrivi Cloud Code, di solito posizioni le tue funzioni JavaScript, trigger e eventuali moduli NPM richiesti in un main.js (o app.js) file. Questo file viene quindi distribuito al tuo progetto Back4app, che viene eseguito all'interno dell'ambiente Parse Server.
Tutto il Cloud Code per la tua app Back4app viene eseguito all'interno del Parse Server gestito da Back4app, quindi non devi preoccuparti della manutenzione del server, della scalabilità o della fornitura. Ogni volta che aggiorni e distribuisci il tuo main.js file, il Parse Server in esecuzione viene aggiornato con il tuo codice più recente.
Puoi chiamare queste funzioni di Cloud Code da Elm effettuando una richiesta REST a:
https://parseapi.back4app.com/functions/fetchExternalData
- Logica aziendale: Aggregazione di dati, elaborazione dei pagamenti, ecc.
- Validazioni dei dati: Assicurarsi che determinati campi soddisfino i criteri prima di salvare.
- Trigger: Esecuzione di codice prima o dopo azioni di salvataggio/aggiornamento/cancellazione.
- Integrazioni: Collegamento con API o servizi esterni.
- Applicazione della sicurezza: Controllo dei ruoli o delle autorizzazioni degli utenti prima di eseguire operazioni critiche.
Distribuendo tramite il Back4app CLI:
- Installa il CLI (esempio Linux/MacOS):
- Configura la tua chiave account:
- Distribuisci il tuo codice cloud:
Distribuzione tramite il Dashboard:
- Nel dashboard della tua app, vai a Cloud Code > Funzioni.
- Copia/incolla la funzione nell' main.js editor.
- Clicca su Distribuisci.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/pGxBQFBhk4prMc8Ub-uho_image.png?format=webp)
Da Elm, puoi chiamare una Cloud Function effettuando una richiesta POST:
Puoi anche chiamare le Cloud Functions tramite GraphQL:
Back4app sfrutta la Parse User classe come base per l'autenticazione. Per impostazione predefinita, Parse gestisce l'hashing delle password, i token di sessione e lo storage sicuro. Puoi creare e accedere agli utenti tramite REST o GraphQL dalla tua app Elm.
Back4app e Parse possono integrarsi con provider OAuth popolari come Google, Facebook, o Apple. Di solito, configurerai questi provider nel dashboard di Back4app e poi farai le richieste necessarie da Elm. Fai riferimento alla Documentazione sul Login Sociale per i dettagli sui passaggi di configurazione.
- Naviga alle Impostazioni Email nel tuo dashboard di Back4app.
- Abilita la verifica email per garantire che i nuovi utenti verifichino la proprietà dei loro indirizzi email.
- Configura l'indirizzo del mittente, i modelli email e il tuo dominio personalizzato se desiderato.
Parse include la Parse.File classe per gestire i caricamenti di file, che Back4app memorizza in modo sicuro. Poiché stiamo usando REST da Elm, possiamo fare un caricamento di file multi-part o allegare un file codificato in base64.
Una volta caricato, riceverai un URL del file nella risposta. Puoi memorizzare quell'URL in un campo della classe Parse o visualizzarlo nella tua applicazione Elm secondo necessità.
Parse Server fornisce configurazioni per gestire la sicurezza del caricamento dei file. Ad esempio:
Cloud Jobs in Back4app ti consente di pianificare ed eseguire compiti di routine sul tuo backend, come la pulizia dei dati obsoleti o l'invio di email periodiche. Ad esempio, un lavoro per rimuovere i todo più vecchi di 30 giorni potrebbe apparire così:
- Distribuisci il tuo Cloud Code con il nuovo lavoro (tramite CLI o dashboard).
- Vai al Dashboard di Back4app > Impostazioni App > Impostazioni Server > Lavori in Background.
- Pianifica il lavoro per essere eseguito quotidianamente o come desiderato.
![Pianificazione di un lavoro nel cloud Pianificazione di un lavoro nel cloud](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/5wG60YnWIST74erryTb-u_image.png?format=webp)
I Webhook consentono alla tua app Back4app di inviare richieste HTTP a un servizio esterno ogni volta che si verificano determinati eventi. Questo è potente per l'integrazione con sistemi di terze parti come gateway di pagamento (ad es., Stripe), strumenti di email marketing o piattaforme di analisi.
- Naviga nella configurazione dei Webhook nel tuo dashboard di Back4app > Altro > WebHooks e poi clicca su Aggiungi Webhook.
- Configura i trigger per specificare quali eventi nelle tue classi Back4app o nelle funzioni Cloud Code attiveranno il webhook.
![Aggiunta di un Webhook Aggiunta di un Webhook](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/morUMdwsAbVQ1EmBfUfAA_image.png?format=webp)
Ad esempio, se vuoi notificare un canale Slack ogni volta che viene creato un nuovo Todo:
- Crea un'app Slack che accetta webhook in entrata.
- Copia l'URL del webhook di Slack.
- Nel tuo dashboard di Back4app, imposta l'endpoint su quell'URL di Slack per l'evento “Nuovo record nella classe Todo.”
- Aggiungi intestazioni HTTP personalizzate o payload se necessario.
![Webhook BeforeSave Webhook BeforeSave](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/fXvy4eRzabyWmN80OMyqW_image.png?format=webp)
Il Back4app Admin App è un'interfaccia di gestione basata sul web progettata per utenti non tecnici per eseguire operazioni CRUD e gestire attività di routine sui dati senza scrivere codice. Fornisce un modello-centrico, interfaccia user-friendly che semplifica l'amministrazione del database, la gestione dei dati personalizzati e le operazioni a livello aziendale.
Abilita andando su App Dashboard > Altro > Admin App e cliccando sul pulsante “Abilita Admin App”.
![Abilita Admin App Abilita Admin App](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/5BTk1ntDh9JLXurObmm_o_image.png?format=webp)
Crea un Primo Utente Admin (nome utente/password), che genera automaticamente un nuovo ruolo (B4aAdminUser) e classi (B4aSetting, B4aMenuItem e B4aCustomField) nello schema della tua app.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/u-pU1yBJJxa9KEM2psjXS_image.png?format=webp)
Scegli un Sottodominio per accedere all'interfaccia admin e completare la configurazione.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/_2b71RLDTlQW468017saY_image.png?format=webp)
Accedi utilizzando le credenziali admin che hai creato per accedere al tuo nuovo dashboard dell'Admin App.
![Document image Document image](https://images.archbee.com/yD3zCY-NNBBIfd0uqcfR5/jOFU8C0qiFm6wiVZXS9l0_image.png?format=webp)
Una volta abilitata, l'app Back4app Admin rende facile visualizzare, modificare o rimuovere record dal tuo database – senza richiedere l'uso diretto del Parse Dashboard o del codice backend. Con controlli di accesso configurabili, puoi condividere in modo sicuro questa interfaccia con membri del team o clienti che necessitano di un modo chiaro e intuitivo per gestire i dati.
Seguendo questo tutorial completo, hai:
- Creato un backend sicuro per un'app Elm su Back4app.
- Configurato un database con schemi di classe, tipi di dati e relazioni.
- Integrato query in tempo reale (Live Queries) per aggiornamenti immediati dei dati.
- Applicato misure di sicurezza utilizzando ACL e CLP per proteggere e gestire l'accesso ai dati.
- Implementato Cloud Code funzioni per eseguire logica aziendale personalizzata sul lato server.
- Impostato l'autenticazione degli utenti con supporto per la verifica dell'email e il ripristino della password.
- Gestito caricamenti di file e recupero, con controlli di sicurezza opzionali per i file.
- Pianificato Cloud Jobs per attività di background automatizzate.
- Utilizzato Webhooks per integrarsi con servizi esterni.
- Esplorato il Pannello di Amministrazione di Back4app per la gestione dei dati.
Con un solido frontend Elm e un robusto backend Back4app, sei ora ben attrezzato per sviluppare applicazioni ricche di funzionalità, scalabili e sicure. Continua a esplorare funzionalità più avanzate, integra la tua logica aziendale e sfrutta la potenza di Back4app per risparmiare innumerevoli ore nella gestione di server e database. Buon coding!
- Costruisci un'app Elm pronta per la produzione estendendo questo backend per gestire modelli di dati più complessi, strategie di caching e ottimizzazioni delle prestazioni.
- Integra funzionalità avanzate come flussi di autenticazione specializzati, controllo degli accessi basato sui ruoli o API esterne (come i gateway di pagamento).
- Controlla la documentazione ufficiale di Back4app per approfondimenti su sicurezza avanzata, ottimizzazione delle prestazioni e analisi dei log.
- Esplora altri tutorial su applicazioni di chat in tempo reale, dashboard IoT o servizi basati sulla posizione. Puoi combinare le tecniche apprese qui con API di terze parti per creare applicazioni complesse e reali.
![Doc contributor](https://s3.amazonaws.com/archbee-animals/cat.png)