vert-x3 / vertx-sbt-starter

PLEASE USE OUR G8-QUICKSTART INSTEAD OF THIS PROJECT

sbt new vert-x3/vertx-scala.g8

This is our old quickstart (still maintained but not as up to date as the g8)

This is a quickstart for a Vert.x Scala project. It provides a few sample unit tests.

The project depends on vertx-core and vertx-web so the project can provide REST functionality. Take your time and take a look around.

Vert.x Modules

There is a list of available modules maintained in project/Dependencies.scala. Simply add the appropriate entry to build.sbt to use one of the modules. Here is an example with an added vertx-hazelcast dependency for clustering.

libraryDependencies ++= Vector (
  Library.vertx_lang_scala,
  Library.vertx_web,
  Library.vertx_codegen,
  Library.vertx_hazelcast,
  Library.scalaTest % Test
)

Scala Console

In the following code, we launch sbt and enter the sbt console. Then we obtain an initialized Vert.x instance and the necessary imports to start playing around.

$ sbt console
scala> vertx.deployVerticle(nameForVerticle[HttpVerticle])
scala> vertx.deploymentIDs

Now you can use the sbt console to discover all sorts of things about the Vertx API.

Fat Jars

Take a look at build.sbt and search for the entry packageOptions. Enter the fully qualified class name of your primary verticle. This will be used as entry point for a generated fat jar.

To create the runnable fat jar, type:

$ sbt assembly

Dockerize

The project also contains everything you need to create a Docker container. Most configuration is done in project/Docker.scala. The only thing you have to do is keep the following line in build.sbt:

enablePlugins(DockerPlugin)
exposedPorts := Seq(8666)

Simply add additional ports to exposedPorts as required.

To package your fat jar inside a Docker container type the following at a shell prompt:

$ sbt docker

To run the container, type:

docker run -p 8666:8666 default/vertx-sbt-starter

Point your browser to http://127.0.0.1:8666/hello and enjoy :)

vertx-sbt-starter's Issues

unclear where to go from here

readme says:

PLEASE USE OUR G8-QUICKSTART INSTEAD OF THIS PROJECT

but where is that? Can you link to that in the readme?

no type for HttpVerticle

Project created with G8-QUICKSTART.
I tried to use Scala Console under the root folder of the project.
When vertx.deployVerticle(nameForVerticle[HttpVerticle]) typed.

vertx.deployVerticle(nameForVerticle[HttpVerticle])
<console>:25: error: not found: type HttpVerticle
       vertx.deployVerticle(nameForVerticle[HttpVerticle])

occured.

my env:
vertx-full+ vertx-scala-stack 3.5.1

openjdk version "1.8.0_161"
OpenJDK Runtime Environment (build 1.8.0_161-b14)
OpenJDK 64-Bit Server VM (build 25.161-b14, mixed mode)

sbt-1.1.1

oracle jdk tried, same problem.

Update to 3.5.0

How to use Live Redeploy during development without building jar on changes.

Vert.x Docs doesn't specify anything about sbt setup. Only Maven & Gradle are covered.