Проста та стисла бібліотека клієнта HTTP для Scala

Мені потрібна зріла бібліотека клієнта HTTP, яка є ідіоматичною для масштабування, стислою у використанні, простою семантикою. Я розглянув Apache HTTP та Scala Dispatch та численні нові бібліотеки, які обіцяють ідіоматичне обгортання Scala. Клієнт Apache HTTP, безсумнівно, вимагає багатослів'я, тоді як Dispatch легко заплутав.

Що є підходящим HTTP-клієнтом для використання Scala?

Нещодавно я почав використовувати Dispatch , трохи загадковий (чудове загальне вступне слово, серйозна відсутність детальних документів на основі сценаріїв / випадків використання). Dispatch 0.9.1 - це обгортка Scala навколо Async Http-клієнта Ning ; щоб повністю зрозуміти, що відбувається, потрібно познайомитись із цією бібліотекою. На практиці єдине, на що мені справді довелося подивитися, це RequestBuilder - все інше добре впадає в моє розуміння HTTP.

Я даю випуску 0.9 тверді пальці вгору (поки що!) Про те, щоб зробити роботу дуже просто .. як тільки ви пройдете цю початкову криву навчання.

"Конструктор" Http диспетчера є незмінним і, здається, добре працює в потоковому середовищі. Хоча я не можу знайти нічого в документах, щоб стверджувати, що він безпечний для потоків; загальне прочитання джерела свідчить про те, що воно є.

Слід пам’ятати, що RequestBuilder можна змінювати , і тому НЕ є потокобезпечним.

Ось кілька додаткових посилань, які я знайшов корисними:

• Я не можу знайти посилання ScalaDoc для випуску 0.9. *, Тому я переглядаю вихідний код для випуску 0.9. * ;

• ScalaDoc для версії 0.8 ; істотно інша тварина (сьогодні) , ніж 0,9.

• "Періодична" таблиця операторів, також пов'язана 0,8.

• Старіші 0,8 "класично-диспетчерські" документи допомогли мені зрозуміти, як вони використовували конструктори URL-адрес, і дали деякі підказки про те, як речі пов'язані між собою, що перенесли на 0,9.

Я зробив порівняння більшості основних доступних бібліотек HTTP-клієнтів

Dispatch та деякі інші бібліотеки більше не підтримуються . На сьогодні єдиними серйозними є спрей-клієнт та Play! Зн .

spray-client - трохи загадковий у своєму синтаксисі. play-ws досить простий у використанні:

(build.sbt)

libraryDependencies += "com.typesafe.play" %% "play-ws" % "2.4.3"

(основне використання)

val wsClient = NingWSClient()
wsClient
  .url("http://wwww.something.com")
  .get()
  .map { wsResponse =>
    // read the response
}

Трохи запізнився на вечірку тут, але мене вразив спрей-клієнт .

Він має приємний DSL для побудови запитів, підтримує як синхронізацію, так і виконання асинхронізації, а також різноманітні типи (не) маршалінгу (JSON, XML, форми). Це дуже добре грає і з Аккою .

Через два шість років після первинної відповіді на цю публікацію я мав би іншу відповідь.

Я використовую akka-http , співпрацю між бригадами спрею та akka. Він підтримується Lightbend, щільно узгоджується з асинхронним середовищем akka ... це правильний інструмент для цієї роботи.

sttp - це бібліотека Scala HTTP, яку ми всі так довго чекали!

Він має вільний DSL для формування та виконання запитів (зразки коду з їх README):

val request = sttp
  .cookie("session", "*!@#!@!$")
  .body(file) // of type java.io.File
  .put(uri"http://httpbin.org/put")
  .auth.basic("me", "1234")
  .header("Custom-Header", "Custom-Value")
  .response(asByteArray)

Він підтримує синхронні, асинхронні та потокові дзвінки через підключаються бекенди, включаючи Akka-HTTP (раніше Spray) та поважний AsyncHttpClient (Netty):

implicit val sttpHandler = AsyncHttpClientFutureHandler()
val futureFirstResponse: Future[Response[String]] = request.send()

Він підтримує scala.concurrent.Future, scalaz.concurrent.Task, monix.eval.Task, і cats.effect.IO- все основні Scala IO монади бібліотеки.

Плюс у нього є кілька додаткових хитрощів:

• Він має представлення класів case як для запитів, так і для відповідей (хоча це не заходить так далеко, як наявність, наприклад, сильно набраних заголовків): https://github.com/softwaremill/sttp/blob/master/core/src/main/scala /com/softwaremill/sttp/RequestT.scala https://github.com/softwaremill/sttp/blob/master/core/src/main/scala/com/softwaremill/sttp/Response.scala

• Він забезпечує інтерполятор рядків URI :

val test = "chrabąszcz majowy" val testUri: Uri = uri"http://httpbin.org/get?bug=$test"

