Quickstarters
Come costruire un backend per Deno?

34min
Introduzione
In questo tutorial, imparerai come costruire un backend per Deno utilizzando Back4App. 
Esploreremo ogni passaggio per integrare le funzionalità chiave di Back4App: database, API REST, autenticazione degli utenti, archiviazione dei file e query in tempo reale, in un ambiente Deno. 
Vedrai come comunicare con Back4App attraverso endpoint REST e creare un'infrastruttura completa senza gestire server da solo.
Quando utilizzi Back4App, puoi evitare di configurare manualmente i server con Deno, risparmiando tempo e fatica. 
Ti concentrerai sulla scrittura di codice più semplice, grazie alla libreria standard di Deno e all'approccio moderno. 
Alla fine di questa guida su come costruire un backend per Deno, avrai un percorso chiaro per integrare sicurezza avanzata, codice cloud e attività programmate nella tua applicazione Deno.
Una volta completato questo tutorial, sarai in grado di eseguire il server, gestire le API REST, integrare l'autenticazione degli utenti, memorizzare file e pianificare attività facilmente.
Capirai anche come gestire i tuoi dati utilizzando l'approccio fetch di Deno con l'API REST di Back4App.
Requisiti
Un account Back4app e un nuovo progetto Back4app
Iniziare con Back4app.
Se non hai un account, puoi crearne uno gratuitamente. Usa il link sopra per preparare il tuo progetto.
Installa Deno
Puoi ottenere Deno su https://deno.land. Installa Deno sul tuo sistema operativo e confermalo con deno --version.
Familiarità con i concetti di base di Deno
Come moduli, file system, deno run --allow-net, o come importare moduli dell'applicazione dalla libreria standard.
Conoscenza di base delle API REST
Utilizzeremo chiamate fetch e il tipo di contenuto degli header per la gestione dei dati, quindi assicurati di conoscere i fondamenti di REST e JSON.
Assicurati di avere questi requisiti prima di iniziare. Avere il tuo progetto Back4App configurato e il tuo ambiente Deno locale in esecuzione ti permetterà di seguire questo tutorial senza problemi.
Passo 1 – Creare un Nuovo Progetto su Back4App e connettersi
Crea un Nuovo Progetto
La base per il tuo backend Deno è un progetto Back4App. Se non ne hai ancora creato uno:
Accedi al tuo account Back4App.
Clicca sul pulsante “Nuova App” nel tuo dashboard di Back4App.
Dai un nome alla tua app (ad esempio, “Deno-Backend-Tutorial”).
﻿
Una volta che il tuo progetto è pronto, apparirà nel tuo dashboard di Back4App. Questo progetto è dove configurerai database, sicurezza e API.
Collegati a Back4App tramite REST
Poiché non abbiamo un SDK Parse per Deno, utilizzeremo gli endpoint API REST di Back4App. Puoi trovare l’ID Applicazione, l’API Key REST, e l’URL del Server nella sezione Impostazioni App o Sicurezza e Chiavi della tua app.
﻿
In questo tutorial, utilizzeremo fetch per inviare richieste da Deno a Back4App. Assicurati di includere la tua chiave API e il tipo di contenuto degli header in ogni chiamata.
Passo 2 – Configurazione del Database
In questo passaggio, creerai un modello di dati su Back4App e interagirai con esso utilizzando le API REST da Deno.
Creazione di un Modello di Dati
Vai alla sezione “Database” nel tuo dashboard di Back4App.
Clicca su “Crea una Nuova Classe” e chiamala, ad esempio, “Todo.”
Aggiungi colonne rilevanti (ad esempio, titolo (String), isCompleted (Boolean)).
Crea Nuova Classe
﻿
Puoi anche consentire a Parse di creare automaticamente queste colonne quando i dati vengono salvati.
Creare un Modello di Dati con l'Agente AI
L'Agente AI di Back4App può progettare il tuo schema per te:
Apri l'Agente AI nel tuo dashboard di Back4App.
Descrivi il tuo modello di dati (ad esempio, “Crea una classe Todo con un titolo, una descrizione e un campo isCompleted.”).
Consenti all'agente di generare automaticamente lo schema.
﻿
Questo ti aiuta a gestire schemi più complessi rapidamente.
Leggere e Scrivere Dati Utilizzando l'API REST
Da Deno, puoi eseguire il server chiamando gli endpoint REST con fetch. Ad esempio, per creare un Todo:
Text
// file called createTodo.ts
export async function createTodoItem(title: string, isCompleted: boolean) {
  const url = "https://parseapi.back4app.com/classes/Todo";
  const body = JSON.stringify({ title, isCompleted });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  if (!response.ok) {
    throw new Error(`Error saving Todo: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
// file called createTodo.ts
export async function createTodoItem(title: string, isCompleted: boolean) {
  const url = "https://parseapi.back4app.com/classes/Todo";
  const body = JSON.stringify({ title, isCompleted });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  if (!response.ok) {
    throw new Error(`Error saving Todo: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
﻿
Per recuperare i Todos:
Text
// file called fetchTodos.ts
export async function fetchTodos() {
  const url = "https://parseapi.back4app.com/classes/Todo";

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });

  if (!response.ok) {
    throw new Error(`Error fetching Todos: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
// file called fetchTodos.ts
export async function fetchTodos() {
  const url = "https://parseapi.back4app.com/classes/Todo";

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });

  if (!response.ok) {
    throw new Error(`Error fetching Todos: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
﻿
Puoi eseguirli con:
Bash
deno run --allow-net createTodo.ts
deno run --allow-net createTodo.ts
﻿
Lettura e Scrittura dei Dati Utilizzando l'API GraphQL
Back4App fornisce anche un endpoint GraphQL: https://parseapi.back4app.com/graphql
Text
// file called createTodoGraphQL.ts
export async function createTodoGraphQL(title: string) {
  const mutation = `
    mutation {
      createTodo(input: {
        fields: {
          title: "${title}"
          isCompleted: false
        }
      }) {
        todo {
          objectId
          title
          isCompleted
        }
      }
    }
  `;

  const response = await fetch("https://parseapi.back4app.com/graphql", {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query: mutation }),
  });

  const result = await response.json();
  return result;
}
// file called createTodoGraphQL.ts
export async function createTodoGraphQL(title: string) {
  const mutation = `
    mutation {
      createTodo(input: {
        fields: {
          title: "${title}"
          isCompleted: false
        }
      }) {
        todo {
          objectId
          title
          isCompleted
        }
      }
    }
  `;

  const response = await fetch("https://parseapi.back4app.com/graphql", {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query: mutation }),
  });

  const result = await response.json();
  return result;
}
﻿
Lavorare con le Query Live (Opzionale)
Le Query Live ti aggiornano in tempo reale, ma Deno non ha una libreria nativa Parse LiveQuery. Puoi comunque impostare la funzionalità di Query Live nel tuo dashboard di Back4App per altri client o utilizzare un WebSocket in Deno per iscriversi manualmente. Per ulteriori dettagli, consulta la documentazione delle Query Live.
Passo 3 – Applicare la Sicurezza con ACL e CLP
Panoramica
Le ACL (Liste di Controllo degli Accessi) e le CLP (Permessi a Livello di Classe) di Back4App proteggono i tuoi dati. Usa le CLP per impostare regole predefinite per un'intera classe. Poi usa le ACL per restrizioni a livello di oggetto.
Impostazione dei Permessi a Livello di Classe
Apri il Database nella tua dashboard di Back4App.
Seleziona una Classe (ad esempio, “Todo”).
Vai alle autorizzazioni a livello di Classe.
Abilita o disabilita la lettura/scrittura per il pubblico o per gli utenti autenticati secondo necessità.
﻿
Configurazione delle ACL
Quando crei o aggiorni un oggetto tramite REST, puoi includere un attributo ACL nel corpo della richiesta. Ad esempio:
Text
const body = JSON.stringify({
  title: "Private Task",
  ACL: {
    "*": { "read": false, "write": false },
    "ROLE:Admins": { "read": true, "write": true },
  }
});
const body = JSON.stringify({
  title: "Private Task",
  ACL: {
    "*": { "read": false, "write": false },
    "ROLE:Admins": { "read": true, "write": true },
  }
});
﻿
Questo esempio consente solo al ruolo “Admins” di leggere o scrivere. L'accesso pubblico è disattivato.
Passo 4 – Scrivere Funzioni di Cloud Code
Perché Cloud Code
Cloud Code è dove memorizzi la logica sicura lato server. Non gestisci i server da solo. Puoi aggiungere convalide o trigger per classi specifiche.
Esempio di Funzione Cloud Code
Puoi definire una Funzione Cloud (in JavaScript) e distribuirla nella tua app. Ad esempio, una funzione per controllare la lunghezza del testo potrebbe essere:
Text
Parse.Cloud.define("calculateTextLength", async (request) => {
  const { text } = request.params;
  if (!text) {
    throw "Text parameter is required";
  }
  return { length: text.length };
});
Parse.Cloud.define("calculateTextLength", async (request) => {
  const { text } = request.params;
  if (!text) {
    throw "Text parameter is required";
  }
  return { length: text.length };
});
﻿
Distribuzione
Puoi distribuire il codice tramite il Back4App CLI o il pannello Cloud Code nel tuo dashboard di Back4App.
NPM su Cloud Code
Puoi importare librerie esterne con require(). Una volta distribuite, l'ambiente server le eseguirà. Questo è utile per compiti avanzati, ma ricorda che eseguirle da Deno è separato dal tuo ambiente Cloud Code su Back4App.
Passo 5 – Configurare l'Autenticazione
Abilita l'Autenticazione
Back4App utilizza la classe Parse User per l'autenticazione. Mentre lavori con Deno, puoi chiamare gli endpoint REST per gestire gli utenti.
Registrati e Accedi utilizzando REST
Text
async function signUpUser(username: string, password: string, email: string) {
  const url = "https://parseapi.back4app.com/users";
  const body = JSON.stringify({ username, password, email });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  return await response.json();
}

