如何以编程方式读取 Java 中 GraphQL 查询的模式？

java

2024-05-25 19:19:10

获取 GraphQL 模式概述

在构建依赖于 GraphQL 的应用程序时，了解如何以编程方式读取和解析 GraphQL 模式的细节至关重要。这不仅有助于设计更有效的查询，还能使客户端代码更加灵活，适应服务器端的变更。

读取 GraphQL 模式的步骤

要实现这一目标，开发者可以使用 Java 中的 GraphQL 库来获取模式信息。以下是几个主要的方法：

通过 HTTP 请求访问 GraphQL 服务
使用 HTTP GET 或 POST 请求访问 GraphQL 服务，并以查询请求的形式发送 __schema 查询。
解析返回的数据并提取模式
将接收到的 JSON 响应转换为对象，从而可以访问和操作 GraphQL 模式的各个部分。

示例：使用 OkHttp 和 Gson 解析 GraphQL 模式

以下示例展示了如何使用 Java 的 OkHttp 库发送 HTTP 请求，并利用 Gson 来解析返回的 GraphQL 模式数据。这个例子假设目标服务已正确配置并响应 __schema 查询请求。

步骤 1: 添加依赖
确保在项目中添加了必要的依赖项，如 OkHttp 和 Gson：

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.0</version>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.6</version>
</dependency>

步骤 2: 发送查询请求
通过 OkHttp 创建一个 HTTP 客户端，发送包含 __schema 查询的 POST 请求。

import okhttp3.*;

public class GraphQLSchemaFetcher {

    private static final MediaType JSON = MediaType.get("application/json; charset=utf-8");

    public String fetchGraphQLSchema(String url) throws Exception {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = RequestBody.create("{\"query\": \"{ __schema { types { name } } } }", JSON);
        Request request = new Request.Builder()
                .url(url)
                .post(body)
                .build();

        try (Response response = client.newCall(request).execute()) {
            return response.body().string();
        }
    }
}

步骤 3: 解析响应
使用 Gson 将 JSON 响应转换为 Java 对象。

import com.google.gson.Gson;
import java.util.List;

public class SchemaParser {

    public List<String> parseSchema(String json) {
        Gson gson = new Gson();
        SchemaResponse response = gson.fromJson(json, SchemaResponse.class);
        return response.getData().getSchema().getTypes().stream()
                .map(Type::getName)
                .collect(Collectors.toList());
    }
}

class Data {
    private Schema schema;

    public Schema getSchema() {
        return schema;
    }
}

class Schema {
    List<Type> types = new ArrayList<>();

    public List<Type> getTypes() {
        return types;
    }
}

class Type {
    String name;

    public String getName() {
        return name;
    }
}

class SchemaResponse {
    private Data data;

    public Data getData() {
        return data;
    }
}