com.arangodb.async

Class ArangoDBAsync.Builder

java.lang.Object

com.arangodb.internal.InternalArangoDBBuilder

com.arangodb.async.ArangoDBAsync.Builder

Enclosing interface:

ArangoDBAsync

public static class ArangoDBAsync.Builder
extends InternalArangoDBBuilder

Builder class to build an instance of ArangoDBAsync.

Author:

Mark Vollmary

Field Summary

Fields inherited from class com.arangodb.internal.InternalArangoDBBuilder

acquireHostList, acquireHostListInterval, chunkSize, connectionTtl, hosts, jwt, keepAliveInterval, loadBalancingStrategy, maxConnections, password, protocol, responseQueueTimeSamples, sslContext, timeout, user, userDataSerde, useSsl, verifyHost

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
ArangoDBAsync.Builder	acquireHostList(Boolean acquireHostList) Whether or not the driver should acquire a list of available coordinators in an ArangoDB cluster or a single server with active failover.
ArangoDBAsync	build() Returns an instance of ArangoDBAsync.
ArangoDBAsync.Builder	chunksize(Integer chunksize) Sets the chunk size when Protocol.VST is used.
ArangoDBAsync.Builder	connectionTtl(Long connectionTtl) Set the maximum time to life of a connection.
ArangoDBAsync.Builder	host(String host, int port) Adds a host to connect to.
ArangoDBAsync.Builder	jwt(String jwt) Sets the JWT for the user authentication.
ArangoDBAsync.Builder	keepAliveInterval(Integer keepAliveInterval) Set the keep-alive interval for VST connections.
ArangoDBAsync.Builder	loadBalancingStrategy(LoadBalancingStrategy loadBalancingStrategy) Sets the load balancing strategy to be used in an ArangoDB cluster setup.
ArangoDBAsync.Builder	loadProperties(ArangoConfigProperties config)
ArangoDBAsync.Builder	maxConnections(Integer maxConnections) Sets the maximum number of connections the built in connection pool will open.
ArangoDBAsync.Builder	password(String password) Sets the password for the user for authentication.
ArangoDBAsync.Builder	responseQueueTimeSamples(Integer responseQueueTimeSamples) Setting the amount of samples kept for queue time metrics
ArangoDBAsync.Builder	serializer(ArangoSerde serialization) Replace the built-in serializer/deserializer with the given one.
ArangoDBAsync.Builder	sslContext(SSLContext sslContext) Sets the SSL context to be used when true is passed through useSsl(Boolean).
ArangoDBAsync.Builder	timeout(Integer timeout) Sets the timeout in milliseconds.
ArangoDBAsync.Builder	user(String user) Sets the username to use for authentication.
ArangoDBAsync.Builder	useSsl(Boolean useSsl) If set to true SSL will be used when connecting to an ArangoDB server.

Methods inherited from class com.arangodb.internal.InternalArangoDBBuilder

createHostHandler, createHostList, createHostResolver, doLoadProperties, serdeProvider, setAcquireHostList, setAcquireHostListInterval, setChunkSize, setConnectionTtl, setHost, setJwt, setKeepAliveInterval, setLoadBalancingStrategy, setMaxConnections, setPassword, setResponseQueueTimeSamples, setSslContext, setTimeout, setUser, setUserDataSerde, setUseSsl, setVerifyHost

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

loadProperties

public ArangoDBAsync.Builder loadProperties(ArangoConfigProperties config)

host

public ArangoDBAsync.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:

ArangoDBAsync.Builder

timeout

public ArangoDBAsync.Builder timeout(Integer timeout)

Sets the timeout in milliseconds. It is used as socket timeout when opening a VecloyStream.

Parameters:

timeout - timeout in milliseconds

Returns:

ArangoDBAsync.Builder

user

public ArangoDBAsync.Builder user(String user)

Sets the username to use for authentication.

Parameters:

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

Returns:

ArangoDBAsync.Builder

password

public ArangoDBAsync.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:

ArangoDBAsync.Builder

jwt

public ArangoDBAsync.Builder jwt(String jwt)

Sets the JWT for the user authentication.

Parameters:

jwt - token to use (default: null)

Returns:

ArangoDBAsync.Builder

useSsl

public ArangoDBAsync.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:

ArangoDBAsync.Builder

sslContext

public ArangoDBAsync.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:

ArangoDBAsync.Builder

chunksize

public ArangoDBAsync.Builder chunksize(Integer chunksize)

Sets the chunk size when Protocol.VST is used.

Parameters:

chunksize - size of a chunk in bytes

Returns:

ArangoDBAsync.Builder

maxConnections

public ArangoDBAsync.Builder maxConnections(Integer maxConnections)

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

In an ArangoDB cluster setup with LoadBalancingStrategy.ROUND_ROBIN set, this value should be at least as high as the number of ArangoDB coordinators in the cluster.

Parameters:

maxConnections - max number of connections (default: 1)

Returns:

ArangoDBAsync.Builder

connectionTtl

public ArangoDBAsync.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.

Returns:

ArangoDBAsync.Builder

keepAliveInterval

public ArangoDBAsync.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:

ArangoDBAsync.Builder

acquireHostList

public ArangoDBAsync.Builder acquireHostList(Boolean acquireHostList)

Whether or not 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 or not automatically acquire a list of available hosts (default: false)

Returns:

ArangoDBAsync.Builder

responseQueueTimeSamples

public ArangoDBAsync.Builder responseQueueTimeSamples(Integer responseQueueTimeSamples)

Setting the amount of samples kept for queue time metrics

Parameters:

responseQueueTimeSamples - amount of samples to keep

Returns:

ArangoDBAsync.Builder

loadBalancingStrategy

public ArangoDBAsync.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:

ArangoDBAsync.Builder

serializer

public ArangoDBAsync.Builder serializer(ArangoSerde serialization)

Replace the built-in serializer/deserializer with the given one.

ATTENTION!: Any registered custom serializer/deserializer or module will be ignored.

Parameters:

serialization - custom serializer/deserializer

Returns:

ArangoDBAsync.Builder

build

public ArangoDBAsync build()

Returns an instance of ArangoDBAsync.

Returns:

ArangoDBAsync