async function logInUser(username: string, password: string) {
  const url = `https://parseapi.back4app.com/login?username=${username}&password=${password}`;

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });
  return await response.json();
}
async function signUpUser(username: string, password: string, email: string) {
  const url = "https://parseapi.back4app.com/users";
  const body = JSON.stringify({ username, password, email });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  return await response.json();
}

async function logInUser(username: string, password: string) {
  const url = `https://parseapi.back4app.com/login?username=${username}&password=${password}`;

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });
  return await response.json();
}
﻿
Accesso Sociale
Puoi configurare Google, Facebook, Apple e altri provider su Back4App. Poi, chiamerai gli endpoint dedicati con i token OAuth. Vedi la documentazione di Accesso Sociale di Back4App per dettagli.
Passo 6 – Gestione dello Storage dei File
Carica e Recupera File
Per caricare file da Deno, usa una richiesta POST a https://parseapi.back4app.com/files/<FILENAME>. Ad esempio:
Text
async function uploadFile(fileData: Uint8Array, fileName: string) {
  const url = `https://parseapi.back4app.com/files/${fileName}`;
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "image/png",
    },
    body: fileData,
  });
  return await response.json();
}
async function uploadFile(fileData: Uint8Array, fileName: string) {
  const url = `https://parseapi.back4app.com/files/${fileName}`;
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "image/png",
    },
    body: fileData,
  });
  return await response.json();
}
﻿
Puoi quindi memorizzare l'URL del file risultante nei tuoi oggetti di classe. Questo metodo è perfetto per memorizzare immagini o documenti mentre esegui il server in Deno.
Passo 7 – Verifica Email e Reimpostazione Password
Panoramica
Verificare le email garantisce un accesso legittimo. La reimpostazione della password aiuta gli utenti a riacquistare l'accesso in modo sicuro.
Configurazione della Dashboard
Abilita la Verifica Email nel tuo dashboard di Back4App sotto Impostazioni Email.
Personalizza i tuoi modelli di verifica.
Abilita la Reimpostazione della Password e imposta il layout email preferito.
Quando un utente si registra, riceve un link di verifica se hai attivato la verifica via email. Per il ripristino della password, chiama l'endpoint REST POST /requestPasswordReset.
Passo 8 – Pianificazione dei Compiti con i Cloud Jobs
Panoramica dei Cloud Jobs
I Cloud Jobs vengono eseguiti periodicamente senza intervento umano. Ad esempio, puoi eliminare record obsoleti ogni giorno o inviare promemoria via email di routine.
Text
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.valueOf() - THIRTY_DAYS);

  query.lessThan("createdAt", cutoff);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
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.valueOf() - THIRTY_DAYS);

  query.lessThan("createdAt", cutoff);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
