This document describes the ADUCID® integration library. The library simplifies communication from the Java Runtime Environment (1.5 and higher), by using the R4 interface. The library is the alternative to direct access to the R4 interface for calling web services. This API is used by other adapters (, e.g. the adapter for the Tomcat web server, adapter for spring security).
It is highly recommended to work with Client API or/and Web Platform only as the high level APIs. Abstract Part and R4 Client parts are for ADUCID® masters only.
When reading this document, the following basic knowledge is assumed:
Knowledge of web technologies, integration of web applications and Java programming language is also assumed.
This SDK is supplied as a standard Java library, which can be used by the application as an indirection layer when communicating with the R4 AIM interface.
This layer has the following functions:
SDK has following parts:
See chapters below for details.
The architecture of abstract part is provided in the picture below:
Integrators may create their own implementation of AducidMessageSender, which uses a different technology for calling the AIM server web services. In some cases, integrators may also create their own descendant of the AbstractAducidClient abstract class. It is assumed that the portfolio of available communication methods for RESTful web services or XML/http will be expanded.
To work with abstract part of Java SDK, include api-[version].jar Java library in your application classpath.