クイックスターターズ
ExpressJSのバックエンドを構築する方法は？

46min
はじめに
このチュートリアルでは、Back4appを使用して、ExpressJSアプリケーションの完全なバックエンドを構築する方法を学びます。
データベース管理、Cloud Code Functions、RESTおよびGraphQL API、ユーザー認証、リアルタイムクエリ（ライブクエリ）など、Back4appの重要な機能を統合する方法を説明し、ExpressJSのルートやミドルウェアとシームレスに通信する安全でスケーラブル、かつ堅牢なバックエンドを作成します。
また、Back4appの迅速なセットアップと直感的な環境が、サーバーやデータベースを手動で構成するのに比べて、時間と労力を大幅に削減できることを確認します。
その過程で、高度なセキュリティ機能、Cloud Jobsを使用したタスクのスケジューリング、外部統合のためのWebhookの設定など、主要な機能に関する実践的な経験を得ることができます。
このチュートリアルの終わりまでには、この基本的なセットアップを本番環境に適したアプリケーションに拡張する準備が整い、必要に応じてカスタムロジックやサードパーティAPIを簡単に組み込むことができるようになります。
前提条件
このチュートリアルを完了するには、次のものが必要です:
Back4appアカウントと新しいBack4appプロジェクト
 Back4appの始め方。
アカウントを持っていない場合は、無料で作成できます。上記のガイドに従ってプロジェクトを準備してください。
基本的なNode.js / Express環境
 Express Generatorまたは同様のツールを使用してこれを設定できます。マシンにNode.jsがインストールされていることを確認してください。
Node.js（バージョン14以上）がインストールされていること
npmパッケージをインストールし、ローカル開発サーバーを実行するためにNode.jsが必要です。 Node.jsのインストール﻿
JavaScriptと基本的なExpressJSの概念に慣れていること
 ExpressJS公式ドキュメント。
Expressが初めての場合は、始める前に公式ドキュメントまたは初心者向けのチュートリアルを確認してください。
始める前に、これらの前提条件がすべて整っていることを確認してください。Back4appプロジェクトを設定し、ローカルのExpressJS環境を準備しておくと、より簡単に進めることができます。
ステップ1 – Back4appプロジェクトの設定
新しいプロジェクトを作成する
Back4app上でExpressJSバックエンドを構築する最初のステップは、新しいプロジェクトを作成することです。まだ作成していない場合は、次の手順に従ってください:
Back4appアカウントにログインする.
「新しいアプリ」ボタンをクリックする あなたのBack4appダッシュボードで。
アプリに名前を付ける（例：「ExpressJS-バックエンド-チュートリアル」）。
﻿
プロジェクトが作成されると、Back4appダッシュボードにリスト表示されます。このプロジェクトは、このチュートリアルで説明するすべてのバックエンド設定の基盤となります。
Parse SDKを接続する
Back4appは、データを管理し、リアルタイム機能を提供し、ユーザー認証を処理するためにParseプラットフォームに依存しています。ExpressJSアプリケーションをBack4appに接続するには、parse npmパッケージをインストールし、Back4appダッシュボードからの資格情報で初期化します。
Parseキーを取得する:
Back4appダッシュボードで、アプリの「アプリ設定」または「セキュリティとキー」セクションに移動して、アプリケーションIDとJavaScriptキーを見つけます。ParseサーバーURLも見つかります（通常はhttps://parseapi.back4app.comの形式です）。
﻿
Parse SDKをインストールする あなたのExpressJSプロジェクトに:
Bash
npm install parse
npm install parse
﻿
Yarnを使用している場合は、次のようにインストールできます:
Bash
yarn add parse
yarn add parse
﻿
ExpressJSアプリケーションでParseを初期化します：
プロジェクトディレクトリにファイル（例：parseConfig.js)を作成することができます。
src/parseConfig.js
// src/parseConfig.js
const Parse = require('parse/node');

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

module.exports = Parse;
// src/parseConfig.js
const Parse = require('parse/node');

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

