Package com.arangodb

Class ArangoDB.Builder

java.lang.Object

com.arangodb.ArangoDB.Builder

Enclosing interface:

ArangoDB

public static class ArangoDB.Builder
extends Object

Builder class to build an instance of ArangoDB.

Author:

Mark Vollmary

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
ArangoDB.Builder	acquireHostList(Boolean acquireHostList)	Whether the driver should acquire a list of available coordinators in an ArangoDB cluster or a single server with active failover.
ArangoDB.Builder	acquireHostListInterval(Integer acquireHostListInterval)	Setting the Interval for acquireHostList
ArangoDB.Builder	asyncExecutor(Executor executor)	Sets the downstream async executor that will be used to consume the responses of the async API, that are returned as CompletableFuture
ArangoDB	build()	Returns an instance of ArangoDB.
ArangoDB.Builder	chunkSize(Integer chunkSize)	Sets the chunk size when Protocol.VST is used.
ArangoDB.Builder	connectionTtl(Long connectionTtl)	Set the maximum time to life of a connection.
protected com.arangodb.internal.net.HostHandler	createHostHandler(com.arangodb.internal.net.HostResolver hostResolver)
protected Collection<com.arangodb.internal.net.Host>	createHostList(com.arangodb.internal.net.ConnectionFactory connectionFactory)
protected com.arangodb.internal.net.HostResolver	createHostResolver(Collection<com.arangodb.internal.net.Host> hosts, com.arangodb.internal.net.ConnectionFactory connectionFactory)
ArangoDB.Builder	host(String host, int port)	Adds a host to connect to.
ArangoDB.Builder	jwt(String jwt)	Sets the JWT for the user authentication.
ArangoDB.Builder	keepAliveInterval(Integer keepAliveInterval)	Set the keep-alive interval for VST connections.
ArangoDB.Builder	loadBalancingStrategy(LoadBalancingStrategy loadBalancingStrategy)	Sets the load balancing strategy to be used in an ArangoDB cluster setup.
ArangoDB.Builder	loadProperties(ArangoConfigProperties properties)
ArangoDB.Builder	maxConnections(Integer maxConnections)	Sets the maximum number of connections the built in connection pool will open per host.
ArangoDB.Builder	password(String password)	Sets the password for the user for authentication.
ArangoDB.Builder	protocol(Protocol protocol)
protected com.arangodb.internal.net.ProtocolProvider	protocolProvider(Protocol protocol)
ArangoDB.Builder	responseQueueTimeSamples(Integer responseQueueTimeSamples)	Setting the amount of samples kept for queue time metrics
ArangoDB.Builder	serde(ArangoSerde serde)	Sets the serde for the user data.
ArangoDB.Builder	sslContext(SSLContext sslContext)	Sets the SSL context to be used when true is passed through useSsl(Boolean).
ArangoDB.Builder	timeout(Integer timeout)	Sets the connection and request timeout in milliseconds.
ArangoDB.Builder	user(String user)	Sets the username to use for authentication.
ArangoDB.Builder	useSsl(Boolean useSsl)	If set to true SSL will be used when connecting to an ArangoDB server.
ArangoDB.Builder	verifyHost(Boolean verifyHost)	Set whether hostname verification is enabled

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

build

public ArangoDB build()

Returns an instance of ArangoDB.

Returns:

ArangoDB

loadProperties

public ArangoDB.Builder loadProperties(ArangoConfigProperties properties)

protocol

public ArangoDB.Builder protocol(Protocol protocol)

host

public ArangoDB.Builder host(String host,
                             int port)

Adds a host to connect to. Multiple hosts can be added to provide fallbacks.

Parameters:

host - address of the host

port - port of the host

Returns:

ArangoDB.Builder

timeout

public ArangoDB.Builder timeout(Integer timeout)

Sets the connection and request timeout in milliseconds.

Parameters:

timeout - timeout in milliseconds

Returns:

ArangoDB.Builder

user

public ArangoDB.Builder user(String user)

Sets the username to use for authentication.

Parameters:

user - the user in the database (default: root)

Returns:

ArangoDB.Builder

password

public ArangoDB.Builder password(String password)

Sets the password for the user for authentication.

Parameters:

password - the password of the user in the database (default: null)

Returns:

ArangoDB.Builder

jwt

public ArangoDB.Builder jwt(String jwt)

Sets the JWT for the user authentication.

Parameters:

jwt - token to use (default: null)

Returns:

ArangoDB.Builder

useSsl

public ArangoDB.Builder useSsl(Boolean useSsl)

If set to true SSL will be used when connecting to an ArangoDB server.

Parameters:

useSsl - whether or not use SSL (default: false)

