Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/j5ik2o/reactive-aws-clients
AWS Client libraries for Scala (Automatic generation from AWS source code)
https://github.com/j5ik2o/reactive-aws-clients
aws aws-clients aws-sdk aws-sdk-java-v2 scala
Last synced: 23 days ago
JSON representation
AWS Client libraries for Scala (Automatic generation from AWS source code)
- Host: GitHub
- URL: https://github.com/j5ik2o/reactive-aws-clients
- Owner: j5ik2o
- License: mit
- Created: 2019-03-03T23:26:08.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T11:52:47.000Z (11 months ago)
- Last Synced: 2024-10-01T15:59:36.027Z (about 1 month ago)
- Topics: aws, aws-clients, aws-sdk, aws-sdk-java-v2, scala
- Language: Scala
- Homepage:
- Size: 8.68 MB
- Stars: 29
- Watchers: 3
- Forks: 10
- Open Issues: 24
-
Metadata Files:
- Readme: README.ja.md
- License: LICENSE
Awesome Lists containing this project
README
# reactive-aws-clients
ScalaのためのAWSクライアントライブラリ。
[](https://circleci.com/gh/j5ik2o/reactive-aws-clients/tree/master)
[](https://maven-badges.herokuapp.com/maven-central/com.github.j5ik2o/reactive-aws-common-core_2.12)
[](http://javadoc-badge.appspot.com/com.github.j5ik2o/reactive-aws-common-core_2.12/com/github/j5ik2o/reactive-aws-clients/index.html?javadocio=true)
[](LICENSE)
## 特徴
- AWS SDK for Java V2 対応
- AWS ClientのソースコードからScalaラッパーを自動生成
- Java SDKで使えるメソッドはすべて使うことができます(ただし、Consumer型の引数を使うメソッドは使えません)
- Javaモデルクラスのエンリッチ
- モデルクラスなどはJavaの既存の型を利用します。これらのモデルクラスをエンリッチすることでScala用メソッド(`AsScala`サフィックス)を追加できます
- Scalaの非同期型に対応
- core
- `scala.concurrent.Future`
- monix
- `monix.eval.Task`
- `monix.reactive.Observable`
- cats-effect
- `cats.effect.IO`
- akka-stream
- `akka.stream.scaladsl.Source`
- `akka.stream.scaladsl.Flow`
## 動作環境
- Java SE 8
- Scala
- 2.11.x
- 2.12.x
- 2.13.x
## インストール
`build.sbt`に依存関係を追加してください。
```scala
val libraryName = "..." // e.g.) dynamodb
val version = "1.1.5"
libraryDependencies += Seq(
"com.github.j5ik2o" %% s"reactive-aws-$libraryName-core" % version,
"com.github.j5ik2o" %% s"reactive-aws-$libraryName-monix" % version, // optional
"com.github.j5ik2o" %% s"reactive-aws-$libraryName-akka" % version, // optional
"com.github.j5ik2o" %% s"reactive-aws-$libraryName-cats" % version, // optional
)
```
## 使い方
以下はdynamodbの例です。他のライブラリを使う場合もほとんど同じです。
```scala
import com.github.j5ik2o.reactive.aws.dynamodb._
import com.github.j5ik2o.reactive.aws.dynamodb.implicits._ // エンリッチのためのインポート
import software.amazon.awssdk.services.dynamodb.model._
import software.amazon.awssdk.services.dynamodb.{ DynamoDbAsyncClient => JavaDynamoDbAsyncClient }
val underlying = JavaDynamoDbAsyncClient
.builder()
// ...
.build()
val client = DynamoDbAsyncClient(underlying) // Javaクライントのインスタンスをコンストラクタに渡す
val putItemRequest = PutItemRequest // Javaの型をそのまま利用可能
.builder()
.tableName(tableName)
.itemAsScala(
Map[String, AttributeValue](
"Id" -> AttributeValue.builder().s("abc").build(),
"Name" -> AttributeValue.builder().s("xyz").build()
)
) // エンリッチされたScala用メソッドが使える
.build()
val putItemResponseFuture = client.putItem(putItemRequest)
```
## ビルド方法
以下のコマンドを実行してください(mvnInstall の実行にはMavenが必要です)
```sh
$ sbt mvnClean mvnInstall // 初回のみ
$ sbt compile
```