Quickstarters
Come creare un backend per Dart?

25min
Introduzione
In questo tutorial, imparerai come costruire un backend per Dart utilizzando Back4app. 
Ci concentreremo sull'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)—in un progetto basato su Dart. 
Poiché Dart è un linguaggio di programmazione versatile, puoi usarlo per vari progetti backend, da semplici server web a applicazioni su larga scala.
Sfruttando l'ambiente intuitivo di Back4app, potrai configurare rapidamente un robusto e sicuro framework backend senza una pesante manutenzione del server. 
Vedrai come funzionalità come ACL, CLP, pianificazione di attività in background e creazione di logica personalizzata con Cloud Code semplificano le operazioni lato server. 
Dopo aver completato questo tutorial, sarai pronto a scalare il tuo backend Dart o ad aggiungere integrazioni più avanzate.
Prerequisiti
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.
Ambiente di sviluppo Dart di base
Puoi configurarlo installando il Dart SDK e qualsiasi editor di tua scelta. Per ulteriori informazioni, vedere Ottieni il Dart SDK.﻿
Dart 2.0 o superiore
Assicurati che il tuo ambiente sia aggiornato, in modo da poter sfruttare le recenti funzionalità di Dart e le librerie server side come shelf.
Familiarità con Dart e concetti di backend
Se sei nuovo in Dart, rivedi la Documentazione ufficiale di Dart. per costruire una base di conoscenza.
Assicurati di avere tutti questi prerequisiti in atto prima di iniziare. Avere il tuo progetto Back4app pronto e il tuo ambiente Dart locale correttamente configurato ti aiuterà a seguire più facilmente.
Passo 1 – Creare un nuovo progetto su Back4App e connettersi
Perché creare un nuovo progetto Back4app?
Un nuovo progetto Back4app forma la base del tuo backend, gestendo il tuo database, la sicurezza, le API, l'archiviazione dei file e altro ancora. Ti offre una struttura organizzata per costruire la tua logica server side basata su Dart.
Creare un progetto Back4app
Accedi al tuo account Back4app.
Clicca su “Nuova App” nel dashboard di Back4app.
Dai al tuo app un nome descrittivo (ad es., “Dart-Backend-Tutorial”).
﻿
Una volta creato, il tuo progetto apparirà nel dashboard di Back4app. Questo progetto è dove configurerai tutte le impostazioni del backend per la tua applicazione Dart.
Installa il Parse SDK e Connetti
Sebbene Dart non abbia un Parse SDK ufficiale, ci sono librerie mantenute dalla comunità come parse_server_sdk che abilitano l'integrazione con Back4app. Puoi aggiungerlo includendo la seguente dipendenza nel file pubspec.yaml:
YAML
dependencies:
  parse_server_sdk: ^4.0.0  # Example version
dependencies:
  parse_server_sdk: ^4.0.0  # Example version
