GraphQL - 解析器

解析器是一组为 GraphQL 查询生成响应的函数。简单来说，解析器充当 GraphQL 查询处理程序。GraphQL 模式中的每个解析器函数都接受四个位置参数，如下所示 −

fieldName:(root, args, context, info) => { result }

解析器函数的示例如下所示 −

//没有参数并返回字符串的解析器函数
greeting:() => {
return "hello from TutorialsPoint !!!"
}

//没有参数并返回列表的解析器函数
students:() =>; db.students.list()

//带有参数并返回对象的解析器函数
studentById:(root,args,context,info) => {
    return db.students.get(args.id);
}

下面给出了位置参数及其描述 −

解析器结果格式

GraphQL 中的解析器可以返回不同类型的值，如下所示 −

插图

让我们创建一个简单的应用程序来了解解析器。这将创建从服务器按 ID 查询学生的架构。学生数据将存储在平面文件中，我们将使用名为 notarealdb 的节点模块来伪造数据库并从平面文件中读取。

以下是创建简单应用程序的分步过程 −

步骤 1 − 下载并安装项目所需的依赖项

创建一个名为 resolver-app 的文件夹。从终端将目录更改为 resolver-app。稍后，按照环境设置章节中的步骤 3 到 5 进行操作。

步骤 2 − 创建 Schema

在项目文件夹 resolver-app 中添加 schema.graphql 文件，并添加以下代码 −

type Query { 
   greeting:String
   students:[Student]
   studentById(id:ID!):Student 
}

type Student {
   id:ID!
   firstName:String
   lastName:String
   password:String
   collegeId:String
}

架构文件显示用户可以查询 greeting、students 和 studentById。要检索具有特定 ID 的学生，我们使用 数据类型 ID!，它显示一个不可为空的唯一标识符字段。students 字段返回学生数组，greeting 返回一个简单的字符串值。

步骤 3 − 创建解析器

在项目文件夹中创建一个文件 resolvers.js 并添加以下代码 −

const db = require('./db')
const Query = {
    //Greeting 的解析函数
    Greeting:() => {
    return "hello from TutorialsPoint !!!"
    },
    
    //students 解析函数返回列表
    students:() => db.students.list(),
    
    //studentbyId 解析器函数
   studentById:(root,args,context,info) => {
      //args will contain parameter passed in query
      return db.students.get(args.id);
   }
}
module.exports = {Query}

此处，studentById 包含三个参数。如本章所述，studentId 可以从 args 中检索；root 将包含查询对象本身。要返回特定学生，我们需要使用 students 集合中的 id 参数调用 get 方法。

此处 greeting、students、studentById 是处理查询的解析器。students 解析器函数 从数据访问层返回学生列表。要访问模块外部的解析器函数，必须使用 module.exports 导出查询对象。

步骤 4 − 运行应用程序

创建 server.js 文件。请参阅环境设置章节中的步骤 8。在终端中执行命令 npm start。服务器将在 9000 端口上启动并运行。这里我们使用 GraphiQL 作为客户端来测试应用程序。

打开浏览器并输入网址 http://localhost:9000/graphiql。在编辑器中输入以下查询 −

{  
   studentById(id:"S1001") {
      id
      firstName
      lastName
   }
}

上述查询的输出如下所示 −

{
   "data": {
      "studentById": {
         "id": "S1001",
         "firstName": "Mohtashim",
         "lastName": "Mohammad"
      }
   }
}