module.exports = Parse;
﻿
このファイルは、Expressアプリの他の場所でParseをインポートするたびに（例：ルートやコントローラーで）、特定のBack4appインスタンスに接続するように事前に設定されていることを保証します。
このステップを完了することで、ExpressJSサーバーとBack4appバックエンドの間に安全な接続が確立されました。すべてのリクエストとデータトランザクションは、このSDKを通じて安全にルーティングされ、手動のRESTまたはGraphQL呼び出しの複雑さが軽減されます（必要に応じてそれらを使用することもできます）。
ステップ2 – データベースの設定
データの保存とクエリ
Back4appプロジェクトが設定され、Parse SDKがExpressアプリに統合されたので、データの保存と取得を開始できます。レコードを作成する最も簡単な方法は、Parse.Objectクラスを使用することです。たとえば、ルートハンドラーの1つで：
JS
// routes/todo.js
const express = require('express');
const router = express.Router();
const Parse = require('../parseConfig');

// Example: Create a Todo item
router.post('/create', async (req, res) => {
  try {
    const { title, isCompleted } = req.body;
    const Todo = Parse.Object.extend('Todo');
    const todo = new Todo();
    todo.set('title', title);
    todo.set('isCompleted', isCompleted);

    const savedTodo = await todo.save();
    res.status(200).json({ message: 'Todo saved successfully', savedTodo });
  } catch (error) {
    res.status(500).json({ error: 'Error saving Todo', details: error.message });
  }
});

// Example: Query all Todo items
router.get('/', async (req, res) => {
  try {
    const Todo = Parse.Object.extend('Todo');
    const query = new Parse.Query(Todo);
    const results = await query.find();
    res.status(200).json(results);
  } catch (error) {
    res.status(500).json({ error: 'Error fetching Todos', details: error.message });
  }
});

module.exports = router;
// routes/todo.js
const express = require('express');
const router = express.Router();
const Parse = require('../parseConfig');

// Example: Create a Todo item
router.post('/create', async (req, res) => {
  try {
    const { title, isCompleted } = req.body;
    const Todo = Parse.Object.extend('Todo');
    const todo = new Todo();
    todo.set('title', title);
    todo.set('isCompleted', isCompleted);

    const savedTodo = await todo.save();
    res.status(200).json({ message: 'Todo saved successfully', savedTodo });
  } catch (error) {
    res.status(500).json({ error: 'Error saving Todo', details: error.message });
  }
});

// Example: Query all Todo items
router.get('/', async (req, res) => {
  try {
    const Todo = Parse.Object.extend('Todo');
    const query = new Parse.Query(Todo);
    const results = await query.find();
    res.status(200).json(results);
  } catch (error) {
    res.status(500).json({ error: 'Error fetching Todos', details: error.message });
  }
});

module.exports = router;
﻿
また、Back4appのREST APIエンドポイントを使用することもできます：
Curl
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
﻿
Back4appはGraphQLインターフェースも提供しています:
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
    }
  }
}
﻿
これらの多様なオプションにより、Parse SDK、REST、またはGraphQLを通じて、開発プロセスに最も適した方法でデータ操作を統合できます。
スキーマ設計とデータ型
デフォルトでは、Parseは スキーマを動的に作成する, しかし、より多くの制御のためにBack4appダッシュボードでクラスとデータ型を定義することもできます。
Back4appダッシュボードの「データベース」セクションに移動します。
新しいクラスを作成します。（例：「Todo」）およびタイトル（String）やisCompleted（Boolean）などの関連する列を追加します。 
新しいクラスを作成
﻿
Back4appはさまざまなデータ型もサポートしています: String, Number, Boolean, Object, Date, File, Pointer, Array, Relation, GeoPoint, そして Polygon. 各フィールドに適切な型を選択できます。希望する場合は、Expressアプリからオブジェクトを最初に保存するときにParseが自動的にこれらの列を作成することもできます。
列を作成
﻿
Back4appはデータモデルの設計を手助けするAIエージェントを提供しています:
AIエージェントを アプリダッシュボードまたはメニューから開きます。
データモデルを説明する 簡単な言葉で（例：「新しいToDoアプリをback4appで完全なクラススキーマで作成してください。」）。
AIエージェントにスキーマを作成させる. 
﻿
AIエージェントを使用すると、データアーキテクチャの設定にかかる時間を節約し、アプリケーション全体での一貫性を確保できます。
リレーショナルデータ
リレーショナルデータがある場合—例えば、複数のCategoryオブジェクトが複数のTodoアイテムを指している場合—ParseでPointersまたはRelationsを使用できます。例えば、Categoryへのポインタを追加することができます:
JS
// Linking a Task to a Category with a pointer
const Parse = require('./parseConfig');

