/*@jsxRuntime automatic @jsxImportSource react*/
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
function _createMdxContent(props) {
  const _components = Object.assign({
    p: "p",
    h2: "h2",
    a: "a",
    ul: "ul",
    li: "li",
    code: "code",
    pre: "pre",
    span: "span"
  }, props.components), {Link} = _components;
  if (!Link) _missingMdxReference("Link", true);
  return _jsxs(_Fragment, {
    children: [_jsx(_components.p, {
      children: "We have just re­leased Vert.x 3.5.1!"
    }), "\n", _jsxs(_components.h2, {
      id: "fixes-first",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#fixes-first"
      }), "Fixes first!"]
    }), "\n", _jsx(_components.p, {
      children: "As usual this re­lease fixes bugs re­ported in 3.5.0, see the re­lease notes."
    }), "\n", _jsxs(_components.h2, {
      id: "junit-5-support",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#junit-5-support"
      }), "JUnit 5 support"]
    }), "\n", _jsxs(_components.p, {
      children: ["This re­lease in­tro­duces the new ", _jsx(_components.a, {
        href: "https://github.com/vert-x3/vertx-junit5",
        children: "vertx-​junit5 mod­ule"
      }), "."]
    }), "\n", _jsxs(_components.p, {
      children: [_jsx(_components.a, {
        href: "http://junit.org/junit5/",
        children: "JUnit 5"
      }), " is a rewrite of the fa­mous Java test­ing frame­work that brings new in­ter­est­ing fea­tures, in­clud­ing:"]
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: "nested tests,"
      }), "\n", _jsx(_components.li, {
        children: "the abil­ity to give a human-​readable de­scrip­tion of tests and test cases (and yes, even use emo­jis),"
      }), "\n", _jsx(_components.li, {
        children: "a mod­u­lar ex­ten­sion mech­a­nism that is more pow­er­ful than the JUnit 4 run­ner mech­a­nism (@Run­With an­no­ta­tion),"
      }), "\n", _jsx(_components.li, {
        children: "con­di­tional test ex­e­cu­tion,"
      }), "\n", _jsx(_components.li, {
        children: "pa­ra­me­ter­ized tests, in­clud­ing from sources such as CSV data,"
      }), "\n", _jsx(_components.li, {
        children: "the sup­port of Java 8 lambda ex­pres­sions in the re­worked built-​in as­ser­tions API,"
      }), "\n", _jsx(_components.li, {
        children: "sup­port for run­ning tests pre­vi­ously writ­ten for JUnit 4."
      }), "\n"]
    }), "\n", _jsxs(_components.p, {
      children: ["Sup­pose that we have a ", _jsx(_components.code, {
        children: "SampleVerticle"
      }), " ver­ti­cle that ex­poses a HTTP server on port 11981.\nHere is how we can test its de­ploy­ment as well as the re­sult of 10 con­cur­rent HTTP re­quests:"]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: [_jsx(_components.span, {
          className: "hljs-meta",
          children: "@Test"
        }), "\n", _jsx(_components.span, {
          className: "hljs-meta",
          children: "@DisplayName(\"🚀 Deploy a HTTP service verticle and make 10 requests\")"
        }), "\n", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "void"
        }), " ", _jsx(_components.span, {
          className: "hljs-title function_",
          children: "useSampleVerticle"
        }), _jsx(_components.span, {
          className: "hljs-params",
          children: "(Vertx vertx, VertxTestContext testContext)"
        }), " {\n  ", _jsx(_components.span, {
          className: "hljs-type",
          children: "WebClient"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "webClient"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " WebClient.create(vertx);\n  ", _jsx(_components.span, {
          className: "hljs-type",
          children: "Checkpoint"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "deploymentCheckpoint"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " testContext.checkpoint();\n\n  ", _jsx(_components.span, {
          className: "hljs-type",
          children: "Checkpoint"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "requestCheckpoint"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " testContext.checkpoint(", _jsx(_components.span, {
          className: "hljs-number",
          children: "10"
        }), ");\n  vertx.deployVerticle(", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "new"
        }), " ", _jsx(_components.span, {
          className: "hljs-title class_",
          children: "SampleVerticle"
        }), "(), testContext.succeeding(id -> {\n    deploymentCheckpoint.flag();\n\n    ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "for"
        }), " (", _jsx(_components.span, {
          className: "hljs-type",
          children: "int"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "i"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " ", _jsx(_components.span, {
          className: "hljs-number",
          children: "0"
        }), "; i < ", _jsx(_components.span, {
          className: "hljs-number",
          children: "10"
        }), "; i++) {\n      webClient.get(", _jsx(_components.span, {
          className: "hljs-number",
          children: "11981"
        }), ", ", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"localhost\""
        }), ", ", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"/\""
        }), ")\n        .as(BodyCodec.string())\n        .send(testContext.succeeding(resp -> {\n          testContext.verify(() -> {\n            assertThat(resp.statusCode()).isEqualTo(", _jsx(_components.span, {
          className: "hljs-number",
          children: "200"
        }), ");\n            assertThat(resp.body()).contains(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"Yo!\""
        }), ");\n            requestCheckpoint.flag();\n          });\n        }));\n    }\n  }));\n}\n"]
      })
    }), "\n", _jsxs(_components.p, {
      children: ["The test method above ben­e­fits from the in­jec­tion of a work­ing ", _jsx(_components.code, {
        children: "Vertx"
      }), " con­text, a ", _jsx(_components.code, {
        children: "VertxTestContext"
      }), " for deal­ing with\nasyn­chro­nous op­er­a­tions, and the guar­an­tee that the ex­e­cu­tion time is bound by a time­out which can op­tion­ally be con­fig­ured\nusing a ", _jsx(_components.code, {
        children: "@Timeout"
      }), " an­no­ta­tion."]
    }), "\n", _jsxs(_components.p, {
      children: ["The test suc­ceeds when all check­points have been flagged.\nNote that ", _jsx(_components.code, {
        children: "vertx-junit5"
      }), " is ag­nos­tic of the as­ser­tions li­brary being used: you may opt for the built-​in JUnit 5 as­ser­tions\nor use a 3rd-​party li­brary such as ", _jsx(_components.a, {
        href: "http://joel-costigliola.github.io/assertj/",
        children: "As­sertJ"
      }), " as we did in the ex­am­ple above."]
    }), "\n", _jsxs(_components.p, {
      children: ["You can check­out the ", _jsx(_components.a, {
        href: "https://github.com/vert-x3/vertx-junit5",
        children: "source on GitHub"
      }), ", read ", _jsx(Link, {
        href: "/docs/vertx-junit5/java/",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "the man­ual"
        })
      }), " and learn from ", _jsx(_components.a, {
        href: "https://github.com/vert-x3/vertx-examples/tree/master/junit5-examples",
        children: "the ex­am­ples"
      }), "."]
    }), "\n", _jsxs(_components.h2, {
      id: "web-api-contract-enhancements",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#web-api-contract-enhancements"
      }), "Web API Contract enhancements"]
    }), "\n", _jsxs(_components.p, {
      children: ["The pack­age ", _jsx(_components.code, {
        children: "vertx-web-api-contract"
      }), " in­cludes a va­ri­ety of fixes, from schema ", _jsx(_components.code, {
        children: "$ref"
      }), " to\n", _jsx(Link, {
        href: "/docs/vertx-web-api-contract/java/",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "re­vamped doc­u­men­ta­tion"
        })
      }), ". You can give a look at list of all\n", _jsx(_components.a, {
        href: "https://github.com/vert-x3/vertx-web/pull/802",
        children: "fixes/im­prove­ments here"
      }), " and all\n", _jsx(_components.a, {
        href: "https://github.com/vert-x3/wiki/wiki/3.5.1-Breaking-Changes#vertx-web-api-contracts",
        children: "break­ing changes here"
      }), "."]
    }), "\n", _jsxs(_components.p, {
      children: ["From 3.5.1 to load the ope­napi spec and in­stan­ti­ate the Router you should use new method ", _jsx(_components.code, {
        children: "OpenAPI3RouterFactory.create()"
      }), "\nthat re­places old meth­ods ", _jsx(_components.code, {
        children: "createRouterFactoryFromFile()"
      }), " and ", _jsx(_components.code, {
        children: "createRouterFactoryFromURL()"
      }), ". This new method ac­cepts\nrel­a­tive paths, ab­solute paths, local URL with ", _jsx(_components.code, {
        children: "file://"
      }), " and re­mote URL with ", _jsx(_components.code, {
        children: "http://"
      }), ". Note that if you want refeer to\na file rel­a­tive to your jar’s root, you can sim­ply use a rel­a­tive path and the parser will look out the jar and into the\njar for the spec."]
    }), "\n", _jsxs(_components.p, {
      children: ["From 3.5.1 all set­tings about ", _jsx(_components.code, {
        children: "OpenAPI3RouterFactory"
      }), " be­hav­iours dur­ing router gen­er­a­tion are in­globed in a new ob­ject called\n", _jsx(Link, {
        href: "/docs/apidocs/io/vertx/ext/web/api/contract/RouterFactoryOptions.html",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: _jsx(_components.code, {
            children: "RouterFactoryOptions"
          })
        })
      }), ". From\nthis ob­ject you can:"]
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsxs(_components.li, {
        children: ["Con­fig­ure if you want to mount a de­fault val­i­da­tion fail­ure han­dler and which one\n(meth­ods ", _jsx(_components.code, {
          children: "setMountValidationFailureHandler(boolean)"
        }), " and ", _jsx(_components.code, {
          children: "setValidationFailureHandler(Handler)"
        }), ")"]
      }), "\n", _jsxs(_components.li, {
        children: ["Con­fig­ure if you want to mount a de­fault 501 not im­ple­mented han­dler and which one\n(meth­ods ", _jsx(_components.code, {
          children: "setMountNotImplementedFailureHandler(boolean)"
        }), " and ", _jsx(_components.code, {
          children: "setNotImplementedFailureHandler(Handler)"
        }), ")"]
      }), "\n", _jsxs(_components.li, {
        children: ["Con­fig­ure if you want to mount ", _jsx(_components.code, {
          children: "ResponseContentTypeHandler"
        }), " au­to­mat­i­cally\n(method ", _jsx(_components.code, {
          children: "setMountResponseContentTypeHandler(boolean)"
        }), ")"]
      }), "\n", _jsxs(_components.li, {
        children: ["Con­fig­ure if you want to fail dur­ing router gen­er­a­tion when se­cu­rity han­dlers are not con­fig­ured\n(method ", _jsx(_components.code, {
          children: "setRequireSecurityHandlers(boolean)"
        }), ")"]
      }), "\n"]
    }), "\n", _jsxs(_components.p, {
      children: ["After ini­tial­iza­tion of route, you can mount the ", _jsx(_components.code, {
        children: "RouterFactoryOptions"
      }), " ob­ject with method ", _jsx(_components.code, {
        children: "routerFactory.setOptions()"
      }), "\nwhen you want be­fore call­ing ", _jsx(_components.code, {
        children: "getRouter()"
      }), "."]
    }), "\n", _jsxs(_components.h2, {
      id: "rxjava-deprecation-removal",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#rxjava-deprecation-removal"
      }), "RxJava deprecation removal"]
    }), "\n", _jsxs(_components.p, {
      children: ["It is im­por­tant to know that 3.5.x will be the last re­lease with the legacy ", _jsx(_components.code, {
        children: "xyzObservable()"
      }), " meth­ods:"]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: [_jsx(_components.span, {
          className: "hljs-meta",
          children: "@Deprecated()"
        }), "\n", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "public"
        }), " Observable<HttpServer> ", _jsx(_components.span, {
          className: "hljs-title function_",
          children: "listenObservable"
        }), _jsxs(_components.span, {
          className: "hljs-params",
          children: ["(", _jsx(_components.span, {
            className: "hljs-type",
            children: "int"
          }), " port, String host)"]
        }), ";\n"]
      })
    }), "\n", _jsx(_components.p, {
      children: "has been re­placed since Vert.x 3.4 by:"
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: [_jsx(_components.span, {
          className: "hljs-keyword",
          children: "public"
        }), " Single<HttpServer> ", _jsx(_components.span, {
          className: "hljs-title function_",
          children: "rxListen"
        }), _jsxs(_components.span, {
          className: "hljs-params",
          children: ["(", _jsx(_components.span, {
            className: "hljs-type",
            children: "int"
          }), " port, String host)"]
        }), ";\n"]
      })
    }), "\n", _jsxs(_components.p, {
      children: ["The ", _jsx(_components.code, {
        children: "xyzObservable()"
      }), " dep­re­cated meth­ods will be ", _jsx(_components.a, {
        href: "https://github.com/vert-x3/vertx-rx/issues/113",
        children: "re­moved"
      }), " in Vert.x 3.6."]
    }), "\n", _jsxs(_components.h2, {
      id: "wrap-up",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#wrap-up"
      }), "Wrap up"]
    }), "\n", _jsx(_components.p, {
      children: "Vert.x 3.5.1 re­lease notes and break­ing changes:"
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: _jsx(_components.a, {
          href: "https://github.com/vert-x3/wiki/wiki/3.5.1-Release-Notes",
          children: "https://github.com/vert-​x3/wiki/wiki/3.5.1-​Release-Notes"
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(_components.a, {
          href: "https://github.com/vert-x3/wiki/wiki/3.5.1-Breaking-Changes",
          children: "https://github.com/vert-​x3/wiki/wiki/3.5.1-​Breaking-Changes"
        })
      }), "\n"]
    }), "\n", _jsx(_components.p, {
      children: "The event bus client using the SockJS bridge are avail­able from NPM, Bower and as a We­b­Jar:"
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: _jsx(_components.a, {
          href: "https://www.npmjs.com/package/vertx3-eventbus-client",
          children: "https://www.npmjs.com/pack­age/vertx3-​eventbus-client"
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(_components.a, {
          href: "https://github.com/vert-x3/vertx-bus-bower",
          children: "https://github.com/vert-​x3/vertx-​bus-bower"
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(_components.a, {
          href: "http://www.webjars.org/",
          children: "http://www.we­b­jars.org/"
        })
      }), "\n"]
    }), "\n", _jsxs(_components.p, {
      children: ["Docker im­ages are also avail­able on the ", _jsx(_components.a, {
        href: "https://hub.docker.com/u/vertx/",
        children: "Docker Hub"
      }), ". The Vert.x dis­tri­b­u­tion is also avail­able from ", _jsx(_components.a, {
        href: "http://sdkman.io/index.html",
        children: "SD­KMan"
      }), " and ", _jsx(_components.a, {
        href: "http://brew.sh/",
        children: "Home­Brew"
      }), "."]
    }), "\n", _jsxs(_components.p, {
      children: ["The ar­ti­facts have been de­ployed to ", _jsx(_components.a, {
        href: "http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22io.vertx%22%20AND%20v%3A%223.5.1%22",
        children: "Maven Cen­tral"
      }), " and you can get the dis­tri­b­u­tion on ", _jsx(_components.a, {
        href: "https://bintray.com/vertx/downloads/distribution/3.3.3/view",
        children: "Bin­tray"
      }), "."]
    }), "\n", _jsx(_components.p, {
      children: "Happy cod­ing !"
    })]
  });
}
function MDXContent(props = {}) {
  const {wrapper: MDXLayout} = props.components || ({});
  return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, {
    children: _jsx(_createMdxContent, props)
  })) : _createMdxContent(props);
}
return {
  default: MDXContent
};
function _missingMdxReference(id, component) {
  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it.");
}


Blog

Eclipse Vert.x 3.5.1 released!

Next post

Google Summer of Code 2018

Previous post

TCP Client using Eclipse Vert.x, Kotlin and Gradle build

Blog

Eclipse Vert.x 3.5.1 released!

Next post

Google Summer of Code 2018

Previous post

TCP Client using Eclipse Vert.x, Kotlin and Gradle build

Related posts

Unit and Integration Tests

Checklist for Migrating from Vert.x 2.1.x to Vert.x 3 - Part One

Things to keep in mind concerning CSRF attacks