Welcome to PReServ's JavaDoc!

Before studying this API documentation in-depth, we suggest you read the Architecture for Provenance Systems document first. The architecture document provides a comprehensive discussion of the ideas that are represented/used in PReServ. It is a must read in order to effectively use and work with PReServ. This API documentation assumes you have read the architecture document.

We also note that this is alpha software. We are still working on making our documentation better. If you have any suggestions don't hesitate to contact us (pg03r@ecs.soton.ac.uk).

Audience
This API is designed with two audiences in mind.

  1. Developers using the PReServ provenance service.
  2. Developers trying to modify, extend, or improve PReServ itself.
For those developers in audience 1, the packages marked (External) will be of most interest to you. Probably, the best staring point for you is to look at org.pasoa.util.ClientLib, which provides a Java API for programatically working with a provenance store. Likewise, org.pasoa.test.examples.ClientLibExample should show you how to use ClientLib.

You will probably find those packages marked (External) to be better documented than those marked (Internal).

If you're in audience 2 then I suggest you contact us (pg03r@ecs.soton.ac.uk) so we can point you in the right direction. We have endeavoured to make PReServ easy to extend and add to by using quite a bit of abstraction but given that this is still alpha software you might need some pointers ;-)

This software is released under an open source license. Please see the distribution's readme for the exact contents or type "ant license".