KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

graphql-client

★ 31 Open GitHub ↗

graphql client for java

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# English

## Graphql Client
The project is graphql client for java,support custom query and mutation.

The current version only supports post requests

You need java1.8 and maven.

Welcome to my home page:[Mount Cloud](http://www.mountcloud.org)

## Update plan V2.0,Update time:Recent months

1:Support proxy setting.

2:Support subquery.

3:Support multiple query.

4:More flexible expansion.

## Update 1.2 Note

Requested parameters support custom complex types and Enum types.

## Use You Project

maven:

<dependency>
		    <groupId>org.mountcloud</groupId>
		    <artifactId>graphql-client</artifactId>
		    <version>1.2</version>
	</dependency>

## Insall Project

mvn install

## Demo

do query

```Java
//crate client
GraphqlClient client = GraphqlClient.buildGraphqlClient("http://localhost:8081/graphql");
//create http headers
Map<String,String> headers = new HashMap<String,String>();
headers.put("token","123");
client.setHttpHeaders(headers);
//create query
GraphqlQuery query = new DefaultGraphqlQuery("findUsers");
//add query or mutation param
query.addParameter("sex","man").addParameter("age",11);
//add query response basics attribute
query.addResultAttributes("id","name","age","sex");
//add query complex attributes
ResultAttributtes classAttributte = new ResultAttributtes("class");
classAttributte.addResultAttributes("name","code");
//attributes can be more complex
ResultAttributtes schoolAttributte = new ResultAttributtes("school");
schoolAttributte.addResultAttributes("name");
//class add school attribute
classAttributte.addResultAttributes(schoolAttributte);
//do query
try {
    GraphqlResponse response = client.doQuery(query);

//this map is graphql result
    Map data = response.getData();

} catch (IOException e) {
    e.printStackTrace();
}
```

query is

```Java
query{
  findUsers(sex:"man",age:11){
    id
    name
    age
    sex
    class{
    	name
	code
	school{
	  name
	}
    }
  }
}
```

do mutation

//result
mutation.addResultAttributes("code");
try {
    GraphqlResponse response = client.doMutation(mutation);
    //this map is graphql result
    Map data = response.getData();
} catch (IOException e) {
    e.printStackTrace();
}
```

mutation is

```Java
mutation{
  updateUser(id:1,name:"123",age:18){
    code
  }
}
```

## Complex structure request demo

Mutation demo,The query is consistent with the mutation.

```Java
    @Test
    public void testObjectParameter() throws IOException {

String serverUrl = "http://localhost:8080/graphql";
        
        GraphqlClient graphqlClient = GraphqlClient.buildGraphqlClient(serverUrl);

Map<String,String> httpHeaders = new HashMap<>();
        httpHeaders.put("token","graphqltesttoken");
        
        graphqlClient.setHttpHeaders(httpHeaders);

GraphqlMutation mutation = new DefaultGraphqlMutation("addUser");

List<User> users = new ArrayList<>();
        users.add(new User("tim",SexEnum.M));
        users.add(new User("sdf",SexEnum.F));
        mutation.getRequestParameter().addParameter("classId","123").addObjectParameter("users",users);

mutation.addResultAttributes("code");

System.out.println(mutation.toString());

}

/**
     * test user
     */
    class User{
        public User(String name, SexEnum sexEnum) {
            this.name = name;
            this.sexEnum = sexEnum;
        }

private String name;
        private SexEnum sexEnum;

public String getName() {
            return name;
        }

public void setName(String name) {
            this.name = name;
        }

public SexEnum getSexEnum() {
            return sexEnum;
        }

public void setSexEnum(SexEnum sexEnum) {
            this.sexEnum = sexEnum;
        }
    }

/**
     * test user sex
     */
    enum SexEnum{
        M,
        F
    }
```

mutation is

```Java
mutation{
  addUser(classId:"123",users:[{name:"tim",sexEnum:M},{name:"sdf",sexEnum:F}]){
    code
  }
}
```

# 中文

## Graphql Client
该项目是java的graphql客户端，支持自定义query和mutation.

当前版本仅支持post请求

你需要java1.8和maven.

欢迎观临我的主页:[Mount Cloud](http://www.mountcloud.org)

## 更新预览V2.0,预计更新时间：最近几个月不忙的时候

1:支持代理服务器.

2:支持子查询.

3:支持多个查询组合.

4:更加灵活的扩展方式.

## 更新 1.2 日志

请求的参数支持自定义复杂类型和Enum类型。

## 使用方式

maven:

<dependency>
		    <groupId>org.mountcloud</groupId>
		    <artifactId>graphql-client</artifactId>
		    <version>1.2</version>
	</dependency>

## Insall Project

mvn install

## Demo

do query

//this map is graphql result
    Map data = response.getData();

} catch (IOException e) {
    e.printStackTrace();
}
```

query is

```Java
query{
  findUsers(sex:"man",age:11){
    id
    name
    age
    sex
    class{
    	name
	code
	school{
	  name
	}
    }
  }
}
```

do mutation

mutation is

```Java
mutation{
  updateUser(id:1,name:"123",age:18){
    code
  }
}
```

## 如何实现一个复杂请求

用Mutation做演示,query与mutation原理一样.

```Java
    @Test
    public void testObjectParameter() throws IOException {

String serverUrl = "http://localhost:8080/graphql";
        
        GraphqlClient graphqlClient = GraphqlClient.buildGraphqlClient(serverUrl);

Map<String,String> httpHeaders = new HashMap<>();
        httpHeaders.put("token","graphqltesttoken");
        
        graphqlClient.setHttpHeaders(httpHeaders);

GraphqlMutation mutation = new DefaultGraphqlMutation("addUser");

mutation.addResultAttributes("code");

System.out.println(mutation.toString());

}

/**
     * test user
     */
    class User{
        public User(String name, SexEnum sexEnum) {
            this.name = name;
            this.sexEnum = sexEnum;
        }

private String name;
        private SexEnum sexEnum;

public String getName() {
            return name;
        }

public void setName(String name) {
            this.name = name;
        }

public SexEnum getSexEnum() {
            return sexEnum;
        }

public void setSexEnum(SexEnum sexEnum) {
            this.sexEnum = sexEnum;
        }
    }

/**
     * test user sex
     */
    enum SexEnum{
        M,
        F
    }
```

mutation is

```Java
mutation{
  addUser(classId:"123",users:[{name:"tim",sexEnum:M},{name:"sdf",sexEnum:F}]){
    code
  }
}
```

graphql-client

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README