Virtuoso Open-Source Wiki
Virtuoso Open-Source, OpenLink Data Spaces, and OpenLink Ajax Toolkit
Advanced Search
Help?
Location: / Dashboard / Main / VirtSpongerCartridgeProgrammersGuide / VirtInteractSpongerMiddlewareRESTPatterns

Interacting with Sponger Middleware via RESTful Patterns

Sponger functionality can be exploited via RESTful interaction via a variety of URL patterns.

Prequisites

Ensure you have the cartridges_dav.vad package installed. Once in place, the following URL pattern becomes functional: '/about/[rdf|html]/'. Thus, if you've installed Virtuoso on the host example.com, with HTTP listener enabled on port 8080 you would use patterns: http://example.com:8080/about/[rdf|html]/.

Example

The following URLs (using the live Sponger instance behind our URIBurner service) returns a Linked Data resource that describes the musician John Cale, based on data from the MusicBrainz database, optionally rendered as RDF or HTML formats respectively. (The actual description data is exposed in HTML format through value of the foaf:primaryTopic property.)

URL Patterns Reference

The following table presents a list of the supported URL parameters:

Parameter Value Description Example
refresh clean Usage: for overwriting.
The 'clean' usage explicitly clears the graph i.e. will cause the Sponger to drop cache even if it is marked to be in the fly.
Thus, if fetched cache by some reason is left in some inconsistent state like shutdown during Network Resource fetching, then 'clean' is required as it doesn't check cache state.
Note: must be used with caution as other threads may be doing fetching of network resources at same time.
Explicitly clear the graph
sponger:get add Usage: Add new triples to named graphs, progressively. This is the default value for the parameter sponger:get. May be used together with refresh=<seconds> to overwrite the expiration in the cache. Add new triples and refresh on every 10 seconds
sponger:get soft Usage: Network Resource Fetch data subject to cache invalidation mode and associated rules of instance. May be used together with refresh=<seconds> to overwrite the expiration in the cache. Network Resource Fetch data with option soft and refresh on every 10 seconds
sponger:get replace Usage: Replace subject to cache invalidation mode and rules, but coverage includes non fetched triples if such exist in a given named graph. may be used together with refresh=<seconds> to overwrite the expiration in the cache. Replace data and refresh on every 10 seconds

Related

Powered By Virtuoso