Introduction

The Files.com Java client library provides convenient access to the Files.com API from JVM based applications.

Installation

Add the SDK to your Java application with Maven or Gradle. These build tools download the SDK and the libraries it needs. Choose the instructions that match your project's build file. If you are starting your first Java project, the Maven getting-started guide explains how to install Maven and create a project.

The SDK is published to Maven Central as com.files:files-sdk. Use the latest 2.x version shown there in place of 2.0.0 below.

Maven

In your application's pom.xml, add this dependency inside the <dependencies> element under <project>. If <dependencies> already exists, copy only the <dependency> element into it.

<dependencies>
    <dependency>
        <groupId>com.files</groupId>
        <artifactId>files-sdk</artifactId>
        <version>2.0.0</version>
    </dependency>
</dependencies>

From the directory containing pom.xml, download the dependencies and compile your application:

mvn compile

Gradle

In your Java application's build.gradle, add Maven Central to repositories and the SDK to dependencies. Add the entries to those blocks if they already exist.

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.files:files-sdk:2.0.0'
}

For build.gradle.kts, use the Kotlin syntax:

repositories {
    mavenCentral()
}

dependencies {
    implementation("com.files:files-sdk:2.0.0")
}

From your project directory, use its Gradle wrapper to download the dependencies and compile:

./gradlew classes

On Windows, run gradlew.bat classes. If your project has no wrapper, use your installed Gradle with gradle classes.

Requirements

The SDK runs on Java 8 or later. Use a Java release that still receives security updates from its vendor; for new applications we recommend Java 25.

The SDK logs through the SLF4J API and leaves the choice of logging provider to your application; see Logging in the configuration documentation.

Files.com is Committed to Java

Java is a core language used by the Files.com team for internal development. This library is directly used by our official Boomi integration and our official MuleSoft integration.

As such, this library is actively developed and should be expected to be highly performant.

Getting Support

The Files.com Support team provides official support for all of our official Files.com integration tools.

To initiate a support conversation, you can send an Authenticated Support Request or simply send an E-Mail to support@files.com.