최신 애플리케이션의 복잡성이 계속 증가함에 따라 확장 가능한 API 및 쿼리 시스템을 구축하는 것이 점점 더 중요해지고 있습니다. 과거에는 REST API와 SOAP가 주류 API 구축 솔루션이었지만 이제는 GraphQL도 인기 있는 옵션이 되었습니다. 이 기사에서는 Spring Boot와 GraphQL을 사용하여 API 및 쿼리 시스템을 구축하는 방법을 소개합니다.
GraphQL이란 무엇인가요?
GraphQL은 API 및 쿼리 시스템을 위한 쿼리 언어입니다. 기존 REST API와 비교하여 GraphQL에는 다음과 같은 장점이 있습니다.
Spring Boot 및 GraphQL
Spring Boot는 Java 기반 웹 애플리케이션을 구축하기 위한 Java 프레임워크입니다. 자동 구성, 신속한 개발 등 유용한 기능을 많이 제공합니다. 기존 Java 웹 개발과 비교하여 Spring Boot는 개발 프로세스를 더욱 즐겁고 효율적으로 만들 수 있습니다.
이 기사에서는 Spring Boot와 GraphQL을 사용하여 기본 API 및 쿼리 시스템을 구축하겠습니다. 시작하기 전에 다음 구성 요소를 알아야 합니다.
API 및 쿼리 시스템 구축
먼저 Spring Boot 애플리케이션을 생성해야 합니다. Spring 초기화를 사용하여 Spring Boot 애플리케이션을 빠르게 생성할 수 있습니다. Spring Boot 애플리케이션을 생성하는 단계는 다음과 같습니다.
Creating a GraphQL Schema
GraphQL 스키마를 만들기 전에 API에서 수행해야 할 작업에 대해 생각해 보겠습니다. 저자, 도서, 저자-도서 관계의 세 가지 유형으로 API를 작성하겠습니다. 다음은 API 작업입니다.
다음 단계는 GraphQL 스키마를 생성하는 것입니다. 스키마는 API에서 수행할 수 있는 작업을 정의합니다. 이 기사에서는 GraphQL Java 도구를 사용하여 스키마를 생성합니다. GraphQL 스키마를 생성하는 단계는 다음과 같습니다.
type Author {
id: ID!
name: String!
}
type Book {
id: ID!
title: String!
author: Author!
}
type Relationship {
id: ID!
author: Author!
book: Book!
}
type Query {
authors: [Author]
author(id: ID!): Author
books: [Book]
book(id: ID!): Book
relationships: [Relationship]
booksByAuthor(authorId: ID!): [Book]
}이 스키마는 작성자, 책의 세 가지 유형을 정의합니다. 그리고 관계. 또한 저자 목록 가져오기, ID로 저자 가져오기, 도서 목록 가져오기, ID로 도서 가져오기, 관계 목록 가져오기, 저자 ID로 관련 도서 가져오기 등 6가지 작업을 정의합니다.
package com.example.demo;
import com.example.demo.entity.*;
import com.example.demo.repository.*;
import com.example.demo.resolver.*;
import java.util.List;
import javax.annotation.PostConstruct;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import graphql.schema.DataFetcher;
import graphql.schema.DataFetchingEnvironment;
import graphql.schema.GraphQLSchema;
import graphql.schema.idl.RuntimeWiring;
import graphql.schema.idl.SchemaGenerator;
import graphql.schema.idl.SchemaParser;
import graphql.schema.idl.TypeRuntimeWiring;
import graphql.servlet.GraphQLServlet;
import graphql.servlet.SimpleGraphQLHttpServlet;
@Configuration
public class GraphQLProvider {
private static final Logger LOGGER = LoggerFactory.getLogger(GraphQLProvider.class);
private final AuthorRepository authorRepository;
private final BookRepository bookRepository;
private final RelationshipRepository relationshipRepository;
private List<DataFetcher> fetchDataers;
@Autowired
public GraphQLProvider(
AuthorRepository authorRepository,
BookRepository bookRepository,
RelationshipRepository relationshipRepository,
List<DataFetcher> fetchDataers
) {
this.authorRepository = authorRepository;
this.bookRepository = bookRepository;
this.relationshipRepository = relationshipRepository;
this.fetchDataers = fetchDataers;
}
@PostConstruct
public void setup() {
fetchDataers.add(new DataFetcher() {
@Override
public Object get(DataFetchingEnvironment environment) {
return authorRepository.findAll();
}
});
fetchDataers.add(new DataFetcher() {
@Override
public Object get(DataFetchingEnvironment environment) {
return authorRepository.findById(environment.getArgument("id")).get();
}
});
fetchDataers.add(new DataFetcher() {
@Override
public Object get(DataFetchingEnvironment environment) {
return bookRepository.findAll();
}
});
fetchDataers.add(new DataFetcher() {
@Override
public Object get(DataFetchingEnvironment environment) {
return bookRepository.findById(environment.getArgument("id")).get();
}
});
fetchDataers.add(new DataFetcher() {
@Override
public Object get(DataFetchingEnvironment environment) {
return relationshipRepository.findAll();
}
});
fetchDataers.add(new DataFetcher() {
@Override
public Object get(DataFetchingEnvironment environment) {
return bookRepository.findByAuthor_Id(environment.getArgument("authorId"));
}
});
}
@Bean
public GraphQLSchema schema() {
SchemaParser schemaParser = new SchemaParser();
SchemaGenerator schemaGenerator = new SchemaGenerator();
TypeRuntimeWiring.Builder authorWiring = newTypeWiring("Author").dataFetchers(fetchDataers);
return schemaGenerator.makeExecutableSchema(schemaParser.parse(getClass().getResource("/schema.graphqls").getPath()), RuntimeWiring.newRuntimeWiring()
.type(authorWiring)
.build());
}
@Bean
public GraphQLServlet graphQLServlet() {
return new SimpleGraphQLHttpServlet(new GraphQL.Builder(schema()).build());
}
}이 클래스는 GraphQL 서비스를 생성하고 해당 서비스에 Schema.graphqls 파일을 로드합니다. 가져오기 도구가 정의되어 있습니다. 데이터 가져오기 프로그램은 데이터를 가져와서 GraphQL 작업 결과로 채우는 역할을 담당합니다.
JPA 엔터티 및 저장소 생성
이제 엔터티를 생성하고 데이터베이스에 매핑해야 합니다. 이 기사에서는 Author, Book 및 Relationship 엔터티를 생성하고 JPA를 사용하여 H2 데이터베이스에 매핑합니다.
package com.example.demo.repository;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;
import com.example.demo.entity.Author;
@Repository
public interface AuthorRepository extends JpaRepository<Author, Long> {
}package com.example.demo.entity;
import lombok.Data;
import javax.persistence.*;
@Data
@Entity
public class Author {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;
private String name;
protected Author() {}
public Author(String name) {
this.name = name;
}
}위의 예에서는 Lombok @Data 주석의 "id" 및 "name" 필드를 사용하여 Author라는 Java 엔터티를 만들었습니다.
데이터 채우기
이제 H2 콘솔을 사용하거나 Java 코드를 작성하여 데이터를 채울 수 있습니다.
H2 콘솔을 사용하여 데이터 채우기:
INSERT INTO author (id, name) VALUES (1, 'William Shakespeare'); INSERT INTO author (id, name) VALUES (2, 'John Milton'); INSERT INTO author (id, name) VALUES (3, 'Charles Dickens'); INSERT INTO book (id, title, author_id) VALUES (1, 'Hamlet', 1); INSERT INTO book (id, title, author_id) VALUES (2, 'Paradise Lost', 2); INSERT INTO book (id, title, author_id) VALUES (3, 'Oliver Twist', 3); INSERT INTO relationship (id, author_id, book_id) VALUES (1, 1, 1); INSERT INTO relationship (id, author_id, book_id) VALUES (2, 2, 2); INSERT INTO relationship (id, author_id, book_id) VALUES (3, 3, 3);
使用Java代码填充数据：
package com.example.demo.seed;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;
import com.example.demo.entity.Author;
import com.example.demo.entity.Book;
import com.example.demo.entity.Relationship;
import com.example.demo.repository.AuthorRepository;
import com.example.demo.repository.BookRepository;
import com.example.demo.repository.RelationshipRepository;
@Component
public class DataSeed implements CommandLineRunner {
private AuthorRepository authorRepository;
private BookRepository bookRepository;
private RelationshipRepository relationshipRepository;
public DataSeed(AuthorRepository authorRepository,
BookRepository bookRepository,
RelationshipRepository relationshipRepository) {
this.authorRepository = authorRepository;
this.bookRepository = bookRepository;
this.relationshipRepository = relationshipRepository;
}
@Override
public void run(String... args) throws Exception {
Author shakespeare = new Author("William Shakespeare");
Author milton = new Author("John Milton");
Author dickens = new Author("Charles Dickens");
authorRepository.save(shakespeare);
authorRepository.save(milton);
authorRepository.save(dickens);
Book hamlet = new Book("Hamlet", shakespeare);
Book paradiseLost = new Book("Paradise Lost", milton);
Book oliverTwist = new Book("Oliver Twist", dickens);
bookRepository.save(hamlet);
bookRepository.save(paradiseLost);
bookRepository.save(oliverTwist);
relationshipRepository.save(new Relationship(shakespeare, hamlet));
relationshipRepository.save(new Relationship(milton, paradiseLost));
relationshipRepository.save(new Relationship(dickens, oliverTwist));
}
}在上面的示例中，我们创建了一个CommandLineRunner工具类，它在应用程序启动时添加示例数据到数据库中。
测试GraphQL API
我们现在可以使用GraphQL Playground工具查询GraphQL API。
以下是一些示例查询：
获取作者列表：
query {
authors {
id
name
}
}按ID获取作者：
query {
author(id: 1) {
id
name
}
}获取书籍列表：
query {
books {
id
title
author {
id
name
}
}
}按ID获取书籍：
query {
book(id: 1) {
id
title
author {
id
name
}
}
}获取作者-书籍关系列表：
query {
relationships {
id
author {
id
name
}
book {
id
title
}
}
}按作者ID获取关联书籍：
query {
booksByAuthor(authorId: 1) {
id
title
author {
id
name
}
}
}结论
本文介绍了如何使用Spring Boot和GraphQL构建API和查询系统，并执行基本的操作。可以使用GraphQL Java Tools和JPA轻松定义Schema和映射实体。GraphQL的灵活性和可扩展性使得它成为构建现代Web应用程序的理想选择。
위 내용은 Spring Boot 및 GraphQL을 사용하여 API 및 쿼리 시스템 구축의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!
![[웹 프런트엔드] Node.js 빠른 시작](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
