Ratpack — талантливо перепето

от автора

Исторически сложилось, что Groovy берет много хорошего у Ruby. В первую очередь, конечно Grails (от Rails), но и Spock (от Spec) и даже где-то Gradle (от Buildr, хотя никто не признается). Сегодня я вам расскажу про еще одну толковую «спертую» штуку — web framework Ratpack.

Списан Ratpack с Sinatra, о котором много написано на Хабре, например вот тут.
На мой взгляд, главное преимущество Синатры — что он талантливый певец что это простейший в использовании и моментальный в разработке фреймворк. Создать несколько простых страниц, менять их и видеть результаты налету, и за несколько часов сваять достаточно нетривиальный сайт с динамическим контентом — это как раз то, для чего и был придуман Синатра. Это, своего рода, ответ «ожиревшим» Рельсам. Точно в такой же роли (ответа «ожиревшим» Грейлзам) Синатра и перекочевал в Груви.

Должен заметить, что на сей раз сообщество Груви были не первыми, кто передрал Синатру. Первыми были Scala, со своей Скалатрой (ага, ответ на «ожиревший» Play). Насколько я знаю, решение не делать название похожим на слух, а искать ассоциацию по смыслу, было принято в первую очередь, придя в ужас от звучания названия версии Скалы 🙂

Ratpack переводится на русский как Крысиная стая, и привязка к Синатре в том, что это тусовка, в которой тусовался Франк Синатра.

А причем тут Java?

Ну, тут, мне кажется, все ясно. В отличие от Руби, где когда-то был lightweight RoR, или от Груви с его Грейлз, в Джаве никогда не было «легковесных» фреймворков. У нас есть либо громоздкие server-side component фреймворки типа JSF и Wicket, либо MVC фреймворки, которые, конечно, легче компонентных монстров, но все равно, требуют нагородить MVC для простейшей странички. Тут, конечно, я говорю о Spring MVC и Struts2. И всё это с жутко медленным циклом разработки «поменял слово? перезагрузи!». Бррр.

Как всегда, преимущество Груви для програмистов Джава — что они чувствуют себя как дома. 99% Java кода работает в Грувях без изменений, поэтому любой Груви фреймворк или инструмент может быть немедленно использован Java программистом.
Ситуация и с ratpack еще лучше — разработчики специально постарались, чтобы можно было писать на чистой Джаве, не задействуя Груви ни на одном этапе разработки. Один из примеров в этой статье будет написан 100% на Java. Кого не интерсует всё это Грувийное шаманство, перекручивает прямо на последний пример. Остальные начинают здесь:

Hello, World!

Ну, я думаю, начать надо с Hello, World!, правда? Полноценное веб-приложение на ratpack выглядит так:

@GrabResolver('http://oss.jfrog.org/artifactory/libs-snapshot') //(1) @Grab('org.ratpack-framework:ratpack-groovy:0.9.0-SNAPSHOT') import static org.ratpackframework.groovy.RatpackScript.ratpack  ratpack { //(2)     handlers {         get {             response.send 'Hello, world!' //(3)         }     } }

Всё. Честно. Пишем это в файл (например ratpack.groovy), запускаем через groovy ratpack.groovy:
INFO: Ratpack started for http://localhost:5050
Послушно идем на http://localhost:5050 и обнаруживаем там ожидаемое:

Давайте посмотрим, что же мы написали:

  1. Это инструкция скачать все необходимые библиотеки с бесплатного opensource аккаунта Artifactory
  2. Это объявление приложения, оно состоит из обработчиков и модулей
  3. Это обработчик команды get. Поскольку у него нет параметров, он отработает по вызову root url. Тут-то мы и просим вернуть Hello World.

Добавляем еще один handler

Вписываем в наш ratpack.groovy еще один обработчик:

