超音速 启动

MicroProfile GraphQL现在包含在刚发布的Quarkus 1.5.0版本中。

现在，您可以使用code.quarkus.io开始使用Quarkus，并包括SmallRye GraphQL Extension 。

这将创建一个具有以下依赖关系的Quarkus启动器应用程序：

<dependency><groupId>io.quarkus</groupId><artifactId>quarkus-resteasy</artifactId></dependency><dependency><groupId>io.quarkus</groupId><artifactId>quarkus-junit5</artifactId><scope>test</scope></dependency><dependency><groupId>io.rest-assured</groupId><artifactId>rest-assured</artifactId><scope>test</scope></dependency><dependency><groupId>io.quarkus</groupId><artifactId>quarkus-smallrye-graphql</artifactId></dependency>

注意：目前，创建的示例应用程序是一个JAX-RS应用程序。 允许扩展定义自定义示例应用程序的工作正在进行中，但是直到那时，我们始终会得到一个JAX-RS应用程序。 您可以删除quarkus-resteasy依赖项，因为我们不需要JAX-RS。

您的第一个GraphQL端点。

让我们将ExampleResource Rest服务更改为GraphQL端点。

1. 用@GraphQLApi替换@Path("/hello")类注释。
2. 更换@GET与方法的注释@Query 。
3. 删除@Produces(MediaType.TEXT_PLAIN)方法注释和所有JAX-RS导入。

这就对了！ 您的ExampleResource现在应该如下所示：

 package org.acme;  import org.eclipse.microprofile.graphql.GraphQLApi;  import org.eclipse.microprofile.graphql.Query;  @GraphQLApi  public class ExampleResource { @Query public String hello() { return "hello" ; }  } 

现在，您可以使用Quarkus dev模式运行该应用程序：

 mvn quarkus:dev 

现在浏览到localhost：8080 / graphql-ui /并运行以下查询：

 { hello  } 

这将返回：

 { "data" : { "hello" : "hello" }  } 

另请参阅《 Quarkus GraphQL指南》

更详细的例子

让我们看一个更详细的示例，从该GitHub项目获取源代码

这是一个多模块应用程序。 首先编译所有模块。 在根中：

 mvn clean install 

现在浏览到quarkus示例：

 cd quarkus-example 

看ProfileGraphQLApi.java被标记为@GraphQLApi ：

 @Query ( "person" ) public Person getPerson( @Name ( "personId" ) int personId){ return personDB.getPerson(personId); } 

上面的方法将通过personId获取一个人。 如您所见，该方法可通过@Query注释进行查询。 您可以选择提供名称（在这种情况下为“ person”），但是默认情况下仍为“ person”（方法名称不带“ get”）。 您还可以选择命名参数，但默认名称为参数名称（“ personId”）。

人员对象是一个POJO，代表系统中的人员（用户或成员）。 它具有许多字段，其中一些是其他复杂的POJO：

但是，使用Query批注可以查询我们感兴趣的确切字段。

运行示例应用程序：

 mvn quarkus:dev 

现在浏览到localhost：8080 / graphql-ui /并运行以下查询：

 { person(personId: 1 ){ names surname scores{ name value } }  } 

请注意，您在编辑器中拥有“代码洞察力”。 这是因为GraphQL具有架构并且还支持自省。

我们只能请求我们感兴趣的字段，从而使有效负载小得多。

我们还可以组合查询，即，假设我们要获得人员1的字段，如上所示，以及人员2的名称和姓氏，我们可以执行以下操作：

 { person1: person(personId: 1 ){ names surname scores{ name value } } person2: person(personId: 2 ){ names surname }  } 

这将返回：

 { "data" : { "person1" : { "names" : [ "Christine" , "Fabian" ], "surname" : "O'Reilly" , "scores" : [ { "name" : "Driving" , "value" : 15 }, { "name" : "Fitness" , "value" : 94 }, { "name" : "Activity" , "value" : 63 }, { "name" : "Financial" , "value" : 22 } ] }, "person2" : { "names" : [ "Masako" , "Errol" ], "surname" : "Zemlak" } }  } 

源字段

如果仔细查看我们的查询，您会看到我们要求提供人员的scores字段，但是， Person POJO不包含scores字段。 我们通过向人员添加@Source字段来添加scores字段：

 @Query ( "person" ) public Person getPerson( @Name ( "personId" ) int personId){ return personDB.getPerson(personId); } public List<Score> getScores( @Source Person person) { return scoreDB.getScores(person.getIdNumber()); } 

因此，我们可以通过添加与响应类型匹配的@Source参数来添加合并到输出中的字段。

部分结果

上面的示例合并了两个不同的数据源，但是比分系统下降了。 然后，我们仍将返回我们拥有的数据以及分数的错误：

 { "errors" : [ { "message" : "Scores for person [797-95-4822] is not available" , "locations" : [ { "line" : 5 , "column" : 5 } ], "path" : [ "person" , "scores2" ], "extensions" : { "exception" : "com.github.phillipkruger.user.graphql.ScoresNotAvailableException" , "classification" : "DataFetchingException" } } ], "data" : { "person" : { "names" : [ "Christine" , "Fabian" ], "surname" : "O'Reilly" , "scores2" : null } }  } 

纯模式

让我们以纯模式运行此示例（使用graalvm-ce-java11-19.3.2）：

 mvn -Pnative clean install 

这将创建一个本机可执行文件，现在将很快启动该应用程序：

 ./target/quarkus-example- 1.0 . 0 -SNAPSHOT-runner 

在管线中

这是MicroProfile GraphQL Spec的第一个版本，管线中有很多东西。 其中之一是客户。 我们建议两种类型的客户：

动态

动态客户端将允许您使用构建器来构建查询：

 // Building of the graphql document.  Document myDocument = document( operation(Operation.Type.QUERY, field( "people" , field( "id" ), field( "name" ) )));  // Serialization of the document into a string, ready to be sent.  String graphqlRequest = myDocument.toString(); 

有关更多详细信息，请参见： github.com/worldline/dynaql

输入安全

类型安全的客户端将更接近MicroProfile RESTClient。 查看与上述相同的示例，让我们看看如何使用它。 从项目的根目录，浏览到quarkus-client文件夹。 本示例使用Quarkus命令模式进行查询。

客户端还不是Quarkus扩展，因此我们将其添加到我们的项目中，如下所示：

 <dependency> <groupId>io.smallrye</groupId> <artifactId>smallrye-graphql-client</artifactId> <version>${smallrye-graphql.version}</version>  </dependency> 

现在，我们可以创建一个POJO，该POJO仅包含我们感兴趣的字段。在客户端模块中查看Person和Score ，它比服务器端的定义小得多：

现在我们需要做的就是添加一个接口，该接口定义我们感兴趣的查询：

 @GraphQlClientApi  public interface PersonGraphQLClient { public Person person( int personId);  } 

现在我们可以使用：

 //@Inject //PersonGraphQLClient personClient; or PersonGraphQLClient personClient = GraphQlClientBuilder.newBuilder().build(PersonGraphQLClient. class ); // ... Person person = personClient.person(id); 

运行Quarkus客户端应用程序，我们现在可以调用服务器（确保它仍在运行）并打印响应：

 java -jar target/quarkus-client- 1.0 . 0 -SNAPSHOT-runner.jar 2 

在我们的示例中，数字（2）是personId ：

摘要

这是MicroProfile GraphQL的简短介绍，现在Quarkus中可以使用。 还有更多功能 ，甚至还有更多计划 ，请继续关注。

翻译自: https://www.javacodegeeks.com/2020/06/supersonic-subatomic-graphql.html

超音速 启动