Быстрые стартеры
Как создать бэкэнд для Play Framework?

36min
Введение
В этом учебном пособии вы узнаете, как создать полный бэкенд для Play Framework с использованием Back4App.
Мы рассмотрим основные функции для серверных бэкендов, включая настройку конфигурации, управление базами данных, функции Cloud Code, REST и GraphQL API, аутентификацию пользователей, хранение файлов и запросы в реальном времени.
Вы увидите, как Back4App упрощает процесс настройки, масштабирования и поддержки бэкенда веб-приложения, позволяя вам сосредоточиться на вашем коде Play Framework.
Изучив, как построить бэкенд для Play Framework с помощью Back4App, вы сократите время разработки и минимизируете проблемы с dev ops.
Вы также добавите надежные функции, такие как социальный вход, планирование задач (Cloud Jobs) и вебхуки. После завершения вы сможете расширить систему до решения уровня производства, интегрируя более сложные функции по мере необходимости.
Когда вы закончите, у вас будет надежный план для создания вашего следующего масштабируемого и безопасного веб-приложения на Play Framework.
Вы будете готовы углубиться в улучшение производительности, интеграции или оптимизации режима разработки для удовлетворения реальных требований.
Предварительные требования
Чтобы завершить этот учебник, вам понадобятся:
Учетная запись Back4App и новый проект Back4App
Начало работы с Back4App.
Если у вас нет учетной записи, вы можете создать ее бесплатно. Следуйте приведенному выше руководству, чтобы подготовить ваш проект.
Рабочая среда Play Framework
Убедитесь, что у вас установлена Java 8+.
Установите sbt или используйте sbt через вашу IDE.
Базовые знания Play Framework
Обратитесь к Документации Play если вам нужно освежить свои знания.
Знание REST или GraphQL
Это поможет вам взаимодействовать с Back4App, особенно если вы решите не использовать или не сможете использовать Parse SDK напрямую.
Убедитесь, что у вас есть все эти предварительные требования перед началом. Наличие настроенного проекта Back4App и готовой среды Play Framework поможет вам легко следовать инструкциям.
Шаг 1 – Создание нового проекта на Back4App и подключение
Почему вам нужен новый проект Back4App
Новый проект Back4App является основой для вашего бэкенда, так как он управляет данными вашего приложения, аутентификацией и облачной логикой. Независимо от того, создаете ли вы небольшой прототип или крупномасштабное веб-приложение, легко подключить ваше приложение Play Framework к новому проекту Back4App.
Создание проекта Back4App
Войдите в свою учетную запись Back4App.
Нажмите “Новое приложение” в вашей панели управления Back4App.
Назовите ваше приложение, например, “Play-Framework-Backend”.
﻿
После создания ваш новый проект появится в панели управления.
Подключение к Back4App
Back4App использует Parse Server. Если ваше приложение на Play Framework планирует взаимодействовать с Back4App через Parse Java SDK, вы можете добавить его в ваш build.sbt при необходимости. В противном случае вы можете использовать REST или GraphQL конечные точки.
Получите ваши ключи Parse:
В вашей панели управления Back4App откройте Настройки приложения или Безопасность и ключи чтобы найти ваш Идентификатор приложения, Ключ REST API, Ключ JavaScript (если используете фронтенд вызовы), или Ключ клиента, плюс URL сервера (обычно https://parseapi.back4app.com).
﻿
Использование Java/Parse SDK (необязательно):
Если вы хотите прямую серверную интеграцию с использованием Parse SDK, добавьте зависимость в ваш build.sbt:
Text
libraryDependencies += "com.parse" % "parse" % "1.0.40" // Example version
libraryDependencies += "com.parse" % "parse" % "1.0.40" // Example version
﻿
Затем, в вашем коде Play Framework, вы можете инициализировать Parse:
Text
object ParseConfig {
  def init(): Unit = {
    Parse.initialize(new Parse.Configuration.Builder("YOUR_APP_ID")
      .server("https://parseapi.back4app.com")
      .clientKey("YOUR_CLIENT_KEY")
      .build()
    )
  }
}
object ParseConfig {
  def init(): Unit = {
    Parse.initialize(new Parse.Configuration.Builder("YOUR_APP_ID")
      .server("https://parseapi.back4app.com")
      .clientKey("YOUR_CLIENT_KEY")
      .build()
    )
  }
}
﻿
Вы можете разместить это в вашем Global.scala или вызвать это из подходящей точки инициализации. Это подготавливает вас к прямому взаимодействию с вашим проектом Back4App.
Если вы предпочитаете, используйте REST или GraphQL конечные точки для операций с данными, особенно если вы хотите больше контроля над вашими HTTP-запросами или если вы строите микросервисы.
Шаг 2 – Настройка базы данных
Сервис хранения данных Back4App поддерживает широкий спектр типов данных и динамическое создание схемы. Это позволяет вам хранить данные вашего приложения Play с минимальными усилиями.
Создание модели данных
Откройте раздел “База данных” в вашей панели управления Back4App.
Создайте новый класс (например, “Todo”) и добавьте столбцы (например, title как String, isCompleted как Boolean).
Сохраните для завершения вашей схемы базы данных.
Создать новый класс
﻿
Создание модели данных с помощью AI-агента
Если вы хотите быстро определить структуру данных:
Откройте AI-агента в вашей панели управления приложением.
Опишите вашу желаемую модель данных простым языком (например, “Создайте простую модель ToDo.”).
Агент автоматически генерирует схему для вас.
﻿
Чтение и запись данных с использованием Parse SDK (необязательно)
Если вы решили включить Parse Java SDK в ваше приложение Play Framework, вы можете сохранять и запрашивать данные:
Text
import com.parse.{ParseObject, ParseQuery}

object TodoService {
  def createTodo(title: String, isCompleted: Boolean): Either[Throwable, ParseObject] = {
    try {
      val todo = new ParseObject("Todo")
      todo.put("title", title)
      todo.put("isCompleted", isCompleted)
      Right(todo.save())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def fetchTodos(): Either[Throwable, java.util.List[ParseObject]] = {
    try {
      val query = ParseQuery.getQuery("Todo")
      val results = query.find()
      Right(results)
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
import com.parse.{ParseObject, ParseQuery}

object TodoService {
  def createTodo(title: String, isCompleted: Boolean): Either[Throwable, ParseObject] = {
    try {
      val todo = new ParseObject("Todo")
      todo.put("title", title)
      todo.put("isCompleted", isCompleted)
      Right(todo.save())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def fetchTodos(): Either[Throwable, java.util.List[ParseObject]] = {
    try {
      val query = ParseQuery.getQuery("Todo")
      val results = query.find()
      Right(results)
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
﻿
Чтение и запись данных с использованием REST
Вы можете отправлять HTTP-запросы из ваших контроллеров или сервисов Play Framework:
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
﻿
Чтение и запись данных с использованием GraphQL
Back4App также предоставляет 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
    }
  }
}
﻿
Это удобно, если вы создаете микросервисы или хотите гибкий API для ваших клиентских приложений.
Работа с живыми запросами
Если ваше веб-приложение требует данных в реальном времени, включите живые запросы:
Включите живые запросы в панели управления Back4App в разделе Настройки сервера.
Настройте вашу подписку в коде. Если вы используете Parse SDK или собственный код, убедитесь, что вы настроили liveQueryServerURL.
Подпишитесь на изменения для классов, таких как “Todo.”
Шаг 3 – Применение безопасности с помощью ACL и CLP
Обзор ACL и CLP
Back4App предоставляет Списки контроля доступа (ACL) для безопасности на уровне объектов и Разрешения на уровне классов (CLP) для широких ограничений. Это помогает поддерживать безопасность ваших серверных бэкендов и гарантирует, что происходят только авторизованные операции.
﻿
Разрешения на уровне классов
В разделе База данных вашей панели управления Back4App:
Выберите класс (например, “Todo”).
Откройте CLP для ограничения чтения/записи для аутентифицированных пользователей, ролей или для общественности.
Настройте по мере необходимости (например, “Требуется аутентификация” для любых записей).
ACL
ACL защищает отдельные объекты. Например, вы можете гарантировать, что только определенный пользователь может читать или записывать конкретную запись. Если вы используете Parse SDK из кода Scala:
Text
import com.parse.{ParseACL, ParseUser, ParseObject}

def createPrivateTodo(title: String, owner: ParseUser): ParseObject = {
  val todo = new ParseObject("Todo")
  todo.put("title", title)

  val acl = new ParseACL(owner)
  acl.setPublicReadAccess(false)
  acl.setPublicWriteAccess(false)

  todo.setACL(acl)
  todo.save()
  todo
}
import com.parse.{ParseACL, ParseUser, ParseObject}

def createPrivateTodo(title: String, owner: ParseUser): ParseObject = {
  val todo = new ParseObject("Todo")
  todo.put("title", title)

  val acl = new ParseACL(owner)
  acl.setPublicReadAccess(false)
  acl.setPublicWriteAccess(false)

  todo.setACL(acl)
  todo.save()
  todo
}
﻿
Шаг 4 – Написание функций облачного кода
Почему облачный код
Облачный код позволяет вам выполнять пользовательскую логику на серверах Back4App, добавляя бизнес-правила или валидации до или после транзакций данных. Вам не нужно будет заниматься настройкой собственного сервера или перезапуском в режиме разработки для реализации таких функций.
Пример функции
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 };
});
﻿
Вы можете вызвать это из вашего приложения Play через REST, GraphQL или, если используете Parse SDK, напрямую.
Развертывание
Используйте Back4App CLI или панель управления:
Установите CLI (пример для Linux/MacOS):
Настройте ключ учетной записи:
Развернуть:
Или развернуть через панель управления вставив вашу функцию в Cloud Code > Functions и нажав “Развернуть”.
Использование модулей NPM
Облачный код поддерживает модули NPM. Например, если вам нужен HTTP-клиент, такой как axios:
JS
const axios = require('axios');
Parse.Cloud.define('fetchData', async (req) => {
  const response = await axios.get(req.params.url);
  return response.data;
});
const axios = require('axios');
Parse.Cloud.define('fetchData', async (req) => {
  const response = await axios.get(req.params.url);
  return response.data;
});
﻿
Шаг 5 – Настройка аутентификации
Включение аутентификации пользователей
Back4App использует класс Parse.User для регистрации, входа и управления сессиями. В ваших настройках конфигурации, убедитесь, что включены «Включить проверку электронной почты» и «Включить сброс пароля», если это необходимо.
Пример кода (Parse SDK)
Text
import com.parse.{ParseUser}

object AuthService {
  def signUpUser(username: String, password: String, email: String): Either[Throwable, ParseUser] = {
    try {
      val user = new ParseUser()
      user.setUsername(username)
      user.setPassword(password)
      user.setEmail(email)

      Right(user.signUp())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def logInUser(username: String, password: String): Either[Throwable, ParseUser] = {
    try {
      Right(ParseUser.logIn(username, password))
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
import com.parse.{ParseUser}

object AuthService {
  def signUpUser(username: String, password: String, email: String): Either[Throwable, ParseUser] = {
    try {
      val user = new ParseUser()
      user.setUsername(username)
      user.setPassword(password)
      user.setEmail(email)

      Right(user.signUp())
    } catch {
      case e: Throwable => Left(e)
    }
  }

  def logInUser(username: String, password: String): Either[Throwable, ParseUser] = {
    try {
      Right(ParseUser.logIn(username, password))
    } catch {
      case e: Throwable => Left(e)
    }
  }
}
﻿
Социальный вход
Если вам нужны социальные входы (Google, Apple или Facebook), настройте их в вашей панели управления Back4App. Parse предоставляет утилиты или вы можете полагаться на стандартные потоки OAuth, в зависимости от ваших потребностей и подхода.
Шаг 6 – Обработка хранения файлов
Back4App хранит файлы через Parse.File. Из Play Framework вы можете загружать с помощью REST или Parse SDK.
Text
// Example with Parse SDK
import com.parse.{ParseFile, ParseObject}
import java.nio.file.{Files, Paths}

def uploadImage(filePath: String): Either[Throwable, String] = {
  try {
    val data = Files.readAllBytes(Paths.get(filePath))
    val parseFile = new ParseFile("myImage.jpg", data)
    parseFile.save()
    Right(parseFile.getUrl)
  } catch {
    case e: Throwable => Left(e)
  }
}
// Example with Parse SDK
import com.parse.{ParseFile, ParseObject}
import java.nio.file.{Files, Paths}

def uploadImage(filePath: String): Either[Throwable, String] = {
  try {
    val data = Files.readAllBytes(Paths.get(filePath))
    val parseFile = new ParseFile("myImage.jpg", data)
    parseFile.save()
    Right(parseFile.getUrl)
  } catch {
    case e: Throwable => Left(e)
  }
}
﻿
Соображения безопасности: Вы можете настроить разрешения на загрузку файлов (включить для публичных, анонимных или аутентифицированных пользователей) в настройках сервера Back4App.
Шаг 7 – Подтверждение электронной почты и сброс пароля
Перейдите в настройки электронной почты в панели управления Back4App.
Включите подтверждение электронной почты и настройте шаблоны электронной почты для сброса паролей.
В вашем приложении Play вы можете вызвать:
Bash
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 '{"email":"[email protected]"}' \
  https://parseapi.back4app.com/requestPasswordReset
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 '{"email":"user@example.com"}' \
  https://parseapi.back4app.com/requestPasswordReset
﻿
Это вызовет Back4App для отправки инструкций по сбросу пароля на электронную почту пользователя.
Шаг 8 – Планирование задач с помощью облачных заданий
Облачные задания
Если вам нужно начальное задание для фоновой работы (например, очистка данных или генерация отчетов), вы можете запланировать облачные задания на Back4App.
JS
// main.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);
  }
});
// main.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);
  }
});
﻿
Планирование:
Разверните ваш облачный код.
В Настройки приложения > Настройки сервера > Фоновые задания, запланируйте выполнение задания ежедневно, еженедельно или по мере необходимости.
Планирование облачного задания
﻿
Шаг 9 – Интеграция Webhooks
Если вы хотите уведомлять внешние сервисы всякий раз, когда данные изменяются, настройте Webhooks в Back4App.
Перейдите в Разное > WebHooks в вашей панели управления Back4App.
Добавить Webhook с конечной точкой (например, Slack или Stripe).
Выберите триггеры, такие как “Новая запись в классе Todo.”
Добавление Webhook
﻿
Вы также можете создавать Webhooks в триггерах Cloud Code, выполняя прямые HTTP-запросы к сторонним сервисам.
WebHook BeforeSave
﻿
Шаг 10 – Изучение панели администратора Back4App
Административное приложение Back4App Admin App является удобным интерфейсом для управления данными и записями. Нетехнические пользователи могут выполнять операции CRUD, не углубляясь в код.
Включение административного приложения
Перейдите в App Dashboard > More > Admin App.
Включите его и создайте администратора.
Выберите поддомен для удобного доступа.
Включите административное приложение
﻿
После входа в систему вы можете управлять записями данных, не беспокоясь о низкоуровневых панелях управления или инструментах CLI.
﻿
Заключение
Поздравляем! Вы научились создавать бэкенд для Play Framework с использованием услуг Back4App. На протяжении этого учебника вы:
Создали безопасный бэкенд для приложения Play Framework на Back4App.
Настроили базу данных, включая проектирование схемы, отношения и запросы в реальном времени.
Применили ACL и CLP для безопасного доступа к данным.
Написали Cloud Code для пользовательской логики, триггеров и внешних интеграций.
Настроили аутентификацию пользователей, социальный вход и сброс паролей.
Обработали загрузку файлов и добавили дополнительную безопасность файлов.
Запланировали фоновые задачи с помощью Cloud Jobs.
Интегрировались с сторонними сервисами через Webhooks.
Изучили панель администратора Back4App для упрощенного управления данными.
С этими инструментами вы можете оптимизировать режим разработки, масштабироваться по мере необходимости и создавать надежные веб-приложения на Play Framework. 
Используйте дальнейшие интеграции, настройку производительности и расширенные меры безопасности, чтобы вывести ваши серверные бэкенды на новый уровень.
Следующие шаги
Улучшите вашу производственную настройку с помощью кэширования, ведения журналов или инструментов мониторинга.
Изучите расширенную безопасность с контролем доступа на основе ролей или настройками нулевого доверия.
Интегрируйте платежные шлюзы или другие сторонние API для коммерции или аналитики.
Посмотрите официальную документацию Back4App для более глубокого понимания производительности и устранения неполадок.
Просмотрите больше учебников по приложениям для чата в реальном времени, IoT-решениям или услугам на основе местоположения — многие из которых основаны на методах, описанных в этом руководстве.
﻿
Обновлено 23 Jan 2025
Помогла ли вам эта страница?
Как построить бэкенд для Elixir?
Как создать бекенд для Spring Boot?