﻿
Esegui quindi:
Bash
dart pub get
dart pub get
﻿
Inizializza Parse nel tuo codice Dart (ad esempio, in un main.dart file):
Dart
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> main() async {
  const keyApplicationId = 'YOUR_APPLICATION_ID';
  const keyClientKey = 'YOUR_JAVASCRIPT_KEY';
  const keyParseServerUrl = 'https://parseapi.back4app.com';

  await Parse().initialize(
    keyApplicationId,
    keyParseServerUrl,
    clientKey: keyClientKey,
    autoSendSessionId: true,
  );

  // Your Dart server logic goes here
  print('Parse initialized with Back4app!');
}
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> main() async {
  const keyApplicationId = 'YOUR_APPLICATION_ID';
  const keyClientKey = 'YOUR_JAVASCRIPT_KEY';
  const keyParseServerUrl = 'https://parseapi.back4app.com';

  await Parse().initialize(
    keyApplicationId,
    keyParseServerUrl,
    clientKey: keyClientKey,
    autoSendSessionId: true,
  );

  // Your Dart server logic goes here
  print('Parse initialized with Back4app!');
}
﻿
Recupera il tuo Application ID, JavaScript Key, e Parse Server URL dal dashboard di Back4app (sotto “Impostazioni App” > “Sicurezza e Chiavi”). Con questo passaggio, la tua applicazione Dart può interagire in modo sicuro con il tuo framework backend di Back4app.
Passo 2 – Configurazione del Database
Creazione di un Modello Dati
Nel dashboard di Back4app, vai alla sezione “Database” e crea una nuova classe (ad esempio, “Todo”). Aggiungi colonne per i tuoi campi, come title (String) e isCompleted (Boolean).
Creazione di un Modello Dati Utilizzando l'Agente AI
Apri l'Agente AI nel tuo Dashboard App.
Descrivi il tuo schema desiderato (ad esempio, “Per favore crea una classe ToDo con i campi title e isCompleted.”).
Lascia che l'Agente AI finalizzi lo schema per te.
Agente AI per la Creazione di Schemi
﻿
Lettura e Scrittura di Dati Utilizzando SDK
Con la libreria parse_server_sdk, puoi salvare e interrogare dati dal tuo codice Dart. Ad esempio:
Dart
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<ParseObject?> createTodoItem(String title, bool isCompleted) async {
  final todo = ParseObject('Todo')
    ..set('title', title)
    ..set('isCompleted', isCompleted);

  final response = await todo.save();

  if (response.success && response.result != null) {
    print('Todo created: ${response.result}');
    return response.result as ParseObject;
  } else {
    print('Error creating Todo: ${response.error?.message}');
    return null;
  }
}

Future<List<ParseObject>?> fetchTodos() async {
  final query = QueryBuilder<ParseObject>(ParseObject('Todo'));
  final response = await query.query();

  if (response.success && response.results != null) {
    return response.results as List<ParseObject>;
  } else {
    print('Error fetching Todos: ${response.error?.message}');
    return null;
  }
}
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<ParseObject?> createTodoItem(String title, bool isCompleted) async {
  final todo = ParseObject('Todo')
    ..set('title', title)
    ..set('isCompleted', isCompleted);

  final response = await todo.save();

  if (response.success && response.result != null) {
    print('Todo created: ${response.result}');
    return response.result as ParseObject;
  } else {
    print('Error creating Todo: ${response.error?.message}');
    return null;
  }
}

