使用Java构建GraphQL API（从零开始的GraphQL入门指南）

什么是 GraphQL？

GraphQL 是由 Facebook 开发的一种查询语言和运行时，用于 API。与传统的 REST API 不同，GraphQL 允许客户端通过单个端点发送查询，精确指定需要哪些字段，从而减少网络请求次数和数据冗余。

为什么选择 Java 实现 GraphQL？

Java 拥有成熟的生态系统和强大的企业级支持。结合 GraphQL，你可以构建高性能、类型安全且易于维护的 API。本教程使用的库是 graphql-java 和 Spring Boot，这是目前最流行的组合之一。

准备工作

你需要安装以下工具：

• Java 11 或更高版本
• Maven 或 Gradle（本教程使用 Maven）
• IDE（如 IntelliJ IDEA 或 Eclipse）

步骤 1：创建 Spring Boot 项目

访问 Spring Initializr，选择以下依赖：

• Spring Web
• Spring Boot DevTools
• GraphQL Java Tools（或手动添加）

或者，在 pom.xml 中手动添加 GraphQL 依赖：

<dependency>    <groupId>com.graphql-java-kickstart</groupId>    <artifactId>graphql-spring-boot-starter</artifactId>    <version>15.0.0</version></dependency><dependency>    <groupId>com.graphql-java-kickstart</groupId>    <artifactId>graphiql-spring-boot-starter</artifactId>    <version>15.0.0</version></dependency>

步骤 2：定义 GraphQL Schema

在 src/main/resources 目录下创建 schema.graphqls 文件：

type Query {    bookById(id: ID!): Book    allBooks: [Book!]!}type Book {    id: ID!    title: String!    author: String!    price: Float}

步骤 3：创建数据模型

创建 Book.java 类：

public class Book {    private String id;    private String title;    private String author;    private Double price;    // 构造函数、getter 和 setter    public Book(String id, String title, String author, Double price) {        this.id = id;        this.title = title;        this.author = author;        this.price = price;    }    // getters...    public String getId() { return id; }    public String getTitle() { return title; }    public String getAuthor() { return author; }    public Double getPrice() { return price; }}

步骤 4：实现 Resolver（数据查询逻辑）

创建一个 Query Resolver 类：

@Componentpublic class QueryResolver implements GraphQLQueryResolver {    private List<Book> books = Arrays.asList(        new Book("1", "Java GraphQL实战", "张三", 59.9),        new Book("2", "Spring Boot权威指南", "李四", 79.0)    );    public Book bookById(String id) {        return books.stream()            .filter(book -> book.getId().equals(id))            .findFirst()            .orElse(null);    }    public List<Book> allBooks() {        return books;    }}

步骤 5：启动并测试 API

运行 Spring Boot 应用后，访问 http://localhost:8080/graphiql（GraphiQL 是 GraphQL 的内置浏览器工具）。

尝试以下查询：

{  allBooks {    id    title    author  }}

你将看到返回的 JSON 数据，只包含你请求的字段！

总结

通过本篇 Java GraphQL教程，你已经学会了如何使用 Java 构建一个基本的 GraphQL API。我们涵盖了 Schema 定义、数据模型、Resolver 实现以及测试方法。无论你是想提升 API 效率，还是希望提供更灵活的数据接口，GraphQL Java实现 都是一个值得掌握的技能。

继续深入学习，你可以探索：GraphQL 入门指南中的高级主题，如 Mutation（数据修改）、分页、认证授权等。祝你在 Java构建GraphQL API 的旅程中取得成功！