/*@jsxRuntime automatic @jsxImportSource react*/
const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];
function _createMdxContent(props) {
  const _components = Object.assign({
    p: "p",
    a: "a",
    ul: "ul",
    li: "li",
    h2: "h2",
    h3: "h3",
    code: "code",
    pre: "pre",
    span: "span",
    em: "em"
  }, props.components), {Link} = _components;
  if (!Link) _missingMdxReference("Link", true);
  return _jsxs(_Fragment, {
    children: [_jsxs(_components.p, {
      children: ["Vert.x 4.4 ships sev­eral im­prove­ments to the ", _jsx(Link, {
        href: "/docs/vertx-web-graphql/java/",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "GraphQL-​Java in­te­gra­tion with Vert.x Web"
        })
      }), "."]
    }), "\n", _jsx(_components.p, {
      children: "In this ar­ti­cle, we’ll go through the most im­por­tant of them:"
    }), "\n", _jsxs(_components.ul, {
      children: ["\n", _jsx(_components.li, {
        children: "GraphiQL IDE up­grade (slick UI and sub­scrip­tions sup­port),"
      }), "\n", _jsx(_components.li, {
        children: "sim­pli­fied data fetcher de­f­i­n­i­tions (using in­stru­men­ta­tion),"
      }), "\n", _jsx(_components.li, {
        children: "sup­port of Apollo’s Au­to­matic Per­sisted Queries (APQ)."
      }), "\n"]
    }), "\n", _jsxs(_components.h2, {
      id: "graphiql-ide-upgrade",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#graphiql-ide-upgrade"
      }), "GraphiQL IDE upgrade"]
    }), "\n", _jsxs(_components.p, {
      children: ["Vert.x Web GraphQL now ships the lat­est ver­sion of the ", _jsx(Link, {
        href: "/docs/vertx-web-graphql/java/#_graphiql_ide",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "GraphQL IDE"
        })
      }), ".\nCom­pared to the old ver­sion, you’ll get a slick user in­ter­face, ed­itable code his­tory and the abil­ity to switch be­tween light and dark modes."]
    }), "\n", _jsx("video", {
      controls: true,
      width: "100%",
      preload: "auto",
      children: _jsx("source", {
        src: "/videos/blog/vertx-web-graphql-java-improvements/graphiql-updated.webm",
        type: "video/webm"
      })
    }), "\n", _jsxs(_components.p, {
      children: ["More im­por­tantly, our in­te­gra­tion lever­ages the ", _jsx(_components.a, {
        href: "https://github.com/graphql/graphiql/blob/main/packages/graphiql-toolkit/docs/create-fetcher.md",
        children: "GraphiQL toolkit fetcher"
      }), ".\nThis means you can test sub­scrip­tions over the GraphQLWS pro­to­col."]
    }), "\n", _jsx("video", {
      controls: true,
      width: "100%",
      preload: "auto",
      children: _jsx("source", {
        src: "/videos/blog/vertx-web-graphql-java-improvements/graphiql-subscriptions.webm",
        type: "video/webm"
      })
    }), "\n", _jsxs(_components.h2, {
      id: "simplified-data-fetcher-definitions",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#simplified-data-fetcher-definitions"
      }), "Simplified data fetcher definitions"]
    }), "\n", _jsxs(_components.h3, {
      id: "data-fetchers-returning-vertx-future",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#data-fetchers-returning-vertx-future"
      }), "Data fetchers returning Vert.x ", _jsx(_components.code, {
        children: "Future"
      })]
    }), "\n", _jsxs(_components.p, {
      children: ["In pre­vi­ous ver­sions, you could cre­ate asyn­chro­nous data fetch­ers with ", _jsx(_components.code, {
        children: "VertxDataFetcher"
      }), ":"]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["VertxDataFetcher<List<Link>> dataFetcher = VertxDataFetcher.create((env, promise) -> {\n  retrieveLinksFromBackend(env, promise);\n});\n\n", _jsx(_components.span, {
          className: "hljs-type",
          children: "RuntimeWiring"
        }), " ", _jsx(_components.span, {
          className: "hljs-variable",
          children: "runtimeWiring"
        }), " ", _jsx(_components.span, {
          className: "hljs-operator",
          children: "="
        }), " RuntimeWiring.newRuntimeWiring()\n  .type(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"Query\""
        }), ", builder -> builder.dataFetcher(", _jsx(_components.span, {
          className: "hljs-string",
          children: "\"allLinks\""
        }), ", dataFetcher))\n  .build();\n"]
      })
    }), "\n", _jsx(_components.p, {
      children: "This method re­quired to wrap every data fetcher de­f­i­n­i­tion man­u­ally.\nBe­sides, it was easy to for­get to do it, be­cause any ob­ject is a valid data fetcher re­sult.\nCon­se­quently, the com­piler wouldn’t com­plain."
    }), "\n", _jsx(_components.p, {
      children: "Using GraphQL-​Java in­stru­men­ta­tion, in 4.4 it is pos­si­ble to wrap data fetch­ers au­to­mat­i­cally."
    }), "\n", _jsx(_components.p, {
      children: "First, de­clare the in­stru­men­ta­tion while con­fig­ur­ing GraphQL-​Java."
    }), "\n", _jsx(_components.pre, {
      children: _jsx(_components.code, {
        className: "hljs language-java",
        children: "graphQLBuilder.instrumentation(VertxFutureAdapter.create());\n"
      })
    }), "\n", _jsx(_components.p, {
      children: "Then you can re­turn Vert.x fu­tures di­rectly."
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["DataFetcher<Future<List<Link>>> dataFetcher = environment -> {\n  Future<List<Link>> future = retrieveLinksFromBackend(environment);\n  ", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "return"
        }), " future;\n};\n"]
      })
    }), "\n", _jsxs(_components.p, {
      children: ["Note that sim­i­lar func­tion­nal­ity is pro­vided for data fetch­ers re­turn­ing Rx­Java3’s ", _jsx(_components.code, {
        children: "Single"
      }), " or ", _jsx(_components.code, {
        children: "Maybe"
      }), ".\nLearn more about this in the ", _jsx(Link, {
        href: "/docs/vertx-web-graphql/java/#_working_with_vert_x_rxified_apis",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: _jsx(_components.em, {
            children: "work­ing with Vert.x Rx­i­fied APIs"
          })
        })
      }), " sec­tion of the doc­u­men­ta­tion."]
    }), "\n", _jsxs(_components.h3, {
      id: "json-data-results",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#json-data-results"
      }), "JSON data results"]
    }), "\n", _jsxs(_components.p, {
      children: ["The de­fault GraphQL-​Java data fetcher is the ", _jsx(_components.code, {
        children: "PropertyDataFetcher"
      }), ".\nIt is able to read the fields of your do­main ob­jects with­out fur­ther con­fig­u­ra­tion."]
    }), "\n", _jsxs(_components.p, {
      children: ["Nev­er­the­less, in Vert.x ap­pli­ca­tions it is com­mon to work with ", _jsx(_components.code, {
        children: "JsonArray"
      }), " and ", _jsx(_components.code, {
        children: "JsonObject"
      }), ".\nThe ", _jsx(_components.code, {
        children: "PropertyDataFetcher"
      }), " can read the items in a JsonAr­ray out of the box, but not the fields of a ", _jsx(_components.code, {
        children: "JsonObject"
      }), "…"]
    }), "\n", _jsxs(_components.p, {
      children: ["If your project de­pends on GraphQL-​Java 20 (the de­fault in Vert.x 4.4), con­fig­ure GraphQL-​Java with the ", _jsx(_components.code, {
        children: "JsonObjectAdapter"
      }), " in­stru­men­ta­tion."]
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["graphQLBuilder.instrumentation(", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "new"
        }), " ", _jsx(_components.span, {
          className: "hljs-title class_",
          children: "JsonObjectAdapter"
        }), "());\n"]
      })
    }), "\n", _jsxs(_components.h2, {
      id: "support-of-apollos-automatic-persisted-queries-apq",
      children: [_jsx(_components.a, {
        "aria-hidden": true,
        tabIndex: "-1",
        className: "heading-anchor",
        href: "#support-of-apollos-automatic-persisted-queries-apq"
      }), "Support of Apollo’s Automatic Persisted Queries (APQ)"]
    }), "\n", _jsxs(_components.p, {
      children: ["Apollo’s Au­to­matic Per­sisted Queries (", _jsx(_components.a, {
        href: "https://www.apollographql.com/docs/apollo-server/performance/apq/",
        children: "APQ"
      }), ") im­prove net­work per­for­mance for large query strings."]
    }), "\n", _jsxs(_components.p, {
      children: ["Re­cent ver­sions of GraphQL-​Java pro­vide sup­port for ex­e­cu­tion of such queries.\nIn Vert.x 4.4, the trans­port lay­ers (", _jsx(Link, {
        href: "/docs/vertx-web-graphql/java/#_http",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "HTTP"
        })
      }), ", ", _jsx(Link, {
        href: "/docs/vertx-web-graphql/java/#_graphql_over_websocket",
        passHref: true,
        children: _jsx(_components.a, {
          href: "",
          children: "GraphQLWS"
        })
      }), ") are also ready to re­ceive them."]
    }), "\n", _jsx(_components.p, {
      children: "This re­quires to con­fig­ure GraphQL-​Java with a spe­cific preparsed doc­u­ment Provider:"
    }), "\n", _jsx(_components.pre, {
      children: _jsxs(_components.code, {
        className: "hljs language-java",
        children: ["graphQLBuilder.preparsedDocumentProvider(", _jsx(_components.span, {
          className: "hljs-keyword",
          children: "new"
        }), " ", _jsx(_components.span, {
          className: "hljs-title class_",
          children: "ApolloPersistedQuerySupport"
        }), "(inMemoryPersistedQueryCache));\n"]
      })
    }), "\n", _jsxs(_components.p, {
      children: ["GraphQL-​Java comes with a sim­ple ", _jsx(_components.code, {
        children: "InMemoryPersistedQueryCache"
      }), ", but you could pro­vide your own (using, for ex­am­ple, the ", _jsx(_components.a, {
        href: "https://how-to.vertx.io/async-loading-cache-caffeine-howto/",
        children: "Caf­feine"
      }), " high per­for­mance caching li­brary)."]
    })]
  });
}
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

Improvements to the GraphQL-Java integration

Next post

Eclipse Vert.x 4.4.1 released!

Previous post

Eclipse Vert.x 4.4.0 released!

Blog

Improvements to the GraphQL-Java integration

Next post

Eclipse Vert.x 4.4.1 released!

Previous post

Eclipse Vert.x 4.4.0 released!

Related posts

Eclipse Vert.x meets GraphQL

Unit and Integration Tests

Centralized logging for Vert.x applications using the ELK stack