GraphQL 是一种新型的数据查询语言，它可以帮助我们更高效地请求和获取数据。与传统的 REST API 相比，GraphQL 更加灵活，可以满足各种不同的数据需求，并且可以一次性获取多个资源，降低了网络请求的次数。GraphQL 中的输入类型是一种非常重要的概念，本文将详细介绍 GraphQL 中的输入类型及其用法。
什么是输入类型
在 GraphQL 中，输入类型用来表示客户端向服务器提交的数据的结构。通常情况下，输入类型用来在 GraphQL 的 mutation 操作中表示函数的参数。它们与普通的 GraphQL 类型非常类似，但有一些关键的区别。例如，输入类型不能包含复杂的字段，例如对象、列表或联合类型等。这是因为 GraphQL 的输入类型必须是可序列化的，以便能够在网络上传输。
如何定义输入类型
要定义一个输入类型，我们需要在 GraphQL schema 中使用 input 关键字。例如，我们可以定义一个简单的输入类型来表示用户的基本信息：
input UserInput {
name: String!
email: String!
password: String!
}这个输入类型包含了三个字段：名字、邮箱和密码。这些字段都是必填的，并且都是字符串类型。
使用输入类型
一旦我们完成了输入类型的定义，我们就可以在 mutation 操作中使用它。例如，我们可以创建一个名为 createUser 的 mutation 操作，它将接受一个 UserInput 类型的参数，并将新用户添加到数据库中。下面是一个示例：
type Mutation {
createUser(input: UserInput!): User!
}在这个示例中，我们定义了一个名为 createUser 的 mutation 操作。它接受一个 UserInput 类型的参数，并将这个参数映射到我们指定的 createUser 函数的参数中。函数返回一个 User 类型的对象，表示新创建的用户。
输入类型的优点
使用 GraphQL 的输入类型可以带来许多好处。首先，它们可以帮助我们更加清晰地表达数据结构，并保证参数的一致性和可验证性。其次，它们可以简化代码，因为参数的处理和验证已经由 GraphQL 处理了。最后，它们可以提高代码的可维护性，因为只需要在 schema 中定义一次数据类型，这样就可以在整个应用程序中使用该类型了。
示例代码
下面是一个完整的示例代码，它演示了如何在 GraphQL 中定义和使用输入类型。
-- -------------------- ---- ------- ---- ---- - --- --- ----- ------- ------ ------- --------- ------- - ----- --------- - ----- ------- ------ ------- --------- ------- - ---- -------- - ----------------- ------------ ----- - ------ - --------- -------- -
这个示例定义了一个名为 User 的类型，代表用户的基本信息。它还定义了一个名为 UserInput 的输入类型，表示用户信息的输入。最后，它定义了一个名为 createUser 的 mutation 操作，该操作接受 UserInput 类型的参数，并返回 User 类型的对象。
在本示例中，我们还定义了一个 schema，它将 Mutation 操作公开给客户端。当客户端向 GraphQL API 发送请求时，它可以使用 createUser 操作来创建新用户。
总结
GraphQL 的输入类型是一种非常有用的概念，它可以帮助我们更好地管理和验证数据。通过使用输入类型，我们可以更好地将关注点分离，提高代码的可维护性。在实际项目中，我们可以定义各种不同的输入类型，以适应不同的业务需求。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64609bd1968c7c53b0244e30