GraphQL: 开始使用GraphQL
本文是对GraphQL官方网站的”Introduction to GraphQL”一文进行了日文解释(非正式译文)。
GraphQL是一种用于API的查询语言。它可以在服务器端的运行时上使用定义的类型系统执行查询。GraphQL不限于特定的数据库或存储引擎,它可以作为现有代码和数据可用的后端。
GraphQL服务会定义类型及其字段,并为每个字段提供函数。例如,要获取登录用户(me)以及该用户的姓名的服务,可以使用以下代码。
type Query {
me: User
}
type User {
id: ID
name: String
}
而且,字段和类型都具备以下函数。
function Query_me(request) {
return request.auth.user;
}
function User_name(user) {
return user.getName();
}
当GraphQL服务启动时(通常使用Web服务的URL),可以接收并验证和执行查询。首先,服务会确保查询只引用了已定义的类型和字段,然后通过执行提供的函数来生成结果。
例如,下面的代码是由查询生成的JSON结果的示例。
{
me {
name
}
}
{
"me": {
"name": "Luke Skywalker"
}
}
请阅读下一步的内容:“GraphQL: 查询(queries)和变更(mutations)”。