1. Architecture Tutorial Client Side Library Dr. Sheng Jiang Provenance Team sj@ecs.soton.ac.uk

2. Architecture Tutorial 2 Concept and role of CSL Client Side Library (CSL) is a collection of functions, which –allows provenance-aware applications to communicate with provenance store services –helps application developers enforce architecture rules An implementation of the CSL should contain at least one of query library, record library and management library CSL is intends to be embedded as part of provenance-aware applications

3. Architecture Tutorial 3 Interaction of Application Actor AActor B Message Host AHost B

4. Architecture Tutorial 4 Provenance-aware Application Message (embedded p-header) Host AHost B Actor AActor B CSL Source: hostA Sink: hostB VK: isSender PAssertions Provenance Store Server CSL Source: hostA Sink: hostB VK: isReceiver PAssertions Provenance Store Server

5. Architecture Tutorial 5 Layered Model of CSL Client Side Library Applications Provenance Store Server Application API Utilities Server API

6. Architecture Tutorial 6 Server API Defined our provenance store interface in several WSDL files –WSRF compatible Generated stubs from these WSDL –Using WSDL2Java from the GT4 –Used as server API Security is not enabled yet Too complicated to be used by application developers

7. Architecture Tutorial 7 Application API Simple interfaces and data structures Re-usable information Helper facilities –Relationship helper –Documentation style helper, Policy helper, P- Header helper, Tracer helper (not available yet) Is Mapped to the server API using utilities

8. Architecture Tutorial 8 Simple Example ProvenanceService ps = new ProvenanceServiceImpl (recordPort, xQueryPort, pQueryPort) InteractionRecord irInstance = ps.newInteractionRecord (msgSink, msgSource, asserter, viewKind) GlobalPAssertionKey gpakIPA = irInstance.addInteractionPAssertion(message, documentationStyle) RecordResult rResult = irInstance.record()