How to Build a Backend for BackboneJS?

はじめに このチュートリアルでは、back4appを使用してbackbonejsアプリケーションの完全なバックエンドを構築する方法を学びます。 データベース管理、cloud code functions、restおよびgraphql api、ユーザー認証、リアルタイムクエリ（ライブクエリ）など、back4appの重要な機能を統合する方法を説明します。これにより、backbonejsフロントエンドとシームレスに通信する安全でスケーラブル、かつ堅牢なバックエンドを作成します。 また、back4appの迅速なセットアップと直感的な環境が、サーバーやデータベースを手動で構成するのに比べて、時間と労力を大幅に削減できることを確認します。 その過程で、高度なセキュリティ機能、cloud jobsを使用したタスクのスケジューリング、外部統合のためのwebhookの設定など、主要な機能に関する実践的な経験を得ることができます。 このチュートリアルの終わりまでには、この基本的なセットアップを本番環境に適したアプリケーションに拡張する準備が整い、必要に応じてカスタムロジックやサードパーティapiを簡単に組み込むことができるようになります。 前提条件 このチュートリアルを完了するには、次のものが必要です back4appアカウントと新しいback4appプロジェクト back4appの始め方。 https //www back4app com/docs/get started/new parse app アカウントを持っていない場合は、無料で作成できます。上記のガイドに従ってプロジェクトを準備してください。 基本的なbackbonejs開発環境 プロジェクトに backbonejs https //backbonejs org/ を含めることでこれを設定できます。ローカルでbackboneアプリを提供またはバンドルする予定がある場合は、node jsがマシンにインストールされていることを確認してください。 node js（バージョン14以上）がインストールされていること npmパッケージをインストールし、ローカル開発サーバーを実行するためにnode jsが必要です。 node jsのインストール https //nodejs org/en/download/ javascriptと基本的なbackbonejsの概念に精通していること backbonejs公式ドキュメント。 https //backbonejs org/ backboneに不慣れな場合は、始める前に公式ドキュメントまたは初心者向けのチュートリアルを確認してください。 始める前に、これらの前提条件がすべて整っていることを確認してください。back4appプロジェクトを設定し、ローカルのbackbonejs環境を準備しておくことで、より簡単に進めることができます。 ステップ1 – back4appプロジェクトの設定 新しいプロジェクトを作成する back4app上でbackbonejsバックエンドを構築する最初のステップは、新しいプロジェクトを作成することです。まだ作成していない場合は、次の手順に従ってください back4appアカウントにログインする 「新しいアプリ」ボタンをクリックする あなたのback4appダッシュボードで。 アプリに名前を付ける （例：「backbonejs バックエンド チュートリアル」）。 プロジェクトが作成されると、あなたのback4appダッシュボードにリストされているのが見えます。このプロジェクトは、このチュートリアルで説明するすべてのバックエンド設定の基盤となります。 parse sdkを接続する back4appは、データを管理し、リアルタイム機能を提供し、ユーザー認証を処理するためにparseプラットフォームに依存しています。あなたのbackbonejsアプリケーションをback4appに接続するには、parse npmパッケージをインストールする（またはparse sdkスクリプトを含める）必要があり、back4appダッシュボードの資格情報で初期化します。 parseキーを取得する あなたのback4appダッシュボードで、アプリの「アプリ設定」または「セキュリティとキー」セクションに移動して、あなたの アプリケーションid と javascriptキー を見つけてください。 parseサーバーurl （通常は https //parseapi back4app com の形式で）も見つかります。 parse sdkをインストールする あなたのプロジェクトに npm install parse yarnを使用している場合は、次のようにインストールできます yarn add parse parseを初期化する あなたのbackbonejsアプリケーションで。通常、あなたはファイルを作成します（例： parseconfig js ) あなたのアプリケーションのディレクトリに src/parseconfig js // src/parseconfig js import parse from 'parse'; // replace the placeholders with your back4app credentials parse initialize('your application id', 'your javascript key'); parse serverurl = 'https //parseapi back4app com'; export default parse; このファイルは、あなたがbackbonejsアプリの他の場所でparseをインポートまたは参照するたびに、特定のback4appインスタンスに接続するように事前に設定されていることを保証します。 このステップを完了することで、あなたのbackbonejsフロントエンドとback4appバックエンドの間に安全な接続が確立されました。すべてのリクエストとデータトランザクションは、このsdkを通じて安全にルーティングされ、手動のrestまたはgraphql呼び出しの複雑さが軽減されます（必要に応じてそれらを使用することもできます）。 ステップ2 – データベースの設定 データの保存とクエリ back4appプロジェクトが設定され、parse sdkがあなたのbackbonejsアプリに統合されたので、データの保存と取得を開始できます。以下は、backboneに優しい構造からparseオブジェクトを使用する簡単な例です。 モデルの定義 import parse from ' /parseconfig'; // define a parse powered backbone model const todomodel = parse object extend('todo'); export default todomodel; データの作成と保存 import todomodel from ' /todomodel'; async function createtodoitem(title, iscompleted) { const todo = new todomodel(); todo set('title', title); todo set('iscompleted', iscompleted); try { const savedtodo = await todo save(); console log('todo saved successfully ', savedtodo); return savedtodo; } catch (error) { console error('error saving todo ', error); } } async function fetchtodos() { const todoquery = new parse query(todomodel); try { const results = await todoquery find(); console log('fetched todo items ', results); return results; } catch (error) { console error('error fetching todos ', error); } } 代わりに、back4appのrest apiエンドポイントを使用できます 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インターフェースも提供しています 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 , and polygon 各フィールドに適切な型を選択できます。希望する場合は、backbonejsアプリからオブジェクトを最初に保存するときに、parseが自動的にこれらの列を作成することもできます。 back4appはデータモデルの設計を手助けするaiエージェントを提供しています アプリダッシュボードまたはメニューから aiエージェントを開きます。 データモデルを 簡単な言葉で説明します（例 “新しいtodoアプリをback4appで完全なクラススキーマで作成してください。”）。 aiエージェントにスキーマを作成させます aiエージェントを使用することで、データアーキテクチャの設定にかかる時間を節約し、アプリケーション全体での一貫性を確保できます。 リレーショナルデータ リレーショナルデータがある場合 – 例えば、複数の category オブジェクトを指す todo アイテム – parseで pointers または relations を使用できます。例えば // linking a task to a category with a pointer async function createtaskforcategory(categoryobjectid, title) { const todomodel = parse object extend('todo'); const todo = new todomodel(); // construct a pointer to the category const category = parse object extend('category'); const categorypointer = new 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); } } async function fetchtodoswithcategory() { const todomodel = parse object extend('todo'); const query = new parse query(todomodel); // include pointer data query include('category'); try { return await query find(); } catch (err) { console error('error fetching todos with category ', err); } } include('category') を呼び出すと、各todoと一緒にカテゴリの詳細を取得し、リレーショナルデータにシームレスにアクセスできるようになります。 ライブクエリ リアルタイムの更新のために、back4appは live queries を提供しています。backbonejsアプリでは、特定のクラスの変更にサブスクライブできます live queriesを有効にする あなたのback4appダッシュボードのアプリの サーバー設定 の下で。 “live queries” がオンになっていることを確認してください。 live queryサブスクリプションを初期化する あなたのコードで src/parseconfig js // src/parseconfig js import parse from 'parse'; // 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'; export default parse; import parse from ' /parseconfig'; async function subscribetotodos(callback) { const todoquery = new parse query('todo'); const subscription = await todoquery 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 は個々のオブジェクトに適用され、どのユーザー、役割、または一般の人々が読み書き操作を行えるかを決定します。例えば async function createprivatetodo(title, owneruser) { const todomodel = parse object extend('todo'); const todo = new todomodel(); 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があります。 クラスレベルの権限 (clp) clp は、クラス全体のデフォルトの権限を管理します。たとえば、クラスが一般に読み取り可能または書き込み可能か、または特定の役割のみがアクセスできるかどうかです。 back4appダッシュボードに移動する , アプリを選択し、 データベース セクションを開きます。 クラスを選択する （例：「todo」）。 クラスレベルの権限 タブを開きます。 「認証が必要」などのデフォルトを設定します。読み取りまたは書き込み用、または「公開にアクセス不可」。 これらの権限は基本を設定し、aclは個々のオブジェクトの権限を微調整します。堅牢なセキュリティモデルは通常、clp（広範な制限）とacl（オブジェクトごとの細かい制限）を組み合わせます。詳細については、 アプリセキュリティガイドライン。 ステップ4 – クラウドファンクションの作成とデプロイ クラウドコードは、parse server環境の機能で、サーバー側でカスタムjavascriptコードを実行できるようにします – サーバーやインフラストラクチャを管理する必要はありません。クラウドコードを書くことで、back4appバックエンドを追加のビジネスロジック、バリデーション、トリガー、およびparse server上で安全かつ効率的に実行される統合で拡張できます。 仕組み cloud codeを書くときは、通常、javascript関数、トリガー、および必要なnpmモジュールを main js (または app js ) ファイルに配置します。このファイルは、parse server環境内で実行されるback4appプロジェクトにデプロイされます。 これらの関数とトリガーはサーバー上で実行されるため、機密ロジックを処理したり、敏感なデータを処理したり、バックエンド専用のapi呼び出しを行ったりすることを信頼できます。これらは、クライアントに直接公開したくないプロセスです。 back4appアプリのすべてのcloud codeは、back4appによって管理されるparse server内で実行されるため、サーバーのメンテナンス、スケーリング、またはプロビジョニングについて心配する必要はありません。 main js ファイルを更新してデプロイするたびに、実行中のparse serverは最新のコードで更新されます。 // 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 }; }); デプロイするには、 back4app cli 1 cliをインストールします： linux/macosの場合 curl https //raw\ githubusercontent com/back4app/parse cli/back4app/installer sh | sudo /bin/bash windowsの場合 b4a exe ファイルを リリースページ https //github com/back4app/parse cli/releases からダウンロードします。 2 アカウントキーを設定します b4a configure accountkey 3 クラウドコードをデプロイします： b4a deploy ダッシュボードを通じてデプロイする アプリのダッシュボードで、 cloud code > functions に移動します。 関数を main js エディタにコピー/ペーストします。 クリックして deploy します。 関数の呼び出し backbonejsを使用してparse sdkから import parse from ' /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 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経由で mutation { calculatetextlength(input { text "hello graphql" }) { result } } この柔軟性により、backbonejsフロントエンドやrestまたはgraphqlをサポートする他のクライアントにカスタムロジックを統合できます。 ステップ5 – ユーザー認証の設定 back4appにおけるユーザー認証 back4appは、 parse user クラスを認証の基盤として活用しています。デフォルトでは、parseはパスワードのハッシュ化、セッショントークン、セキュアストレージを処理します。これにより、複雑なセキュリティフローを手動で設定する必要がありません。 ユーザー認証の設定 backbonejsアプリケーションでは、次のように新しいユーザーを作成できます import parse from ' /parseconfig'; async function signupuser(username, password, email) { const user = new parse user(); user set('username', username); user set('password', password); user set('email', email); try { await user signup(); console log('user signed up successfully!'); } catch (error) { console error('error signing up user ', error); } } async function loginuser(username, password) { try { const user = await parse user login(username, password); console log('user logged in ', user); } catch (error) { console error('error logging in user ', error); } } restを介して、ログインは次のようになります 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は セッショントークン をユーザーオブジェクトに保存します。アプリ内で、現在ログインしているユーザーにアクセスできます const currentuser = parse user current(); if (currentuser) { console log('currently logged in user ', currentuser getusername()); } else { console log('no user is logged in'); } parseはバックグラウンドでトークンベースのセッションを自動的に処理しますが、手動で管理または取り消すこともできます。これは、ログアウトする必要があるときに便利です await parse user logout(); ソーシャルログイン統合 back4appとparseは、追加のパッケージをインストールするか、既存のアダプターを使用することで、 google や facebook などの人気のあるoauthプロバイダーと統合できます。詳細な手順は異なるため、 ソーシャルログインのドキュメント。 https //www back4app com/docs/platform/sign in with apple // example facebook login (conceptual example) 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); } }; メール確認とパスワードリセット メール確認とパスワードリセットを有効にするには メール設定 に移動します。 メール確認を有効にする ことで、新しいユーザーが自分のメールアドレスの所有権を確認できるようにします。 送信元アドレスを設定する 、メールテンプレート、および必要に応じてカスタムドメインを設定します。 これらの機能は、ユーザーのメールの所有権を検証し、安全なパスワード回復方法を提供することで、アカウントのセキュリティとユーザーエクスペリエンスを向上させます。 ステップ6 – ファイルストレージの取り扱い ファイルのアップロードと取得 parseには、back4appが安全に保存するファイルアップロードを処理するための parse file クラスが含まれています import parse from ' /parseconfig'; async function uploadimage(file) { // file is typically from an \<input type="file" /> in a webpage const name = file name; const parsefile = new parse file(name, file); try { const savedfile = await parsefile save(); console log('file saved ', savedfile url()); return savedfile url(); } catch (err) { console error('error uploading file ', err); } } async function createphotoobject(file) { const photo = parse object extend('photo'); const photo = new photo(); const parsefile = new parse file(file name, file); photo set('imagefile', parsefile); return await photo save(); } ファイルurlの取得は簡単です const imagefile = photo get('imagefile'); const imageurl = imagefile url(); // use imageurl in your backbone view or html element ファイルのセキュリティ parse serverは、ファイルアップロードのセキュリティを管理するための柔軟な設定を提供します。例えば { "fileupload" { "enableforpublic" true, "enableforanonymoususer" true, "enableforauthenticateduser" true } } enableforpublic trueに設定すると、認証状態に関係なく、誰でもファイルをアップロードできるようになります。 enableforanonymoususer 匿名（ゲスト）ユーザーがファイルをアップロードできるかどうかを制御します。 enableforauthenticateduser 認証されたユーザーのみがファイルをアップロードできるかどうかを指定します。 ステップ7 – クラウドジョブを使用したタスクのスケジューリング クラウドジョブ クラウドジョブ はback4appで、古いデータのクリーンアップや毎日の要約メールの送信など、バックエンドでルーチンタスクをスケジュールして実行できます。典型的なクラウドジョブは次のようになります // 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); } }); cloud codeをデプロイする 新しいジョブで（cliまたはダッシュボード経由で）。 back4appダッシュボードに移動する > アプリ設定 > サーバー設定 > バックグラウンドジョブ ジョブをスケジュールする 毎日またはニーズに合った間隔で実行されるように。 クラウドジョブは、手動の介入を必要とせずに、バックグラウンドメンテナンスやその他の定期的なプロセスを自動化することを可能にします。 ステップ8 – webhookの統合 webhooks は、特定のイベントが発生するたびに、back4appアプリが外部サービスにhttpリクエストを送信できるようにします。これは、決済ゲートウェイ（例：stripe）、メールマーケティングツール、または分析プラットフォームなどのサードパーティシステムと統合するために強力です。 webhooksの設定に移動 は、back4appダッシュボード > その他 > webhooksに行き、次に「webhookを追加」をクリックします。 エンドポイントを設定 （例： https //your external service com/webhook endpoint https //your external service com/webhook endpoint ）。 トリガーを設定 して、back4appのクラスやcloud code関数でどのイベントがwebhookを発火させるかを指定します。 例えば、新しいtodoが作成されるたびにslackチャンネルに通知したい場合： 受信webhookを受け入れるslackアプリを作成します。 slackのwebhook urlをコピーします。 back4appダッシュボードで、「todoクラスの新しいレコード」というイベントのために、そのslack urlにエンドポイントを設定します。 必要に応じて、カスタムhttpヘッダーやペイロードを追加することもできます。 cloud codeでwebhooksを定義することもできます。beforesaveやaftersaveのトリガーでカスタムhttpリクエストを作成します ステップ9 – back4app管理パネルの探索 「 back4app admin app 」は、非技術的なユーザーがcrud操作を実行し、コードを書くことなく日常的なデータタスクを処理するために設計されたウェブベースの管理インターフェースです。これは、「 モデル中心 」、「 ユーザーフレンドリー なインターフェースを提供し、データベース管理、カスタムデータ管理、エンタープライズレベルの操作を効率化します。 管理アプリの有効化 「 有効化 」を選択し、「 app dashboard > more > admin app 」に移動し、「管理アプリを有効化」ボタンをクリックします。 最初の管理ユーザーを作成します （ユーザー名/パスワード）。これにより、新しい役割（b4aadminuser）とクラス（b4asetting、b4amenuitem、b4acustomfield）がアプリのスキーマに自動的に生成されます。 管理インターフェースにアクセスするためのサブドメインを選択し、セットアップを完了します。 ログイン あなたが新しい管理アプリのダッシュボードにアクセスするために作成した管理者の資格情報を使用して。 有効にすると、back4app管理アプリは、parseダッシュボードやバックエンドコードを直接使用することなく、データベースのレコードを簡単に表示、編集、または削除することができます。設定可能なアクセス制御を使用することで、データを管理するための明確でポイント＆クリックの方法が必要なチームメンバーやクライアントとこのインターフェースを安全に共有できます。 結論 この包括的なチュートリアルに従うことで、あなたは 安全なバックエンドを作成しました back4app上のbackbonejsアプリ用。 データベースを構成しました クラススキーマ、データ型、関係を使用して。 リアルタイムクエリを統合しました （ライブクエリ）即時データ更新のため。 セキュリティ対策を適用しました aclとclpを使用してデータアクセスを保護および管理。 クラウドコードを実装しました サーバー側でカスタムビジネスロジックを実行するための関数。 ユーザー認証を設定しました メール確認とパスワードリセットをサポート。 ファイルのアップロードを管理しました オプションのファイルセキュリティコントロール付き。 クラウドジョブをスケジュールしました 自動バックグラウンドタスクのため。 webhookを使用しました 外部サービスと統合するため。 back4app管理パネルを探索しました データ管理のため。 堅牢なback4appバックエンドとしっかりしたbackbonejsフロントエンドを持つことで、機能豊富でスケーラブルかつ安全なアプリケーションを開発する準備が整いました。より高度な機能を探求し、ビジネスロジックを統合し、back4appの力を活用してサーバーとデータベースの管理にかかる無数の時間を節約してください。コーディングを楽しんで！ 次のステップ 本番環境に対応したbackbonejsアプリを構築する このバックエンドを拡張して、より複雑なデータモデル、キャッシング戦略、パフォーマンス最適化を処理します。 高度な機能を統合する 特化した認証フロー、役割ベースのアクセス制御、または外部api（支払いゲートウェイなど）を含みます。 back4appの公式ドキュメントをチェックする 高度なセキュリティ、パフォーマンス調整、ログ分析についての詳細な情報を得るために。 他のチュートリアルを探る リアルタイムチャットアプリケーション、iotダッシュボード、または位置情報サービスに関するものです。ここで学んだ技術を組み合わせることができます。