com.coze.loop.client

Class CozeLoopClientBuilder

java.lang.Object

com.coze.loop.client.CozeLoopClientBuilder

public class CozeLoopClientBuilder
extends Object

Builder for creating CozeLoopClient instances.

Constructor Summary

Constructors

Constructor and Description
CozeLoopClientBuilder()

Method Summary

Modifier and Type	Method and Description
CozeLoopClientBuilder	auth(Auth auth) Use custom authentication.
CozeLoopClientBuilder	baseUrl(String baseUrl) Set base URL (optional, default: "https://api.coze.cn").
CozeLoopClient	build() Build the CozeLoopClient instance.
CozeLoopClientBuilder	config(CozeLoopConfig config) Set configuration (optional).
CozeLoopClientBuilder	finishEventProcessor(FinishEventProcessor processor) Set finish event processor for span finish events.
CozeLoopClientBuilder	jwtOAuth(String clientId, String privateKey, String publicKeyId) Use JWT OAuth authentication.
CozeLoopClientBuilder	maxSpanExportBatchSize(int size) Set maximum span export batch size (default: 100).
CozeLoopClientBuilder	maxSpanExportQueueSize(int size) Set maximum span queue size (default: 1024).
CozeLoopClientBuilder	serviceName(String serviceName) Set service name (optional, default: "cozeloop-java-app").
CozeLoopClientBuilder	spanExportScheduleDelay(long delayMillis) Set schedule delay between batch exports in milliseconds (default: 1000).
CozeLoopClientBuilder	spanExportTimeout(long timeoutMillis) Set span exporter timeout in milliseconds (default: 3000).
CozeLoopClientBuilder	tokenAuth(String token) Use token authentication.
CozeLoopClientBuilder	tracePath(String tracePath) Set trace path (optional, default: "/v1/loop/opentelemetry/v1/traces").
CozeLoopClientBuilder	workspaceId(String workspaceId) Set workspace ID (required).

Methods inherited from class java.lang.Object

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

Constructor Detail

CozeLoopClientBuilder

public CozeLoopClientBuilder()

Method Detail

workspaceId

public CozeLoopClientBuilder workspaceId(String workspaceId)

Set workspace ID (required).

Parameters:

workspaceId - the workspace ID

Returns:

this builder

serviceName

public CozeLoopClientBuilder serviceName(String serviceName)

Set service name (optional, default: "cozeloop-java-app").

Parameters:

serviceName - the service name

Returns:

this builder

baseUrl

public CozeLoopClientBuilder baseUrl(String baseUrl)

Set base URL (optional, default: "https://api.coze.cn").

Parameters:

baseUrl - the base URL

Returns:

this builder

tracePath

public CozeLoopClientBuilder tracePath(String tracePath)

Set trace path (optional, default: "/v1/loop/opentelemetry/v1/traces").

Parameters:

tracePath - the trace path

Returns:

this builder

config

public CozeLoopClientBuilder config(CozeLoopConfig config)

Set configuration (optional).

Parameters:

config - the configuration

Returns:

this builder

tokenAuth

public CozeLoopClientBuilder tokenAuth(String token)

Use token authentication.

Parameters:

token - the access token

Returns:

this builder

jwtOAuth

public CozeLoopClientBuilder jwtOAuth(String clientId,
                                      String privateKey,
                                      String publicKeyId)

Use JWT OAuth authentication.

Parameters:

clientId - the client ID

privateKey - the private key (PEM format)

publicKeyId - the public key ID

Returns:

this builder

auth

public CozeLoopClientBuilder auth(Auth auth)

Use custom authentication.

Parameters:

auth - the authentication provider

Returns:

this builder

finishEventProcessor

public CozeLoopClientBuilder finishEventProcessor(FinishEventProcessor processor)

Set finish event processor for span finish events.

Parameters:

processor - the finish event processor

Returns:

this builder

maxSpanExportQueueSize

public CozeLoopClientBuilder maxSpanExportQueueSize(int size)

Set maximum span queue size (default: 1024). When the queue is full, new spans will be dropped.

Parameters:

size - maximum queue size

Returns:

this builder

maxSpanExportBatchSize

public CozeLoopClientBuilder maxSpanExportBatchSize(int size)

Set maximum span export batch size (default: 100). This is the maximum number of spans sent to the exporter in a single batch.

Parameters:

size - maximum batch size

Returns:

this builder

spanExportTimeout

public CozeLoopClientBuilder spanExportTimeout(long timeoutMillis)

Set span exporter timeout in milliseconds (default: 3000). This is the maximum time to wait for the export to complete.

Parameters:

timeoutMillis - timeout in milliseconds

Returns:

this builder

spanExportScheduleDelay

public CozeLoopClientBuilder spanExportScheduleDelay(long delayMillis)

Set schedule delay between batch exports in milliseconds (default: 1000). This is the time interval between automatic batch exports.

Parameters:

delayMillis - delay in milliseconds

Returns:

this builder

build

public CozeLoopClient build()

Build the CozeLoopClient instance.

Returns:

CozeLoopClient instance