﻿
Dopo aver distribuito questo lavoro, puoi programmarlo in Impostazioni App > Impostazioni Server > Lavori in Background nel tuo dashboard di Back4App.
Passo 9 – Integrazione dei Webhook
Definizione
Un Webhook è un callback HTTP attivato quando si verificano eventi, come la creazione o l'aggiornamento di oggetti. Puoi integrarti con Slack, Stripe o qualsiasi servizio esterno.
Configurazione
Apri “Altro” > “WebHooks” nel dashboard di Back4App.
Clicca “Aggiungi Webhook” e fornisci l'endpoint del tuo servizio di terze parti.
Imposta quali trigger o classi vuoi inviare richieste.
Aggiunta di un Webhook
﻿
Questo consente ai sistemi esterni di ricevere dati ogni volta che crei o modifichi oggetti in Back4App.
Passo 10 – Esplorare il Pannello di Amministrazione di Back4App
Introduzione al Pannello di Amministrazione
I team non tecnici possono utilizzare questo pannello per gestire i dati visivamente. Semplifica le operazioni CRUD e le revisioni dei dati.
Come Abilitare
Vai al Dashboard dell'App > Altro > App di Amministrazione e scegli “Abilita App di Amministrazione.”
Crea un Utente Amministratore per accedere.
Imposta un sottodominio per la tua App di Amministrazione.
Abilita App di Amministrazione
﻿
Puoi quindi accedere all'App di Amministrazione per gestire i record in modo sicuro.
Conclusione
In questo tutorial, hai scoperto come costruire un backend per Deno su Back4App. Hai creato modelli di dati, gestito l'autenticazione degli utenti, appreso riguardo a ACL e CLP per la sicurezza, e programmato Cloud Jobs.
Hai anche visto come integrare API esterne tramite webhook e come eseguire il server o le API REST con comandi deno run --allow-net.
Questa configurazione ti permette di iniziare rapidamente senza dover configurare manualmente i file system o le complessità della libreria standard per l'architettura del server.
Prossimi Passi:
Espandi la tua applicazione Deno con endpoint aggiuntivi e logica avanzata utilizzando Cloud Code.
Integra più servizi (ad es., gateway di pagamento, analisi) con i tuoi dati di Back4App.
Fai riferimento alla documentazione ufficiale di Back4App per suggerimenti più approfonditi su sicurezza, prestazioni e analisi dei log.
Sperimenta con funzionalità avanzate in tempo reale o con lo storage deno kv, collegando i dati tra il tuo runtime Deno e l'ambiente robusto di Back4App.
Con le tue nuove conoscenze, puoi implementare con fiducia un backend Deno sicuro, scalabile e ricco di funzionalità supportato da Back4App.
Aggiornato 23 Jan 2025
Questa pagina ti è stata di aiuto?
Come costruire un backend per Astro?
AVANTI IL PROSSIMO
Come costruire un backend per Golang?