async function createTaskForCategory(categoryObjectId, title) {
  const todo = new Parse.Object('Todo');

  // Construct a pointer to the category
  const categoryPointer = new Parse.Object('Category');
  categoryPointer.id = categoryObjectId;

  // Set fields
  todo.set('title', title);
  todo.set('category', categoryPointer);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error creating Task with category relationship:', err);
  }
}
// Linking a Task to a Category with a pointer
const Parse = require('./parseConfig');

async function createTaskForCategory(categoryObjectId, title) {
  const todo = new Parse.Object('Todo');

  // Construct a pointer to the category
  const categoryPointer = new Parse.Object('Category');
  categoryPointer.id = categoryObjectId;

  // Set fields
  todo.set('title', title);
  todo.set('category', categoryPointer);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error creating Task with category relationship:', err);
  }
}
﻿
クエリを実行する際、ポインタデータも含めることができます:
JS
const Parse = require('./parseConfig');

const query = new Parse.Query('Todo');
query.include('category');
query.find().then((todosWithCategory) => {
  console.log('Todos with category details:', todosWithCategory);
});
const Parse = require('./parseConfig');

const query = new Parse.Query('Todo');
query.include('category');
query.find().then((todosWithCategory) => {
  console.log('Todos with category details:', todosWithCategory);
});
﻿
このinclude('category')呼び出しは、各Todoにカテゴリの詳細を取得し、リレーショナルデータをシームレスにアクセス可能にします。
ライブクエリ
リアルタイムの更新のために、Back4appはLive Queriesを提供します。ExpressJSアプリでは、特定のクラスの変更にサブスクライブできます。通常はフロントエンドのサブスクリプション（ReactやAngularなど）に関連付けられますが、Node環境でリアルタイム接続を管理したり、ウェブソケットを介して接続されたクライアントに更新を渡したりすることもできます。
ライブクエリを有効にする あなたのBack4appダッシュボードのアプリの サーバー設定. 「ライブクエリ」がオンになっていることを確認してください。
ライブクエリサブスクリプションを初期化する あなたのコードで:
src/parseConfig.js
// src/parseConfig.js
const Parse = require('parse/node');

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

// Live Query's subdomain:
Parse.liveQueryServerURL = 'wss://YOUR_SUBDOMAIN_HERE.b4a.io'; 

module.exports = Parse;
// src/parseConfig.js
const Parse = require('parse/node');

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

// Live Query's subdomain:
Parse.liveQueryServerURL = 'wss://YOUR_SUBDOMAIN_HERE.b4a.io'; 

module.exports = Parse;
﻿
JS
// A Node script to subscribe to Live Queries
const Parse = require('./parseConfig');

async function subscribeToTodos(callback) {
  const query = new Parse.Query('Todo');
  const subscription = await query.subscribe();

  subscription.on('create', (newTodo) => {
    console.log('New Todo created:', newTodo);
    callback('create', newTodo);
  });

  subscription.on('update', (updatedTodo) => {
    console.log('Todo updated:', updatedTodo);
    callback('update', updatedTodo);
  });

  subscription.on('delete', (deletedTodo) => {
    console.log('Todo deleted:', deletedTodo);
    callback('delete', deletedTodo);
  });

  return subscription;
}
// A Node script to subscribe to Live Queries
const Parse = require('./parseConfig');

async function subscribeToTodos(callback) {
  const query = new Parse.Query('Todo');
  const subscription = await query.subscribe();

  subscription.on('create', (newTodo) => {
    console.log('New Todo created:', newTodo);
    callback('create', newTodo);
  });

  subscription.on('update', (updatedTodo) => {
    console.log('Todo updated:', updatedTodo);
    callback('update', updatedTodo);
  });

  subscription.on('delete', (deletedTodo) => {
    console.log('Todo deleted:', deletedTodo);
    callback('delete', deletedTodo);
  });

  return subscription;
}
﻿
サブスクリプションを行うことで、新しいTodoが作成、更新、または削除されるたびにリアルタイム通知を受け取ります。この機能は、複数のユーザーが追加のポーリングなしで最新のデータを確認する必要があるコラボレーティブまたはダイナミックなアプリに特に価値があります。
ステップ3 – ACLとCLPを使用したセキュリティの適用
Back4appのセキュリティメカニズム
Back4appはセキュリティを真剣に考え、アクセス制御リスト (ACL)とクラスレベルの権限 (CLP)を提供しています。これらの機能により、オブジェクトまたはクラスごとにデータの読み取りや書き込みを制限でき、認可されたユーザーのみがデータを変更できるようになります。
﻿
アクセス制御リスト (ACL)
ACLは、どのユーザー、役割、または一般の人々が読み取り/書き込み操作を行えるかを決定するために、個々のオブジェクトに適用されます。例えば:
JS
const Parse = require('./parseConfig');

