Play framework java для чайников на windows

Записки программиста

Play Framework — все, что вы хотели о нем узнать, но почему-то боялись спросить

Play Framework — это MVC веб-фреймворк для языков программирования Java и Scala от компании Typesafe. С одной стороны, Play обладает гибкостью и простотой в использовании фреймворков типа Django или Mojolicious, с другой — в нем реализованы многие идеи, например, компилируемость, а следовательно и высокая производительность, строгая статическая типизация и тд, которые мы можем наблюдать, скажем, в Yesod.

Так получилось, что в мире Scala многие вещи очень быстро меняются. Поэтому, если вы хотите получить наиболее актуальную информацию по Play Framework, вам лучше обратиться к официальной документации от Typesafe. Тем не менее, большинство общих моментов остаются неизменными. Поэтому давайте попытаемся разобраться, как вообще выглядит проект на Play Framework.

На момент написания этих строк создание нового проекта на Play происходило при помощи утилиты Typesafe Activator как-то так:

Полученная при этом структура проекта:

Тут следует обратить внимание на следующее:

• activator — скрипт для запуска, тестирования, сборки проекта;
• app/controllers/ — контроллеры, штуки, связывающие model и view;
• app/views/ — html-, rss-, xml- и прочие шаблоны;
• app/models/ — сюда обычно складывают классы для доступа к БД;
• build.sbt — тот самый build.sbt;
• conf/application.conf — настройки приложения;
• conf/routes — роуты, о них речь пойдет ниже;
• public/ — всякая статика;
• test/ — модульные и интеграционные тесты;

Для компиляции и запуска проекта говорим:

По умолчанию приложение слушает порт 9000. При изменении кода проекта перекомпиляция будет происходить автоматически.

Еще можно прогнать тесты:

А еще есть совершенно сумасшедшая штука:

… которая запускает на порту 8888 веб-интерфейс, через который можно собирать, запускать или тестировать проект, править код в редакторе с подсветкой синтаксиса и так далее. В действительности это самая настоящая IDE с веб-мордой!

Итак, допустим, мы хотим добавить в наше приложение новую страничку. Как это сделать? Для начала необходимо создать новый роут в файле conf/routes. Делается это примерно так:

Добавляем метод в соответствующем контроллере:

Помимо Ok также можно вернуть, например:

Использовать созданную заранее вьюшку тоже не обязательно:

Источник

Getting Started with Play Framework

New to Play?

» Learn whether Play Framework is right for your project

» Try the Hello World Tutorial

The Java and Scala Hello World projects are self-contained tutorials that include a distribution of the sbt build tool.

Play requires Java 8 or higher. Check your version with the java -version command and if needed, install it from Oracle’s site.

To try the tutorial, first download the Java or Scala project:

Play 2.8.x Hello World Projects

To run the tutorial:

1. Unzip the project in a convenient location.
2. In a command window, change to the top-level project directory.
3. Enter sbt run .
4. After the message Server started, . displays, enter the following URL in a browser: http://localhost:9000

The tutorial welcome page displays.

Already know a bit about Play?

Lightbend Tech Hub offers a variety of Play example projects for Java and Scala that are focused on a particular use case. The downloadable zip files include everything you need, including sbt, Play Framework, and an HTTP server. The examples also support Gradle.

If you are ready to start your own project and have sbt installed, you can create a Play project from the command line.

» Try a focused example

Follow these steps to try an example project:

1. Check that your Java version is 8 or higher with the java -version command and if needed, install it from Oracle’s site.
2. Choose an example from Lightbend’s Tech Hub.
3. Click «CREATE A PROJECT FOR ME» to download the zipped project.
4. Unzip the project in a convenient location.
5. In a command window, navigate to the top level project directory.
6. Enter one of the following commands:
   • On macOS or Linux systems: ./sbt run or ./gradlew runPlayBinary
   • On Windows systems: sbt.bat run or gradlew.bat runPlayBinary
7. The build tool downloads dependencies and compiles the project.
8. After the build finishes, enter the following URL in a browser to view the app: http://localhost:9000/

Check out the README.md file in the top level project directory to learn more about the example.

» Create a Play Java or Scala project using sbt new

In a command window, enter one of the following and respond to the prompts to create a new project:

Источник

Play Framework. Часть #1. Введение.

Сегодня мы поговорим о Play Framework

