io.pinecone.clients

Class Pinecone.Builder

java.lang.Object

io.pinecone.clients.Pinecone.Builder

Enclosing class:

Pinecone

public static class Pinecone.Builder
extends java.lang.Object

A builder class for creating a Pinecone instance. This builder allows for configuring a Pinecone instance with custom parameters including an API key, a source tag, and a custom OkHttpClient.

Constructor Summary

Constructors

Constructor and Description
Builder(java.lang.String apiKey) Constructs a new Pinecone.Builder with the mandatory API key.

Method Summary

Modifier and Type	Method and Description
Pinecone	build() Builds and returns a Pinecone instance configured with the provided API key, optional source tag, and OkHttpClient.
Pinecone.Builder	withOkHttpClient(okhttp3.OkHttpClient okHttpClient) Sets a custom OkHttpClient for the Pinecone client to use for making HTTP requests.
Pinecone.Builder	withProxy(java.lang.String proxyHost, int proxyPort) Sets a proxy for the Pinecone client to use for control and data plane requests.
Pinecone.Builder	withSourceTag(java.lang.String sourceTag) Sets the source tag to include with all requests made by the Pinecone client.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder(java.lang.String apiKey)

Constructs a new Pinecone.Builder with the mandatory API key.

     import io.pinecone.clients.Pinecone;

     Pinecone client = new Pinecone.Builder("PINECONE_API_KEY").build();
 

Parameters:

apiKey - The API key required for authenticating requests to Pinecone services.

Method Detail

withSourceTag

public Pinecone.Builder withSourceTag(java.lang.String sourceTag)

Sets the source tag to include with all requests made by the Pinecone client.

Source tag is an optional string identifier used to help Pinecone attribute API activity to our partners. For more info, see https://docs.pinecone.io/integrations/build-integration/attribute-api-activity

     Pinecone client = new Pinecone.Builder("PINECONE_API_KEY")
         .withSourceTag("YOUR_SOURCE_TAG")
         .build();

     // The tag will be included in all requests made by the client, e.g.
     client.listIndexes();
 

Parameters:

sourceTag - The source tag to identify the origin of the requests.

Returns:

This Pinecone.Builder instance for chaining method calls.

withOkHttpClient

public Pinecone.Builder withOkHttpClient(okhttp3.OkHttpClient okHttpClient)

Sets a custom OkHttpClient for the Pinecone client to use for making HTTP requests.

     import okhttp3.OkHttpClient;

     OkHttpClient myClient = new OkHttpClient();
     Pinecone client = new Pinecone.Builder("PINECONE_API_KEY")
         .withOkHttpClient(myClient)
         .build();

     // Network requests will now be made using your custom OkHttpClient
     client.listIndexes();
 

Parameters:

okHttpClient - The custom OkHttpClient to be used. Must not be null.

Returns:

This Pinecone.Builder instance for chaining method calls.

withProxy

public Pinecone.Builder withProxy(java.lang.String proxyHost,
                                  int proxyPort)

Sets a proxy for the Pinecone client to use for control and data plane requests.

When a proxy is configured using this method, all control and data plane requests made by the Pinecone client will be routed through the specified proxy server.

It's important to note that both proxyHost and proxyPort parameters should be provided to establish the connection to the proxy server.

Example usage:

 String proxyHost = System.getenv("PROXY_HOST");
 int proxyPort = Integer.parseInt(System.getenv("PROXY_PORT"));
 Pinecone pinecone = new Pinecone.Builder("PINECONE_API_KEY")
     .withProxy(proxyHost, proxyPort)
     .build();

 // Network requests for control plane operations will now be made using the specified proxy.
 pinecone.listIndexes();

 // Network requests for data plane operations will now be made using the specified proxy.
 Index index = pinecone.getIndexConnection("PINECONE_INDEX");
 index.describeIndexStats();
 

Parameters:

proxyHost - The hostname or IP address of the proxy server. Must not be null.

proxyPort - The port number of the proxy server. Must not be null.

Returns:

This Pinecone.Builder instance for chaining method calls.

build

public Pinecone build()

Builds and returns a Pinecone instance configured with the provided API key, optional source tag, and OkHttpClient.

This method also performs configuration validation, sets up the internal API client, and manages indexes API with debugging options based on the environment variables.

Returns:

A new Pinecone instance configured based on the builder parameters.