xml<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-graphql</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

graphqltype Query {
    bookById(id: ID): Book
    allBooks: [Book]
}

type Book {
    id: ID
    title: String
    author: Author
}

type Author {
    id: ID
    name: String
    books: [Book]
}
Здесь Query — это корневой тип для запросов. ID — уникальный идентификатор, String — текст. [Book] значит список книг. Это позволяет запрашивать книги с авторами, и сервер сам свяжет данные.

javaimport jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.ManyToOne;

@Entity
public class Book {
    @Id
    private Long id;
    private String title;
    @ManyToOne
    private Author author;

    // Геттеры и сеттеры (методы для чтения и записи полей)
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
    public Author getAuthor() { return author; }
    public void setAuthor(Author author) { this.author = author; }
}

javaimport org.springframework.data.jpa.repository.JpaRepository;

public interface BookRepository extends JpaRepository<Book, Long> {
}
Это интерфейс, который автоматически генерирует методы вроде findById.

javaimport graphql.kickstart.tools.GraphQLQueryResolver;
import org.springframework.beans.factory.annotation.Autowired;

public class QueryResolver implements GraphQLQueryResolver {
    @Autowired
    private BookRepository bookRepository;

    public Book bookById(Long id) {
        return bookRepository.findById(id).orElse(null); // Возвращает книгу или null, если не найдена
    }

    public List<Book> allBooks() {
        return bookRepository.findAll(); // Все книги
    }
}
@Autowired — это инъекция зависимости, Spring сам подставит репозиторий. Для автора аналогично создай AuthorResolver для поля books.

javaimport graphql.kickstart.tools.GraphQLResolver;

public class BookResolver implements GraphQLResolver<Book> {
    public Author author(Book book) {
        return book.getAuthor(); // Просто возвращает автора из модели
    }
}
Это позволяет в запросе GraphQL получить автора без дополнительных усилий.

mvn spring-boot:run.

graphqlquery {
    bookById(id: 1) {
        title
        author {
            name
        }
    }
}

json{
  "data": {
    "bookById": {
      "title": "Война и мир",
      "author": {
        "name": "Лев Толстой"
      }
    }
  }
}

@Bean
public DataLoaderRegistry dataLoaderRegistry(BookRepository bookRepo) {
    DataLoaderRegistry registry = new DataLoaderRegistry();
    registry.register("authorLoader", DataLoader.newDataLoader((List<Long> authorIds) -> 
        CompletableFuture.supplyAsync(() -> bookRepo.findAuthorsByIds(authorIds)))); // Batch-запрос
    return registry;
}

query {
  user(id: 42) {
    name
    avatar
    posts(limit: 3) {
      title
      likes
    }
  }
}

{
  "data": {
    "user": {
      "name": "Den",
      "avatar": "https://example.com/den.jpg",
      "posts": [
        { "title": "gRPC и Java", "likes": 120 },
        { "title": "GraphQL под капотом", "likes": 80 },
        { "title": "Spring Boot и микросервисы", "likes": 95 }
      ]
    }
  }
}

type User {
  id: ID!
  name: String!
  avatar: String
  posts(limit: Int): [Post]
}

type Post {
  id: ID!
  title: String!
  likes: Int!
}

type Query {
  user(id: ID!): User
}


type — описание структуры данных, аналог класса в Java.

Query — “входная точка”, через которую клиент получает данные.

! — обязательное поле.

[Post] — список постов.

type User {
  id: ID!
  name: String!
  posts: [Post!]!
}

type Post {
  id: ID!
  title: String!
  content: String
}

type Query {
  user(id: ID!): User
  allUsers: [User!]!
}

query {
  user(id: 42) {
    name
    posts {
      title
    }
  }
}

{
  "data": {
    "user": {
      "name": "Den",
      "posts": [
        { "title": "gRPC и Java" },
        { "title": "GraphQL под капотом" }
      ]
    }
  }
}

mutation {
  createUser(input: { name: "Alex" }) {
    id
    name
  }
}

subscription {
  userCreated {
    id
    name
  }
}

{
  "query": "query { user(id: 42) { name posts { title } } }"
}

GraphQL-запрос — это декларативное описание структуры данных, не код и не SQL.

GraphQLObjectType userType = newObject()
    .name("User")
    .field(field -> field
        .name("id")
        .type(Scalars.GraphQLID))
    .field(field -> field
        .name("name")
        .type(Scalars.GraphQLString))
    .field(field -> field
        .name("posts")
        .type(new GraphQLList(postType))
        .dataFetcher(env -> postService.getByUser(env.getSource())))
    .build();

{
  "data": {
    "user": {
      "name": "Den",
      "posts": [{ "title": "gRPC и Java" }]
    }
  }
}

{
  "data": { "user": null },
  "errors": [{ "message": "User not found" }]
}

@Component
public class UserResolver implements GraphQLQueryResolver {
    private final UserService userService;
    public UserResolver(UserService userService) { this.userService = userService; }

    public User user(Long id) {
        return userService.findById(id);
    }

    public List<User> allUsers() {
        return userService.findAll();
    }
}