开门见山,谈一谈我这一个星期的对GraphQL的认识:
刚开始认为,暴露给外部的API类似Java类中的方法,忽视了其实API和自定义类在GraphQL中都是自定义Type。而对方法的定义其实都是对字段的定义,类似Pojo中的属性。
1 2 3 4 5 6 7 8 9 10 11 12 | schema { query: userQuery } type userQuery { selectUsers(id: Int): [User] } type User { id: Int age: Int userName: String! dogs(dogId:Int): [Dog] } |
拿这个例子来说,id:Int 和 selectUsers(id: Int): [User] 其实没有本质性的区别,都是这样的格式:
“Field”(Arguments)-可省略 :Type(标量类型或自定义类型),这样一看,结合官方说的DataFetcher、TypeResolver、Arguments只能放在Field上,我也就能释然了,其实每一个字段都可以定义DataFetcher、TypeResolver、Arguments(如果有的话)。
另外,查看别人Demo的时候经常看到如下IDL定义:
1 2 3 4 5 6 7 8 | type Query{ Field A Field B } type Mutation{ Field C Field C } |
省略了
1 2 3 4 | schema { query:xxxx mutation:yyyy } |
后来了解到原来Schema中 Query 和 Mutation 是默认的注册Type名,所以可以省去schema:xxxx的定义
Default:
1 2 3 4 | schema { query:Query mutation:Mutation } |
学习的过程中,因为官方文档的不完整,网上参考了许多第三方的代码和实现方式,帮助了我很多:
GraphQL中文网:翻译了官方的GraphQL-Java的文档
GitHub代码:使用Java定义Schema执行Query和Mutation,研究Mutation中Variable传递的时候见解了很多
SpringBoot集合
Web集成代码1
Web集成代码2:都是很好的参考。
项目中使用的都是GraphqL Java基础包,后来在查看别人的项目实例时,发现GraphQL-Java官方还推出了一个工具包,可以帮助我们映射Schema文件到Java的Pojo上。
1 2 3 4 5 | <dependency> <groupId>com.graphql-java</groupId> <artifactId>graphql-java-tools</artifactId> <version>4.3.0</version> </dependency> |
HomePage
这个工具包实现了将所有的Schema中定义的type的字段Field与相同名称的Java类中的方法名进行指定规定下的绑定(即不用自己做手动映射了),方便了许多,大家可以自己看一下Example。
未完待续、、、