graphql-java（3）如何将数据映射到Java对象类型（DTO）


https://dreamylost.cn/
文档 version = 1.4 仅供参考

How graphql maps object data to types

graphql的核心是声明类型schema并将其映射到支持的运行时数据。

作为类型schema的设计者，要使这些元素在中间相遇是您的挑战。

例如，假设我们想要一个graphql类型的架构，如下所示

1
2
3
4
5
6
7
8
9
10
11
type Query {
    products(match : String) : [Product]
}

type Product {
    id : ID
    name : String
    description : String
    cost : Float
    tax : Float
}

然后，我们可以通过类似于以下内容的简单schema运行查询

1
2
3
4
5
6
query ProductQuery {
    products(match : "Paper*")
    {
        id, name, cost, tax
    }
}

我们将在Query.products字段上有一个DataFetcher，它负责查找与传入的参数匹配的产品列表。

现在想象我们有3个下游服务。一种获取产品信息，一种获取产品成本信息，另一种获取产品税信息。

graphql-java的工作原理是：在对象上运行数据获取程序以获取所有这些信息，并将其映射回schema中指定的类型。

我们的挑战是采用这三种信息来源并将它们呈现为一种统一的类型。

我们可以在进行这些计算的成本和税收字段上指定数据获取程序，但这要维护得多，并且很可能导致N + 1性能问题。

我们最好在Query.products数据提取器中完成所有这些工作，并创建数据的统一视图。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
DataFetcher productsDataFetcher = new DataFetcher() {
    @Override
    public Object get(DataFetchingEnvironment env) {
        String matchArg = env.getArgument("match");

        List<ProductInfo> productInfo = getMatchingProducts(matchArg);

        List<ProductCostInfo> productCostInfo = getProductCosts(productInfo);

        List<ProductTaxInfo> productTaxInfo = getProductTax(productInfo);

        return mapDataTogether(productInfo, productCostInfo, productTaxInfo);
    }
};

因此，查看上面的代码，我们需要对3种信息进行组合，以便上面的graphql查询可以访问字段 id，name，cost，tax。
我们有两种创建此映射的方法。一种是通过使用非类型安全的List

结构，而另一种是通过封装为类型安全的List类。

Map 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
private List<Map> mapDataTogetherViaMap(List<ProductInfo> productInfo, List<ProductCostInfo> productCostInfo, List<ProductTaxInfo> productTaxInfo) {
    List<Map> unifiedView = new ArrayList<>();
    for (int i = 0; i < productInfo.size(); i++) {
        ProductInfo info = productInfo.get(i);
        ProductCostInfo cost = productCostInfo.get(i);
        ProductTaxInfo tax = productTaxInfo.get(i);

        Map<String, Object> objectMap = new HashMap<>();
        objectMap.put("id", info.getId());
        objectMap.put("name", info.getName());
        objectMap.put("description", info.getDescription());
        objectMap.put("cost", cost.getCost());
        objectMap.put("tax", tax.getTax());

        unifiedView.add(objectMap);
    }
    return unifiedView;
}

DTO 示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
class ProductDTO {
    private final String id;
    private final String name;
    private final String description;
    private final Float cost;
    private final Float tax;

    public ProductDTO(String id, String name, String description, Float cost, Float tax) {
        this.id = id;
        this.name = name;
        this.description = description;
        this.cost = cost;
        this.tax = tax;
    }

    public String getId() {
        return id;
    }

    public String getName() {
        return name;
    }

    public String getDescription() {
        return description;
    }

    public Float getCost() {
        return cost;
    }

    public Float getTax() {
        return tax;
    }
}

private List<ProductDTO> mapDataTogetherViaDTO(List<ProductInfo> productInfo, List<ProductCostInfo> productCostInfo, List<ProductTaxInfo> productTaxInfo) {
    List<ProductDTO> unifiedView = new ArrayList<>();
    for (int i = 0; i < productInfo.size(); i++) {
        ProductInfo info = productInfo.get(i);
        ProductCostInfo cost = productCostInfo.get(i);
        ProductTaxInfo tax = productTaxInfo.get(i);

        ProductDTO productDTO = new ProductDTO(
                info.getId(),
                info.getName(),
                info.getDescription(),
                cost.getCost(),
                tax.getTax()
        );
        unifiedView.add(productDTO);
    }
    return unifiedView;
}

graphql引擎现在将使用该对象列表并对其运行查询子字段 id，name，cost，tax。

graphql-java中的默认数据获取程序为graphql.schema.PropertyDataFetcher，它同时具有Map支持和POJO支持。

对于列表中的每个对象，它将查找一个id字段，在Map中通过名称或通过getId()方法找到它，并将其发送回graphql响应中。它会针对该类型的查询中的每个字段执行此操作。

通过在更高级别的数据读取器中创建“统一视图”，您已经在数据的运行时视图和数据的graphql schema视图之间进行了映射。