如何在NodeJs搭建GraphQL service Apollo Server (1)

减肥吧Evan

已于 2024-05-27 10:59:49 修改

阅读量884

点赞数 18

分类专栏： nodejs GarphQL 文章标签： graphql 后端

于 2024-05-22 15:21:13 首次发布

本文链接：https://blog.csdn.net/EvanYYY1/article/details/139112764

版权

nodejs 同时被 2 个专栏收录

3 篇文章 0 订阅

订阅专栏

GarphQL

2 篇文章 0 订阅

订阅专栏

Graphql在国内是真不火,至于原因网上讨论的也蛮多的.就我个人而言.学习成本很高，资料很少.

适合人员：全栈开发.
使用场景: 也是它的优势所查即所得，绝不给你多余没用的数据回来.

0.了解下什么是GraphQl

GraphQL 简介:

GraphQL is a query language for your API, and a server-side runtime for executing queries using a type system you define for your data. GraphQL isn’t tied to any specific database or storage engine and is instead backed by your existing code and data.

总结下:

GraphQl 是一个基于API的查询语言, （语法上支持很多语言如:python, php, js, java...)
可以在服务端运行，而且可以根据定义的数据类型（数据字典）进行查询
GraphQl 不关心你用的什么的db存储

有点懵是吗？比较有意思的就是最后一句:说白了，我不是数据源啊，我不是DB啊. 我是一个查询的API.给我的第一印象就是那要你有何用..... 其实呢，可以理解GraphQl就是一个管理SQL查询的插件，一个Nodejs的Middleware.这样更好点.这也是为什么在国内不是很火的原因.

在来看看都有哪写公司用，这只是一部分

1. 搭建Nodejs + express

这里不占篇幅，可以看我以往的文章有介绍5分钟了解 NodeJS 密码加密 + Token

2.GraphQl 安装

官网:Tools and Libraries | GraphQL找到自己想用的语言然后下面会看到好多好多库....

例如我用js 40+的库...

不过我既然用nodejs，又是做serice端的.就选Apollo Server. 开始安装

npm install @apollo/server graphql

需要注意下，我选的是服务端的库，如果是想在前端使用Qraphql,后期我会补一个前端如何使用.

3.开始使用GraphQl

3.1 创建Graphql service

在项目的根目录下创建src->urils文件，然后创建service.mjs文件

servic.mjs

import { ApolloServer } from "@apollo/server"
import { startStandaloneServer } from "@apollo/server/standalone"
 
const server = new ApolloServer({
  typeDefs,
  resolvers,
})
 
const { url } = await startStandaloneServer(server)
 
console.log(`🚀 Server ready at ${url}`)

3.2编写GraphQL的schema

官网的基本架子, 然后开始补充代码
首先定义我们需要查询字段的名称和类型 ,注意我们返回的数据是一个数组的对象类型，这有TypeScript基础的就很轻松了很像定义接口

const typeDefs = `#graphql
    type Query {
        getUerInfor: [UserInfo]
    }
    type UserInfo {
        msg: String
        name: String
        age: Int
    }
`

接下来设置数据源，因为是demo，直接就写一个demo的数据，后面会有如何链接db配合GraphQl的实际操作

let reArr = [
    {
        id:1,
        msg: `hello world`,
        name: `Evan `,
        age: 18
    },
    {
        id:2,
        msg: `This is demo of the QraphQl`,
        name: ` Learn & executing `,
        age: 20
    }
]

修改下apolloserver函数最终代码:

import {ApolloServer} from '@apollo/server'
import {startStandaloneServer} from '@apollo/server/standalone'

const typeDefs = `#graphql
    type Query {
        getUerInfor: [UserInfo]
    }
    type UserInfo {
        msg: String
        name: String
        age: Int
    }
`
let reArr = [
    {
        msg: `hello world`,
        name: `Evan `,
        age: 18
    },
    {
        msg: `This is demo of the QraphQl`,
        name: ` Learn & executing `,
        age: 20
    }
]

const resolvers = {
    Query: {
        getUerInfor:()=> reArr
    }
}

const server = new ApolloServer({
    typeDefs,
    resolvers,
});
const {url} = await startStandaloneServer(server);
console.log("********************************")
console.log(`GraphQl Server started at ${url}`)
console.log("********************************")

3.3 挂载nodejs服务

GraphQl有个自带的ui调试server.开发的阶段还是很有用的，所以在开发阶段我习惯在nodejs同时挂载两个服务。一个Nodejs的项目服务一个GraphQL的调试server.这里需要安装一个插件concurrently.

npm i concurrently

修改package.json的script

  "scripts": {
    "start": "node ./bin/www",
    "dev": "nodemon ./bin/www",
    "service": "concurrently \"nodemon ./bin/www\" \"nodemon ./src/utils/service.mjs\""
  },

运行