./gradlew clean build
./gradlew :schemafirst:bootRun
go to: http://localhost:8000/graphiql
The old version of this code for Java 8 available under tag java-8.
Request
{
customer(id: "2") {
id
name
email
company {
id
name
website
}
orders {
id
status
items {
id
name
amount
price
currency
producer {
id
}
}
}
}
}or without graphiql:
curl -X POST -H "Content-Type: application/json" -d '{
"query":"{\n customer(id: \"2\") {\n id\n name\n email\n company {\n id\n name\n website\n }\n orders {\n id\n status\n items {\n id\n name\n amount\n price\n currency\n producer {\n id\n }\n }\n }\n }\n}",
"variables":null,
"operationName":null
}' "http://localhost:8000/graphql"Response
{
"data": {
"customer": {
"id": "2",
"name": "name",
"email": "a@b.com",
"company": {
"id": "211",
"name": "Company Corp.",
"website": "www.company.com"
},
"orders": [
{
"id": "55",
"status": "NEW",
"items": [
{
"id": "101",
"name": "Rubber duck",
"amount": 2,
"price": "5",
"currency": "USD",
"producer": {
"id": "12"
}
},
{
"id": "102",
"name": "Magic Ball",
"amount": 1,
"price": "10",
"currency": "USD",
"producer": {
"id": "13"
}
}
]
},
{
"id": "66",
"status": "DONE",
"items": [
{
"id": "103",
"name": "Super Bike",
"amount": 1,
"price": "1000",
"currency": "USD",
"producer": {
"id": "14"
}
}
]
}
]
}
}
}Now try yourself to remove some lines from request.
Request
{
customers {
id
name
email
}
}Response
{
"data": {
"customers": [
{
"id": "2",
"name": "name",
"email": "a@b.com"
},
{
"id": "19",
"name": "MyName",
"email": "me@my.com"
}
]
}
}You can pass some variables to your query to avoid string concatenation. E.g.:
query queryName($customerID: String!) {
customer(id: $customerID) {
id
name
email
}
}Query Variables:
{
"customerID": "2"
}Response
{
"data": {
"customers": {
"id": "2",
"name": "name",
"email": "a@b.com"
}
}
}You can use Get 2 customers in one call. To discriminate the you can use aliases:
query get2Cust {
cust2: customer(id: "2") {
id
name
email
}
cust3: customer(id: "3") {
id
name
email
}
}Response
{
"data": {
"cust2": {
"id": "2",
"name": "name",
"email": "a@b.com"
},
"cust3": {
"id": "3",
"name": "John Doe",
"email": "john@doe.com"
}
}
}To avoid duplication in queries.
query get2Cust {
cust2: customer(id: "2") {
...frag1
}
cust3: customer(id: "3") {
...frag1
}
}
fragment frag1 on Customer {
id
name
email
}Response
{
"data": {
"cust2": {
"id": "2",
"name": "name",
"email": "a@b.com"
},
"cust3": {
"id": "3",
"name": "John Doe",
"email": "john@doe.com"
}
}
}You can include or exclude fields in query using irective @include or @skip.
You can also define custom directives.
query getCust ($showEmail: Boolean!) {
customer(id: "2") {
id
name
email @include(if: $showEmail)
}
}query get2Cust($arg1:String!, $showEmail: Boolean!) {
customer(id: $arg1) {
...frag1
}
}
fragment frag1 on Customer{
id
name
email @include(if: $showEmail)
}Query Variables
{
"showEmail": false,
"arg1": "1"
}Your query cen return interface.
Interface can have a lot implementations.
E.g. interface User is implemented by Admin and Moderator and both have more fields then interface definition.
{
users {
__typename
id
name
email
... on Admin {
superAdmin
}
... on Moderator {
permissions
}
}
}
Response
{
"data": {
"users": [
{
"__typename": "Admin",
"id": "777",
"name": "Admin a",
"email": "admin@me.com",
"superAdmin": true
},
{
"__typename": "Moderator",
"id": "888",
"name": "Moderator",
"email": "mod@me.com",
"permissions": [
"Delete Customer",
"Delete Comment"
]
}
]
}
}
Your query can also return Union. It means type1 or type2 or type3... Types don't requre a common interface.
{
search(input: "a") {
__typename
... on User {
id
name
}
... on Admin {
superAdmin
}
... on Moderator {
permissions
}
... on User {
id
name
}
... on Customer {
id
name
company {
name
}
}
}
}Response
{
"data": {
"search": [
{
"__typename": "Customer",
"id": "2",
"name": "name",
"company": {
"name": "Company Corp."
}
},
{
"__typename": "Admin",
"id": "777",
"name": "Admin a",
"superAdmin": true
},
{
"__typename": "Moderator",
"id": "888",
"name": "Moderator",
"permissions": [
"Delete Customer",
"Delete Comment"
]
}
]
}
}
Create Customer Request
mutation {
createCustomer(input: {name: "MyName" email: "me@me.com" clientMutationId: "123"}) {
customer {
id
name
email
}
clientMutationId
}
}Response
{
"data": {
"createCustomer": {
"customer": {
"id": "570",
"name": "MyName",
"email": "me@me.com"
},
"clientMutationId": "123"
}
}
}Create Customers Request using createCustomer mutation. This solution use previous mutation + aliases.
mutation {
cust1: createCustomer(input: {
name: "a"
email: "a@a.a"
clientMutationId: "123"
}) {
customer {
id
name
email
}
clientMutationId
}
cust2: createCustomer(input: {
name: "b"
email: "b@b.b"
clientMutationId: "123"
}) {
customer {
id
name
email
}
clientMutationId
}
}Response
{
"data": {
"cust1": {
"customer": {
"id": "807",
"name": "a",
"email": "a@a.a"
},
"clientMutationId": "123"
},
"cust2": {
"customer": {
"id": "824",
"name": "b",
"email": "b@b.b"
},
"clientMutationId": "123"
}
}
}Create Customers Request using array in input - another mutation
mutation mut1($cust: CreateCustomersInput) {
createCustomers(input: $cust) {
customers {
id
name
email
}
clientMutationId
}
}Query Variables:
{
"cust": {
"customers": [
{
"name": "name1",
"email": "email1"
},
{
"name": "name2",
"email": "email2"
}
],
"clientMutationId": "111"
}
}Response
{
"data": {
"createCustomers": {
"customers": [
{
"id": "991",
"name": "name1",
"email": "email1"
},
{
"id": "326",
"name": "name2",
"email": "email2"
}
],
"clientMutationId": "111"
}
}
}