shengc / scalaz-netty

A minimalist wrapper for Netty in terms of scalaz-stream

scalaz-netty

Getting Started

First, you'll need to add the RichRelevance and Scalaz Bintray resolver settings to your SBT file:

resolvers ++= Seq(
  "Scalaz Bintray Repo" at "http://dl.bintray.com/scalaz/releases",
  "RichRelevance Bintray" at "http://dl.bintray.com/rr/releases")

If you want to be able to use snapshot releases, replace releases with snapshots. With the resolver configured, add the following dependency specification:

libraryDependencies += "org.scalaz.netty" %% "scalaz-netty" % "0.1.8"

Builds are published for Scala 2.11.6. The latest stable release is 0.1.8. The upstream dependencies for this project include the following:

• scalaz 7.1.0
• scalaz-stream 0.7a
• scodec-core 1.7.1
• netty 4.0.21.Final

Snapshot releases follow the version scheme master-<sha1>, where the "sha1" component is the Git commit that was snapshotted. Not all commits will have corresponding snapshot releases. You can browse the list of snapshot releases on bintray.

Example

import scalaz.netty._
import scalaz.stream._
import scalaz.concurrent._
import java.net.InetSocketAddress
import scodec.bits.ByteVector

/*
 * A simple server which accepts a connection, echos the incoming
 * data back to the sender, waiting for the client to close the connection.
 */

def log(msg: String): Task[Unit] = Task.delay(println(s"$msg"))

val address = new InetSocketAddress("localhost", 9090)

val EchoServer = merge.mergeN(Netty server address map {
  case (addr, incoming) => {
    for {
      exchange <- incoming
      _ <- Process.eval(log(s"accepted connection from $addr"))
      _ <- exchange.read to exchange.write
    } yield ()
  }
})

/*
 * A simple client which sends ByteVector(1, 2, 3) to the server,
 * prints its response and then shuts down.
 */

val BasicClient = Netty connect address flatMap { exchange =>
  for {
    _ <- Process(ByteVector(1, 2, 3)) to exchange.write
    data <- exchange.read take 1
    _ <- Process.eval(log(s"received data = $data"))
  } yield ()
}

// Usage:
// scala> EchoServer.run.runAsync(_ => ())  // press Enter when this completes to acquire new prompt
// scala> BasicClient.run.run

Future Work

• Byte buffers are copied upon receipt. The only way to safely address this problem will be to integrate with Scodec and decode against the directly allocated byte buffers. Not hard to do, really...
• Exceptions probably don't propagate properly under all circumstances.

License

Licensed under the Apache License 2.0. For more information, please see LICENSE.txt. Opening a pull request signifies your consent to license your contributions under the Apache License 2.0. Don't open a pull request if you don't know what this means.