Java OkHttp Proxy Integration

OkHttp is one of the most popular HTTP clients in the Java ecosystem. It supports proxy configuration natively through java.net.Proxy and authenticators, making it straightforward to route traffic through Hex Proxies.

Basic Proxy Configuration

The simplest setup creates an OkHttp client that routes all requests through the Hex Proxies gateway:

import okhttp3.*;
import java.net.InetSocketAddress;
import java.net.Proxy;

public class ProxyClient { public static void main(String[] args) throws Exception { Proxy proxy = new Proxy( Proxy.Type.HTTP, new InetSocketAddress("gate.hexproxies.com", 8080) );

Authenticator proxyAuth = (route, response) -> { String credential = Credentials.basic("YOUR_USERNAME", "YOUR_PASSWORD"); return response.request().newBuilder() .header("Proxy-Authorization", credential) .build(); };

OkHttpClient client = new OkHttpClient.Builder() .proxy(proxy) .proxyAuthenticator(proxyAuth) .connectTimeout(15, java.util.concurrent.TimeUnit.SECONDS) .readTimeout(30, java.util.concurrent.TimeUnit.SECONDS) .build();

Request request = new Request.Builder() .url("https://httpbin.org/ip") .build();

try (Response response = client.newCall(request).execute()) { System.out.println("Status: " + response.code()); System.out.println("Body: " + response.body().string()); } } } ```

Sticky Sessions

For workflows that require the same IP across multiple requests — such as logging in and then navigating authenticated pages — append a session identifier to your username:

String stickyUser = "YOUR_USERNAME-session-abc123";
Authenticator stickyAuth = (route, response) -> {
    String credential = Credentials.basic(stickyUser, "YOUR_PASSWORD");
    return response.request().newBuilder()
        .header("Proxy-Authorization", credential)
        .build();
};

OkHttpClient stickyClient = new OkHttpClient.Builder() .proxy(proxy) .proxyAuthenticator(stickyAuth) .build(); ```

Rotation Strategy

For large-scale data collection, create a new client per batch or use a connection pool with short keep-alive times. Each new connection through gate.hexproxies.com automatically assigns a fresh IP from a 10M+ residential network accessed through partner agreements.

Error Handling with Retry

int maxRetries = 3;
for (int attempt = 1; attempt <= maxRetries; attempt++) {
    try (Response response = client.newCall(request).execute()) {
        if (response.isSuccessful()) {
            System.out.println(response.body().string());
            break;
        }
        if (response.code() == 429 || response.code() == 503) {
            Thread.sleep(attempt * 2000L);
            continue;
        }
        System.err.println("Failed with status: " + response.code());
        break;
    } catch (java.io.IOException e) {
        if (attempt == maxRetries) throw e;
        Thread.sleep(attempt * 2000L);
    }
}

SOCKS5 Support

OkHttp also supports SOCKS5 proxies for protocols beyond HTTP:

Proxy socks5 = new Proxy(
    Proxy.Type.SOCKS,
    new InetSocketAddress("gate.hexproxies.com", 1080)
);

Performance Considerations

• Reuse OkHttpClient instances across requests to benefit from connection pooling.
• Set explicit timeouts to avoid blocking threads on slow proxy responses.
• Use the ConnectionPool class to control maximum idle connections and keep-alive duration.