ASL HTTP ContentAccess

From Gcube Wiki
Revision as of 15:08, 28 August 2012 by Rena.tsantouli (Talk | contribs) (retrieval of information about content)

Jump to: navigation, search

The ASL HTTP ContentAccess component is part of the HTTP Front End Framework and provides aggregated functionality for accessing gCube content. It follows the all the framework principles for data interchange formats, error handling, and context management, supporting both JSON and XML, using the common framework utilities for user authentication and HTTP error responses, supporting all authentication modes and following the suggested design patterns for scope management and session management as well as coding guidelines. The features provided are listed as follows:

retrieval of information about content

retrieval of content

A client is able to retrieve gCube content by submitting an HTTP GET request to the ContentViewer servlet of the ContentAccess set of services. Through the Content Viewer it is possible to retrieve content not only for main gCube documents but also for any other type of elements in the system, including annotations, metadata, parts and alternative representations. In case of none main documents, a supplement parameter must be added to the request, indicating the element type. The client can also optionally choose whether to save or not the content by using the "save" parameter. The content is rendered by the servlet with mime type, name and length information filled in the HTTP response.

Parameters needed: documentURI (mandatory), elementTypee (optional), scope (optional), responseType (xml/json, optional) URL request example:

    • main document: dl09.di.uoa.gr:8787/aslHttpContentAccess/ContentViewer?documentURI=cms://7f78c200-f877-11dd-8103-acc6e633ea9e/d5452ca0-f877-11dd-8103-acc6e633ea9e
    • alternative representation: localhost:8080/aslHttpContentAccess/ContentViewer?documentURI=cms://7f78c200-f877-11dd-8103-acc6e633ea9e/d5452ca0-f877-11dd-8103-acc6e633ea9e/d5843170-f877-11dd-8103-acc6e633ea9e&elementType=alternative

retrieval of metadata

retrieval of thumbnails