async function createPrivateTodo(title, ownerUser) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);

  // Create an ACL granting read/write access only to the owner
  const acl = new Parse.ACL(ownerUser);
  acl.setPublicReadAccess(false);
  acl.setPublicWriteAccess(false);

  todo.setACL(acl);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error saving private todo:', err);
  }
}
const Parse = require('./parseConfig');

async function createPrivateTodo(title, ownerUser) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);

  // Create an ACL granting read/write access only to the owner
  const acl = new Parse.ACL(ownerUser);
  acl.setPublicReadAccess(false);
  acl.setPublicWriteAccess(false);

  todo.setACL(acl);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error saving private todo:', err);
  }
}
﻿
オブジェクトを保存すると、それには指定されたユーザー以外の誰も読み取りまたは変更できないようにするACLがあります。
ACLを編集
﻿
クラスレベルの権限 (CLP)
CLPは、クラス全体のデフォルトの権限を管理します。たとえば、クラスが公開されているか書き込み可能か、または特定の役割のみがアクセスできるかどうかです。
Back4appダッシュボードに移動, アプリを選択し、データベースセクションを開きます。
クラスを選択（例：「Todo」）。
クラスレベルの権限タブを開きます。 
「認証が必要」などのデフォルトを設定します。読み取りまたは書き込み、または「公開にアクセス不可」。
﻿
これらの権限はベースラインを設定し、ACLは個々のオブジェクトの権限を微調整します。堅牢なセキュリティモデルは通常、CLP（広範な制限）とACL（オブジェクトごとの細かい制限）を組み合わせます。詳細については、アプリセキュリティガイドライン。﻿
ステップ4 – クラウド関数の作成とデプロイ
クラウドコードは、Parse Server環境の機能で、サーバー側でカスタムJavaScriptコードを実行できるようにします。サーバーやインフラストラクチャを管理する必要はありません。クラウドコードを書くことで、Back4appバックエンドを追加のビジネスロジック、検証、トリガー、および安全かつ効率的にParse Server上で実行される統合で拡張できます。
動作の仕組み
クラウドコードを書くとき、通常はJavaScript関数、トリガー、および必要なNPMモジュールをmain.js（またはapp.js)ファイルに配置します。このファイルはBack4appプロジェクトにデプロイされ、Parse Server環境内で実行されます。これらの関数とトリガーはサーバー上で実行されるため、機密ロジックを処理したり、敏感なデータを処理したり、バックエンド専用のAPI呼び出しを行ったりすることを信頼できます。これらのプロセスは、クライアントに直接公開したくない場合があります。
Back4appアプリのすべてのCloud Codeは、Back4appによって管理されているParse Server内で実行されるため、サーバーのメンテナンス、スケーリング、またはプロビジョニングについて心配する必要はありません。main.jsファイルを更新してデプロイするたびに、実行中のParse Serverは最新のコードで更新されます。
main.jsファイル構造
典型的な main.js には次のような内容が含まれる場合があります:
必要なモジュールのためのステートメント（NPMパッケージ、組み込みNodeモジュール、または他のクラウドコードファイル）。
Cloud関数の定義は Parse.Cloud.define() を使用します。
トリガーとして Parse.Cloud.beforeSave(), Parse.Cloud.afterSave(), など。
インストールしたNPMモジュール（必要な場合）。例えば、HTTPリクエストを行うために axios のようなパッケージをインストールすることがあります。その後、ファイルの先頭でそれをrequire（またはimport）できます。
JS
// main.js

// 1. Import necessary modules and other cloud code files
const axios = require('axios');
const report = require('./reports');

