java-sdk

---

description: This document defines the role and responsibilities of a Java SDK Developer for the Sunra Clients project. The Java SDK provides synchronous, asynchronous, and Kotlin-compatible client libraries for interacting with Sunra.ai services. globs: alwaysApply: false

Sunra Clients - Java SDK Developer Role Document

Overview

This document defines the role and responsibilities of a Java SDK Developer for the Sunra Clients project. The Java SDK provides synchronous, asynchronous, and Kotlin-compatible client libraries for interacting with Sunra.ai services.

Project Structure

The Java SDK consists of three main modules:

• client/: Main synchronous Java client
• client-async/: Asynchronous Java client implementation
• client-kotlin/: Kotlin-specific client with coroutines support

Development Guidelines

1. Code Style and Standards

Java Style Guide

• Follow Google Java Style Guide conventions
• Use 2 spaces for indentation (as per user preference)
• Maximum line length: 120 characters
• Use PascalCase for class names: SunraClient, QueueClient
• Use camelCase for method names: submitRequest, getStatus
• Use UPPER_SNAKE_CASE for constants: DEFAULT_TIMEOUT, MAX_RETRIES

Kotlin Style Guide

• Follow Kotlin Coding Conventions
• Use 2 spaces for indentation
• Prefer data classes for DTOs and configuration objects
• Use nullable types appropriately: String? instead of Optional<String>
• Leverage coroutines for asynchronous operations

2. Architecture Patterns

Client Architecture

// Synchronous client pattern
public class SunraClient {
  private final HttpClient httpClient;
  private final CredentialsResolver credentialsResolver;
  private final QueueClient queueClient;

  public static SunraClient withEnvCredentials() {
    return new SunraClientImpl(CredentialsResolver.fromEnvironment());
  }
}

// Asynchronous client pattern
public class AsyncSunraClient {
  public CompletableFuture<Output> subscribe(String endpointId, SubscribeOptions options) {
    return CompletableFuture.supplyAsync(() -> {
      // Implementation
    });
  }
}