前言：首先要明白的是GraphQL是用来干嘛的也就是是解决什么问题的，其实就是解决传输数据的可定制化，减少后端api的开发量。举个例子：比如你获取一个用户列表，后端开发了一个叫getUserList接口,参数是parentId，返回的数据结构是这样的：[ { name, id , logo , address } ]，后来又有个业务只要数据结构是这样的就可以了：[ { name} ]，这个时候要么后端重新开发一个接口，要么就是直接用getUserList，但是造成了数据浪费和网络传输成本浪费，为了解决这个问题GraphQL就被Facebook创造了出来，即能复用getUserList也不造成各种浪费。
后端（使用的是nodejs，express）
1、安装依赖：npm install express-graphql -S ; npm install graphql -S ; 2、单独个目录做route接口，index.js统一导出，方便以后代码膨胀进行分块，如图 
3、开始写具体的业务代码，拿我的base-graphql.js举例
// 也可以在不使用 GraphQL Schema Language 的情况下实现相同的 API:
const {
graphqlHTTP
} = require('express-graphql');
const graphql = require('graphql');
const {
createBaseDb,
createUserDb
} = require('../utils/db-util');
//创建db对象
const DBBase = createBaseDb();
// 定义 数据库对应的User类型
const UserType = new graphql.GraphQLObjectType({
name: 'User',
fields: {
id: {
type: graphql.GraphQLInt
},
version: {
type: graphql.GraphQLInt
},
create_date: {
type: graphql.GraphQLString
},
update_date: {
type: graphql.GraphQLString
},
update_user: {
type: graphql.GraphQLInt
},
name: {
type: graphql.GraphQLString
},
email: {
type: graphql.GraphQLString
},
server: {
type: graphql.GraphQLString
},
username: {
type: graphql.GraphQLString
},
password: {
type: graphql.GraphQLString
},
}
});
const UsersType = new graphql.GraphQLList(UserType);
// 定义查询对象类型,对应post查询传参： query:{user(id:"a"){id,name,age},hello(name:"charming")}
const QueryType = new graphql.GraphQLObjectType({
name: 'Query',
fields: {
queryUser: {
description: 'query user',
//resolve返回的数据类型
type: UserType,
// `args` 描述了 `user` 查询接受的参数
args: {
id: {
type: graphql.GraphQLString,
}
},
resolve(parentValue, args, request) {
//查一个表的所有数据
let data = new Promise((resolve, reject) => {
DBBase.all("select * from user", (err, res) => {
if (err) {
reject(err)
} else {
resolve(res[0])
}
})
});
return data;
}
},
queryUsers: {
description: 'query users',
//resolve返回的数据类型
type: UsersType,
// `args` 描述了 `user` 查询接受的参数
args: {
id: {
type: graphql.GraphQLString,
}
},
resolve(parentValue, args, request) {
//查一个表的所有数据
let data = new Promise((resolve, reject) => {
DBBase.all("select * from user", (err, res) => {
if (err) {
reject(err)
} else {
resolve(res)
}
})
});
return data;
}
},
//可以定义多个
hello: {
description: 'a hello world demo',
type: graphql.GraphQLString,
args: {
name: { // 这里定义参数，包括参数类型和默认值
type: graphql.GraphQLString,
defaultValue: 'Brian'
}
},
resolve(parentValue, args, request) { // 这里演示如何获取参数，以及处理
return 'hello world ' + args.name + '!';
}
}
}
});
// ====================================下面时修改数据=================================
// 输入参数类型
const UserInputType = new graphql.GraphQLInputObjectType({
name: 'UserInput',
fields: () => ({
name: {
type: graphql.GraphQLString
},
email: {
type: graphql.GraphQLString
},
username: {
type: graphql.GraphQLString
},
password: {
type: graphql.GraphQLString
},
})
});
const MutationType = new graphql.GraphQLObjectType({
name: 'Mutation',
fields: {
addUser: { //参数样式 mutation {addUser(one:{id:"s",name:"alice",age:12,male:false}){id,name,age}}
type: graphql.GraphQLString,
// `args` 描述了 `user` 查询接受的参数
args: {
one: {
type: UserInputType
}
},
resolve(parentValue, args, request) {
let sqlStr = `insert into user (create_date,version,name,email,username,password) values (
'${new Date().toISOString()}',
0,
'${args.one.name}',
'${args.one.email}',
'${args.one.username}',
'${args.one.password}'
)`;
return new Promise((resolve, reject) => {
DBBase.run('BEGIN TRANSACTION;');
DBBase.run(sqlStr, async (err, res) => {
console.log("insert user ", err, res);
if (err) {
DBBase.run("ROLLBACK;");
reject(err)
} else {
//添加成功后，创建对应的用户数据库
try {
await createUserDb(args.one.email);
DBBase.run('COMMIT TRANSACTION;');
resolve(res)
} catch (error) {
console.log(error);
DBBase.run("ROLLBACK;");
reject(err)
}
}
});
});
}
},
}
});
const schema = new graphql.GraphQLSchema({
query: QueryType,
mutation: MutationType
});
module.exports = graphqlHTTP({
schema: schema,
graphiql: true /* true代表需要调试 */
})
上面注释写的也比较清楚，简单说下， 这里它提供了GraphQLObjectType来定义对象数据类型的描述，如果是数组必须使用GraphQLList再进行构建，然后你就可以用你构建的来声明你要返回的类型，但是参数类型不能使用这个，必须是GraphQLInputObjectType这种input相关的来构建。 还有resolve方法里是需要你直接return结果的，db的操作其实都是异步的，所以需要你用promise来解决 这个问题，当你的业务涉及事务等比较多db操作是async/await可能更方便，其他的用法就看官方文档吧，这里就不展开了。
例子中
我按功能来划分了模块，我综合思考了，还是觉得这样的普适性和开发难度是最好，对于一些复杂的大型项目肯定还是需要进行调整的。 好了到这里，你就可以直接用postman看看效果了
记得参数那里不要是form-data，一定选的是GraphQL（这个我猜想就是form-data等这种现有的形式来做这个可能有点别扭，所以干脆另外定了一个格式），查询参数类似这样：query {queryUsers(id:"a"){id,name,email}}，修改参数类似这样：mutation {addUser(one:{name:"jack",email:"jack@qq.com",username:"jack",password:"123456"})}；不用postman也可以用自带的，直接访问https://localhost:3001就可以了 。 写到这里你可能会想到现有的类似axios这种的框架也能用但是比较原始简陋，像apollo-client这种提供的功能要多的多。
