org.neo4j.driver.v1

Class Config

java.lang.Object

org.neo4j.driver.v1.Config

@Immutable
public class Config
extends Object

A configuration class to config driver properties.

To build a simple config with custom logging implementation:

 
 Config config = Config
                  .build()
                  .withLogging(new MyLogging())
                  .toConfig();
 
 

To build a more complicated config with tuned connection pool options:

 
 Config config = Config.build()
                          .withEncryption()
                          .withConnectionTimeout(10, TimeUnit.SECONDS)
                          .withMaxConnectionLifetime(30, TimeUnit.MINUTES)
                          .withMaxConnectionPoolSize(10)
                          .withConnectionAcquisitionTimeout(20, TimeUnit.SECONDS)
                          .toConfig();
 
 

Since:

1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Config.ConfigBuilder Used to build new config instances
static class	Config.EncryptionLevel Control the level of encryption to require
static class	Config.LoadBalancingStrategy
static class	Config.TrustStrategy Control how the driver determines if it can trust the encryption certificates provided by the Neo4j instance it is connected to.

Method Summary

Modifier and Type	Method and Description
static Config.ConfigBuilder	build() Start building a Config object using a newly created builder.
static Config.ConfigBuilder	builder() Start building a Config object using a newly created builder.
long	connectionAcquisitionTimeoutMillis()
int	connectionPoolSize() Deprecated. please use maxConnectionPoolSize() instead.
int	connectionTimeoutMillis()
static Config	defaultConfig()
boolean	encrypted()
Config.EncryptionLevel	encryptionLevel() Deprecated.
long	idleTimeBeforeConnectionTest() Pooled connections that have been idle in the pool for longer than this timeout will be tested before they are used again, to ensure they are still live.
Config.LoadBalancingStrategy	loadBalancingStrategy() Load balancing strategy.
Logging	logging() Logging provider
boolean	logLeakedSessions() Check if leaked sessions logging is enabled.
long	maxConnectionLifetimeMillis() Pooled connections older than this threshold will be closed and removed from the pool.
int	maxConnectionPoolSize()
int	maxIdleConnectionPoolSize() Deprecated. please use maxConnectionPoolSize() instead.
ServerAddressResolver	resolver() Server address resolver.
Config.TrustStrategy	trustStrategy()

Methods inherited from class java.lang.Object

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

Method Detail

logging

public Logging logging()

Logging provider

Returns:

the logging provider to use

logLeakedSessions

public boolean logLeakedSessions()

Check if leaked sessions logging is enabled.

Returns:

true if enabled, false otherwise.

connectionPoolSize

@Deprecated
public int connectionPoolSize()

Deprecated. please use maxConnectionPoolSize() instead.

Max number of connections per URL for this driver.

Returns:

the max number of connections

maxIdleConnectionPoolSize

@Deprecated
public int maxIdleConnectionPoolSize()

Deprecated. please use maxConnectionPoolSize() instead.

Max number of idle connections per URL for this driver.

Returns:

the max number of connections

idleTimeBeforeConnectionTest

public long idleTimeBeforeConnectionTest()

Pooled connections that have been idle in the pool for longer than this timeout will be tested before they are used again, to ensure they are still live.

Returns:

idle time in milliseconds

maxConnectionLifetimeMillis

public long maxConnectionLifetimeMillis()

Pooled connections older than this threshold will be closed and removed from the pool.

Returns:

maximum lifetime in milliseconds

connectionTimeoutMillis

public int connectionTimeoutMillis()

Returns:

the configured connection timeout value in milliseconds.

maxConnectionPoolSize

public int maxConnectionPoolSize()

connectionAcquisitionTimeoutMillis

public long connectionAcquisitionTimeoutMillis()

encryptionLevel

@Deprecated
public Config.EncryptionLevel encryptionLevel()

Deprecated.

Returns:

the level of encryption required for all connections.

encrypted

public boolean encrypted()

Returns:

indicator for encrypted communication.

trustStrategy

public Config.TrustStrategy trustStrategy()

Returns:

the strategy to use to determine the authenticity of an encryption certificate provided by the Neo4j instance we are connecting to.

loadBalancingStrategy

@Experimental
public Config.LoadBalancingStrategy loadBalancingStrategy()

Load balancing strategy.

Returns:

the strategy to use.

resolver

public ServerAddressResolver resolver()

Server address resolver.

Returns:

the resolver to use.

build

public static Config.ConfigBuilder build()

Start building a Config object using a newly created builder.

Please use builder() method instead.

Returns:

a new Config.ConfigBuilder instance.

builder

public static Config.ConfigBuilder builder()

Start building a Config object using a newly created builder.

Returns:

a new Config.ConfigBuilder instance.

defaultConfig

public static Config defaultConfig()

Returns:

A config with all default settings