Vert.x 2.x is deprecated - use instead https://github.com/vert-x3/vertx-lang-scala
Scala language implementation for Vert.x.
To use it, we’ve added a first "Hello World"-like example to the Vert.x Examples repository which can be run like this:
-
Clone or download the Vert.x Examples Git repository
-
Change directory to
src/raw/scala
and type:[VERTX_HOME]/bin/vertx run http/Server.scala
-
Go to http://localhost:8080/ and you should see the message: ""This is a Verticle script!"
The best places to look for examples on how to use the Vert.x Scala API are the Vert.x Examples repository and the Vert.x Scala testsuite. Please inspect those if you have any doubts. The following sub sections explain some of the items to bear in mind when using this API.
In some cases, the Scala compiler can fail to detect the type of a particular handler, for example:
+
val datagramSocket = vertx.createDatagramSocket() datagramSocket.send("hello", "127.0.0.1", 1234, { h: AsyncResult[DatagramSocket] => ... }
+
In this example, send
method call explicitly needs to define the type
annotation for the async result handler. This is because there’s an overloaded
method that sends a org.vertx.scala.core.buffer.Buffer
instead of a String.
A possible workaround would have been to use function currying, but doing so
would limit the API capability to add scala.concurrent.Future
based methods,
which are better suited for implementing handlers.
Vert.x 2.1 comes with Vert.x Scala language support embedded within it, but if you want to test a different version of the Vert.x Scala language implementation, follow these instructions:
-
Download a Vert.x distribution.
-
Open
[VERTX_HOME]/conf/langs.properties
file and modify this line to match the Vert.x Scala version to test:scala=io.vertx~lang-scala~X.Y.Z:org.vertx.scala.platform.impl.ScalaVerticleFactory
Optionally, if you’re testing a locally built Vert.x Scala extension, you’ll need to do the following steps additionally:
-
Download latest SBT release
-
Put
[SBT_HOME]/bin/sbt
or[SBT_HOME]/bin/sbt.bar
into your path -
Clone the Vert.x Scala source repository 4a. If you want build plugin with the base Scala version used (e.g. 2.10), execute:
$ sbt clean publishM2 $ [VERTX_HOME]/bin/vertx install io.vertx~lang-scala_2.10~X.Y.Z
4b. On the other hand, if you want build plugin with a cross compiled Scala version (e.g. 2.11), execute:
$ sbt clean +publishM2 $ [VERTX_HOME]/bin/vertx install io.vertx~lang-scala_2.11~X.Y.Z
For more information on building Vert.x Scala, check the contributing guide.