Mutations #Facebook Relay文档翻译#

原文地址

上一篇 Connection

Relay文档翻译目录

Relay uses a common pattern for mutations, where they are root fields on the

mutation type with a single argument,

input

, and where the input and output

both contain a client mutation identifier used to reconcile requests and

responses.

Relay使用通用模式来处理mutation，定义为mutation type带有一个参数input的根字段，这里的输入输出都包含客户端mutation标识符用于撮合请求与响应。

By convention, mutations are named as verbs, their inputs are the name with

“Input” appended at the end, and they return an object that is the name with

“Payload” appended.

按照约定，mutation的名字用动词，他们的输入名字以’Input’结尾，返回的对象的名字以’Payload’结尾。

So for our

introduceShip

mutation, we create two types:

IntroduceShipInput

and

IntroduceShipPayload

:

input IntroduceShipInput {
factionId: ID!
shipName: String!
clientMutationId: String!
}

type IntroduceShipPayload {
faction: Faction
ship: Ship
clientMutationId: String!
}

With this input and payload, we can issue the following mutation:

mutation AddBWingQuery($input: IntroduceShipInput!) {
introduceShip(input: $input) {
ship {
id
name
}
faction {
name
}
clientMutationId
}
}

with these params:

{
"input": {
"shipName": "B-Wing",
"factionId": "1",
"clientMutationId": "abcde"
}
}

and we’ll get this result:

{
"introduceShip": {
"ship": {
"id": "U2hpcDo5",
"name": "B-Wing"
},
"faction": {
"name": "Alliance to Restore the Republic"
},
"clientMutationId": "abcde"
}
}

Complete details on how the server should behave are

available in the GraphQL Input Object Mutations

spec.

服务器端应该如何处理的详细说明请见GraphQL Input Object Mutations

spec.