com.datastax.oss.driver.api.core.config

Interface DriverExecutionProfile

All Superinterfaces:

OngoingConfigOptions<DriverExecutionProfile>

public interface DriverExecutionProfile
extends OngoingConfigOptions<DriverExecutionProfile>

A profile in the driver's configuration.

It is a collection of typed options.

Getters (such as getBoolean(DriverOption)) are self-explanatory.

withXxx methods (such as OngoingConfigOptions.withBoolean(DriverOption, boolean)) create a "derived" profile, which is an on-the-fly copy of the profile with the new value (which might be a new option, or overwrite an existing one). If the original configuration is reloaded, all derived profiles get updated as well. For best performance, such derived profiles should be used sparingly; it is better to have built-in profiles for common scenarios.

See Also:

DriverConfig

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_NAME The name of the default profile (the string "default").

Method Summary

Modifier and Type	Method and Description
SortedSet<Map.Entry<String,Object>>	entrySet() Enumerates all the entries in this profile, including those that were inherited from another profile.
boolean	getBoolean(DriverOption option)
default boolean	getBoolean(DriverOption option, boolean defaultValue)
List<Boolean>	getBooleanList(DriverOption option)
default List<Boolean>	getBooleanList(DriverOption option, List<Boolean> defaultValue)
long	getBytes(DriverOption option)
default long	getBytes(DriverOption option, long defaultValue)
List<Long>	getBytesList(DriverOption option)
default List<Long>	getBytesList(DriverOption option, List<Long> defaultValue)
Object	getComparisonKey(DriverOption option) Returns a representation of all the child options under a given option.
double	getDouble(DriverOption option)
default double	getDouble(DriverOption option, double defaultValue)
List<Double>	getDoubleList(DriverOption option)
default List<Double>	getDoubleList(DriverOption option, List<Double> defaultValue)
Duration	getDuration(DriverOption option)
default Duration	getDuration(DriverOption option, Duration defaultValue)
List<Duration>	getDurationList(DriverOption option)
default List<Duration>	getDurationList(DriverOption option, List<Duration> defaultValue)
int	getInt(DriverOption option)
default int	getInt(DriverOption option, int defaultValue)
List<Integer>	getIntList(DriverOption option)
default List<Integer>	getIntList(DriverOption option, List<Integer> defaultValue)
long	getLong(DriverOption option)
default long	getLong(DriverOption option, long defaultValue)
List<Long>	getLongList(DriverOption option)
default List<Long>	getLongList(DriverOption option, List<Long> defaultValue)
String	getName() The name of the profile in the configuration.
String	getString(DriverOption option)
default String	getString(DriverOption option, String defaultValue)
List<String>	getStringList(DriverOption option)
default List<String>	getStringList(DriverOption option, List<String> defaultValue)
Map<String,String>	getStringMap(DriverOption option)
default Map<String,String>	getStringMap(DriverOption option, Map<String,String> defaultValue)
boolean	isDefined(DriverOption option)

Methods inherited from interface com.datastax.oss.driver.api.core.config.OngoingConfigOptions

withBoolean, withBooleanList, withBytes, withBytesList, withClass, withDouble, withDoubleList, withDuration, withDurationList, withInt, withIntList, withLong, withLongList, without, withString, withStringList, withStringMap

Field Detail

DEFAULT_NAME

static final String DEFAULT_NAME

The name of the default profile (the string "default").

Named profiles can't use this name. If you try to declare such a profile, a runtime error will be thrown.

See Also:

Constant Field Values

Method Detail

getName

@NonNull
String getName()

The name of the profile in the configuration.

Derived profiles inherit the name of their parent.

isDefined

boolean isDefined(@NonNull
                  DriverOption option)

getBoolean

boolean getBoolean(@NonNull
                   DriverOption option)

getBoolean

default boolean getBoolean(@NonNull
                           DriverOption option,
                           boolean defaultValue)

getBooleanList

@NonNull
List<Boolean> getBooleanList(@NonNull
                                      DriverOption option)

