Difference between revisions of "SStorageRest"

From Gcube Wiki
Jump to: navigation, search
(→‎Access Mode)
(→‎Getting-Started)
 
(13 intermediate revisions by the same user not shown)
Line 21: Line 21:
 
= Access Mode =
 
= Access Mode =
  
−
The endppoint of the service could be discovered by [https://gcube.wiki.gcube-system.org/gcube/IS-Collector IS-Collector] service. Now it is deployed under SmartArea VO. For accessing to the service it's needed to use the [https://gcube.wiki.gcube-system.org/gcube/Ic-client ic-client] library in the following way:
+
The Endpoint of the SStorageRest service can be discovered by [https://gcube.wiki.gcube-system.org/gcube/IS-Collector IS-Collector] service under the SmartArea VO.  
 +
For accessing to the service it's needed to use the [https://gcube.wiki.gcube-system.org/gcube/Ic-client ic-client] library in the following way:
  
 
<source lang="java">
 
<source lang="java">
−
                SimpleQuery query = queryFor(ServiceEndpoint.class);
+
import static org.gcube.resources.discovery.icclient.ICFactory.*;
−
query.addCondition("$resource/Profile/Category/text() eq '"+sc+"' and $resource/Profile/Name eq '"+sn+"' ");
+
−
DiscoveryClient<ServiceEndpoint> client = clientFor(ServiceEndpoint.class);
+
−
List<ServiceEndpoint> resources = client.submit(query);
+
−
</source>
+
  
−
where "sc" and "sn" are respectively the "ServiceClass" and the "ServiceName" of the resource. In this case the "ServiceClass" is: DataStorage, the "ServiceName" is "SmartStorageREST".
+
...
  
−
The method client.submit(query) return a List of resources (tipically with only one resource) that match the query parameters.
 
  
−
For retrieving the hostname of the Query server, it's needed to scroll the resource found in the follwing way:
+
XQuery query = queryFor(GCoreEndpoint.class);
 +
query.addCondition("$resource/Profile/ServiceClass/text() eq 'content-management'");
 +
query.addCondition("$resource/Profile/ServiceName/text() eq 'storage'");
 +
query.addVariable("$entry","$resource/Profile/AccessPoint/RunningInstanceInterfaces/Endpoint");
 +
query.addCondition("$entry/@EntryName/string() eq 'jersey-serlvet'");
 +
query.setResult("$entry/text()");
 +
DiscoveryClient<String> client = client();
 +
List<String> addresses = client.submit(query);
  
−
<source lang="java">
 
−
String server addresses=resource.profile().accessPoints().get(0).address();
 
 
</source>
 
</source>
  
−
where "resource" is the object returned by the query. the field address can contains one or more server separated by comma.
+
The method "client.submit(query)" returns a List of resources that match the query parameters. In this case the query should return a list with only one element:
 +
 
 +
<source lang="java">
 +
[http://n039.smart-applications.area.pi.cnr.it:8080/storage/rest]
 +
 
 +
</source>
  
 
= Supported Operations =
 
= Supported Operations =
Line 52: Line 58:
 
=  Getting-Started =
 
=  Getting-Started =
  
 +
We introduce the API of the <code>SStorageRest</code> through a set of examples.
 +
 +
Note that, in all the examples, we submit queries to the <code>SStorageRest</code> service. We then need to make sure that we do so in a given scope by a valid gcube-token
  
 
== Maven artifacts ==
 
== Maven artifacts ==
−
it is downloadable by the following nexus server: http://maven.research-infrastructures.eu/nexus
+
The service package is downloadable from the following nexus server: http://maven.research-infrastructures.eu/nexus
  
 
<source lang="xml">
 
<source lang="xml">
 
<groupId>org.gcube.contentmanagement</groupId>
 
<groupId>org.gcube.contentmanagement</groupId>
 
<artifactId>storage-service-rest</artifactId>
 
<artifactId>storage-service-rest</artifactId>
 +
<version>...</version>
  
 
</source>
 
</source>

Latest revision as of 12:25, 22 December 2017


Overview

A RESTful service providing functions for create, update, read a json object on MongoDB

Key features

The core of the service is java based. It offers a interface for performing CRUD operation through a remote backend over JSON object:

  • Create
  • Read
  • Update
  • Delete


Design and Architecture

The architecture implements a multiton pattern. The records are collected in two separated collection: the first one is a collection dedicated to a single SmartApps, the second One is a collection that collects all the records of all the smartApplications.

Access Mode

The Endpoint of the SStorageRest service can be discovered by IS-Collector service under the SmartArea VO. For accessing to the service it's needed to use the ic-client library in the following way: 

import static org.gcube.resources.discovery.icclient.ICFactory.*;
 
...
 
 
XQuery query = queryFor(GCoreEndpoint.class);
query.addCondition("$resource/Profile/ServiceClass/text() eq 'content-management'");
query.addCondition("$resource/Profile/ServiceName/text() eq 'storage'");
query.addVariable("$entry","$resource/Profile/AccessPoint/RunningInstanceInterfaces/Endpoint");
query.addCondition("$entry/@EntryName/string() eq 'jersey-serlvet'");
query.setResult("$entry/text()");
DiscoveryClient<String> client = client();
List<String> addresses = client.submit(query);

The method "client.submit(query)" returns a List of resources that match the query parameters. In this case the query should return a list with only one element: 

[http://n039.smart-applications.area.pi.cnr.it:8080/storage/rest]

Supported Operations

  • create: implemented by http POST method;
  • read : implemented by http GET method;
  • update: implemented by http PUT method;
  • delete: implemented by http DELETE method.

Getting-Started

We introduce the API of the SStorageRest through a set of examples.

Note that, in all the examples, we submit queries to the SStorageRest service. We then need to make sure that we do so in a given scope by a valid gcube-token

Maven artifacts

The service package is downloadable from the following nexus server: http://maven.research-infrastructures.eu/nexus 

<groupId>org.gcube.contentmanagement</groupId>
<artifactId>storage-service-rest</artifactId>
<version>...</version>

Usage examples

To insert (create) a new record in the system, we might use:

  • POST n039.smart-applications.area.pi.cnr.it:8080/storage/rest/resources?gcube-token=xxxxxxxx

To read a object with ID# 33245:

Here are proposed URIs for products:

for reading, updating, deleting object with id 66432, respectively.

For deleting all the objects in the collection:

Retrieved from "https://wiki.gcube-system.org/index.php?title=SStorageRest&oldid=30638"