Configuration

The GQLDB Java driver provides flexible configuration options through the GqldbConfig class with a builder pattern.

Configuration Options

The GqldbConfig class supports the following options:

Using the Builder

Create a configuration using the builder pattern:

Java
import com.gqldb.GqldbConfig;
import com.gqldb.GqldbClient;
import java.time.Duration;

// Minimal configuration
GqldbConfig config = GqldbConfig.builder()
    .hosts("192.168.1.100:9000")
    .build();

// Full configuration
GqldbConfig fullConfig = GqldbConfig.builder()
    .hosts("server1:9000", "server2:9000")
    .username("admin")
    .password("secret")
    .defaultGraph("myGraph")
    .timeout(60)                              // 60 seconds
    .maxRecvSize(128 * 1024 * 1024)          // 128MB
    .poolSize(20)
    .retryCount(5)
    .retryDelay(Duration.ofMillis(200))
    .build();

GqldbClient client = new GqldbClient(config);

Builder Methods

TLS/SSL Configuration

For secure connections, configure an SSL context:

Java
import com.gqldb.GqldbConfig;
import com.gqldb.GqldbClient;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManagerFactory;
import java.security.KeyStore;
import java.io.FileInputStream;

// Load the trust store
KeyStore trustStore = KeyStore.getInstance("JKS");
try (FileInputStream fis = new FileInputStream("/path/to/truststore.jks")) {
    trustStore.load(fis, "truststorePassword".toCharArray());
}

// Create trust manager
TrustManagerFactory tmf = TrustManagerFactory.getInstance(
    TrustManagerFactory.getDefaultAlgorithm());
tmf.init(trustStore);

// Create SSL context
SSLContext sslContext = SSLContext.getInstance("TLS");
sslContext.init(null, tmf.getTrustManagers(), null);

// Configure client with SSL
GqldbConfig config = GqldbConfig.builder()
    .hosts("secure-server:9000")
    .sslContext(sslContext)
    .build();

GqldbClient client = new GqldbClient(config);

Environment Variables

You can load configuration from environment variables:

Java
import com.gqldb.GqldbConfig;
import com.gqldb.GqldbClient;
import java.util.Arrays;

String hostsEnv = System.getenv("GQLDB_HOSTS");
String[] hosts = hostsEnv != null ? hostsEnv.split(",") : new String[]{"192.168.1.100:9000"};

GqldbConfig config = GqldbConfig.builder()
    .hosts(hosts)
    .username(System.getenv("GQLDB_USERNAME"))
    .password(System.getenv("GQLDB_PASSWORD"))
    .defaultGraph(System.getenv("GQLDB_DEFAULT_GRAPH"))
    .timeout(Integer.parseInt(System.getenv().getOrDefault("GQLDB_TIMEOUT", "30")))
    .build();

GqldbClient client = new GqldbClient(config);

Configuration Validation

The build() method validates the configuration:

• hosts must be non-empty
• timeout must be non-negative

Java
import com.gqldb.GqldbConfig;

try {
    GqldbConfig config = GqldbConfig.builder()
        .hosts()  // Empty hosts - will throw
        .build();
} catch (IllegalArgumentException e) {
    System.err.println("Invalid configuration: " + e.getMessage());
}

Accessing Configuration

Retrieve configuration values from an existing config:

Java
GqldbConfig config = client.getConfig();
System.out.println("Hosts: " + config.getHosts());
System.out.println("Default graph: " + config.getDefaultGraph());
System.out.println("Timeout: " + config.getTimeout() + " seconds");
System.out.println("Max receive size: " + config.getMaxRecvSize() + " bytes");
System.out.println("Pool size: " + config.getPoolSize());
System.out.println("Retry count: " + config.getRetryCount());