如何使用GraphQL，Koa和MongoDB设置功能强大的API（二）

想mutationsPOST或PUTREST动作。设置mutations非常简单。

将记录添加到我们的数据库

创建一个文件 graphql/mutations.js

在文件中我们将放置mutations。

const { GraphQLObjectType, GraphQLObjectType } = require('graphql');
const gadgetGraphQLType =  require('./gadgetType');
const Gadget = require('./../models/gadget');

const Mutation = new GraphQLObjectType({
  name: 'Mutation',
  fields: {


  }
})

module.exports = Mutation;

我们需要从GraphQL库中导入GraphQLObjectType和GraphQLObjectTypeObjects。
导入GraphQL类型 gadget
导入gadgetmongoose模型。

导入我们需要的东西后，我们可以继续创建方法。

mutations只是GraphQLObjectType像我们之前的查询一样简单。它有两个我们感兴趣的主要属性。

name
fields

mutations的名称出现在graphiql文档中。

Fields是我们可以放置文档操作逻辑的地方。

const Mutation = new GraphQLObjectType({
  name: 'Mutation',
  fields: {
    addGadget: {
      // add props here
    }
  }
})

注意我在fields对象中添加了一个新对象。它被称为addGadget 它将完全按照它所说的做。

里面addGadget我们有机会获得三个属性，type，args，和resolve()。

const Mutation = new GraphQLObjectType({
  name: 'Mutation',
  fields: {
    addGadget: {
      type: gadgetGraphQLType,
    }
  }
})

该addGadget类型会gadgetGraphQLType。args只能具有gadgetGraphQLType我们之前声明的类型中允许的属性。

Addgadget是接受参数的查询。需要参数来指定我们要添加到数据库的args。

const Mutation = new GraphQLObjectType({
  name: 'Mutation',
  fields: {
    addGadget: {
      type: gadgetGraphQLType,
      args: {
        name: { type: GraphQLString },
        release_date: { type: GraphQLString },
        by_company: { type: GraphQLString },
        price: { type: GraphQLString }
      },
    }
  }
})

我们预先声明查询接受哪些参数以及参数的类型。

最后 - 查询会发生什么？这就是为什么我们有这个resolve()功能。

记住这个resolve()函数有两个参数 - parent和args。我们对args这些是我们传递给查询的值感兴趣。

resolve(parent, args) {
  // Create a new mongo record
}

在解决方案中，我们放置了用于创建新mongo记录的逻辑。

const newGadget = new Gadget({
  name: args.name,
  release_date: args.release_date,
  by_company: args.by_company,
  price: args.price,
})

return newGadget.save();

我们创建了一个新的Gadgetmongoose模型实例，将我们从GraphQL接收的道具作为新字段传递，最后保存记录。

这是完整mutations的样子;

graphl/mutations.js

const { GraphQLObjectType, GraphQLString } = require('graphql');
const gadgetGraphQLType =  require('./gadgetType');
const Gadget = require('./../models/gadget');

const Mutation = new GraphQLObjectType({
  name: 'Mutation',
  fields: {
    addGadget: {
      type: gadgetGraphQLType,
      args: {
        name: { type: GraphQLString },
        release_date: { type: GraphQLString },
        by_company: { type: GraphQLString },
        price: { type: GraphQLString }
      },
      resolve(parent, args) {
        const newGadget = new Gadget({
          name: args.name,
          release_date: args.release_date,
          by_company: args.by_company,
          price: args.price,
        })

        return newGadget.save();
      }
    }

  }
})

module.exports = Mutation;

瞧！我们需要做的就是将Mutation导入我们的schema.js文件。

graphl/schema.js

const Mutations = require('./mutations');

module.exports = new GraphQLSchema({
  query: RootQuery,
  mutation: Mutations
});

如果一切顺利，我们应该在graphiql上看到这一点。

15573829102684.jpg

如果我们点击它;

15573829196774.jpg

请注意GraphQL如何自动创建文档。这就是为什么我们有这么强的types。

触发Mutation查询

15573829300265.jpg

Mutation只是一个简单的graphQL查询，它接受我们的参数，将其保存到mongo数据库，并返回我们想要的属性。

这是捕获;

每个mutations都需要标记为 mutation

15573829397873.jpg

我们成功创建了一个新数据并将其插入到我们的mongo数据库中。

如果您前往mlab或您正在使用的任何提供商，您应该看到新记录。

15573829487058.jpg

这是我们mutations的完整查询。

mutation {
  addGadget(name: "MacBook Pro", release_date: "January 10, 2006", by_company: "Apple", price: "2199") {
  name,
  release_date,
  by_company,
  price
  }
}

在数据库中编辑我们的记录

如果我们想要编辑预先存在的记录怎么办？当然，我们不能依赖从不打错字，或者如果价格变化会怎么样。