Future<List<ParseObject>?> fetchTodos() async {
  final query = QueryBuilder<ParseObject>(ParseObject('Todo'));
  final response = await query.query();

  if (response.success && response.results != null) {
    return response.results as List<ParseObject>;
  } else {
    print('Error fetching Todos: ${response.error?.message}');
    return null;
  }
}
﻿
Lettura e Scrittura di Dati Utilizzando REST API
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
Lettura e Scrittura di Dati Utilizzando GraphQL API
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
Lavorare con le Query Live (opzionale)
Per abilitare aggiornamenti in tempo reale, attiva le Query Live nel tuo dashboard di Back4app (Impostazioni del Server). Puoi quindi iscriverti da Dart, anche se potresti aver bisogno di una libreria specializzata. La libreria parse_server_sdk potrebbe avere supporto parziale per le query live; controlla la sua documentazione per dettagli.
Passo 3 – Applicare Sicurezza con ACL e CLP
Panoramica
ACL (Liste di Controllo degli Accessi): Limita la lettura/scrittura a livello di oggetto.
CLP (Permessi a Livello di Classe): Limita la lettura/scrittura a livello di classe.
Passo dopo passo
Permessi a Livello di Classe: Nella dashboard di Back4app, apri la sezione Database, scegli una classe e configura i CLP sotto “Sicurezza.”
ACL nel Codice (utilizzando il parse_server_sdk):
Dart
Future<ParseObject?> createPrivateTodo(String title, ParseUser ownerUser) async {
  final todo = ParseObject('Todo')..set('title', title);
  
  final acl = <String, dynamic>{};
  // Grant read/write to the owner
  acl[ownerUser.objectId!] = {"read": true, "write": true};
  
  // Disable public read/write
  acl['*'] = {"read": false, "write": false};

  todo.setACL(acl);

  final response = await todo.save();
  if (response.success && response.result != null) {
    return response.result as ParseObject;
  } else {
    print('Error setting ACL: ${response.error?.message}');
    return null;
  }
}
Future<ParseObject?> createPrivateTodo(String title, ParseUser ownerUser) async {
  final todo = ParseObject('Todo')..set('title', title);
  
  final acl = <String, dynamic>{};
  // Grant read/write to the owner
  acl[ownerUser.objectId!] = {"read": true, "write": true};
  
  // Disable public read/write
  acl['*'] = {"read": false, "write": false};

  todo.setACL(acl);

  final response = await todo.save();
  if (response.success && response.result != null) {
    return response.result as ParseObject;
  } else {
    print('Error setting ACL: ${response.error?.message}');
    return null;
  }
}
﻿
Passo 4 – Scrivere Funzioni di Cloud Code
Perché Cloud Code
Il Cloud Code è essenziale per creare logica aziendale personalizzata sul lato server. Ti libera dalla gestione della tua infrastruttura e mantiene il tuo codice sicuro e scalabile.
Esempio di Funzione e Trigger
Nel tuo main.js (per Cloud Code):
JS
// main.js
Parse.Cloud.define('helloDart', (request) => {
  return `Hello from Dart and Back4app, ${request.params.name || 'Guest'}!`;
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Each Todo needs a title!';
  }
});
// main.js
Parse.Cloud.define('helloDart', (request) => {
  return `Hello from Dart and Back4app, ${request.params.name || 'Guest'}!`;
});

Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw 'Each Todo needs a title!';
  }
});
﻿
Distribuzione
Utilizzando il Back4app CLI:
Utilizzando il Dashboard:
Vai a Cloud Code > Funzioni.
Incolla il tuo codice in main.js.
Clicca Distribuisci.
NPM e Cloud Code
Se hai bisogno di moduli NPM aggiuntivi per il tuo Cloud Code, specificali nel package.json. Questo ti consente di integrare API esterne o operazioni avanzate direttamente dal tuo codice lato server.
Passo 5 – Configurazione dell'Autenticazione
Abilita l'Autenticazione Utente
Nel dashboard di Back4app, puoi abilitare la verifica dell'email o impostare accessi social. Per impostazione predefinita, la classe Parse User memorizza le password in modo sicuro.
Esempi di Codice (utilizzando parse_server_sdk in Dart):
Dart
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> signUpUser(String username, String password, String email) async {
  final user = ParseUser(username, password, email);
  final response = await user.signUp();
  
  if (response.success) {
    print('User signed up: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}

Future<void> loginUser(String username, String password) async {
  final user = ParseUser(username, password, null);
  final response = await user.login();

  if (response.success) {
    print('User logged in: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}
import 'package:parse_server_sdk/parse_server_sdk.dart';

Future<void> signUpUser(String username, String password, String email) async {
  final user = ParseUser(username, password, email);
  final response = await user.signUp();
  
  if (response.success) {
    print('User signed up: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}

Future<void> loginUser(String username, String password) async {
  final user = ParseUser(username, password, null);
  final response = await user.login();

  if (response.success) {
    print('User logged in: ${response.result}');
  } else {
    print('Error: ${response.error?.message}');
  }
}
﻿
Accesso Sociale
Configura i fornitori come Google, Apple o Facebook all'interno del pannello di controllo di Back4app.
Implementa il corrispondente plugin parse_server_sdk o un flusso OAuth personalizzato se disponibile.
Passo 6 – Gestione dello Storage dei File
Impostazione dello Storage dei File
Back4app ospita automaticamente i file che carichi tramite le API Parse. Puoi memorizzare immagini, documenti o qualsiasi tipo di file.
Esempio (Dart)
Considerazioni sulla Sicurezza
Puoi controllare chi può caricare o recuperare file regolando i tuoi CLP o i ruoli utente nel pannello di controllo di Back4app.
Passo 7 – Verifica Email e Ripristino Password
Panoramica
La verifica dell'email conferma che gli utenti possiedono le email con cui si registrano, mentre i link per il ripristino della password forniscono un modo sicuro per gestire le credenziali smarrite.
Configurazione del Dashboard di Back4App
Vai a Impostazioni App > Email.
Abilita Verifica Email Utente e Ripristino Password.
Personalizza i tuoi modelli di email secondo necessità.
Implementazione
Quando gli utenti si registrano utilizzando un'email valida, ricevono un link di verifica dell'email. Per il ripristino della password, chiama il metodo requestPasswordReset di ParseUser (se disponibile in parse_server_sdk) o l'endpoint REST.
Passo 8 – Pianificazione dei Compiti con Cloud Jobs
Cosa Fanno i Cloud Jobs
I Cloud Jobs ti permettono di pianificare compiti a intervalli prestabiliti, come la pulizia di vecchi record o l'invio di report periodici. Operano in background, indipendentemente dalle azioni attivate dagli utenti.
Esempio
In main.js, aggiungi:
JS
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
﻿
Pianificazione
Vai a Impostazioni App > Impostazioni Server > Lavori in Background.
Pianifica cleanupOldTodos per essere eseguito quotidianamente o a un intervallo a tua scelta.
Passo 9 – Integrazione dei Webhook
Definizione
I webhook consentono alla tua app Back4app di effettuare richieste HTTP a un servizio esterno in determinati eventi. Questo è utile per l'integrazione con servizi di terze parti come Slack o Stripe.
Configurazione
Vai a Altro > WebHooks nel tuo dashboard di Back4app.
Clicca su Aggiungi Webhook e fornisci un endpoint (ad es., https://your-external-service.com/webhook-endpoint).
Specifica l'evento di attivazione (ad es., dopo che un Todo è stato creato).
Aggiungere un Webhook
﻿
Esempio
Se hai un URL Webhook di Slack, puoi configurarlo per ricevere una notifica ogni volta che viene inserito un nuovo Todo. Questa connessione fluida tra il tuo backend Dart e strumenti esterni aumenta l'automazione.
Passo 10 – Esplorare il Pannello di Amministrazione di Back4App
Dove trovarlo
Nella tua console Back4app, apri Altro > App di Amministrazione e abilita il pannello.
Caratteristiche
Gestisci facilmente i record del database.
Esamina i log, i lavori in background e le analisi.
Controlla l'accesso e i ruoli degli utenti.
Abilita l'app Admin
﻿
Conclusione
Seguendo questi passaggi, hai:
Costruito un backend sicuro per Dart su Back4app.
Gestito il tuo database attraverso classi e campi Parse.
Creato codice Cloud personalizzato per gestire la logica lato server.
Sicurezza dei dati utilizzando ACL, CLP e autenticazione degli utenti.
Pianificato attività in background con Cloud Jobs.
Integrato servizi esterni utilizzando Webhook.
Esplorato il Pannello di Amministrazione per una facile gestione dei dati.
Questa solida base ti prepara a distribuire progetti Dart in modo efficiente, sia che tu stia costruendo server web su larga scala, microservizi o applicazioni specializzate. Da qui, puoi scalare il tuo framework backend, aggiungere logica più complessa o integrare funzionalità avanzate come notifiche push o analisi avanzate.
Prossimi Passi
Esplora la prontezza per la produzione: Utilizza strategie di caching, gestisci la concorrenza e ottimizza le prestazioni per un alto traffico.
Integra funzionalità avanzate: Come il controllo degli accessi basato sui ruoli, più accessi sociali o strumenti di collaborazione in tempo reale.
Controlla la documentazione ufficiale di Back4app per approfondimenti su log, sicurezza e ottimizzazione delle prestazioni.
Sperimenta con pacchetti aggiuntivi come il pacchetto shelf per creare server web personalizzati accanto al tuo layer di dati basato su Parse, sfruttando le capacità di Dart come linguaggio di programmazione flessibile.
Con questa conoscenza di come costruire un backend per Dart, hai un modo potente per gestire i dati, proteggere i tuoi processi lato server e automatizzare i flussi di lavoro della tua app, il tutto senza la necessità di un significativo sovraccarico infrastrutturale.
Aggiornato 23 Jan 2025
Questa pagina ti è stata di aiuto?
Come costruire un backend per Ionic?
AVANTI IL PROSSIMO
Come costruire un backend per PHP?