Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 2.81 KB

README.md

File metadata and controls

85 lines (63 loc) · 2.81 KB
Raw

Mambu Java Client

The Mambu Java Client library is an open source library to interact with Mambu's APIs from your Java project. The library interacts with Mambu's REST APIs.

Using the original class files from the Mambu project, the library allows you to easily interact with Mambu via the APIs to retrieve and store information.

The library is continuously updated each time new functionalities are added to the Mambu's REST APIs and it is released once with the main Mambu product.

Usage

To use the Mambu Java API Wrapper, please include the following jars in your build path

  • build/Mambu-APIs-Java-9.6-bin.jar
  • build/Mambu-APIs-Java-9.6-bin-sources.jar
  • lib/mambu-models-V9.6.jar
  • further dependencies to run and test (see pom.xml for versions)
  • httpclient
  • httpcore
  • gson
  • commons-io
  • commons-codec
  • commons-logging
  • google-collect
  • jdo-api
  • guice
  • mockito-all
  • junit
  • datanucleus-core

There is a list of services which are provided through a factory. The list will be updated constantly and currently contains:

  • AccountingService
  • ActivitiesService
  • ClientsService
  • CommentsService
  • CustomFieldValueService
  • CustomViewsService
  • DatabaseService
  • DocumentsService
  • DocumentTemplatesService
  • IntelligenceService
  • LinesOfCreditService
  • LoansService
  • NotificationsService
  • OrganizationService
  • RepaymentsService
  • SavingsService
  • SearchService
  • TasksService
  • UsersService

To use the factory, some date must be provided in order to set it up:

MambuAPIServiceFactory serviceFactory = MambuAPIServiceFactory.getFactory(
	"mydomain.mambu.com", "username", "password");
	
	OR
	
MambuAPIServiceFactory serviceFactory = MambuAPIServiceFactory.getFactory(
	"mydomain.mambu.com", "username", "password", "user agent header value");

After this step, each service can be taken through a simple call like:

ClientService clientService = serviceFactory.getClientService();

See the classes from demo package for a few more examples of using the library

Or check out the javadocs here: http://mambu-gmbh.github.com/Mambu-APIs-Java/

Contributing to the Project

This is a community project and we'd love if you can contribute to make the Mambu API wrapper for Java better.

The project uses Maven for the build process. To make contributions to the project, fork it on GitHub, checkout the project and import it into Eclipse (or your favourite Java IDE) as a Maven 2 project.

Ensure to write JUnit tests for all contributions and rerun all existing tests (under /test) to ensure a high code quality.

When you're done with your changes, commit and push them to your GitHub fork and create a pull request so that we can review your code and incorporate the changes.

The Mambu team updates the Mambu models jar to account for changes in new releases as needed.