A Java and Retrofit2 based Fineract Client Library that you can use to interact with the Apache Fineract 1.x Platform. This library is autogenerated using Swagger Codegen. It can be used in Android or any Java and Kotlin Project.
To use library in your gradle project follow the steps below:
- Add this in your root
build.gradle
at the end of repositories:allprojects { repositories { ... maven { url 'https://jitpack.io' } } }
- Add the dependency
dependencies { implementation 'com.github.openMF:fineract-client:1.0.1' }
To use the library in your Maven project, follow the steps below:
- Add the JitPack repository to your build file:
<repositories> <repository> <id>jitpack.io</id> <url>https://jitpack.io</url> </repository> </repositories>
- Add the dependency
<dependency> <groupId>com.github.openMF</groupId> <artifactId>fineract-client</artifactId> <version>1.0.1</version> </dependency>
Example code to use the Authentication API:
import org.mifos.fineract.models.PostAuthenticationResponse;
import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
public class Main {
public static void main(String[] args) {
new FineractApiClient().getAuthApi().authenticate("mifos", "password").enqueue(
new Callback<PostAuthenticationResponse>() {
@Override
public void onResponse(Call<PostAuthenticationResponse> call, Response<PostAuthenticationResponse> response) {
System.out.println(response.toString());
PostAuthenticationResponse body = response.body();
if (body != null) {
System.out.println(body.toString());
}
}
@Override
public void onFailure(Call<PostAuthenticationResponse> call, Throwable t) {
System.out.println(t.toString());
}
}
);
}
}
Refer Main.java for full example.
Clone the repository and import as Maven project in IntelliJ IDEA or Eclipse
Before building the project, make sure you have the following things installed.
- Maven
- Java 11
To install the API client library to your local Maven repository, simply execute:
mvn install
To build the library using Gradle, execute the following command
./gradlew build
Refer to the official documentation for more information.