// 2. Define a custom Cloud Function
Parse.Cloud.define('fetchExternalData', async (request) => {
  const url = request.params.url;
  if (!url) {
    throw new Error('URL parameter is required');
  }
  const response = await axios.get(url);
  return response.data;
});

// 3. Example of a beforeSave trigger
Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
// main.js

// 1. Import necessary modules and other cloud code files
const axios = require('axios');
const report = require('./reports');

// 2. Define a custom Cloud Function
Parse.Cloud.define('fetchExternalData', async (request) => {
  const url = request.params.url;
  if (!url) {
    throw new Error('URL parameter is required');
  }
  const response = await axios.get(url);
  return response.data;
});

// 3. Example of a beforeSave trigger
Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
﻿
NPMモジュールをインストールして使用する能力により、Cloud Codeは非常に柔軟になり、外部APIとの統合、データ変換の実行、または複雑なサーバーサイドロジックの実行が可能になります。
典型的な使用例
ビジネスロジック: 例えば、複数のオブジェクトプロパティを集計してゲーム内のユーザーのスコアを計算し、そのデータを自動的に保存することができます。
データ検証: レコードを保存または削除する前に、特定のフィールドが存在することやユーザーが正しい権限を持っていることを確認します。
トリガー: データが変更されたときにアクションを実行します（例：ユーザーがプロフィールを更新したときに通知を送信）。
統合: サードパーティのAPIやサービスと接続します。例えば、Cloud Codeから直接支払いゲートウェイ、Slack通知、またはメールマーケティングプラットフォームと統合することができます。
セキュリティ強化: Cloud Code関数内で入力パラメータを検証およびサニタイズすることで、追加のセキュリティ層を追加します。
関数をデプロイする
以下は、クライアントから送信されたテキスト文字列の長さを計算するシンプルなCloud Code関数です。
main.js
// main.js

Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js

Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
デプロイするには、Back4app CLI:
1 - CLIをインストールする：
Linux/MacOSの場合:
Bash
curl https://raw.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
curl https://raw.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
﻿
Windowsの場合:
からファイルをダウンロードするb4a.exe リリースページから。
2 - アカウントキーを設定する:﻿
Bash
b4a configure accountkey
b4a configure accountkey
﻿
3 - クラウドコードをデプロイする：
Bash
b4a deploy
b4a deploy
﻿
ダッシュボードを通じてデプロイする:
アプリのダッシュボードで、クラウドコード > 関数に移動します。
関数をmain.jsエディタにコピー/ペーストします。
「デプロイ」をクリックします。
﻿
関数を呼び出す
ExpressJSアプリケーションから、Parse SDKを使用してCloud Code関数を呼び出すことができます:
JS
const Parse = require('./parseConfig');

async function getTextLength(text) {
  try {
    const result = await Parse.Cloud.run('calculateTextLength', { text });
    console.log('Text length:', result.length);
  } catch (err) {
    console.error('Error calling cloud function:', err);
  }
}
const Parse = require('./parseConfig');

async function getTextLength(text) {
  try {
    const result = await Parse.Cloud.run('calculateTextLength', { text });
    console.log('Text length:', result.length);
  } catch (err) {
    console.error('Error calling cloud function:', err);
  }
}
﻿
REST経由でも呼び出すことができます:
Curl
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
﻿
またはGraphQL経由で:
GraphQL
mutation {
  calculateTextLength(input: {
    text: "Hello GraphQL"
  }) {
    result
  }
}
mutation {
  calculateTextLength(input: {
    text: "Hello GraphQL"
  }) {
    result
  }
}
﻿
この柔軟性により、ExpressJSバックエンドやRESTまたはGraphQLをサポートする他のクライアントにカスタムロジックを統合することができます。
ステップ5 – ユーザー認証の設定
Back4appにおけるユーザー認証
Back4appは、Parse Userクラスを認証の基盤として活用しています。デフォルトでは、Parseはパスワードのハッシュ化、セッショントークン、セキュアストレージを処理します。これは、複雑なセキュリティフローを手動で設定する必要がないことを意味します。
ユーザー認証の設定
Expressアプリケーションでは、ユーザーのサインアップとログインのためのルートを作成することができます。
JS
// routes/user.js
const express = require('express');
const router = express.Router();
const Parse = require('../parseConfig');

