graphql

GraphQL 是一种用于 API 的查询语言

特点：

1. 请求 需要的数据 即可，不多不少
   例如：account中有name, age, sex等，可以只取得需要的字段name
2. 获取多个资源时，只用一个请求即可
3. 描述所有可能类型的系统，便于维护。可以根据需求平滑演进，添加或隐藏字段

与restful对比

restful：Representational State Transfer 表属性状态转移。本质上是用定义uri，通过api接口来取得资源。这是一个通用系统架构，不受语言限制

• restful一个接口只能返回一个资源，而graphql一次可以获取多个资源
• restful用不同的url来区分资源，而graphql用类型区分资源

使用

cnpm install express express-graphql graphql

var express = require('express')
var graphqlHTTP = require('express-graphql') //连接express和graphql的中间件
var {buildSchema} = require('graphql')

// 构建schema，定义查询的语句和类型：查询方法是hello，返回值是String类型
var schema = buildSchema(`
    type Query {
        hello: String
        accoutnName: String
    }
`)
// 定义查询（hello方法）所对应的resolver，也就是查询对应的处理器
var root = {
    hello: ()=>{
        return 'Hello graphql';//reuturn的返回值需要和前面定义的一致
    },
    accoutnName: ()=>{
        return 'Tom';
    }
};

var app = express();

app.use('/graphql', graphqlHTTP({//把地址/graphql的请求，转发给graphqlHTTP进行处理
    schema: schema,
    rootValue: root,
    graphiql: true//是否启用调试界面
}));

app.listen(4000);

访问localhost/graphql，点击右侧docs
左框输入要查询的内容，中间是查询的结果

感慨，用起来真的很爽