org.sonar.api.config

Interface Configuration

All Known Implementing Classes:

ConfigurationBridge

@ScannerSide
 @ServerSide
 @ComputeEngineSide
 @SonarLintSide
public interface Configuration

Component to get effective configuration. Values of properties depend on the runtime environment:

• immutable project or module configuration in scanner.
• global configuration in web server. It does not allow to get the settings overridden on projects.
• project configuration in Compute Engine.

Usage

 public class MyExtension {

   private final Configuration config;

   public MyExtension(Configuration config) {
     this.config = config;
   }
   public void doSomething() {
     String fooValue = config.get("sonar.foo").orElse(null);
     // ..
   }
 }
 

Scanner example

Scanner sensor can get the reference on Configuration directly through SensorContext, without injecting the component into constructor.

 public class MySensor implements Sensor {
    @Override
   public void execute(SensorContext context) {
     String fooValue = context.config().get("sonar.foo").orElse(null);
     // ..
   }
 }
 

For testing, and only for testing, the in-memory implementation MapSettings can be used.

  @Test
 public void my_test() {
   MapSettings settings = new MapSettings();
   settings.setProperty("foo", "bar");
   MyExtension underTest = new MyExtension(settings.asConfig());
   // ...
 }
 

Since:

6.5

See Also:

MapSettings, PropertyDefinition

Method Summary

Modifier and Type	Method and Description
Optional<String>	get(String key) The effective value of the specified property.
default Optional<Boolean>	getBoolean(String key) Effective value as boolean.
default Optional<Double>	getDouble(String key) Effective value as Double.
default Optional<Float>	getFloat(String key) Effective value as Float.
default Optional<Integer>	getInt(String key) Effective value as int.
default Optional<Long>	getLong(String key) Effective value as long.
String[]	getStringArray(String key) Used to read multi-valued properties.
boolean	hasKey(String key)

Method Detail

get

Optional<String> get(String key)

The effective value of the specified property. Can return Optional#empty() if the property is not set and has no defined default value.

If the property is encrypted with a secret key, then the returned value is decrypted.

Throws:

IllegalStateException - if value is encrypted but fails to be decrypted.

hasKey

boolean hasKey(String key)

Returns:

true if the property has a non-default value, else false.

getStringArray

String[] getStringArray(String key)

Used to read multi-valued properties.

See PropertyDefinition.Builder.multiValues(boolean) Multi-valued properties coming from scanner are parsed as CSV lines (ie comma separator and optional double quotes to escape values). Non quoted values are trimmed.
Examples :

• "one,two,three " -> ["one", "two", "three"]
• " one, two, three " -> ["one", "two", "three"]
• "one, , three" -> ["one", "", "three"]
• "one,\"two,three\",\" four \"" -> ["one", "two,three", " four "]

getBoolean

default Optional<Boolean> getBoolean(String key)

Effective value as boolean. It is empty if get(String) is empty or if it does not return "true", even if it's not a boolean representation.

Returns:

true if the effective value is "true", false for any other non empty value. If the property does not have value nor default value, then empty is returned.

getInt

default Optional<Integer> getInt(String key)

Effective value as int.

Returns:

the value as int. If the property does not have value nor default value, then empty is returned.

Throws:

NumberFormatException - if value is not empty and is not a parsable integer

getLong

default Optional<Long> getLong(String key)

Effective value as long.

Returns:

the value as long. If the property does not have value nor default value, then empty is returned.

Throws:

NumberFormatException - if value is not empty and is not a parsable long

getFloat

default Optional<Float> getFloat(String key)

Effective value as Float.

Returns:

the value as Float. If the property does not have value nor default value, then empty is returned.

Throws:

NumberFormatException - if value is not empty and is not a parsable number

getDouble

default Optional<Double> getDouble(String key)

Effective value as Double.

Returns:

the value as Double. If the property does not have value nor default value, then empty is returned.

Throws:

NumberFormatException - if value is not empty and is not a parsable number