// Sign up route
router.post('/signup', async (req, res) => {
  try {
    const { username, password, email } = req.body;
    const user = new Parse.User();
    user.set('username', username);
    user.set('password', password);
    user.set('email', email);

    await user.signUp();
    res.status(201).json({ message: 'User signed up successfully!' });
  } catch (error) {
    res.status(500).json({ error: 'Error signing up user', details: error.message });
  }
});

// Log in route
router.post('/login', async (req, res) => {
  try {
    const { username, password } = req.body;
    const user = await Parse.User.logIn(username, password);
    res.status(200).json({ message: 'User logged in', user });
  } catch (error) {
    res.status(401).json({ error: 'Invalid credentials', details: error.message });
  }
});

module.exports = router;
// routes/user.js
const express = require('express');
const router = express.Router();
const Parse = require('../parseConfig');

// Sign up route
router.post('/signup', async (req, res) => {
  try {
    const { username, password, email } = req.body;
    const user = new Parse.User();
    user.set('username', username);
    user.set('password', password);
    user.set('email', email);

    await user.signUp();
    res.status(201).json({ message: 'User signed up successfully!' });
  } catch (error) {
    res.status(500).json({ error: 'Error signing up user', details: error.message });
  }
});

// Log in route
router.post('/login', async (req, res) => {
  try {
    const { username, password } = req.body;
    const user = await Parse.User.logIn(username, password);
    res.status(200).json({ message: 'User logged in', user });
  } catch (error) {
    res.status(401).json({ error: 'Invalid credentials', details: error.message });
  }
});

module.exports = router;
﻿
REST経由でのログインは次のようになります:
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
﻿
セッション管理
成功したログインの後、Parseはユーザーオブジェクトに保存されるセッショントークンを作成します。Expressアプリでは、このトークンをセッションに保存するか、クライアントに返すことができます。
JS
const currentUser = Parse.User.current();
if (currentUser) {
  console.log('Currently logged-in user:', currentUser.getUsername());
} else {
  console.log('No user is logged in');
}
const currentUser = Parse.User.current();
if (currentUser) {
  console.log('Currently logged-in user:', currentUser.getUsername());
} else {
  console.log('No user is logged in');
}
﻿
Parseはバックグラウンドでトークンベースのセッションを自動的に処理しますが、手動で管理または取り消すこともできます。これは、ログアウトする必要があるときに便利です。
JS
await Parse.User.logOut();
await Parse.User.logOut();
﻿
ソーシャルログイン統合
Back4appとParseは、追加のパッケージをインストールするか、既存のアダプターを使用することで、GoogleやFacebookなどの人気のOAuthプロバイダーと統合できます。たとえば、Facebook App IDを設定し、Parse.FacebookUtils.logIn()を使用することで、Facebookログインを設定できます。詳細な手順は異なるため、ソーシャルログインドキュメント。﻿
JS
const facebookLogin = async () => {
  try {
    const user = await Parse.FacebookUtils.logIn('email');
    console.log(user.existed() ? 'User logged in' : 'User signed up and logged in');
  } catch (error) {
    console.error('Error logging in with Facebook:', error);
  }
};
const facebookLogin = async () => {
  try {
    const user = await Parse.FacebookUtils.logIn('email');
    console.log(user.existed() ? 'User logged in' : 'User signed up and logged in');
  } catch (error) {
    console.error('Error logging in with Facebook:', error);
  }
};
﻿
メール認証とパスワードリセット
メール認証とパスワードリセットを有効にするには:
Back4appダッシュボードのメール設定に移動します。
メール認証を有効にすることで、新しいユーザーがメールアドレスの所有権を確認できるようにします。
送信元アドレスを設定する, メールテンプレート、および必要に応じてカスタムドメインを設定します。
これらの機能は、ユーザーがメールの所有権を確認し、安全なパスワード回復方法を提供することで、アカウントのセキュリティとユーザーエクスペリエンスを向上させます。
ステップ6 – ファイルストレージの取り扱い
ファイルのアップロードと取得
Parseには、ファイルのアップロードを処理するためのParse.Fileクラスが含まれており、Back4appが安全に保存します。Expressルートでは、次のようにできます:
JS
const express = require('express');
const router = express.Router();
const multer = require('multer'); // For handling file uploads
const upload = multer({ dest: 'uploads/' });
const Parse = require('../parseConfig');

