寻求适用于Java服务端通信的GraphQL Java客户端库建议

Hey there! Let me start by clearing up a common misconception: Apollo GraphQL does have a robust Java client that works flawlessly for pure server-side Java applications—you don’t need to be using Android at all. It’s easy to miss because Apollo’s Android docs get more attention, but the core Java client is fully optimized for server-to-server scenarios.

Below are my top recommendations tailored to your needs, with practical examples to get you started:

1. Apollo GraphQL Java Client #

This is one of the most mature options, offering type-safe code generation, flexible request patterns, and extensive customization.

• Key features:
  • Generates Java classes from your GraphQL schema/queries, eliminating manual JSON parsing
  • Supports synchronous, asynchronous, and reactive requests
  • Built-in caching, request batching, and custom interceptors for auth/headers
• Quick example:
  First add Maven dependencies:

  <dependency>
    <groupId>com.apollographql.apollo</groupId>
    <artifactId>apollo-runtime</artifactId>
    <version>2.5.14</version> <!-- Use the latest stable version -->
  </dependency>
  <dependency>
    <groupId>com.apollographql.apollo</groupId>
    <artifactId>apollo-compiler</artifactId>
    <version>2.5.14</version>
    <scope>provided</scope>
  </dependency>
  

  Define a GraphQL query file (e.g., GetUser.graphql):

  query GetUser($userId: ID!) {
    user(id: $userId) {
      id
      name
      email
    }
  }
  

  The compiler will generate a GetUserQuery class. Use it in your code:

  // Initialize client
  ApolloClient apolloClient = ApolloClient.builder()
      .serverUrl("https://your-graphql-endpoint.com/graphql")
      .addHttpInterceptor(chain -> {
        // Add auth headers if needed
        Request request = chain.request().newBuilder()
            .addHeader("Authorization", "Bearer YOUR_TOKEN")
            .build();
        return chain.proceed(request);
      })
      .build();
  
  // Synchronous request
  GetUserQuery query = GetUserQuery.builder().userId("123").build();
  Response<GetUserQuery.Data> response = apolloClient.query(query).execute();
  
  if (response.hasErrors()) {
    // Handle GraphQL errors
    System.err.println("Query failed: " + response.errors());
  } else {
    GetUserQuery.User user = response.data().user();
    System.out.println("Fetched user: " + user.name() + " (" + user.email() + ")");
  }
  

2. Spring GraphQL Client #

If your project is built on Spring Boot, this is the most seamless choice—integrated directly into the Spring ecosystem.

• Key features:
  • Works with Spring’s reactive and synchronous programming models
  • Minimal configuration, native support for GraphQL subscriptions
  • Easily integrates with Spring Security for auth
• Quick example:
  Add the Spring Boot starter:

  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-graphql</artifactId>
  </dependency>
  

  Configure and use the client:

  @Configuration
  public class GraphQLClientConfig {
    @Bean
    public GraphQLClient graphQLClient() {
      return GraphQLClient.create("https://your-graphql-endpoint.com/graphql");
    }
  }
  
  @Service
  public class UserService {
    private final GraphQLClient graphQLClient;
  
    public UserService(GraphQLClient graphQLClient) {
      this.graphQLClient = graphQLClient;
    }
  
    public User fetchUser(String userId) {
      String query = """
          query GetUser($userId: ID!) {
            user(id: $userId) {
              id
              name
              email
            }
          }
          """;
  
      // Synchronous call (use subscribe() for reactive flows)
      return graphQLClient.document(query)
          .variable("userId", userId)
          .retrieve("user")
          .toEntity(User.class)
          .block();
    }
  }
  

3. Netflix DGS Client #

Developed by Netflix for their DGS (GraphQL Server) framework, this lightweight client is perfect for microservice environments.

• Key features:
  • Type-safe code generation similar to Apollo
  • Built-in support for batch requests and error handling
  • Works independently or paired with the DGS server
• Quick example:
  Add the dependency:

  <dependency>
    <groupId>com.netflix.graphql.dgs</groupId>
    <artifactId>dgs-client</artifactId>
    <version>5.4.1</version> <!-- Use latest version -->
  </dependency>
  

  Generate query classes and use the client:

  DgsClient dgsClient = DgsClient.create("https://your-graphql-endpoint.com/graphql");
  
  GetUserQuery query = GetUserQuery.newRequest().userId("123").build();
  User user = dgsClient.executeAndExtractJsonPath(query, "data.user", User.class);
  

4. Plain HTTP Client (Low-Level Option) #

If you don’t need type safety and want a no-frills approach, use Java’s built-in HttpClient or OkHttp to send raw POST requests.

• Quick example with OkHttp:

  OkHttpClient client = new OkHttpClient();
  
  String requestBody = """
      {
        "query": "query GetUser($userId: ID!) { user(id: $userId) { id name email } }",
        "variables": { "userId": "123" }
      }
      """;
  
  Request request = new Request.Builder()
      .url("https://your-graphql-endpoint.com/graphql")
      .post(RequestBody.create(requestBody, MediaType.parse("application/json")))
      .addHeader("Authorization", "Bearer YOUR_TOKEN")
      .build();
  
  try (Response response = client.newCall(request).execute()) {
    if (!response.isSuccessful()) throw new IOException("Request failed: " + response);
    // Parse response with Jackson/Gson
    String jsonResponse = response.body().string();
    User user = new ObjectMapper().readTree(jsonResponse).get("data").get("user").traverse().readValueAs(User.class);
  }
  

Final Recommendation #

• For type safety and broad compatibility: Go with Apollo Java Client
• For Spring Boot projects: Spring GraphQL Client is the most integrated choice
• For microservice environments: Netflix DGS Client pairs well with cloud-native architectures
• For simple, one-off requests: Use a plain HTTP client

内容的提问来源于stack exchange，提问作者Hana Giat