Introduction
The
ServiceAPI java client is still in beta (maybe alpha). It is written by a part time Java programmer (me) and as such could probably do with some some re-factoring and re-design.
Try it out
There is a simple console application to be found at java\TrimServiceSamples. It demonstrates authentication and simple things like searching for records. You can run it using run (or winrun.bat on windows). For example: winrun http://localhost/HPRMServiceAPI user_name password.
Code overview
The vast bulk of the code in the java client is a generated Records Manager object model. This is used to allow type safe serialization/de-serialization. The code in the base namespace (com.hp.TrimClient) combines the
Apache Http client and the Google
gson JSON serialization library to interact with the ServiceAPI.
Getting started
The
ServiceAPI Java - Code Samples provides sample code to get started.
Doing a build
I use Eclipse and the steps I follow to setup a new machine for development are:
- download or clone the repository
- open eclipse and select a workspace (not the folder the source code is in)
- File - Import - General - Existing Projects into Workspace
- in 'Select root directory select the 'TrimServiceClient' folder
- select defaults from there on
Unit Tests
The project contains a few unit tests. Most of these should work but a few require the presence of a local ServiceAPI instance with a particular set of data. There are no plans to make this generally available unless the need arises.