router.post('/upload', upload.single('file'), async (req, res) => {
  try {
    const { file } = req;
    if (!file) {
      return res.status(400).json({ error: 'No file uploaded' });
    }

    const parseFile = new Parse.File(file.originalname, file);
    const savedFile = await parseFile.save();
    res.status(200).json({ url: savedFile.url() });
  } catch (err) {
    res.status(500).json({ error: 'Error uploading file', details: err.message });
  }
});

module.exports = router;
const express = require('express');
const router = express.Router();
const multer = require('multer'); // For handling file uploads
const upload = multer({ dest: 'uploads/' });
const Parse = require('../parseConfig');

router.post('/upload', upload.single('file'), async (req, res) => {
  try {
    const { file } = req;
    if (!file) {
      return res.status(400).json({ error: 'No file uploaded' });
    }

    const parseFile = new Parse.File(file.originalname, file);
    const savedFile = await parseFile.save();
    res.status(200).json({ url: savedFile.url() });
  } catch (err) {
    res.status(500).json({ error: 'Error uploading file', details: err.message });
  }
});

module.exports = router;
﻿
データベース内のオブジェクトにファイルを添付するには、次のようにします:
JS
const Photo = Parse.Object.extend('Photo');
const photo = new Photo();
photo.set('imageFile', parseFile);
await photo.save();
const Photo = Parse.Object.extend('Photo');
const photo = new Photo();
photo.set('imageFile', parseFile);
await photo.save();
﻿
ファイルのURLを取得するのは簡単です:
JS
const imageFile = photo.get('imageFile');
const imageUrl = imageFile.url();
const imageFile = photo.get('imageFile');
const imageUrl = imageFile.url();
﻿
その後、Expressルートで imageUrl を返したり、提供したりできます。
ファイルのセキュリティ
Parse Serverは、ファイルアップロードのセキュリティを管理するための柔軟な設定を提供します。以下の例は、誰がサーバーにファイルをアップロードできるかを制御するための権限を設定する方法を示しています:
{
"fileUpload": {
"enableForPublic": true,
"enableForAnonymousUser": true,
"enableForAuthenticatedUser": true
}
}
enableForPublic: trueに設定すると、認証状態に関係なく、誰でもファイルをアップロードできます。
enableForAnonymousUser: 匿名ユーザー（サインアップしていないユーザー）がファイルをアップロードできるかどうかを制御します。
enableForAuthenticatedUser: 認証されたユーザーのみがファイルをアップロードできるかどうかを指定します。
ステップ7 – クラウドジョブによるタスクのスケジューリング
クラウドジョブ
クラウドジョブはBack4appでバックエンド上のルーチンタスクをスケジュールして実行できます。例えば、古いデータのクリーンアップや毎日の要約メールの送信などです。典型的なクラウドジョブは次のようになります:
JS
// main.js

Parse.Cloud.job('cleanupOldTodos', async (request) => {
  // This runs in the background, not triggered by a direct user request
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  // For example, remove todos older than 30 days
  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);
  }
});
// main.js

