# commons-configuration2

## Overview

### Description

Tools to assist in the reading of configuration/preferences files in various formats; requires Java 8.

### Snippets

Apache Maven:

```xml
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-configuration2</artifactId>
    <version>2.12.0</version>
</dependency>
```

### Maven POM File

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
  <parent>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-parent</artifactId>
    <version>81</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <artifactId>commons-configuration2</artifactId>
  <version>2.12.0</version>
  <name>Apache Commons Configuration</name>

<inceptionYear>2001</inceptionYear>
  <description>
    Tools to assist in the reading of configuration/preferences files in various formats; requires Java 8.
  </description>

<properties>
    <commons.componentid>configuration</commons.componentid>
    <commons.module.name>org.apache.commons.configuration2</commons.module.name>
    <commons.release.version>2.12.0</commons.release.version>
    <commons.release.next>2.12.1</commons.release.next>
    <commons.release.desc>(Java 8 or above)</commons.release.desc>
    <commons.jira.id>CONFIGURATION</commons.jira.id>
    <commons.jira.pid>12310467</commons.jira.pid>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <commons.scmPubUrl>https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-configuration</commons.scmPubUrl>
    <log4j.version>2.24.3</log4j.version>
    <slf4j.version>2.0.17</slf4j.version>
    <spring.version>5.3.39</spring.version>
    <commons.release.isDistModule>true</commons.release.isDistModule>
    <project.build.outputTimestamp>2024-06-10T19:02:53Z</project.build.outputTimestamp>
  </properties>

<url>https://commons.apache.org/proper/commons-configuration/</url>

<dependencies>
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-lang3</artifactId>
      <version>3.17.0</version>
    </dependency>
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-text</artifactId>
      <version>1.13.1</version>
    </dependency>
    <dependency>
      <groupId>commons-logging</groupId>
      <artifactId>commons-logging</artifactId>
      <version>1.3.5</version>
      <exclusions>
        <exclusion>
          <groupId>logkit</groupId>
          <artifactId>logkit</artifactId>
        </exclusion>
        <exclusion>
          <groupId>avalon-framework</groupId>
          <artifactId>avalon-framework</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>commons-beanutils</groupId>
      <artifactId>commons-beanutils</artifactId>
      <version>1.10.1</version>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>commons-codec</groupId>
      <artifactId>commons-codec</artifactId>
      <version>1.18.0</version>
      <optional>true</optional>
    </dependency>
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-jexl</artifactId>
      <version>2.1.1</version>
      <optional>true</optional>
    </dependency>
    <!-- More dependencies omitted for brevity -->
  </dependencies>

<build>
   <defaultGoal>clean verify apache-rat:check japicmp:cmp checkstyle:check spotbugs:check pmd:check</defaultGoal>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
        <configuration>
          <systemPropertyVariables>
            <java.awt.headless>true</java.awt.headless>
          </systemPropertyVariables>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>
```

### Metadata

- **Age:** 1 year ago  
- **Licenses:**  
  - Apache-2.0

### Organization

[org.apache.commons](https://central.sonatype.com/namespace/org.apache.commons)

### External Resources

- [Project URL](https://commons.apache.org/proper/commons-configuration/)  
- [Issue Tracker URL](https://issues.apache.org/jira/browse/CONFIGURATION)  
- [Source Control](https://gitbox.apache.org/repos/asf?p=commons-configuration.git)  
- [Continuous Integration](https://github.com/apache/commons-configuration/actions)

### Known Contributors

- Jorge Ferrer  
- Patrick Schmidt  
- Vincent Maurin  
- Gabriele Garuglieri  
- Jamie M. Guillemette  
- Konstantin Shaposhnikov  
- Nicolas De Loof  
- Dennis Kieselhorst  
- Pascal Essiembre  
- Oliver Kopp  
- Raviteja Lokineni  
- The Alchemist  
- Oliver Heger  
- Brian E. Dunbar  
- Claude Warren  
- Gary Gregory  
- Jörg Schaible  
- Henning P. Schmiedehausen  
- dIon Gillard  
- Daniel Rall  
- Martin Poeschl  
- Eric Pugh  
- Ralph Goers  
- Jason van Zyl  
- Rob Tompkins  
- Emmanuel Bourg