Play — это java web framework, на нем можно строить как и обычные сайты, так и rest api. Это достаточно молодой фреймворк, куда моложе чем spring. Изначально он задумывался исключительно как Java фреймворк. Но начиная с версии 2.0 он стал заточен под Scala, и Java отошла на второй план, но до сих пор поддерживается и ее поддержку отменять не собираются.

Рассмотрим возможности фреймворка

Play достаточно мощный фреймворк, проще сказать то, чего он не умеет, нежели наборот. Рассмотрим сугубо поверхностно то, что он умеет. В его арсенале находятся самые свежие технологии, такие как

• WebSocket
• Асинхронное выполнение
• Тестирование
• Работа с базами данных
• Процессинг JSON
• Процессинг XML
• Сессии/Куки
• Потоковые Response
• Гибкий роутинг
• Композиция экшенов
• Фильтры
• Модули
• Встроенный шаблонизатор
• Формы
• ORM
• Кэширование
• Встроенный OAuth2 клиент
• Интеграция с Akka
• IoC, в Play это Google Guice
• Логгеры
• Конфигурация в стиле Hocon

И это еще не полный список. Полный можно посмотреть на официальном сайте. Но на самом деле, что может немного обидеть нас, Джавистов. Это то, что поддержка Java — это второстепенное дело для них, версия фреймворка для Scala имеет больше возможностей. И по факту для нас написали просто Java оболочку которая оборачивает Scala версию фреймворка.

Три. Два. Один. Пуск!

В этой статье мы рассмотрим первоначальный запуск фреймворка. Для того чтобы запустить фреймворк, нам нужно скачать activator. Для этого переходим по этой ссылке и жмем на ссылку «Offline Distribution», да, активатор весит дофига :).

После того как скачается активатор Вам нужно будет добавить его bin папку в переменную PATH. После того как вы это сделали, уже спокойно можно создавать проект. Для этого в терминале введите следующую команду.

введите имя проекта. Давайте создадим проект example. Для этого введите следующую команду.

Вы увидите следующее окно.

Здесь play нам предлагает выбрать шаблон с которым мы будем создавать проект. Нам как джавистам должно быть интересно только три шаблона.

Рассмотрим каждый по чуть-чуть.

minimal-akka-java-seed — Это минимальный набор с которым можно начать разрабатывать свое приложение. Оно не включает демонстрации и документацию.

minimal-java — Это тоже самое что и предыдущий пример, но насколько мне известно (это не точная информация) отличие в том, что в minimal-java нет интеграции с akka. Но это может быть не точная информация. Документация как-то не особо освещает этот момент.

play-java — Это самый частоиспользуемый шаблон, с него мы и начнем. Этот шаблон включает в себя документацию и примеры кода.

Продолжим. В предложенном нам выборе мы выбираем 5-ый шаблон. Просто вводим цифру «5» и продолжаем (жмем enter).

В первый раз инициализация займет некоторое время, потому что activator будет качать некоторый список библиотек, при следующих созданиях проектов этого происходить не будет. После того как проект создастся надо перейти в его директорию и запустить его. Активатор создает папку проекта в той директории из который вызывалась команда activator new. Соответственно для проекта example у нас создалась папка example. Выполните следующие комманды для запуска проекта

Первая команда наверное для многих известна — это переход в папку example из текущей директории. Вторая команда запускает проект. Что команда запуска проекта сработала, нужно обязательно перейти в папку с самим проектом.

После того как вы увидели в консоле следующий вывод:

Это означает что проект был успешно запущен и можно перейти на домашнюю страницу. Для этого в браузере перейдите по адресу http://127.0.0.1:9000/. При первом переходе вы увидите задержку, в это время play компилирует проект. Так же, обратите внимание на то, что при изменении файлов проекта не нужно будет перезапускать проект, watcher активатора будет автоматически перекомпилировать проект. После перехода по ссылке вы увидите следующую страницу.

Это локальная документация которую вы сможете читать без доступа к интернету. Play имеет несколько встроенных примеров кода и enpoint’ов. Советую посмотреть их.

• /count — это простой счетчик
• /message — а это асинхронный экшен.

В следующих статьях мы рассмотрим структуру проекта, каталогов и обсудим исходный код.

На этом все, спасибо! Задавайте вопросы в комментариях.

Источник