Setup configuration for Java

Configuration can be loaded from 3 sources:

  • Environment variables
  • System properties
  • Configuration file

Configuration can also be setup manually:

final DataverseConfiguration config = new DataverseConfiguration();
config.set(Key.API_TOKEN, "12345678-1234-1234-1234-123456789012");
config.set(Key.DEFAULT_DATAVERSE, "curare");
config.set(Key.CURARE_INSTANCE_URL, "https://data-preproduction.inrae.fr");

Check if configuration is valid using config.check().

See:

Environment variables

Set up environment variables in your shell:

export CURARE_API_TOKEN=12345678-1234-1234-1234-123456789012
export CURARE_INSTANCE_URL=https://data-preproduction.inrae.fr
export CURARE_DEFAULT_DATAVERSE=curare

Load environment variables:

final DataverseConfiguration config = new DataverseConfiguration();
config.loadEnvironmentVariables();

System properties

Load system properties:

final DataverseConfiguration config = new DataverseConfiguration();
config.loadSystemProperties();

Run your application:

java -jar your_app.jar \
-Dcurare.api.token=12345678-1234-1234-1234-123456789012 \
-Dcurare.instance.url=https://data-preproduction.inrae.fr \
-Dcurare.default.dataverse=https://data-preproduction.inrae.fr

.env file

Write an .env file in the root of your project:

CURARE_API_TOKEN=12345678-1234-1234-1234-123456789012
CURARE_INSTANCE_URL=https://data-preproduction.inrae.fr
CURARE_DEFAULT_DATAVERSE=curare

Load .env:

final DataverseConfiguration config = new DataverseConfiguration();
config.loadDotEnv();

Run your application:

java -jar your_app.jar