GraphQL“不能为不可为空返回 null”[重复]

Facebook

GraphQL是一种用于API开发的查询语言，它的一项特性是“不能为不可为空返回null”。这意味着，当我们向GraphQL API发送查询请求时，我们可以明确告诉API我们所需要的数据，并确保API返回的数据符合我们的期望。在这篇文章中，我们将详细探讨这个特性，并通过案例代码来说明它的用法。

什么是GraphQL

GraphQL是由Facebook于2015年开发的一种查询语言。它提供了一种灵活且高效的方式来定义和查询API中的数据。与传统的RESTful API相比，GraphQL允许客户端精确地指定需要的数据结构和字段，从而减少了网络传输的数据量和次数。这使得GraphQL成为构建现代应用程序所需的强大工具。

GraphQL的“不能为不可为空返回null”特性

在GraphQL中，每个字段都有一个类型，并且可以是可空或非可空的。当我们在查询中请求一个字段时，我们可以通过在字段名称后面添加一个感叹号来指定该字段为非可空。这意味着API在返回响应时，必须提供该字段的值，否则将返回一个错误。

这个特性的好处是，我们可以在编译时就能够知道API的响应数据是否符合我们的期望。如果API返回的数据缺少了我们所需的非可空字段，我们可以立即发现并解决这个问题，而不是在运行时才发现错误。

案例代码

为了更好地理解“不能为不可为空返回null”的特性，让我们来看一个简单的例子。假设我们有一个图书馆的GraphQL API，我们可以使用GraphQL来查询图书馆中的书籍信息。

首先，我们定义一个查询类型Query，其中包含一个查询字段book，用于查询一本书的详细信息。这个字段返回一个Book类型的对象。

graphql
type Query {
  book(id: ID!): Book!
}
type Book {
  id: ID!
  title: String!
  author: String!
  publicationYear: Int!
}

在上面的代码中，我们可以看到Book类型的字段id、title、author和publicationYear都被标记为非可空。

接下来，我们实现这个查询字段的解析逻辑。假设我们的图书馆中有一本id为"1"的书籍。

Javascript
const resolvers = {
  Query: {
    book: (parent, { id }) => {
      // 根据id查询书籍信息
      const book = fetchBookById(id);
      // 如果找不到对应的书籍，抛出错误
      if (!book) {
        throw new Error(<code>Book with id ${id} not found</code>);
      }
      return book;
    },
  },
};

在上面的代码中，我们首先根据传入的id查询书籍信息。如果找不到对应的书籍，我们抛出一个错误。这样，无论何时我们查询一本书的详细信息时，API都会返回一个非空的Book对象。

使用非可空字段的优势

通过使用非可空字段，我们可以在编译时就能发现潜在的错误，从而提高开发效率。当我们定义了一个GraphQL查询时，我们可以明确告诉API我们所需要的非可空字段，以及它们的类型。这样，我们可以更好地理解API的响应数据，并且可以更好地处理错误情况。

此外，使用非可空字段还可以提高客户端的性能。由于API只返回我们所需的数据，我们可以减少网络传输的数据量和次数。这对于移动设备和网络条件较差的环境来说尤为重要。

GraphQL的“不能为不可为空返回null”特性是一项强大且实用的功能。通过在查询中使用非可空字段，我们可以在编译时就能够检测到潜在的错误，并提高开发效率。此外，使用非可空字段还可以减少网络传输的数据量和次数，提高客户端性能。

在实际开发中，我们应该合理使用非可空字段，并确保API返回的数据符合我们的期望。这将有助于构建健壮、高效的应用程序。

参考代码

graphql
type Query {
  book(id: ID!): Book!
}
type Book {
  id: ID!
  title: String!
  author: String!
  publicationYear: Int!
}

Javascript
const resolvers = {
  Query: {
    book: (parent, { id }) => {
      const book = fetchBookById(id);
      if (!book) {
        throw new Error(<code>Book with id ${id} not found</code>);
      }
      return book;
    },
  },
};

通过以上案例代码，我们可以更好地理解并应用GraphQL的“不能为不可为空返回null”特性。这将帮助我们构建更可靠、高效的API，并为我们的应用程序提供更好的用户体验。