Returns:

ArangoDB.Builder

sslContext

public ArangoDB.Builder sslContext(SSLContext sslContext)

Sets the SSL context to be used when true is passed through useSsl(Boolean).

Parameters:

sslContext - SSL context to be used

Returns:

ArangoDB.Builder

verifyHost

public ArangoDB.Builder verifyHost(Boolean verifyHost)

Set whether hostname verification is enabled

Parameters:

verifyHost - true if enabled

Returns:

ArangoDB.Builder

chunkSize

public ArangoDB.Builder chunkSize(Integer chunkSize)

Sets the chunk size when Protocol.VST is used.

Parameters:

chunkSize - size of a chunk in bytes

Returns:

ArangoDB.Builder

maxConnections

public ArangoDB.Builder maxConnections(Integer maxConnections)

Sets the maximum number of connections the built in connection pool will open per host.

Defaults:

 Protocol.VST == 1
 Protocol.HTTP_JSON == 20
 Protocol.HTTP_VPACK == 20
 

Parameters:

maxConnections - max number of connections

Returns:

ArangoDB.Builder

connectionTtl

public ArangoDB.Builder connectionTtl(Long connectionTtl)

Set the maximum time to life of a connection. After this time the connection will be closed automatically.

Parameters:

connectionTtl - the maximum time to life of a connection in milliseconds

Returns:

ArangoDB.Builder

keepAliveInterval

public ArangoDB.Builder keepAliveInterval(Integer keepAliveInterval)

Set the keep-alive interval for VST connections. If set, every VST connection will perform a no-op request every keepAliveInterval seconds, to avoid to be closed due to inactivity by the server (or by the external environment, eg. firewall, intermediate routers, operating system).

Parameters:

keepAliveInterval - interval in seconds

Returns:

ArangoDB.Builder

acquireHostList

public ArangoDB.Builder acquireHostList(Boolean acquireHostList)

Whether the driver should acquire a list of available coordinators in an ArangoDB cluster or a single server with active failover. In case of Active-Failover deployment set to true to enable automatic master discovery.

The host list will be used for failover and load balancing.

Parameters:

acquireHostList - whether automatically acquire a list of available hosts (default: false)

Returns:

ArangoDB.Builder

acquireHostListInterval

public ArangoDB.Builder acquireHostListInterval(Integer acquireHostListInterval)

Setting the Interval for acquireHostList

Parameters:

acquireHostListInterval - Interval in milliseconds

Returns:

ArangoDB.Builder

loadBalancingStrategy

public ArangoDB.Builder loadBalancingStrategy(LoadBalancingStrategy loadBalancingStrategy)

Sets the load balancing strategy to be used in an ArangoDB cluster setup. In case of Active-Failover deployment set to LoadBalancingStrategy.NONE or not set at all, since that would be the default.

Parameters:

loadBalancingStrategy - the load balancing strategy to be used (default: LoadBalancingStrategy.NONE

Returns:

ArangoDB.Builder

responseQueueTimeSamples

public ArangoDB.Builder responseQueueTimeSamples(Integer responseQueueTimeSamples)

Setting the amount of samples kept for queue time metrics

Parameters:

responseQueueTimeSamples - amount of samples to keep

Returns:

ArangoDB.Builder

serde

public ArangoDB.Builder serde(ArangoSerde serde)

Sets the serde for the user data. This is used to serialize and deserialize all the data payload such as: - documents, vertexes, edges - AQL bind vars - body payload of requests and responses in ArangoDB.execute(Request, Class)

However, note that the following types will always be serialized and deserialized using the internal serde: - JsonNode - RawJson - RawBytes - BaseDocument - BaseEdgeDocument

Parameters:

serde - custom serde for the user data

Returns:

ArangoDB.Builder

asyncExecutor

public ArangoDB.Builder asyncExecutor(Executor executor)

Sets the downstream async executor that will be used to consume the responses of the async API, that are returned as CompletableFuture

Parameters:

executor - async downstream executor

Returns:

ArangoDB.Builder

protocolProvider

protected com.arangodb.internal.net.ProtocolProvider protocolProvider(Protocol protocol)

createHostHandler

protected com.arangodb.internal.net.HostHandler createHostHandler(com.arangodb.internal.net.HostResolver hostResolver)

createHostResolver

protected com.arangodb.internal.net.HostResolver createHostResolver(Collection<com.arangodb.internal.net.Host> hosts,
                                                                    com.arangodb.internal.net.ConnectionFactory connectionFactory)

createHostList

protected Collection<com.arangodb.internal.net.Host> createHostList(com.arangodb.internal.net.ConnectionFactory connectionFactory)