背景
隨著React的開源，facebook相繼開源了很多相關的項目，這些項目在他們內部已經使用了多年，其中引起我注意的就是本次討論的是graphql，目前官方只有nodejs版，由於很多公司的後台技術棧都是Java，所以便有了graphql的java版實現，在github上可以找到，廢話不多說，直接看代碼吧，具體介紹還是去看官網吧，不然就跑題了。
GraphQLSchema
Schema相當於一個數據庫，它有很多GraphQLFieldDefinition組成，Field相當於數據庫表/視圖，每個表/視圖又由名稱、查詢參數、數據結構、數據組成.
1） 先定義一個數據結構（GraphQLOutputType）字段，然後定義一個初始化方法
private GraphQLOutputType userType;private void initOutputType() { /** * 會員對象結構*/ userType = newObject() .name("User") .field(newFieldDefinition().name("id").type(GraphQLInt).build()) .field(newFieldDefinition().name("age").type(GraphQLInt).build()) .field(newFieldDefinition().name("sex").type(GraphQLInt).build()) .field(newFieldDefinition().name("name").type(GraphQLString).build()) .field(newFieldDefinition().name("pic").type(GraphQLString).build()) .build();}2）再定義兩個表/視圖，它包括名稱，查詢參數，數據結構，以及數據檢索器
/** * 查詢單個用戶信息* @return */ private GraphQLFieldDefinition createUserField() { return GraphQLFieldDefinition.newFieldDefinition() .name("user") .argument(newArgument().name("id").type(GraphQLInt).build()) .type(userType) .dataFetcher(environment -> { // 獲取查詢參數int id = environment.getArgument("id"); // 執行查詢, 這裡隨便用一些測試數據來說明問題User user = new User(); user.setId(id); user.setAge(id + 15); user.setSex(id % 2); user.setName("Name_" + id); user.setPic("pic_" + id + ".jpg"); return user; }) .build(); } /** * 查詢多個會員信息* @return */ private GraphQLFieldDefinition createUsersField() { return GraphQLFieldDefinition.newFieldDefinition() .name("users") .argument(newArgument().name("page").type(GraphQLInt).build()) .argument(newArgument().name("size").type(GraphQLInt).build()) .argument(newArgument().name("name").type(GraphQLString).build()) .type(new GraphQLList(userType)) .dataFetcher(environment -> { // 獲取查詢參數int page = environment.getArgument("page"); int size = environment.getArgument("size"); String name = environment.getArgument("name"); // 執行查詢, 這裡隨便用一些測試數據來說明問題List<User> list = new ArrayList<>(size); for (int i = 0; i < size; i++) { User user = new User(); user.setId(i); user.setAge(i + 15); user.setSex(i % 2); user.setName(name + "_" + page + "_" + i); user.setPic("pic_" + i + ".jpg"); list.add(user); } return list; }) .build(); }3）接著定義一個Schema，並將其初始化，它包含一個名稱，以及一個或多個表/視圖（Field）
private GraphQLSchema schema; public GraphSchema() { initOutputType(); schema = GraphQLSchema.newSchema().query(newObject() .name("GraphQuery") .field(createUsersField()) .field(createUserField()) .build()).build(); }4）完成以上步驟之後，還需要定義一個model，類名不限，但是結構需要滿足前面定義的數據結構，而且必須是public的
public class User { private int id; private int age; private int sex; private String name; private String pic; // getter, setter...}5）之後寫一個main方法，來測試一下
public static void main(String[] args) { GraphQLSchema schema = new GraphSchema().getSchema(); String query1 = "{users(page:2,size:5,name:/"john/") {id,sex,name,pic}}"; String query2 = "{user(id:6) {id,sex,name,pic}}"; String query3 = "{user(id:6) {id,sex,name,pic},users(page:2,size:5,name:/"john/") {id,sex,name,pic}}"; Map<String, Object> result1 = (Map<String, Object>) new GraphQL(schema).execute(query1).getData(); Map<String, Object> result2 = (Map<String, Object>) new GraphQL(schema).execute(query2).getData(); Map<String, Object> result3 = (Map<String, Object>) new GraphQL(schema).execute(query3).getData(); // 查詢用戶列表System.out.println(result1); // 查詢單個用戶System.out.println(result2); // 單個用戶、跟用戶列表一起查System.out.println(result3);}輸出：
{users=[{id=0, sex=0, name=john_2_0, pic=pic_0.jpg}, {id=1, sex=1, name=john_2_1, pic=pic_1.jpg}, {id=2, sex=0, name=john_2_2, pic=pic_2.jpg}, {id=3, sex=1, name=john_2_3, pic=pic_3.jpg}, {id=4, sex=0, name=john_2_4, pic=pic_4.jpg}]}{user={id=6, sex=0, name=Name_6, pic=pic_6.jpg}}{user={id=6, sex=0, name=Name_6, pic=pic_6.jpg}, users=[{id=0, sex=0, name=john_2_0, pic=pic_0.jpg}, {id=1, sex=1, name=john_2_1, pic=pic_1.jpg}, {id=2, sex=0, name=john_2_2, pic=pic_2.jpg}, {id=3, sex=1, name=john_2_3, pic=pic_3.jpg}, {id=4, sex=0, name=john_2_4, pic=pic_4.jpg}]}6）最後把main方法裡面的代碼放到web層，只需要定義一個query參數，很容易就把查詢服務搭建好了，dataFetcher 裡面還是調用原來的查詢接口
7）引入maven依賴
<dependency> <groupId>com.graphql-java</groupId> <artifactId>graphql-java</artifactId> <version>2.0.0</version></dependency>
關於graphql查詢什麼定義，看看這個或許對你有幫助
json
{ id=6, sex=0, name="Name_6", pic="pic_6.jpg"}query
{ id, sex, name, pic}後面那部分，其實就是json字符串，去掉=和value的結果，還是可讀的
結語
graphql 帶了一種全新的思維方式，可以簡化web api的開發，由客戶端指定需要什麼數據，服務端返回什麼數據，減少不必要的流量傳輸，對移動端友好，還提供多種數據聚合查詢，多個查詢只是用一個請求，既滿足api最小粒度，又滿足前端需要，減少請求，提高性能。
感覺以後會朝這方面去發展，大趨所驅。