Module io.vertx.core
Package io.vertx.core

Interface Verticle

All Superinterfaces:
Deployable
All Known Implementing Classes:
AbstractVerticle
public interface Verticle extends Deployable
WARNING : this class is not deprecated, however we encourage instead to use VerticleBase A verticle is a piece of code that can be deployed by Vert.x.

Use of verticles with Vert.x is entirely optional, but if you use them they provide an actor-like deployment and concurrency model, out of the box.

Vert.x does not provide a strict actor implementation, but there are significant similarities.

You can think of verticle instances as a bit like actors in the Actor Model. A typical verticle-based Vert.x application will be composed of many verticle instances in each Vert.x instance.

The verticles communicate with each other by sending messages over the EventBus.

Author:
Tim Fox

  • Method Summary

    Modifier and Type
    Method
    Description
    Vertx
    getVertx()
    Get a reference to the Vert.x instance that deployed this verticle
    void
    init(Vertx vertx, Context context)
    Initialise the verticle with the Vert.x instance and the context.
    void
    start(Promise<Void> startPromise)
    Start the verticle instance.
    void
    stop(Promise<Void> stopPromise)
    Stop the verticle instance.

    Methods inherited from interface io.vertx.core.Deployable

    deploy, undeploy

  • Method Details

    • getVertx

      Vertx getVertx()
      Get a reference to the Vert.x instance that deployed this verticle
      Returns:
      A reference to the Vert.x instance

    • init

      void init(Vertx vertx, Context context)
      Initialise the verticle with the Vert.x instance and the context.

      This method is called by Vert.x when the instance is deployed. You do not call it yourself.

      Parameters:
      vertx - the Vert.x instance
      context - the context

    • start

      void start(Promise<Void> startPromise) throws Exception
      Start the verticle instance.

      Vert.x calls this method when deploying the instance. You do not call it yourself.

      A promise is passed into the method, and when deployment is complete the verticle should either call Promise.complete(T, java.lang.Throwable) or Promise.fail(java.lang.Throwable) the future.

      Parameters:
      startPromise - the future
      Throws:
      Exception

    • stop

      void stop(Promise<Void> stopPromise) throws Exception
      Stop the verticle instance.

      Vert.x calls this method when un-deploying the instance. You do not call it yourself.

      A promise is passed into the method, and when un-deployment is complete the verticle should either call Promise.complete(T, java.lang.Throwable) or Promise.fail(java.lang.Throwable) the future.

      Parameters:
      stopPromise - the future
      Throws:
      Exception