漏洞赏金猎人笔记-GraphQL-II-阿里云开发者社区

漏洞赏金猎人笔记-GraphQL-II

2022-12-13 197

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 上一节我们学习了GraphQL的一些基础知识,本文继续深入研究,从对比的角度来切入,方便读者理解.Mutation在GraphQL中,只有两种类型的操作,就是queries 和 mutations.如果说query类似于REST中的GET操作,那么Mutation就好比REST中的DELETE, PUT,PATCH方法,笔者用一句简单的话来概括一下:query用来查询服务端的数据,而mutation用来修改服务端的数据

前言

上一节我们学习了GraphQL的一些基础知识,本文继续深入研究,从对比的角度来切入,方便读者理解.

Mutation

在GraphQL中,只有两种类型的操作,就是queries 和 mutations.

如果说query类似于REST中的GET操作,那么Mutation就好比REST中的DELETE, PUT,PATCH方法,笔者用一句简单的话来概括一下:

query用来查询服务端的数据,而mutation用来修改服务端的数据

Mutation例子

假设有个宠物店的应用采用了GraphQL API。

获取所有宠物的query可能如下:

query GetAllPets {
  pets {
    name
    petType
  }
}

添加新宠物的mutation开起来是这样的:

# String! ---> !表示这个变量是必须的
mutation AddNewPet ($name: String!, $petType: PetType) {
  addPet(name: $name, petType: $petType) {
    id
    name
    petType
  }
}

AddNewPet mutation预期得到name和petType变量的值,其请求的数据类似下面这样:

{
  "name": "Rover",
  "petType": "DOG"
}

mutation的响应中有类似下面这样的数据:

{
  "data": {
    "addPet": {
      "id": 1
      "name": "Wang Cai",
      "petType": "DOG"
    }
  }
}

mutation和query对比

相同点(类似点)

Mutation和query的结构看起来非常类似,GraphQL操作结构一般如下所示:

不同点

mutation和query之间的一个真正区别是操作类型,query用于查询,mutation用于增/删/改数据

另外一个注意点:

在AddNewPet示例中，mutation的名称是addPet.

# String! ---> !表示这个变量是必须的
mutation AddNewPet ($name: String!, $petType: PetType) {
  addPet(name: $name, petType: $petType) {
    id
    name
    petType
  }
}

这意味着在 GraphQL API 类型定义中，有这么一个字段，如下所示：

type Mutation {
  addPet (name: String!, petType: PetType): AddPetResult!
}

服务器端配置

来看一个例子,使用了一个能够和petsAPI数据源(data source)进行的连接来添加一个新的宠物。

#这里是一个异步操作
const resolvers = {
  ...
  Mutation: {
    addPet: async (root, args, context) => {
      const { name, petType } = args;
      const newPet = await context.dataSources.petsAPI.addPet({ name, petType })
      return {
        id: newPet.id,
        name,
        petType
      }
    }
  }
};