Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ollls/zio-quartz-h2
ZIO2 native, asynchronous Java NIO based implementation of http/2 packet streaming server with TLS encryption implemented as scala ZIO2 effect. Direct native translation of ZIO ZStream chunks into http2 packets (inbound and outbound).
https://github.com/ollls/zio-quartz-h2
http http-server http2 http2-server httpclient scala zio zio-http zio-streams zio2
Last synced: about 9 hours ago
JSON representation
ZIO2 native, asynchronous Java NIO based implementation of http/2 packet streaming server with TLS encryption implemented as scala ZIO2 effect. Direct native translation of ZIO ZStream chunks into http2 packets (inbound and outbound).
- Host: GitHub
- URL: https://github.com/ollls/zio-quartz-h2
- Owner: ollls
- License: mit
- Created: 2022-12-24T22:39:45.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-07-09T03:26:13.000Z (4 months ago)
- Last Synced: 2024-07-09T06:34:07.992Z (4 months ago)
- Topics: http, http-server, http2, http2-server, httpclient, scala, zio, zio-http, zio-streams, zio2
- Language: Scala
- Homepage:
- Size: 7.2 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://repo1.maven.org/maven2/io/github/ollls/zio-quartz-h2_3/0.5.7)
[](https://sonarcloud.io/summary/new_code?id=ollls_zio-quartz-h2)
# Asynchronous Java NIO **http/2 TLS** packet streaming server/client.
It's now with HTTP/1.1
ZIO2 native,asynchronous,Java NIO based implementation of http/2 packet streaming server with TLS encryption implemented as scala ZIO2 effect with ALPN h2 tag. Direct native translation of ZIO ZStream chunks into http2 packets (inbound and outbound). Tested and optimized to produce highest possible TPS. Server supports http multipart with ZStream interface along with automatic file saving for file based multipart uploads.
```
libraryDependencies += "io.github.ollls" %% "zio-quartz-h2" % "0.5.5"
```
to run example from zio-quartz-h2 code base directly
```
sbt IO/run
```
### Logging.
Use .../src/main/resources/logback-test.xml to tailor to your specific requirements.
Also you may use options to control logging level.
```
sbt "run --debug"
sbt "run --error"
sbt "run --off"
```
### 0.5.4 template example: client/server (quartz-h2 HTTP/2 client only supports TLS with ALPN H2 HTTP/2 hosts)
https://github.com/ollls/zio-quartz-demo
* Template project with use cases, `sbt run`:
https://github.com/ollls/zio-qh2-examples
* Use cases:
https://github.com/ollls/zio-quartz-h2/blob/master/examples/IO/src/main/scala/Run.scala, to run: `sbt IO/run`
* To debug: switch to "debug" or 'trace" in logback-test.xml, **use "off" or "error" for performace tests with wrk and h2load**.
* You may look at the quartz-h2 CATS port https://github.com/ollls/quartz-h2
### Standard support for ZIO Environment.
```scala
def run =
val env = ZLayer.fromZIO( ZIO.succeed( "Hello ZIO World!") )
(for {
ctx <- QuartzH2Server.buildSSLContext("TLS", "keystore.jks", "password")
exitCode <- new QuartzH2Server("localhost", 8443, 16000, ctx).startIO(R, filter, sync = false)
} yield (exitCode)).provideSomeLayer( env )
```
### Webfilter support with Either[Response, Request]. Provide filter as a parameter QuartzH2Server()
```scala
val filter: WebFilter = (request: Request) =>
ZIO.attempt(
Either.cond(
!request.uri.getPath().startsWith("/private"),
request.hdr("test_tid" -> "ABC123Z9292827"),
Response.Error(StatusCode.Forbidden).asText("Denied: " + request.uri.getPath())
)
)
```
```scala
exitCode <- new QuartzH2Server("localhost", 8443, 16000, ctx).startIO(R, filter, sync = false)
```
### File retrieval.
```scala
case GET -> Root / StringVar(file) =>
val FOLDER_PATH = "/Users/user000/web_root/"
val FILE = s"$file"
val BLOCK_SIZE = 16000
for {
jpath <- ZIO.attempt(new java.io.File(FOLDER_PATH + FILE))
present <- ZIO.attempt(jpath.exists())
_ <- ZIO.fail(new java.io.FileNotFoundException).when(present == false)
} yield (Response
.Ok()
.asStream(ZStream.fromFile( jpath, BLOCK_SIZE ))
.contentType(ContentType.contentTypeFromFileName(FILE)))
```
### File upload ( smart http2 flow control implemented if disk saving speed cannot keep up with inbound network data.)
```scala
case req @ POST -> Root / "upload" / StringVar(file) =>
val FOLDER_PATH = "/Users/user000/web_root/"
val FILE = s"$file"
for {
jpath <- ZIO.attempt(new java.io.File(FOLDER_PATH + FILE))
u <- req.stream.run(ZSink.fromFile(jpath))
} yield (Response.Ok().asText("OK"))
```
### HTTP Multipart file upload.
```scala
case req @ POST -> Root / "mpart" =>
MultiPart.writeAll(req, "/Users/user000/tmp1/" ) *> ZIO.succeed(Response.Ok())
```
### How to send data in separate H2 packets of various size
```scala
case GET -> Root / "example" =>
val ts = ZStream.fromChunks(Chunk.fromArray("Block1\n".getBytes()), Chunk.fromArray("Block22\n".getBytes()))
ZIO.attempt(Response.Ok().asStream(ts))
````
### How to run h2spec.
1. Start server with "sbt IO/run"
2. ./h2spec http2 -h localhost -p 8443 -t -k
You should get:
```
Finished in 2.1959 seconds
94 tests, 94 passed, 0 skipped, 0 failed
```
### Performance test with h2load.
```
h2load -D10 -c68 -m30 -t2 https://localhost:8443/test
...
finished in 10.01s, 65292.20 req/s, 637.89KB/s
requests: 652922 total, 654452 started, 652922 done, 652922 succeeded, 0 failed, 0 errored, 0 timeout
status codes: 652922 2xx, 0 3xx, 0 4xx, 0 5xx
traffic: 6.23MB (6531974) total, 637.62KB (652922) headers (space savings 90.00%), 0B (0) data
min max mean sd +/- sd
time for request: 231us 144.82ms 19.31ms 10.02ms 73.06%
time for connect: 7.39ms 860.22ms 385.69ms 278.36ms 54.90%
time to 1st byte: 9.10ms 875.77ms 398.01ms 282.96ms 54.90%
req/s : 0.00 1489.99 959.99 563.28 75.00%
```