getBooleanList

@Nullable
default List<Boolean> getBooleanList(@NonNull
                                               DriverOption option,
                                               @Nullable
                                               List<Boolean> defaultValue)

getInt

int getInt(@NonNull
           DriverOption option)

getInt

default int getInt(@NonNull
                   DriverOption option,
                   int defaultValue)

getIntList

@NonNull
List<Integer> getIntList(@NonNull
                                  DriverOption option)

getIntList

@Nullable
default List<Integer> getIntList(@NonNull
                                           DriverOption option,
                                           @Nullable
                                           List<Integer> defaultValue)

getLong

long getLong(@NonNull
             DriverOption option)

getLong

default long getLong(@NonNull
                     DriverOption option,
                     long defaultValue)

getLongList

@NonNull
List<Long> getLongList(@NonNull
                                DriverOption option)

getLongList

@Nullable
default List<Long> getLongList(@NonNull
                                         DriverOption option,
                                         @Nullable
                                         List<Long> defaultValue)

getDouble

double getDouble(@NonNull
                 DriverOption option)

getDouble

default double getDouble(@NonNull
                         DriverOption option,
                         double defaultValue)

getDoubleList

@NonNull
List<Double> getDoubleList(@NonNull
                                    DriverOption option)

getDoubleList

@Nullable
default List<Double> getDoubleList(@NonNull
                                             DriverOption option,
                                             @Nullable
                                             List<Double> defaultValue)

getString

@NonNull
String getString(@NonNull
                          DriverOption option)

getString

@Nullable
default String getString(@NonNull
                                   DriverOption option,
                                   @Nullable
                                   String defaultValue)

getStringList

@NonNull
List<String> getStringList(@NonNull
                                    DriverOption option)

getStringList

@Nullable
default List<String> getStringList(@NonNull
                                             DriverOption option,
                                             @Nullable
                                             List<String> defaultValue)

getStringMap

@NonNull
Map<String,String> getStringMap(@NonNull
                                         DriverOption option)

getStringMap

@Nullable
default Map<String,String> getStringMap(@NonNull
                                                  DriverOption option,
                                                  @Nullable
                                                  Map<String,String> defaultValue)

getBytes

long getBytes(@NonNull
              DriverOption option)

Returns:

a size in bytes. This is separate from getLong(DriverOption), in case implementations want to allow users to provide sizes in a more human-readable way, for example "256 MB".

getBytes

default long getBytes(@NonNull
                      DriverOption option,
                      long defaultValue)

getBytesList

@NonNull
List<Long> getBytesList(DriverOption option)

See Also:

getBytes(DriverOption)

getBytesList

@Nullable
default List<Long> getBytesList(DriverOption option,
                                          @Nullable
                                          List<Long> defaultValue)

getDuration

@NonNull
Duration getDuration(@NonNull
                              DriverOption option)

getDuration

@Nullable
default Duration getDuration(@NonNull
                                       DriverOption option,
                                       @Nullable
                                       Duration defaultValue)

getDurationList

@NonNull
List<Duration> getDurationList(@NonNull
                                        DriverOption option)

getDurationList

@Nullable
default List<Duration> getDurationList(@NonNull
                                                 DriverOption option,
                                                 @Nullable
                                                 List<Duration> defaultValue)

getComparisonKey

@NonNull
Object getComparisonKey(@NonNull
                                 DriverOption option)

Returns a representation of all the child options under a given option.

This is only used to compare configuration sections across profiles, so the actual implementation does not matter, as long as identical sections (same options with same values, regardless of order) compare as equal and have the same hashCode().

entrySet

@NonNull
SortedSet<Map.Entry<String,Object>> entrySet()

Enumerates all the entries in this profile, including those that were inherited from another profile.

The keys are raw strings that match DriverOption.getPath().

The values are implementation-dependent. With the driver's default implementation, the possible types are String, Number, Boolean, Map<String,Object>, List<Object>, or null.