• Він підтримує кодери / декодери для тіл запитів / відповідей, наприклад, JSON через Circe:

import com.softwaremill.sttp.circe._ val response: Either[io.circe.Error, Response] = sttp .post(uri"...") .body(requestPayload) .response(asJson[Response]) .send()

Нарешті, це підтримується надійними людьми з softwaremill, і у нього є чудова документація .

Отримавши кілька нещасних випадків із клієнтом Apache, я взявся за написання власного. Вбудований HttpURLConnection широко затверджується як глючний. Але це не мій досвід цього. Насправді все було навпаки, клієнт Apache мав дещо проблематичну модель різьблення. Починаючи з Java6 (або 5?), HttpURLConnection забезпечував ефективні з'єднання HTTP1.1 з такими важливими речами, як вбудована підтримка "живого", і він без зайвих зусиль обробляє одночасне використання.

Отже, щоб компенсувати незручний API, запропонований HttpURLConnection, я взявся написати новий API у Scala як проект з відкритим кодом. Це просто обгортка для HttpURLConnection, але на відміну від HttpURLConnection, вона прагне бути простою у використанні. На відміну від клієнта Apache, він повинен легко вписуватися в існуючий проект. На відміну від Dispatch, це повинно бути легким для вивчення.

Це називається Bee Client

• Веб-сайт: http://www.bigbeeconsultants.co.uk/bee-client
• Документи API: http://www.bigbeeconsultants.co.uk/docs/bee-client/latest.html

Прошу вибачення за безсоромну пробку. :)

Окрім відправки, там не так багато чого. scalaz намагався створити функціональний клієнт http. Але він застарілий на деякий час, жодна його версія не існує у гілці scalaz7. Крім того, у плейфрейме є корисна обгортка ning async-http-client. Там ви можете телефонувати:

WS.url("http://example.com/feed").get()
WS.url("http://example.com/item").post("content")

Ви можете використовувати цей API як натхнення, якщо не використовуєте програвання! у вашому проекті та не подобається Dispatch API.

Спрей

Ви дійсно повинні розглянути можливість використання спрею . На мій погляд, у нього трохи хитрий синтаксис, але він все ще досить корисний, якщо ви прагнете створити високопродуктивний http-клієнт. Головною перевагою використання Spray є те, що він базується на бібліотеці акторів akka , яка надзвичайно масштабована та потужна. Ви можете масштабувати свій клієнт http на кілька машин, лише змінюючи confфайли.

Більше того, кілька місяців тому Spray приєднуйтесь до Typesafe, і, наскільки я розумію, він стане частиною базового розповсюдження akka. доказ

Грати2

Іншим варіантом є використання бібліотеки Play2 WS ( doc ). Наскільки мені відомо, він все ще не відокремлений від дистрибутива Play, але завдяки надзвичайній простоті варто витратити трохи часу, прикріплюючи весь фреймворк Play, щоб отримати цю частину. Є деякі проблеми із забезпеченням конфігурації, тому це не підходить для випадків відмови та використання. Однак ми використовували його в кількох проектах, не заснованих на Play, і все було добре.

ScalaJ-Http - це дуже простий синхронний http-клієнт

https://github.com/scalaj/scalaj-http

Я б порекомендував це, якщо вам потрібен клієнт Scala без урочистих церемоній.

Здивований, що тут ніхто не згадував фіналу. Це дуже просто у використанні:

import com.twitter.finagle.{Http, Service}
import com.twitter.finagle.http
import com.twitter.util.{Await, Future}

object Client extends App {
  val client: Service[http.Request, http.Response] = Http.newService("www.scala-lang.org:80")
  val request = http.Request(http.Method.Get, "/")
  request.host = "www.scala-lang.org"
  val response: Future[http.Response] = client(request)
  Await.result(response.onSuccess { rep: http.Response =>
    println("GET success: " + rep)
  })
}

Докладніше див. У посібнику з швидкого запуску: https://twitter.github.io/finagle/guide/Quickstart.html

Я використовував програму Dispatch, Spray Client та бібліотеку клієнтів Play WS ... Жоден з них не був просто використаний або налаштований. Тож я створив простішу бібліотеку HTTP-клієнта, яка дозволяє виконувати всі класичні HTTP-запити в простих однокласниках.

Дивіться приклад:

import cirrus.clients.BasicHTTP.GET

import scala.concurrent.Await
import scala.concurrent.duration._

object MinimalExample extends App {

  val html = Await.result(Cirrus(GET("https://www.google.co.uk")), 3 seconds)

  println(html)
}

... виробляє ...

<!doctype html><html itemscope="" itemtype="http://schema.org/WebPage" lang="en-GB">...</html>

Бібліотека називається Cirrus і доступна через Maven Central

libraryDependencies += "com.github.godis" % "cirrus_2.11" % "1.4.1"

Документація доступна на GitHub

https://github.com/Godis/Cirrus