В GraphQL есть два основных типа операций: запросы и изменения. Хотя запросы хорошо описаны в документации и есть много их примеров, мне трудно понять, как выполнить мутацию. Очевидно, что мутации - это методы обновления.
Я создал очень простой сервер Node.js:
var express = require("express");
var graphqlHTTP = require("express-graphql");
var graphql = require("graphql");
var inMemoryDatabase = require("./inMemoryDatabase").inMemoryDatabase;
var _ = require("lodash-node");
var userType = new graphql.GraphQLObjectType({
name: "User",
fields: {
id: { type: graphql.GraphQLString },
name: { type: graphql.GraphQLString }
}
});
var queryType = new graphql.GraphQLObjectType({
name: "Query",
fields: {
user: {
type: userType,
args: {
id: { type: graphql.GraphQLString }
},
resolve: function(parent, { id }) {
return _.find(inMemoryDatabase, { id: id });
}
}
}
});
var mutationType = new graphql.GraphQLObjectType({
name: "Mutation",
fields: {
user: {
type: userType,
args: {
id: { type: graphql.GraphQLString },
name: { type: graphql.GraphQLString }
},
resolve: function(parent, { id, name }) {
var index = _.findIndex(inMemoryDatabase, { id: id });
inMemoryDatabase.splice(index, 1, { id: id, name: name });
return _.find(inMemoryDatabase, { id: id });
}
}
}
});
var schema = new graphql.GraphQLSchema({
query: queryType,
mutation: mutationType
});
var app = express();
app.use(
"/graphql",
graphqlHTTP({
schema: schema,
graphiql: true
})
);
var port = 9000;
if (process.env.PORT) {
port = process.env.PORT;
}
app.listen(port);
console.info("Running a GraphQL API server at localhost:" + port + "/graphql");
В памяти база данных находится как раз в массиве объектов User {id, name}:
var inMemoryDatabase = [
{
id: "31ce0260-2c23-4be5-ab78-4a5d1603cbc8",
name: "Mark"
},
{
id: "2fb6fd09-2697-43e2-9404-68c2f1ffbf1b",
name: "Bill"
}
];
module.exports = {
inMemoryDatabase
};
Выполнение запроса на получение пользователя по id выглядит следующим образом:
{
user(id: "31ce0260-2c23-4be5-ab78-4a5d1603cbc8"){
name
}
}
Как будет выглядеть имя пользователя, изменяющее мутацию?





Эй, возможно, ты совсем не понимаешь, о чем ты говоришь, но я смотрю на мутацию так
type мутации.var mutationType = new graphql.GraphQLObjectType({
name: "Mutation",
fields: {
user: {
// You must return something from your resolve function
// that will fulfill userType requirements
type: userType,
// with these arguments, find the user and update them
args: {
id: { type: graphql.GraphQLString },
name: { type: graphql.GraphQLString }
},
// this does the lookup and change of the data
// the last step of your result is to return something
// that will fulfill the userType interface
resolve: function(parent, { id, name }) {
// Find the user, Update it
// return something that will respond to id and name, probably a user object
}
}
}
});Затем, используя это в качестве контекста, вы передаете некоторые аргументы и запрашиваете пользователя
mutation updateUser {
user(id: "1", name: "NewName") {
id
name
}
}
В обычной производственной схеме у вас также обычно есть что-то вроде errors, которое можно вернуть, чтобы передать различные состояния обновления для сбоя / не найденного.
Привет, Дэвид, я думаю, это действительно зависит от того, какой уровень ошибок вы хотите получить. Graphql предоставит базовые вещи, такие как ошибка схемы или недопустимый запрос, но если вам нужны более сложные ошибки, которые были бы эквивалентны вещам, которые вы получаете в состоянии покоя (например, 422 или какое-то конкретное событие сбоя), вы должны вернуть новый тип для этого . Другой конкретный пример - это привязка к структуре проверки, например, в rails ActiveModel :: Validations, чтобы ошибки были «лучше» и удобнее для использования клиентом.
В Ruby я обычно использую graphql-ruby.org/errors/execution_errors.html (который также описывает не зависящий от языка формат ответа на ошибку JSON) для возврата ошибок на уровне поля или мутации.
Ах, мой плохой, обновлено :) Иногда, просто помещая их в graphiql или graphqlplayground, вы заметите опечатки
@ Ответ Аустио был довольно близок, но правильный способ:
mutation updateUser {
user(id: "31ce0260-2c23-4be5-ab78-4a5d1603cbc8", name: "Markus") {
id
name
}
}
GraphQL имеет встроенный отчет об ошибках, и вы обычно возвращаете ошибку поля, если мутация не удалась; он вообще не будет специально закодирован в схеме.