3.3.0 Breaking Changes

API

Auth

• OAuth2 provider options are now a DataObject instead of a plain JSON Object. This DataObject OAuth2AuthOptions extend the HttpClientOptions so all configuration to the SSL trust is configurable.

Web

• 'normalizedPath()' Normalized paths never return null. This fixes a bug and complies to the https://www.w3.org/Protocols/rfc2616/rfc2616-sec5.html
• jade template engine upgraded to 1.2.1 which means that the jade language level breaking changes from 0.4.x
  • Instead of 'id = 5' you must use '- var id = 5'
  • Instead of 'h1(attributes, class = "test")' you must use 'h1(class= "test")&attributes(attributes)'
  • Instead of '!!! 5' you must use 'doctype html'
  • Jade Syntax for Conditional Comments is not supported anymore
• TimeoutHandler returns 503 instead of 408. 408 is for client request timeout, while the timeout handler is for the server side code.
• pebble template constructor requires a vertx instance, this is required since the original implementation did not support extensions and includes
• addHeadersEndHandler() is a stack, meaning that handlers are executed in a LIFO approach. Before they were a FIFO which was wrong behaviour.

Redis

• Redis transaction commands have been changed to return a RedisTransaction object, these include:
  • discard
  • exec
  • multi
  • watch
  • unwatch

Once a TX is started all redis commands will be delayed so calling for example a GET will return a success/failure to be added to the TX rather than the value itself.

• spopMany always returns a list of strings, however the API interface was declared as a single string which would always throw a ClassCastException

SPI

• io.vertx.core.spi.FutureFactory - completedFuture methods have been renamed into succeededFuture

• io.vertx.core.spi.metrics.DatagramSocketMetrics - the listening(SocketAddress) method has been removed

• todo : document the metrics changes as there are several (HTTP/2 / Hostname resolver)

JGroups Cluster Manager

• The code has been reorganized.

Vert.x Stomp

• PermittedOptions is now part of the vertx-bridge-common

Config