编辑记录也是一种Mutation。请记住，每次我们想要更改/添加新记录时 - 这都是graphqlMutation！

打开graphql/mutations文件并创建另一个mutations。Mutation只是一个普通的对象。

const Mutation = new GraphQLObjectType({
  name: 'Mutation',
  fields: {
    addGadget: {
      type: gadgetGraphQLType,
      args: {
        name: { type: GraphQLString },
        release_date: { type: GraphQLString },
        by_company: { type: GraphQLString },
        price: { type: GraphQLString }
      },
      resolve(parent, args) {
        const newGadget = new Gadget({
          name: args.name,
          release_date: args.release_date,
          by_company: args.by_company,
          price: args.price,
        })

        return newGadget.save();
      }
    }, // add new mutation
    updateGadget: {
      type: gadgetGraphQLType,
      args: {
        id: { type: GraphQLString },
        name: { type: GraphQLString },
        release_date: { type: GraphQLString },
        by_company: { type: GraphQLString },
        price: { type: GraphQLString }
      },
      resolve(parent, args) {

      }
    }
  }
})

注意新的Mutation叫做updateGadget。它几乎是以前mutations的复制品。关于额外参数的注意事项id- 那是因为我们需要找到现有的记录并进行更改。我们可以通过id找到记录。

该resolve()功能是它变得更有趣的地方。理想情况下，我们希望通过id找到记录，更改并保存它。我们将如何继续这样做？

Mongoose为我们提供了一种方法，称为findById。

resolve(parent, args) {
  return Gadget.findById(args.id)
}

这会返回一个承诺。如果我们使用console.log承诺，我们可以看到附加了大量属性。我们可以用诺言做的就是用then()方法来链接它。如果承诺是陌生人，请查看我写的这篇文章。

resolve(parent, args) {
  return Gadget.findById(args.id)
    .then(gadget => {
      gadget.name = args.name,
      gadget.release_date = args.release_date,
      gadget.by_company = args.by_company,
      gadget.price = args.price

      return gadget.save()
    })
}

像这样; 我们找到记录，改变数据，保存它。但这会带来另一个我们需要解决的承诺。

resolve(parent, args) {
  return Gadget.findById(args.id)
    .then(gadget => {
      gadget.name = args.name,
      gadget.release_date = args.release_date,
      gadget.by_company = args.by_company,
      gadget.price = args.price
      return gadget.save()
    })
    .then(updatedGadget => updatedGadget)
    .catch(err => console.log(err))
}

.catch()对于错误处理，我们遇到错误。请记住，您可以pm2通过pm2 logs命令监视日志。如果遇到错误，这些将记录到pm2记录器。

就这样！查询时间！查看您的mongo表并id从那里随机选择并编辑相应的数据。

15573830470445.jpg

如果我们检查数据库; 我们应该看到编辑过的记录。

15573830533374.jpg

成功！

这是updateGadgetmutations的查询。

[
    mutation {
  updateGadget(
    id: "5c51a8f59121525ff44c41b2", name: "Macbook Pro",
    release_date: "January 10, 2006", by_company: "Apple",
    price: "9999") {
    id
    name
    release_date
    by_company
    price
  }
}
]

好吧，做到这一点的好工作。到目前为止，我们有Create，Read，Update，但我们错过了最后d（elete）。

从mongo数据库中删除记录非常简单。我们所需要的只是另一个mutations，因为事实上我们正在改变数据库。

为了删除记录，Mongoose为我们提供了一个方便的方法findOneAndDelete- 更多关于findOneAndDelete

removeGadget: {
  type: gadgetGraphQLType,
  args: {
    id: { type: GraphQLString }
  },
  resolve(parent, args) {
    return Gadget.findOneAndDelete(args.id).exec()
      .then(gadget => gadget.remove())
      .then(deletedGadget => deletedGadget)
      .catch(err => console.log(err))
  }
}

删除记录只需要一个参数，即id。我们通过ID找到记录，将其删除并返回。如果有错误，我们会记录它。

和查询;

mutation {
  removeGadget(id: "5c51ae117eb446624aad1049") {
    id
    name
    release_date
    by_company
    price
  }
}

注意：确保id数据库中存在正确且存在，否则将无法正常工作。

如果我们前往我们的数据库并检查它 - 实际上记录已从我们的数据库中删除。

干得好，我们已经实现了基本CRUD功能。请注意GraphQL是如何在我们的数据库和视图之间的薄层。它不应该替换数据库，而是更容易处理数据，获取和操作。

其他章节

如何使用GraphQL，Koa和MongoDB设置功能强大的API（一）
如何使用GraphQL，Koa和MongoDB设置功能强大的API（二）
如何使用GraphQL，Koa和MongoDB设置功能强大的API（三）