• Topic
  • Discussion
  • VOS.VirtInteractSpongerMiddlewareRESTPatterns(Last) -- Owiki? , 2018-04-13 12:06:44 Edit owiki 2018-04-13 12:06:44

    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 ExampleSort in ascending order
    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