ratpack {     handlers {         get {             response.send 'Hello, world!'         }         get('habr'){             response.send 'Hello, habr!' //наш новый обработчик         }     } } 

Файл сохраняем, в браузере идем на http://localhost:5050/habr, наслаждаемся.

Перезагружать? Нееее, это не для нас. Кто молодец? Spring-loaded молодец.

Добавим динамизьму

Прибавим скорости и интересу. Код:

ratpack {     handlers {         get('hello/:username') {             response.send "Hello, ${pathTokens.username}"         }     } }

Результат:

Ну, или так. Код:

ratpack {     handlers {         get('hello') {             response.send "Hello, ${request.queryParams.username}"         }     } } 

Результат:

Подключаем шаблоны

Можно упомянуть еще о многих интересных фичах, но статья уже и так не короткая, а я еще будет пример на чистой Джаве, поэтому давайте посмотрим на работу с шаблонами. Для примера возьмем Groovy template:
Шаблоны лежат в директории templates. Сохраним там, например, index.html со следующим содержанием:

<html> <head>     <title>${model.title}</title> </head> <body>     <h5>${model.content}</h5>     <br/>     <img src="http://habr.habrastorage.org/post_images/9a5/14b/49a/9a514b49a2017e50f386f154c8cb0da2.png"/> </body> </html> 

Скрипт с обработчиком теперь выглядит так:

@GrabResolver('http://oss.jfrog.org/artifactory/libs-snapshot') @Grab('org.ratpack-framework:ratpack-groovy:0.9.0-SNAPSHOT') import static org.ratpackframework.groovy.RatpackScript.ratpack import static org.ratpackframework.groovy.Template.groovyTemplate  ratpack {     handlers {         get {             render groovyTemplate("index.html", title: 'Привет Хабру от Ratpack', content: 'Тут логотипы:')         }     } } 

Обратите внимание на новый static import.
Результат ожидаем:

Кто ждал Джавы? Их есть у нас!

Ну, тут не будет запускаемого скрипта, и не ждите. Тут будет серьезное приложение, со структурой директорий, модулями, с файлом сборки.
Dependency injection будет на Guice, веб-сервер на netty, сборка и запуск на gradle, перезагрузка с помощю Spring-loaded.
Поехали:
Структура проекта:

Файл ratpack.properties говорит кто есть HandlerFactory (откуда брать обработчиков):

handlerFactory=example.HandlerFactory 

Класс example.HandlerFactory является, натурально factory для обработчиков. У нас там только один, Hello, %username%:

package example;  import ...  public class HandlerFactory implements org.ratpackframework.launch.HandlerFactory {      public Handler create(LaunchConfig launchConfig) {         return chain(new Action<Chain>() {             public void execute(Chain chain) {                 chain.add(get("hello/:username", new Handler() {                     public void handle(Context context) {                         Map<String, String> pathTokens = context.getPathTokens();                         context.getResponse().send("Hello from Java, " + pathTokens.get("username"));                     }                 }));             }         });     } } 

Да, Java 8 не помешал бы.
Тут все похоже на Грувийную версию — добавляем обработчик на путь hello/:username, потом берем значение динамической части пути из context.getPathTokens().

Запускаем task-ом run, перекомпилируем изменения task-ом classes (в другом окне, run останавливать не надо):

Результат:

Честно говоря, Java пример получился не очень привлекательным. Нагородили классов и директорий, когда это все можно написать в 4 строчках Груви. Так зачем?
Преимущества Джавы начинаются при росте в сложности и размере. Внезапно, разделение на классы и пакеты, жесткое типизирование и возможность тестов становятся намного важнее количества файлов и строк. Чтобы увидеть эти приемущества, посмотрите на более полный пример Java приложения на Ratpack вот тут. Я уверен, вы поймете о каких преимуществах я говорю.

Заключение

Естественно, это самые основы, естественно, в Ratpack есть намного больше плюшек, чем я сейчас показал. Это и модули Guice-а, и сервисы, и интеграция с MongoDB и с GORM-ом.

Использование Java классов для обработчиков, модулей и сервисов дает возможность создавать модулярное и легко тестируемое приложение средней сложности.
Использование Groovy скриптов дает возможность гораздо более быстрой разработки чего-либо простого, «на коленке», с впечатляющими результатами.

Я надеюсь, что сумел заинтересовать вас этим фреймворком. Как вы могли заметить, даже первая версия еще пока не вышла (хотя уже скоро), поэтому я бы не стал переписывать на него mission-critical приложения, но он достоин того, что обратить на него внимание, и попробовать наваять на нем вашу следующую «жуткую домашнюю страничку»

P.S.

Если вы хотите продолжения, пишите в комменты.
Если вы хотите пообщаться на счет Ratpack-а лично, а так-же послушать про другие интересные штуки, приходите на JUG 31-го августа.

ссылка на оригинал статьи http://habrahabr.ru/post/190452/


Комментарии

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *