/*@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",
    pre: "pre",
    code: "code",
    span: "span",
    ul: "ul",
    li: "li"
  }, props.components), {Link} = _components;
  if (!Link) _missingMdxReference("Link", true);
  return _jsxs(_Fragment, {
    children: [_jsx(_components.p, {
      children: "We are ex­tremely pleased to an­nounce the third 4.0 beta re­lease of Eclipse Vert.x."
    }), "\n", _jsx(_components.p, {
      children: "Vert.x 4 is the evo­lu­tion of the Vert.x 3.x se­ries that will bring key fea­tures to Vert.x."
    }), "\n", _jsxs(_components.h2, {
      id: "http-client-request-creation",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#http-client-request-creation"
      }), "HTTP client request creation"]
    }), "\n", _jsx(_components.p, {
      children: "Until Beta3, HTTP client has cre­ated lazy HTTP re­quests, since then cre­at­ing a re­quest\nhas be­come an asyn­chro­nous op­er­a­tion guar­an­tee­ing that a slot for per­form­ing the re­quest\nis granted:"
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: [_jsx(_components.span, {
          className: "hljs-comment",
          children: "// Created a request"
        }), "\n", _jsx(_components.span, {
          className: "hljs-type",
          children: "HttpClientRequest"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "request"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " client.get(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"/some-uri\""
        }), ");\n\n", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Connect to the server or reuse a connection from the pool and then try to send the request"
        }), "\nrequest.end();\n\n", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Since Beta3"
        }), "\nclient.get(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"/some-uri\""
        }), ", ar -> {\n  ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// The client connected to the server or reused a connection from the pool"
        }), "\n  ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (ar.succeeded()) {\n    ", _jsx(_components.span, {
          className: "hljs-type",
          children: "HttpClientRequest"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "request"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " ar.result();\n\n    ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Send the request"
        }), "\n    request.end();\n  }\n});\n"]
      })
    }), "\n", _jsx(_components.p, {
      children: "An­other (hid­den) mo­ti­va­tion to switch to this model is avoid­ing data races when the\nHTTP client is used out­side the event-​loop using fu­tures."
    }), "\n", _jsx(_components.p, {
      children: "Pre­vi­ously, you could write code like:"
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["Future<HttpClientResponse> get = client.get(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"some-uri\""
        }), ");\n\n", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Assuming we have a client that returns a future response"
        }), "\n", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// assuging this is *not* on the event-loop"
        }), "\nFuture<Buffer> fut = get.send().compose(response -> {\n\n  ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Response events might have happen already"
        }), "\n  ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "return"
        }), " response.body();\n});\n"]
      })
    }), "\n", _jsx(_components.p, {
      children: "Now, you can write in­stead:"
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["Future<Buffer> fut = client.get(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"some-uri\""
        }), ").compose(request -> {\n  request.send().compose(response -> response.body())\n});\n"]
      })
    }), "\n", _jsxs(_components.h2, {
      id: "httpserverresponse-send-method",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#httpserverresponse-send-method"
      }), "HttpServerResponse send method"]
    }), "\n", _jsxs(_components.p, {
      children: ["In the pre­vi­ous beta, HTTP client re­quest got a new sim­pli­fied ", _jsx(_components.code, {
        children: "send"
      }), " method to send\na body or a stream. We did the same for the HTTP server re­sponse API:"]
    }), "\n", _jsx(_components.pre, {
      children: _jsx(_components.code, {
        className: "hljs language-java",
        children: "server.requestHandler(req -> {\n  req.pause();\n  getSomeStream().onSuccess(stream -> {\n    req.response().send(stream);\n  });\n});\n"
      })
    }), "\n", _jsxs(_components.h2, {
      id: "http-tunnel-improvements",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#http-tunnel-improvements"
      }), "HTTP tunnel improvements"]
    }), "\n", _jsx(_components.p, {
      children: "Cre­at­ing an HTTP tun­nel has now be­come more nat­ural:"
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["client.request(HttpMethod.CONNECT, ", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"some-uri\""
        }), ")\n  .onSuccess(request -> {\n\n    ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Connect to the server"
        }), "\n    request.connect(ar -> {\n      ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (ar.succeeded()) {\n        ", _jsx(_components.span, {
          className: "hljs-type",
          children: "HttpClientResponse"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "response"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " ar.result();\n\n        ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (response.statusCode() != ", _jsx(_components.span, {
          className: "hljs-number",
          children: "200"
        }), ") {\n          ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Connect failed for some reason"
        }), "\n        } ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "else"
        }), " {\n          ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Tunnel created, raw buffers are transmitted on the wire"
        }), "\n          ", _jsx(_components.span, {
          className: "hljs-type",
          children: "NetSocket"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "socket"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " response.netSocket();\n        }\n      }\n    });\n});\n"]
      })
    }), "\n", _jsxs(_components.p, {
      children: ["The new ", _jsx(_components.code, {
        children: "connect"
      }), " method tells the client that when a ", _jsx(_components.code, {
        children: "201"
      }), " re­sponse is re­ceived\nfrom the server then the con­nec­tion should be switched to not in­ter­pret HTTP\ndata any­more."]
    }), "\n", _jsxs(_components.p, {
      children: ["On the server, the API has be­come asyn­chro­nous and re­named to ", _jsx(_components.code, {
        children: "toNetSocket()"
      }), ":"]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["server.requestHandler(request -> {\n  ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (request.method() == HttpMethod.CONNECT) {\n    ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Will send an HTTP 201 status code and switch the connection to use raw buffers"
        }), "\n    request.toNetSocket(ar -> {\n      ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (ar.succeeded()) {\n        ", _jsx(_components.span, {
          className: "hljs-type",
          children: "NetSocket"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "socket"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " ar.result();\n      }\n    });\n  }\n});\n"]
      })
    }), "\n", _jsxs(_components.h2, {
      id: "websocket-upgrade-improvements",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#websocket-upgrade-improvements"
      }), "WebSocket upgrade improvements"]
    }), "\n", _jsxs(_components.p, {
      children: ["The server Web­Socket man­ual up­grade op­er­a­tion has also be­come asyn­chro­nous and re­named\nto ", _jsx(_components.code, {
        children: "toWebSocket()"
      })]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["server.requestHandler(request -> {\n  ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (request.method() == HttpMethod.GET && ", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"Upgrade\""
        }), ".equals(request.getHeader(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"connection\""
        }), "))) {\n    ", _jsx(_components.span, {
          className: "hljs-comment",
          children: "// Will do the WebSocket handshake"
        }), "\n    request.toWebSocket(ar -> {\n      ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (ar.succeeded()) {\n        ", _jsx(_components.span, {
          className: "hljs-type",
          children: "ServerWebSocket"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "socket"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " ar.result();\n      }\n    });\n  }\n});\n"]
      })
    }), "\n", _jsxs(_components.h2, {
      id: "row-to-json-conversion",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#row-to-json-conversion"
      }), "Row to JSON conversion"]
    }), "\n", _jsxs(_components.p, {
      children: ["SQL client can now eas­ily trans­form a ", _jsx(_components.code, {
        children: "Row"
      }), " into a JSON ob­ject, this can be con­vie­nient\nfor ap­pli­ca­tions di­rectly trans­fer­ring JSON re­sults to the client:"]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["client\n  .preparedQuery(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"SELECT * FROM USERS WHERE ID=$1\""
        }), ")\n  .execute(Tuple.of(id))\n  .onSuccess(row -> {\n    ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "if"
        }), " (row.size() == ", _jsx(_components.span, {
          className: "hljs-number",
          children: "1"
        }), ") {\n      ", _jsx(_components.span, {
          className: "hljs-type",
          children: "JsonObject"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "json"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " row.iterator().next().toJson();\n    }\n  });\n"]
      })
    }), "\n", _jsxs(_components.h2, {
      id: "oauth2oidc-pkce",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#oauth2oidc-pkce"
      }), "OAuth2/OIDC PKCE"]
    }), "\n", _jsxs(_components.p, {
      children: [_jsx(_components.code, {
        children: "OAuth2Handler"
      }), " can now han­dle ", _jsx(_components.a, {
        href: "https://tools.ietf.org/html/rfc7636",
        children: "PKCE"
      }), ", which means an­other layer of se­cu­rity to your ap­pli­ca­tion."]
    }), "\n", _jsxs(_components.h2, {
      id: "redis-resp3",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#redis-resp3"
      }), "Redis RESP3"]
    }), "\n", _jsxs(_components.p, {
      children: ["The redis client can now speak ", _jsx(_components.code, {
        children: "RESP3"
      }), " with redis servers. This means it can han­dle all the new types and APIs avail­able on redis from all ver­sions (RESP2, redis < 6) and (RESP3, redis >= 6)."]
    }), "\n", _jsxs(_components.h2, {
      id: "finally",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#finally"
      }), "Finally"]
    }), "\n", _jsx(_components.p, {
      children: "This is the Beta3 re­lase of Vert.x 4, you can of course ex­pect an­other beta as we get feed­back from the com­mu­nity and fix is­sues that we failed to catch be­fore."
    }), "\n", _jsx(_components.p, {
      children: "You can also read the mile­stone an­nounces to know more about the over­ral changes:"
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-beta-1-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​beta-1-​released"
          })
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-milestone-5-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​milestone-5-​released"
          })
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-milestone-5-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​milestone-5-​released"
          })
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-milestone-4-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​milestone-4-​released"
          })
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-milestone-3-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​milestone-3-​released"
          })
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-milestone-2-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​milestone-2-​released"
          })
        })
      }), "\n", _jsx(_components.li, {
        children: _jsx(Link, {
          href: "/blog/eclipse-vert-x-4-milestone-1-released",
          passHref: true,
          children: _jsx(_components.a, {
            href: "",
            children: "https://vertx.io/blog/eclipse-​vert-x-4-​milestone-1-​released"
          })
        })
      }), "\n"]
    }), "\n", _jsxs(_components.p, {
      children: ["The ", _jsx(_components.a, {
        href: "https://github.com/vert-x3/wiki/wiki/4.0.0-Deprecations-and-breaking-changes",
        children: "dep­re­ca­tions and break­ing changes"
      }), "\ncan be found on the wiki."]
    }), "\n", _jsx(_components.p, {
      children: "For this re­lease, there are no Docker im­ages."
    }), "\n", _jsxs(_components.p, {
      children: ["The re­lease ar­ti­facts have been de­ployed to ", _jsx(_components.a, {
        href: "https://search.maven.org/search?q=g:io.vertx%20AND%20v:4.0.0.Beta1",
        children: "Maven Cen­tral"
      }), " and you can get the dis­tri­b­u­tion on ", _jsx(_components.a, {
        href: "https://repo1.maven.org/maven2/io/vertx/vertx-stack-manager/4.0.0.Beta1/",
        children: "Maven Cen­tral"
      }), "."]
    }), "\n", _jsxs(_components.p, {
      children: ["You can boot­strap a Vert.x 4.0.0.Beta3 project using ", _jsx(_components.a, {
        href: "https://start.vertx.io",
        children: "https://start.vertx.io"
      }), "."]
    }), "\n", _jsxs(_components.p, {
      children: ["The doc­u­men­ta­tion has been de­ployed on this pre­view web-​site ", _jsx(_components.a, {
        href: "https://vertx-web-site.github.io/docs/",
        children: "https://vertx-​web-site.github.io/docs/"
      })]
    }), "\n", _jsxs(_components.p, {
      children: ["That’s it! Happy cod­ing and see you soon on our user or dev ", _jsx(Link, {
        href: "/community",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "chan­nels"
        })
      }), "."]
    })]
  });
}
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 4 beta 3 released!

Next post

JWT Authorization for Vert.x with Keycloak

Previous post

Eclipse Vert.x 3.9.3 released!

Blog

Eclipse Vert.x 4 beta 3 released!

Next post

JWT Authorization for Vert.x with Keycloak

Previous post

Eclipse Vert.x 3.9.3 released!

Related posts

Things to keep in mind concerning CSRF attacks

Real-time bidding with Websockets and Vert.x

Some Rest with Vert.x