How do I set up GraphQL SPQR with Spring Boot?

This demo provides a simple setup: package with Maven and run the jar. It exposes endpoints at /graphql and /gui, but for custom configurations, refer to the main GraphQL SPQR library documentation and Spring Boot properties.

GraphQL SPQR or GraphQL Java: which is better for Spring Boot?

GraphQL SPQR simplifies schema generation from Java code with annotations, reducing boilerplate, while GraphQL Java offers more control. For rapid development in Spring Boot, SPQR is often preferred for its integration ease.

How can I test GraphQL APIs in a Java application?

Use the built-in GraphQL Playground at /gui in this demo for interactive testing. For automated tests, you'll need to implement unit tests with frameworks like JUnit and Mockito, as this sample doesn't cover that.

Does GraphQL SPQR support subscriptions?

This sample doesn't demonstrate subscriptions; GraphQL SPQR itself supports them, but you'll need to extend the setup with additional configuration and reactive programming, which isn't shown here.

How to add authentication to a GraphQL SPQR Spring Boot app?

This demo lacks authentication; in a real project, integrate Spring Security and use GraphQL SPQR's context or custom data fetchers to handle authorization, which requires additional coding beyond the sample.

graphql-spqr-samples

Apache-2.0JavaScript

A minimal Spring Boot demo application showcasing the capabilities of the GraphQL SPQR library.

GitHub

105 stars59 forks0 contributors

What is graphql-spqr-samples?

GraphQL-SPQR Spring Boot Samples is a minimal demo application that showcases the capabilities of the GraphQL SPQR library within a Spring Boot environment. It provides a ready-to-run example for developers to explore GraphQL API implementation, including interactive query testing via GraphQL Playground. The project solves the need for a practical, hands-on demonstration of how to integrate GraphQL SPQR into Java applications.

Target Audience

Java developers, particularly those using Spring Boot, who want to learn or demonstrate GraphQL SPQR integration in their projects. It's also useful for presenters and educators needing live demo examples for talks or workshops.

Value Proposition

Developers choose this project because it offers a straightforward, runnable example focused on live demonstration rather than heavy documentation, enabling quick understanding and experimentation with GraphQL SPQR features in a familiar Spring Boot setup.

Overview

Minimal demo app for graphql-spqr

Use Cases

Best For

Demonstrating GraphQL SPQR library features in presentations

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

Learning GraphQL API integration with Spring Boot

Testing GraphQL queries interactively using GraphQL Playground

Exploring GraphQL schema introspection in Java applications

Setting up a quick GraphQL backend example for educational purposes

Understanding how to expose GraphQL endpoints in a Spring Boot app

Not Ideal For

Production applications requiring robust error handling, security, and monitoring
Developers seeking comprehensive tutorials or detailed step-by-step documentation
Projects needing advanced GraphQL features like real-time subscriptions or complex data persistence

Pros & Cons

Pros

Easy Spring Boot Integration

Demonstrates a minimal setup with Spring Boot, running on port 8000 out of the box, making it quick to start and experiment.

Built-in Interactive Testing

Includes GraphQL Playground mapped to /gui, allowing developers to test queries and mutations visually without external tools.

Practical Example Queries

Provides sample queries in method Javadocs, offering immediate reference points for learning GraphQL SPQR's capabilities.

Cons

Minimal Documentation

The README explicitly states it's not documentation, so users must rely on external resources for in-depth guidance and troubleshooting.

Limited Production Features

Focuses on basic demos; lacks examples of authentication, database integration, error handling, or performance optimizations needed for real-world use.

Frequently Asked Questions

Home

GraphQL

light-java-graphql examples

Example APIs or services to demo all feature of the light-4j framework

Stars149

Forks65

Last commit6 days ago

graphql-java-kickstart_samples

Samples for using the graphql java kickstart projects

Stars121

Forks40

Last commit26 days ago

dgs-federation-example

This project is a practical example of implementing GraphQL federation using Netflix's Domain Graph Service (DGS) framework alongside Apollo Federation Server. It illustrates how to decompose a GraphQL schema across multiple microservices, enabling teams to independently develop and deploy their GraphQL services while maintaining a unified API for clients. ## Key Features - **Federated Schema Composition** — Combines GraphQL types from separate services (`shows-dgs` and `reviews-dgs`) into a single federated graph. - **Multi-language Services** — Demonstrates DGS usage with both Kotlin and Java, showcasing framework flexibility. - **Apollo Federation Gateway** — Uses Apollo Server as the federated gateway to route queries to the appropriate services. - **Independent Service Development** — Each service (shows, reviews) is a standalone Gradle project that can be developed and run independently. ## Architecture The example consists of three components: a Kotlin-based `shows-dgs` service providing core `Show` data, a Java-based `reviews-dgs` service extending the `Show` type with reviews, and an `apollo-gateway` Node.js service that federates the schemas and serves as the entry point for client queries. ## Philosophy The project follows a microservices-based approach to GraphQL, promoting separation of concerns and team autonomy while maintaining a cohesive API through federation.

Stars114

Forks45

Last commit2 years ago