npalm/graphql-java-demo

镜像概述

本镜像包含一个Spring Boot 2.x服务，实现了GraphQL API，基于graphql-java-tools（Schema优先的GraphQL实现）和graphql-spring-boot（Spring Boot Starter），提供会议、演讲、演讲者及评论的管理功能，附带测试数据和多种GraphQL IDE访问入口。

核心功能

• GraphQL操作：支持查询（Query）、突变（Mutation）和订阅（Subscription）
• 数据模型：会议（Conferences）、演讲（Talks）、演讲者（Speakers）、评论（Comments）的关联管理
• IDE支持：集成GraphiQL、Prisma GraphQL Playground、Altair GraphQL Client
• 测试数据：启动时自动加载预设测试数据
• WebSocket订阅：支持通过WebSocket接收评论更新

使用场景

• 学习GraphQL在Java/Spring Boot中的实现
• 演示GraphQL的基本操作（查询、新增、订阅）
• 测试GraphQL客户端工具的交互效果

配置说明

Docker部署示例

1. 运行PostgreSQL容器：

bash
docker run -d --name postgres -e POSTGRES_PASSWORD=password postgres:12

2. 启动GraphQL演示镜像：

bash
docker run -d --name graphql-demo -p 8080:8080 --link postgres npalm/graphql-java-demo

3. 访问入口：
   • GraphiQL：http://localhost:8080/graphiql
   • Playground：http://localhost:8080/playground
   • Altair：http://localhost:8080/altair
   • WebSocket订阅：ws://localhost:8080/subscriptions

示例操作

• 查询会议及演讲信息：

graphql
query {
  conferences {
    name
    city
    talks {
      title
      speakers { name }
    }
  }
}

• 新增演讲者：

graphql
mutation {
  addPerson(person: {name: "John Doe"}) { id }
}

• 订阅评论更新：

graphql
subscription {
  comments {
    comment
    author
    talk { title }
    createdOn
  }
}

测试数据来源

启动时自动加载以下CSV文件中的测试数据：

• src/main/resources/csv/conferences.csv（会议）
• src/main/resources/csv/speakers.csv（演讲者）
• src/main/resources/csv/talks.csv（演讲）
• 数据关联基于名称匹配，支持逗号分隔的多值列表。