Parse.Cloud.job('cleanupOldTodos', async (request) => {
  // This runs in the background, not triggered by a direct user request
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  // For example, remove todos older than 30 days
  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);
  }
});
﻿
クラウドコードをデプロイ 新しいジョブと共に（CLIまたはダッシュボード経由で）。
Back4appダッシュボードに移動 > アプリ設定 > サーバー設定 > バックグラウンドジョブ. 
ジョブをスケジュール 毎日またはニーズに合った間隔で実行します。
クラウドジョブのスケジューリング
﻿
クラウドジョブは、手動の介入を必要とせずに、バックグラウンドメンテナンスやその他の定期的なプロセスを自動化することを可能にします。
ステップ8 – ウェブフックの統合
Webhooks は、特定のイベントが発生するたびに、Back4appアプリが外部サービスにHTTPリクエストを送信できるようにします。これは、決済ゲートウェイ（例：Stripe）、メールマーケティングツール、または分析プラットフォームなどのサードパーティシステムと統合するために強力です。
Webhooks設定に移動 あなたのBack4appダッシュボード > その他 > WebHooksに行き、次に「Webhookを追加」をクリックします。
エンドポイントを設定 （例： https://your-external-service.com/webhook-endpoint）。
トリガーを設定 して、Back4appのクラスやCloud Code関数でどのイベントがWebhookを発火させるかを指定します。
Webhookの追加
﻿
例えば、新しいTodoが作成されるたびにSlackチャンネルに通知したい場合：
受信Webhookを受け入れるSlackアプリを作成します。
SlackのWebhook URLをコピーします。
Back4appダッシュボードで、「Todoクラスの新しいレコード」というイベントのために、そのSlack URLにエンドポイントを設定します。
必要に応じてカスタムHTTPヘッダーやペイロードを追加することもできます。
Cloud CodeでWebhooksを定義することもできます。beforeSaveやafterSaveのトリガーでカスタムHTTPリクエストを作成します:
BeforeSave WebHook
﻿
ステップ9 – Back4app管理パネルの探索
「Back4app Admin App」は、非技術的なユーザーがCRUD操作を実行し、コードを書くことなく日常的なデータタスクを処理するために設計されたウェブベースの管理インターフェースです。これは、データベース管理、カスタムデータ管理、エンタープライズレベルの操作を効率化するモデル中心, ユーザーフレンドリーなインターフェースを提供します。
管理アプリの有効化
「有効化」を選択し、「App Dashboard > More > Admin App」に移動して、「Admin Appを有効化」ボタンをクリックします。
管理アプリを有効化
﻿
最初の管理ユーザーを作成します（ユーザー名/パスワード）。これにより、新しい役割（B4aAdminUser）とクラス（B4aSetting、B4aMenuItem、B4aCustomField）がアプリのスキーマに自動的に生成されます。
﻿
管理インターフェースにアクセスするためのサブドメインを選択し、セットアップを完了します。
﻿
ログイン あなたが新しい管理アプリのダッシュボードにアクセスするために作成した管理者資格情報を使用して。
﻿
有効にすると、Back4app管理アプリは、Parseダッシュボードやバックエンドコードを直接使用することなく、データベースのレコードを簡単に表示、編集、または削除することができます。設定可能なアクセス制御を使用することで、データを管理するための明確でポイント＆クリックの方法が必要なチームメンバーやクライアントとこのインターフェースを安全に共有できます。
結論
この包括的なチュートリアルに従うことで、あなたは:
安全なバックエンドを作成しました Back4app上のExpressJSアプリ用。
データベースを構成しました クラススキーマ、データ型、関係を使用して。
リアルタイムクエリを統合しました （ライブクエリ）即時データ更新のため。
セキュリティ対策を適用しました ACLとCLPを使用してデータアクセスを保護および管理。
Cloud Codeを実装しました サーバー側でカスタムビジネスロジックを実行するための関数。
ユーザー認証を設定しました メール確認とパスワードリセットをサポート。
ファイルのアップロードを管理しました オプションのファイルセキュリティコントロール付き。
Cloud Jobsをスケジュールしました 自動化されたバックグラウンドタスクのため。
Webhooksを使用しました 外部サービスとの統合のため。
Back4app管理パネルを探索しました データ管理のため。
堅牢なExpressJSサーバーと強力なBack4appバックエンドを持つことで、機能豊富でスケーラブルかつ安全なアプリケーションを開発するための準備が整いました。さらに高度な機能を探求し、ビジネスロジックを統合し、Back4appの力を活用してサーバーとデータベースの管理にかかる無数の時間を節約してください。コーディングを楽しんで！
次のステップ
本番環境に対応したExpressJSアプリを構築する このバックエンドを拡張して、より複雑なデータモデル、キャッシング戦略、パフォーマンス最適化を処理します。
高度な機能を統合する 特化した認証フロー、役割ベースのアクセス制御、または外部API（支払いゲートウェイなど）を含みます。
Back4appの公式ドキュメントをチェックする 高度なセキュリティ、パフォーマンス調整、ログ分析についての詳細な情報を得るために。
他のチュートリアルを探る リアルタイムチャットアプリケーション、IoTダッシュボード、または位置情報サービスに関するものです。ここで学んだ技術をサードパーティのAPIと組み合わせて、複雑な実世界のアプリケーションを作成できます。
﻿
更新日 24 Jan 2025
このページは役に立ちましたか？
TypeScriptのバックエンドを構築する方法は？
MeteorJSのバックエンドを構築する方法は？