Migration to Vertx 5

Please add any missing hints to this document!

See TC’s draft of Officially Supported Technologies / Trillium document.

Help

Ask on #development Slack channel if a module doesn’t build with Vert.x 5.

Offical Guide

https://vertx.io/docs/guides/vertx-5-migration-guide/

Notable breaking changes

• ChattyResponsePredicate removed. Use ChattyHttpResponseExpectation instead. Example:
  Old:

  client .get(8080, "example.com", "/some-uri") .expect(ChattyResponsePredicate.SC_SUCCESS) .send()

  New:

  client .get(8080, "example.com", "/some-uri") .send() // new order! .expecting(ChattyHttpResponseExpectation.SC_SUCCESS)

• GenericCompositeFuture removed. The same methods exist in Vert.x' Future now.

• Futurization of Verticle:

  • AbstractVerticle becomes VerticleBase

  • public void start(Promise<Void> promise) becomes public Future<?> start()

  • public void stop(Promise<Void> promise) becomes public Future<?> stop()

• If the module throws an IllegalArgumentException on module startup that originates from org.folio.okapi.common.logging.FolioLoggingContext.put try bumping okapi-common to >= 7.0.1 and/or adding ServicesResourceTransformer to maven-shade-plugin. For details see FolioLocal javadoc.