Разработка веб-приложений на Scala: пишем приложение с Unfiltered

[1i7]

Среду разработки Netbeans для работы со Scala настроили, пишем и запускаем веб-приложение с фреймворком Unfiltered.


Веб-приложение на Scala с Unfiltered

Весь код нашего простого, но функционального веб-приложения находится в одном файле.

Начало традиционное - пэкэдж, импорты используемых классов, главный класс для текущего файла (object в Scala реализует паттерн "Класс-одиночка", который в Яве принято делать из обычного класса вручную).

ScalaUnfilteredBasicDemo/src/main/scala/edu/nntu/scalaunfiltereddemo/UnfilteredBasicDemo.scala

package edu.nntu.scalaunfiltereddemo

import unfiltered.request.Path
import unfiltered.request.Seg
import unfiltered.response.Ok
import unfiltered.response.ContentType
import unfiltered.response.CssContent
import unfiltered.response.HtmlContent
import unfiltered.response.PlainTextContent
import unfiltered.response.ResponseBytes
import unfiltered.response.ResponseString
import unfiltered.response.Html

/**
* Базовый пример Http-сервера с Unfiltered
* http://unfiltered.databinder.net/Try+Unfiltered.html
*
* с нормально поддержкой UTF-8 в строке запроса и в теле ответа.
*
*/
object UnfilteredBasicDemo {

Определим вспомогательный класс для нормальной работы с юникодными символами в адресной строке (да, в 2014 году для этого всё еще приходится использовать специальные костыли, и это касается не только Unfiltered или Scala, послезавтра в 2015 скорее всего тоже ничего не изменится). Заметим, как начинают появляться маленькие фишечки Скалы: импорты можно помещать не только в начале класса, но и внутри вообще любого блока.

/**
* Перекодировщик URL для нормальной работы с UTF-8
* Отсюда: http://stackoverflow.com/questions/18083311/url-decoding-with-unfiltered
*/
object Decode {
import java.net.URLDecoder
import java.nio.charset.Charset

trait Extract {
def charset: Charset
def unapply(raw: String) =
scala.util.Try(URLDecoder.decode(raw, charset.name())).toOption
}

object utf8 extends Extract {
val charset = Charset.forName("utf8")
}
}

Главная часть веб-приложения с фреймфорком Unfiltered - фильтр, работающий с сегментами строки URL, которую ввели адресную строку браузера или отправили программно через JavaScript при доступе к веб-приложению. Для разных сегментов веб-приложение возвращает разный результат (простой текст, HTML-страницу, CSS-файл, двоичный контент или что-то еще), собственном в этом и заключается вся его работа: пришел запрос - отправили ответ.

Каждый блок case соответствует одному или нескольким (для регулярных выражений) сегментам URL. В этом примере рассмотрены сегменты (это и есть структура веб-приложения):
- Nil: для корневого сегмента "/" (показываем простой текст с приветствием и инструкциями).
- /plain_text: пример простого текста
- /inline_html: пример кода HTML, встроенного прямо в код Scala
- /static_html: пример статического файла HTML, заргужаемого из ресурсов внутри jar-файла
- /site.css: файл CSS, загружается из ресурсов внутри jar-файла
- /lasto4ka.png и /buggy.png: картинки PNG, загружаются из ресурсов внутри jar-файла

последний блок case принимает любой сегмент и просто возвращает его обратно.

Очевидно, что для разных веб-приложений можно будет произвольно убирать и добавлять новые блоки.

Замечание 1: Подобные HTTP-серверы обычно используют для того, чтобы возвращать обычный текст (или текст в формате JSON) для обслуживая запросов JavaScript/Ajax, но, как видим, для раздачи любого другого веб-контента он вполне подходит, поэтому мы сможем сделать на нем полноценное веб-приложение целиком.

Замечание 2: Читать картинки по байтам из ресурсов архива jar - не самый лучший способ работы с графикой в веб-приложении, в первую очередь из-за производительности. Поэтому для работы с картинками в реальной инсталляции приложения, которая будет подразумевать хоть какую-то нагрузку, стоит использовать более подходящий для этого способ (работа с внешними ресурсами в Jetty или Netty, использовать внешний http-сервер для статического контента или что-то еще). Но мне нравится иметь теоретическую и практическую возможность хранить любые типы ресурсов в одном jar-файле, для персональных экспериментов производительности будет более чем достаточно.

// Для контейнера веб-приложений jetty
val handlePath = unfiltered.filter.Planify {
// Для контейнера веб-приложений netty
// val handlePath = unfiltered.netty.cycle.Planify {

// список определений доступных XXXContent:
// https://github.com/unfiltered/unfiltered/blob/master/library/src/main/scala/response/types.scala

// начальная страница (корень сайта)
case Path(Seg(Nil)) =>
Ok ~> PlainTextContent ~> ResponseString("Демонстрация работы фреймворка "
+ "Unfiltered для языка Scala, попробуйте сегменты в строке адреса: "
+ "plain_text, inline_html, static_html, site.css, lasto4ka.png, buggy.png")

// простой текст
case Path(Seg("plain_text" :: Nil)) =>
// PlainTextContent добавит заголовок Content-Type с UTF-8:
Ok ~> PlainTextContent ~> ResponseString("Это простой текст от сервера")
// Можно и так, но тогда браузер не распознает UTF-8 строки:
// Ok ~> ResponseString("Это простой текст от сервера" )

// демо html-страницы, встроенной в код scala
case Path(Seg("inline_html" :: Nil)) =>
Ok ~> HtmlContent ~> Html(