Removed -SNAPSHOT to release the component

gitea@code-repo.d4science.org:gCubeSystem/gcat.git into feature/20225

.gitignore

@@ -1,3 +1,4 @@
 target
 .classpath
 .project
+/**/.DS_Store

CHANGELOG.md

@@ -2,13 +2,60 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 # Changelog for gCube Catalogue (gCat) Service
 
-## [v2.3.0]
+
+## [v2.5.3] 
+
+- Improved profile schema #26471
+- Catalogue core operation has been moved in a dedicated library #27118
+
+
+## [v2.5.2] 
+
+- Enforce private to a rejected item to avoid issue #26391
+- Added profile validation (i.e. regex validity and default value conformity) #26142
+
+
+## [v2.5.1]
+
+- Migrated code to reorganized E/R format [#24992]
+- Moderation notification are now sent as separated thread [#25614]
+
+
+## [v2.5.0]
+
+- Switched from commons-lang3 to commons-lang to avoid duplicates
+- Set resource-registry-publisher dependency scope to provided
+- Fixed RequestFilter to avoid to remove info to Smartgears
+- Switching to Facet Based IS [#20225]
+- Delete of item in a moderated catalogue produces a notification [#24305]
+- The user performing create/update item in moderated catalogue receive confirmation via notification of the action [#23575]
+- Enhanced gcube-smartgears-bom version
+- Added support for JSON:API on 'licenses' collection [#24601]
+
+
+## [v2.4.1] [r5.14.0] - 2022-12-07
+
+- Integrating Sphinx for documentation [#23833]
+- Migrated Social service interaction to social-service-client [#23151]
+- Improved author rewrite in case of update [#23851]
+- Fixed item listing [#23901]
+
+
+## [v2.4.0] [r5.13.1] - 2022-09-16
+
+- Added moderation link in moderation message [#23142]
+- Added query parameter in item listing to get the whole item instead of just the name [#23691]
+- Using renamed constant from gcat-api
+- Explict request for approved items return only moderated and approved [#23696]
+
+
+## [v2.3.0] [r5.13.0] - 2022-07-22
 
 - Switched moderation messages to notification [#23317]
 - Item listing returns items in the default organization and not in all supported organization
 
 
-## [v2.2.0]
+## [v2.2.0] [r5.11.0] - 2022-05-12
 
 - Switched gcat credentials to new IAM authz [#21628][#22727]
 - Added support to manage configurations [#22658][#22742]
@@ -21,7 +68,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - ClientID requests are now properly supported [#21903] 
 
 
-## [v2.1.0]
+## [v2.1.0] [r5.7.0] - 2022-01-27
 
 - Added query parameter social_post_notification to override default VRE behaviour [#21345]
 - Users are created/referenced in the form <Surname Name> and not vice-versa [#21479]
@@ -56,7 +103,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Switched JSON management to gcube-jackson [#19735]
 
 
-## [v1.4.3] [r4.23.0] - 2020-06-19
+## [v1.4.3] [r4.23.0] - 2020-06-16
 
 - Social Post is disabled if not explicitly enabled by the client [#19295] 
 - Solved null pointer exception while creating the JSON object to send to CKAN to create the user [#19395]
@@ -87,7 +134,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Resource URL existence is not checked anymore [#16748]
 
 
-## [v1.2.0] 
+## [v1.2.0-SNAPSHOT] - 2019-05-20 
 
 - Separated REST class for Profile management from the logic which effectively manage profile on IS
 - Tags are now properly created/added according to profile definition [#16182]
@@ -114,7 +161,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Refactored to use gcat-api library
 
 
-## [v1.0.0] 
+## [v1.0.0-SNAPSHOT] - 2019-01-10
 
-- First Release
+- First Version
 

FUNDING.md

@@ -0,0 +1,26 @@
+# Acknowledgments
+
+The projects leading to this software have received funding from a series of European Union programmes including:
+
+- the Sixth Framework Programme for Research and Technological Development
+    - [DILIGENT](https://cordis.europa.eu/project/id/004260) (grant no. 004260).
+- the Seventh Framework Programme for research, technological development and demonstration 
+    - [D4Science](https://cordis.europa.eu/project/id/212488) (grant no. 212488);
+    - [D4Science-II](https://cordis.europa.eu/project/id/239019) (grant no.239019);
+    - [ENVRI](https://cordis.europa.eu/project/id/283465) (grant no. 283465);
+    - [iMarine](https://cordis.europa.eu/project/id/283644) (grant no. 283644);
+    - [EUBrazilOpenBio](https://cordis.europa.eu/project/id/288754) (grant no. 288754).
+- the H2020 research and innovation programme 
+    - [SoBigData](https://cordis.europa.eu/project/id/654024) (grant no. 654024);
+    - [PARTHENOS](https://cordis.europa.eu/project/id/654119) (grant no. 654119);
+    - [EGI-Engage](https://cordis.europa.eu/project/id/654142) (grant no. 654142);
+    - [ENVRI PLUS](https://cordis.europa.eu/project/id/654182) (grant no. 654182);
+    - [BlueBRIDGE](https://cordis.europa.eu/project/id/675680) (grant no. 675680);
+    - [PerformFISH](https://cordis.europa.eu/project/id/727610) (grant no. 727610);
+    - [AGINFRA PLUS](https://cordis.europa.eu/project/id/731001) (grant no. 731001);
+    - [DESIRA](https://cordis.europa.eu/project/id/818194) (grant no. 818194);
+    - [ARIADNEplus](https://cordis.europa.eu/project/id/823914) (grant no. 823914);
+    - [RISIS 2](https://cordis.europa.eu/project/id/824091) (grant no. 824091);
+    - [EOSC-Pillar](https://cordis.europa.eu/project/id/857650) (grant no. 857650);
+    - [Blue Cloud](https://cordis.europa.eu/project/id/862409) (grant no. 862409);
+    - [SoBigData-PlusPlus](https://cordis.europa.eu/project/id/871042) (grant no. 871042);

README.md

@@ -13,7 +13,7 @@ This service allows any client to publish on the gCube Catalogue.
 
 ## Change log
 
-See [Releases](https://code-repo.d4science.org/gCubeSystem/gcat/releases).
+See [CHANGELOG.md](CHANGELOG.md).
 
 ## Authors
 
@@ -25,15 +25,13 @@ Tell people how to cite this software.
 * Cite an associated paper?
 * Use a specific BibTeX entry for the software?
 
-
-    @Manual{,
-        title = {gCube Catalogue (gCat) Service},
-        author = {{Frosini, Luca}},
-        organization = {ISTI - CNR},
-        address = {Pisa, Italy},
-        year = 2019,
-        url = {http://www.gcube-system.org/}
-    } 
+    @software{gcat,
+		author		= {{Luca Frosini}},
+		title		= {gCube Catalogue (gCat) Service},
+		abstract	= {gCube Catalogue (gCat) Service allows the publication of items in the gCube Catalogue.},
+		url			= {https://doi.org/10.5281/zenodo.7446641},
+		keywords	= {Catalogue, D4Science, gCube}
+	}
 
 ## License
 
@@ -46,26 +44,5 @@ open-source software toolkit used for building and operating Hybrid Data
 Infrastructures enabling the dynamic deployment of Virtual Research Environments
 by favouring the realisation of reuse oriented policies.
  
-The projects leading to this software have received funding from a series of European Union programmes including:
-
-- the Sixth Framework Programme for Research and Technological Development
-    - DILIGENT (grant no. 004260).
-- the Seventh Framework Programme for research, technological development and demonstration 
-    - D4Science (grant no. 212488);
-    - D4Science-II (grant no.239019);
-    - ENVRI (grant no. 283465);
-    - iMarine(grant no. 283644);
-    - EUBrazilOpenBio (grant no. 288754).
-- the H2020 research and innovation programme 
-    - SoBigData (grant no. 654024);
-    - PARTHENOS (grant no. 654119);
-    - EGIEngage (grant no. 654142);
-    - ENVRIplus (grant no. 654182);
-    - BlueBRIDGE (grant no. 675680);
-    - PerformFish (grant no. 727610);
-    - AGINFRAplus (grant no. 731001);
-    - DESIRA (grant no. 818194);
-    - ARIADNEplus (grant no. 823914);
-    - RISIS2 (grant no. 824091);
-
+The projects leading to this software have received funding from a series of European Union programmes see [FUNDING.md](FUNDING.md)
 

docs/.gitignore

@@ -0,0 +1 @@
+/_build/

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/conf.py

@@ -0,0 +1,54 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'gCube Catalogue (gCat) Service'
+copyright = '2022, Luca Frosini (ISTI-CNR)'
+author = 'Luca Frosini (ISTI-CNR)'
+
+# The full version, including alpha/beta/rc tags
+release = '2.5.1'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = []
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'sphinxdoc'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']

docs/index.md

@@ -0,0 +1,484 @@
+---
+title: Welcome to gCube Catalogue Service (aka gCat) documentation
+---
+
+gCat is a RESTful application which exposes operations via REST-API.
+
+See the available [REST-API docs](../api-docs/index.html).
+
+Base URL
+========
+
+In the production environment, its current value is
+<https://api.d4science.org/gcat>
+
+Authorization
+=============
+
+D4Science adopts state-of-the-art industry standards for authentication
+and authorization. Specifically, the implementation fully adopts [OIDC
+(OpenID Connect)](https://openid.net/connect) for authentication and UMA
+2 (User-Managed Authorization) for authorization flows. [JSON Web Token
+(JWT) Access token](https://jwt.io/) are used for both authentication
+and authorization.
+
+Obtain your Bearer token here:
+<https://dev.d4science.org/how-to-access-resources>
+
+Service
+=======
+
+You can call the methods of the Web Service by writing your own REST
+client application or using existing REST client plugins.
+
+HTTP Statuses
+-------------
+
+Any successful operation returns *200 OK* HTTP status code. The create
+operation returns *201 Created*. Any Background operation returns *202
+Accepted*. Any operation which does not provide any content return *204
+No Content*.
+
+The most common error status a client can obtain are:
+
+-   **400 Bad Request** used to indicate a clients error
+    <https://tools.ietf.org/html/rfc7231#section-6.5.1>;
+-   **401 Unauthorized** used to indicate that the client does not
+    provide the authorization token in the HTTP Header or the client has
+    not enough right to perform such request
+    <https://tools.ietf.org/html/rfc7235#section-3.1>;
+-   **404 Not Found** used to indicate that the requested instance does
+    not exist <https://tools.ietf.org/html/rfc7231#section-6.5.4>;
+-   **405 Method Not Allowed** the used HTTP method is not supported for
+    the requested URL
+    <https://tools.ietf.org/html/rfc7231#section-6.5.5>. The response
+    contains the *Allow* HTTP Header indicating the supported HTTP
+    method for such URL
+    <https://tools.ietf.org/html/rfc7231#section-7.4.1>;
+-   **409 Conflict** the request could not be completed due to a
+    conflict with the current state of the target resource (e.g. the
+    name of the resource already exists)
+    <https://tools.ietf.org/html/rfc7231#section-6.5.8>;
+-   **500 Internal Server Error** indicate a server failure
+    <https://tools.ietf.org/html/rfc7231#section-6.6.1>.
+
+You can find a complete list of HTTP Status at
+<https://httpstatuses.com/>
+
+If you get a *500 Internal Server Error*, please report it in the [gCube
+ticketing system](https://support.d4science.org).
+
+Please use this checklist before reporting an error:
+
+-   Replicate the request;
+-   The failure could be temporal due to network error, server issue and
+    many other temporal issues. For this reason, please retry the
+    request after a certain amount of time before reporting the issue;
+-   indicate how to replicate the error;
+-   indicate the time when the error occurred (this simplifies
+    identifying the issue).
+
+HTTP Methods
+------------
+
+gCat is a pure RESTful service. It uses standard HTTP Methods to perform
+listing of collections and CRUD (Create Read Update Delete) operations
+on instances.
+
+:::{table} Supported operations
+:align: center
+:widths: grid
+
+
+| Operation | HTTP Method | URL | Success HTTP Status | Safe | Idempotent |
+|-----------|-------------|-----|---------------------|------|------------|
+| **Supported<br/>HTTP Methods** | OPTIONS | /{COLLECTION}               | 204 No Content | Y | Y |
+| **List**                   | GET     | /{COLLECTION}               | 200 OK         | Y | Y |
+| **Count**                  | GET     | /{COLLECTION}?count=true    | 200 OK         | Y | Y |
+| **Exists**                 | HEAD    | /{COLLECTION}               | 204 No Content | Y | Y |
+| **Create**                 | POST    | /{COLLECTION}               | 201 Created    | N | N |
+| **Supported<br/>HTTP Methods** | OPTIONS | /{COLLECTION}/{INSTANCE_ID} | 204 No Content | Y | Y |
+| **Exist**                  | HEAD    | /{COLLECTION}/{INSTANCE_ID} | 204 No Content | Y | Y |
+| **Read**                   | GET     | /{COLLECTION}/{INSTANCE_ID} | 200 OK         | Y | Y |
+| **Update**                 | PUT     | /{COLLECTION}/{INSTANCE_ID} | 200 OK         | N | Y |
+| **Patch**                  | PATCH   | /{COLLECTION}/{INSTANCE_ID} | 200 OK         | N | Y |
+| **Delete**                 | DELETE  | /{COLLECTION}/{INSTANCE_ID} | 204 No Content | N | N |
+| **Purge**                  | PURGE   | /{COLLECTION}/{INSTANCE_ID} | 204 No Content | N | N |
+| **Purge**                  | DELETE  | /{COLLECTION}/{INSTANCE_ID}?purge=true | 204 No Content | N | N |
+
+
+### About URL
+
+The presented URL uses the following convention:
+
+-   **{COLLECTION}** is the plural name of the entity type;
+-   **{INSTANCE\_ID}** is an identification that enables univocally
+    identifying the instance in the collection.
+
+### About Safety and Idempotency properties
+
+-   A method is *Safe* if it does not produce any side effects. \"This
+    does not prevent an implementation from including behaviour that is
+    potentially harmful, that is not entirely read-only, or that causes
+    side effects while invoking a safe method\"
+    <https://tools.ietf.org/html/rfc7231#section-4.2.1>;
+-   A method is *Idempotent* if the same operation repeated multiple
+    times has the same side effect than using it one time. \"repeating
+    the request will have the same intended effect, even if the original
+    request succeeded, though the response might differ\"
+    <https://tools.ietf.org/html/rfc7231#section-4.2.2>.
+
+You can find more information about HTTP Methods at
+<https://restfulapi.net/http-methods/>
+
+### Uncommon HTTP Methods
+
+-   PATCH method allows to perform a differential update (i.e. an update
+    which provides only the differences and not the whole new
+    representation);
+-   PURGE method is not a standard but is widely used in service which
+    requires this action (e.g.
+    [Varnish](https://varnish-cache.org/docs/3.0/tutorial/purging.html),
+    [Squid](https://wiki.squid-cache.org/SquidFaq/OperatingSquid#How_can_I_purge_an_object_from_my_cache.3F)).
+    gCat provides support for this method, but to support a wider range
+    of clients, it also provides the Purge action via *DELETE* with the
+    additional get parameter `purge=true`.
+
+Content-Type
+------------
+
+Any request must contain an indication of the interesting content type.
+
+The client must specify the **Accept** HTTP Header for any operation
+returning a result.
+
+``` {.rest}
+Accept: application/json
+```
+
+For any operation sending content to the service, it is necessary to
+specify the **Content-Type** HTTP Header.
+
+``` {.rest}
+Content-Type: application/json
+```
+
+The service accepts and returns only JSON objects.
+
+[Profile Collection](../api-docs/resource\_Profile.html) instead can be
+manipulated in XML only.
+
+Collections
+-----------
+
+The following collections are available to any user. Catalogue-Editor or
+above can invoke Non-safe methods only.
+
+-   [Item Collection](../api-docs/resource_Item.html);
+    -   [Resource Collection](../api-docs/resource_Resource.html);
+-   [Profile Collection](../api-docs/resource_Profile.html);
+-   [Namespace Collection](../api-docs/resource_Namespace.html);
+-   [License Collection](../api-docs/resource_License.html);
+-   [Trash Collection](../api-docs/resource_Trash.html);
+
+The following collections are available for Catalogue-Admins or above
+only:
+
+-   [Group Collection](../api-docs/resource_Group.html);
+-   [Organization Collection](../api-docs/resource_Organization.html);
+-   [User Collection](../api-docs/resource_User.html);
+-   [Configuration Collection](../api-docs/resource_Configuration.html).
+
+An overview of the available collections is available at
+[../api-docs/index.html](../api-docs/index.html);
+
+Roles
+-----
+
+Any user has one or more roles in the catalogue. Only the VRE Manager
+can assign roles to VRE users.
+
+The catalogue uses the following hierarchic roles:
+
+**Catalogue-Member**:
+
+:   A user with such a role is mainly capable of listing and reading
+    items;
+
+**Catalogue-Editor**:
+
+:   A user with such a role is capable of managing the items he/she
+    creates and capable of using other safe APIs;
+
+**Catalogue-Admin**:
+
+:   A user with such a role is capable of administrating many aspects of
+    the catalogue;
+
+**Catalogue-Manager**:
+
+:   A user with such a role can use all the APIs exposed by the service
+    except item moderation APIs (e.g. approve, reject, \...).
+
+Another role that is not in the role hierarchy:
+
+**Catalogue-Moderator**:
+
+:   A user with such a role is capable of invoking the item moderation
+    APIs.
+
+    ::: {.tip}
+    ::: {.title}
+    Tip
+    :::
+    :::
+
+    Please note that not all catalogues are moderated.
+
+Moderated Catalogues
+====================
+
+Any catalogues can be declared as moderated. This means that, a
+**Catalogue-Moderator** must approve any submitted items to make them
+available to the other users of the catalogue.
+
+In a moderated catalogue, an item can be in the following states:
+
+**pending**:
+
+:   The item published by any allowed author (a Catalogue-Editor or
+    above) but not available to the other users of the catalogue. A
+    Catalogue-Moderator has to approve or reject it;
+
+**approved**:
+
+:   A Catalogue-Moderator has approved the item published by any allowed
+    users;
+
+**rejected**:
+
+:   A Catalogue-Moderator has rejected the item published by any allowed
+    users.
+
+The following are the moderation operations that an allowed user can
+perform on an item. To present the moderation operations, we use the
+following convention:
+
+> `initial_state` \-\--**operation** (*User/Role performing the
+> operation*)\-\--\> `final_state`
+
+`initial_state` can be `none`, meaning the item does not exist.
+
+The following are the allowed moderation operation on an item
+
+> `none` \-\--**create** (*Author*)\-\--\> `pending`
+>
+> `pending` \-\--**reject** (*Catalogue-Moderator*)\-\--\> `rejected`
+>
+> `pending` \-\--**approve** (*Catalogue-Moderator*)\-\--\> `approved`
+>
+> `rejected` \-\--**update** (*Author*)\-\--\> `pending`
+>
+> `approved` \-\--**update** (*Author*)\-\--\> `pending`
+
+Please check the table below whcih summarise the item collection
+operation and the allowed users/roles.
+
+In a moderated catalogue, both the Catalogue-Moderators and the item
+author can send messages to discuss the approval process of the item.
+The messages are related to a specific item. Any Catalogue-Moderators
+receive a message sent by an Author. The author receives a message sent
+by a Catalogue-Moderator as well as the other Catalogue-Moderators (if
+any).
+
+Messages can be sent both with an action which changes the status of the
+item or as explicit action which does not change the status of the item:
+
+> `pending` \-\--**message** (*Author OR Catalogue-Moderator*)\-\--\>
+> `pending`
+>
+> `rejected` \-\--**message** (*Author OR Catalogue-Moderator*)\-\--\>
+> `rejected`
+>
+> `approved` \-\--**message** (*Author OR Catalogue-Moderator*)\-\--\>
+> `approved`
+
+The following table summarize the allowed/forbidden operations depending
+on: the role of the user and the state of the item.
+
+The Moderation process has associated notification to authors and
+Catalogue-Moderators. Please note that the user who has acted is not
+self-notified, e.g. approve operation made by a Catalogue-Moderator
+notifies the item author and the other Catalogue-Moderators of the VRE.
+
+The following table summarises the addressee of the notification for any
+action.
+
+Java Client
+===========
+
+We provide the following Java Client out-of-the-box.
+
+> ::: {.tip}
+> ::: {.title}
+> Tip
+> :::
+>
+> If you\'re coding in Java, it is recommended that you use this Java
+> Client.
+> :::
+
+**Maven Coordinates**
+
+``` {.xml}
+<groupId>org.gcube.data-catalogue</groupId>
+<artifactId>gcat-client</artifactId>
+<version>[2.2.0, 3.0.0-SNAPSHOT)</version>
+```
+
+**Methods Result**
+
+The service exposes [its methods](../api-docs/index.html) using a
+standard naming approach. Moreover, they accept (in the case of HTTP
+POST/PUT methods) JSON objects.
+
+> ::: {.important}
+> ::: {.title}
+> Important
+> :::
+>
+> The result of all methods is always a JSON object as per below:
+> :::
+
+``` {.javascript}
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "Frosini Luca",
+    "relationships_as_object": [],
+    "private": false,
+    "maintainer_email": "luca.frosini@isti.cnr.it",
+    "num_tags": 1,
+    "id": "17051d86-c127-4928-9296-d3d7590161fe",
+    "metadata_created": "2022-10-17T12:45:53.118318",
+    "metadata_modified": "2022-10-18T10:30:03.362756",
+    "author": "Frosini Luca",
+    "author_email": "luca.frosini@isti.cnr.it",
+    "state": "active",
+    "version": null,
+    "creator_user_id": "f1b0265c-9983-4f97-a7b6-be3cc0544b27",
+    "type": "dataset",
+    "resources": [],
+    "num_resources": 0,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Test",
+            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+            "name": "Test"
+        }
+    ],
+    "groups": [],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "",
+        "created": "2016-05-30T11:30:41.710079",
+        "title": "devVRE",
+        "name": "devvre",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+        "type": "organization",
+        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+        "approval_status": "approved"
+    },
+    "name": "my_test_item_devvre",
+    "isopen": true,
+    "url": "http://www.d4science.org",
+    "notes": "A test item of Luca Frosini",
+    "extras": [
+        {
+            "key": "Item URL",
+            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item_devvre"
+        },
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:cm_item_status",
+            "value": "approved"
+        },
+        {
+            "key": "system:cm_item_visibility",
+            "value": "public"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "My Test Item",
+    "revision_id": "bc0d1f2a-4e97-4810-b951-8b72e8279719"
+}
+```
+
+*Inputs are automatically validated before the request is served.*
+
+**Usage examples**
+
+-   Example 1
+
+``` {.java}
+import org.gcube.gcat.client.Item;
+
+// count item number
+Item item = new Item();
+int count = item.count();
+...
+```
+
+Service Discovery on IS
+=======================
+
+The service can be discovered in the gCore IS as gCore Endpoint with the
+following parameter:
+
+``` {.xml}
+<ServiceClass>org.gcube.data-catalogue</ServiceClass>
+<ServiceName>gcat</ServiceName>
+```
+
+The service can be discovered in the Facet Based IS as EService with the
+following json query:
+
+``` {.json}
+{
+    "@class": "EService",
+    "consistsOf": [
+        {
+            "@class": "IsIdentifiedBy",
+            "target": {
+                "@class": "SoftwareFacet",
+                "group": "org.gcube.data-catalogue",
+                "name": "gcat"
+            }
+        }
+    ]
+}
+```
+
+Service Maven Coordinates
+=========================
+
+The maven coordinates of gCat service are:
+
+``` {.xml}
+<groupId>org.gcube.data-catalogue</groupId>
+<artifactId>gcat</artifactId>
+```

docs/index.rst

@@ -0,0 +1,509 @@
+***********************************************************
+Welcome to gCube Catalogue Service (aka gCat) documentation
+***********************************************************
+
+gCat is a RESTful application that exposes operations via REST-API.
+
+See the available `REST-API docs <../api-docs/index.html>`_.
+
+Base URL
+========
+
+In the production environment, its current value is https://api.d4science.org/gcat
+
+
+Authorization
+=============
+
+D4Science adopts state-of-the-art industry standards for authentication and authorization. 
+Specifically, the implementation fully adopts `OIDC (OpenID Connect) <https://openid.net/connect>`_ for authentication and UMA 2 (User-Managed Authorization) for authorization flows. 
+`JSON Web Token (JWT) Access token <https://jwt.io/>`_ are used for both authentication and authorization.
+
+Obtain your Bearer token here: https://dev.d4science.org/how-to-access-resources
+
+Service
+=======
+
+You can call the methods of the Web Service by writing your REST client application or using existing REST client plugins.
+
+
+HTTP Statuses
+-------------
+
+Any successful operation returns a *200 OK* HTTP status code.
+The create operation returns *201 Created*. 
+Any Background operation returns *202 Accepted*.
+Any operation that does not provide any content returns *204 No Content*.
+
+
+
+The most common error statuses a client can obtain are:
+
+* **400 Bad Request** used to indicate a clients error `<https://tools.ietf.org/html/rfc7231#section-6.5.1>`_;
+* **401 Unauthorized** used to indicate that the client does not provide the authorization token in the HTTP Header or the client does not have enough right to perform such request `<https://tools.ietf.org/html/rfc7235#section-3.1>`_;
+* **404 Not Found** used to indicate that the requested instance does not exist `<https://tools.ietf.org/html/rfc7231#section-6.5.4>`_;
+* **405 Method Not Allowed** the used HTTP method is not supported for the requested URL `<https://tools.ietf.org/html/rfc7231#section-6.5.5>`_.
+  The response contains the *Allow* HTTP Header indicating the supported HTTP method for such URL `<https://tools.ietf.org/html/rfc7231#section-7.4.1>`_;
+* **409 Conflict**  the request could not be completed due to a conflict with the current state of the target resource (e.g. the name of the resource already exists) `<https://tools.ietf.org/html/rfc7231#section-6.5.8>`_;
+* **500 Internal Server Error** indicate a server failure `<https://tools.ietf.org/html/rfc7231#section-6.6.1>`_.
+
+You can find a complete list of HTTP Status at `<https://httpstatuses.com/>`_
+
+If you get a *500 Internal Server Error*, please report it in the `gCube ticketing system <https://support.d4science.org>`_. 
+
+Please use this checklist before reporting an error:
+
+* Replicate the request;
+* The failure could be temporal due to a network error, a server issue, and many other temporal issues. For this reason, please retry the request after a certain amount of time before reporting the issue;
+* indicate how to replicate the error;
+* indicate the time when the error occurred (this simplifies identifying the issue).
+
+HTTP Methods
+------------
+
+gCat is a pure RESTful service. It uses standard HTTP Methods to perform a listing of collections and CRUD (Create Read Update Delete) operations on instances.
+
+
+.. table::
+
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	|  Operation   | HTTP Method | URL                                    | Success HTTP Status |  Safe  | Idempotent |
+	+==============+=============+========================================+=====================+========+============+
+	| Supported    | OPTIONS     | /{COLLECTION}                          | 204 No Content      |   Y    |     Y      |
+	| HTTP Methods |             |                                        | [#allow]_           |        |            |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| List         | GET         | /{COLLECTION}                          | 200 OK              |   Y    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Count        | GET         | /{COLLECTION}?count=true               | 200 OK              |   Y    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Exists       | HEAD        | /{COLLECTION}                          | 204 No Content      |   Y    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Create       | POST        | /{COLLECTION}                          | 201 Created         |   N    |     N      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Supported    | OPTIONS     | /{COLLECTION}/{INSTANCE_ID}            | 204 No Content      |   Y    |     Y      |
+	| HTTP Methods |             |                                        | [#allow]_           |        |            |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Exist        | HEAD        | /{COLLECTION}/{INSTANCE_ID}            | 204 No Content      |   Y    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Read         | GET         | /{COLLECTION}/{INSTANCE_ID}            | 200 OK              |   Y    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Update       | PUT         | /{COLLECTION}/{INSTANCE_ID}            | 200 OK              |   N    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Patch        | PATCH       | /{COLLECTION}/{INSTANCE_ID}            | 200 OK              |   N    |     Y      |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Delete       | DELETE      | /{COLLECTION}/{INSTANCE_ID}            | 204 No Content      |   N    |  N [#del]_ |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+	| Purge        | DELETE      | /{COLLECTION}/{INSTANCE_ID}?purge=true | 204 No Content      |   N    |  N [#del]_ |
+	+              +-------------+----------------------------------------+---------------------+--------+------------+
+	|              | PURGE       | /{COLLECTION}/{INSTANCE_ID}            | 204 No Content      |   N    |  N [#del]_ |
+	+--------------+-------------+----------------------------------------+---------------------+--------+------------+
+
+.. [#allow] Supported HTTP Methods in **Allow** HTTP Header
+	
+.. [#del] DELETE has been defined as idempotent.
+	
+	*Allamaraju* [#Allamaraju]_ argues that DELETE idempotency should be accomplished client-side.
+	The server should inform the client if the delete operation succeeded because the resource was deleted or it was not found, i.e., **404 Not Found** error is suggested instead of **204 No Content**.
+	The latter situation should be treated as idempotent by the client.
+	
+	We share the same vision. For this reason, gCat does not provide server-side idempotency for DELETE and PURGE operations.
+
+.. [#Allamaraju] Allamaraju S. RESTful Web Services Cookbook: Solutions for Improving Scalability and Simplicity. O’Reilly. first ed. 2010
+ 
+ 
+About URL
+^^^^^^^^^
+
+The presented URL uses the following convention:
+
+* **{COLLECTION}** is the plural name of the entity type;
+* **{INSTANCE_ID}** is an identification that enables univocally identifying the instance in the collection.
+
+
+About Safety and Idempotency properties
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+
+* A method is *Safe* if it does not produce any side effects.
+  "This does not prevent an implementation from including behaviour that is potentially harmful, that is not entirely read-only, or that causes side effects while invoking a safe method"
+  `<https://tools.ietf.org/html/rfc7231#section-4.2.1>`_;
+* A method is *Idempotent* if the same operation repeated multiple times has the same side effect as using it one time.
+  "repeating the request will have the same intended effect, even if the original request succeeded, though the response might differ"
+  `<https://tools.ietf.org/html/rfc7231#section-4.2.2>`_.
+
+You can find more information about HTTP Methods at `<https://restfulapi.net/http-methods/>`_
+
+Uncommon HTTP Methods
+^^^^^^^^^^^^^^^^^^^^^
+
+* PATCH method allows to perform a differential update (i.e. an update which provides only the differences and not the whole new representation);
+* PURGE method is not a standard but is widely used in services that require this action
+  (e.g. `Varnish <https://varnish-cache.org/docs/3.0/tutorial/purging.html>`_, `Squid <https://wiki.squid-cache.org/SquidFaq/OperatingSquid#How_can_I_purge_an_object_from_my_cache.3F>`_).
+  gCat provides support for this method, but to support a wider range of clients, it also provides the Purge action via *DELETE* with the additional get parameter ``purge=true``.
+
+
+Content-Type
+------------
+
+Any request must contain an indication of the interesting content type.
+
+The client must specify the **Accept** HTTP Header for any operation returning a result. 
+
+.. code-block:: rest
+
+	Accept: application/json
+
+For any operation sending content to the service, it is necessary to specify the **Content-Type** HTTP Header.
+
+.. code-block:: rest
+
+	Content-Type: application/json
+
+The service accepts and returns only JSON objects.
+ 
+`Profile Collection <../api-docs/resource\_Profile.html>`_ instead can be manipulated in XML only.
+
+Collections
+-----------
+
+The following collections are available to any user. 
+Catalogue-Editor or above can invoke Non-safe methods only.
+
+* `Item Collection <../api-docs/resource_Item.html>`_;
+  
+  * `Resource Collection <../api-docs/resource_Resource.html>`_;
+
+* `Profile Collection <../api-docs/resource_Profile.html>`_;
+* `Namespace Collection <../api-docs/resource_Namespace.html>`_;
+* `License Collection <../api-docs/resource_License.html>`_;
+* `Trash Collection <../api-docs/resource_Trash.html>`_;
+
+The following collections are available for Catalogue-Admins or above only:
+
+* `Group Collection <../api-docs/resource_Group.html>`_;
+* `Organization Collection <../api-docs/resource_Organization.html>`_;
+* `User Collection <../api-docs/resource_User.html>`_;
+* `Configuration Collection <../api-docs/resource_Configuration.html>`_.
+
+An overview of the available collections is available at `<../api-docs/index.html>`_;
+
+
+Roles
+-----
+
+Any user has one or more roles in the catalogue.
+Only the VRE Manager can assign roles to VRE users. 
+ 
+
+The catalogue uses the following hierarchic roles:
+
+**Catalogue-Member**: 
+	A user with such a role is mainly capable of listing and reading items;
+	
+**Catalogue-Editor**: 
+	A user with such a role is capable of managing the items he/she creates and capable of using other safe APIs;
+
+**Catalogue-Admin**:
+	A user with such a role is capable of administrating many aspects of the catalogue;
+
+**Catalogue-Manager**:
+	A user with such a role can use all the APIs exposed by the service except item moderation APIs (e.g. approve, reject, ...).
+
+
+Another role that is not in the role hierarchy:
+
+**Catalogue-Moderator**:
+	A user with such a role is capable of invoking the item moderation APIs.
+
+
+ .. TIP::
+    Please note that not all catalogues are moderated.
+
+Moderated Catalogues
+====================
+
+
+Any catalogues can be declared as moderated.
+This means that a **Catalogue-Moderator** must approve any submitted items to make them available to the other users of the catalogue.
+
+In a moderated catalogue, an item can be in the following states:
+
+**pending**: 
+	The item is published by any allowed author (a Catalogue-Editor or above) but not available to the other users of the catalogue. 
+	A Catalogue-Moderator has to approve or reject it;
+	
+**approved**:
+	A Catalogue-Moderator has approved the item published by any allowed users;
+	
+**rejected**:
+	A Catalogue-Moderator has rejected the item published by any allowed users.
+
+
+
+The following are the moderation operations that an allowed user can perform on an item. 
+To present the moderation operations, we use the following convention:
+
+	``initial_state``  ---**operation** (*User/Role performing the operation*)---> ``final_state``  
+
+
+``initial_state`` can be ``none``, meaning the item does not exist.
+
+
+The following are the allowed moderation operations on an item
+
+	``none``  ---**create** (*Author*)---> ``pending``
+	
+ 	``pending`` ---**reject** (*Catalogue-Moderator*)---> ``rejected``
+	
+	``pending`` ---**approve** (*Catalogue-Moderator*)---> ``approved``
+	
+	``rejected`` ---**update** (*Author*)---> ``pending``
+
+	``approved`` ---**update** (*Author*)--->  ``pending``
+
+
+Please check the table below that summarises the item collection operation and the allowed users/roles.
+
+In a moderated catalogue, both the Catalogue-Moderators and the item author can send messages to
+discuss the approval process of the item. The messages are related to a specific item.
+Any Catalogue-Moderators receive a message sent by an Author.
+The author receives a message sent by a Catalogue-Moderator as well as the other Catalogue-Moderators (if any).
+
+Messages can be sent both with an action which changes the status of the item or as an explicit action which does not change the status of the item:
+
+	``pending`` ---**message** (*Author OR Catalogue-Moderator*)---> ``pending``
+
+	``rejected`` ---**message** (*Author OR Catalogue-Moderator*)---> ``rejected``
+
+	``approved`` ---**message** (*Author OR Catalogue-Moderator*)---> ``approved``
+
+
+
+The following table summarizes the allowed/forbidden operations depending on the role of the user and the state of the item.
+   
+.. table::
+
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Operation                           | Item State  | Roles                                                                                                          |
+	+                                     +             +----------------------+--------------------------+------------------------------------------+-------------------+
+	|                                     |             | Catalogue Moderator  | Catalogue Admin/Manager  | Catalogue Editor                         | Catalogue Member  |
+	+=====================================+=============+======================+==========================+==========================================+===================+
+	| List                                              | Yes all states       | Yes all states           | Yes only approved - All states if Author | Yes only approved |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Count                                             | Yes all states       | Yes all states           | Yes only approved - All states if Author | Yes only approved |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Create                                            | 403 Forbidden        | Yes -> Pending           | Yes -> Pending                           | 403 Forbidden     |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Read                                              | Yes all states       | Yes all states           | Yes only approved - All states if Author | Yes only approved |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Update                              | Pending     | Yes -> Pending       | Yes if Author -> Pending | Yes if Author -> Pending                 | 403 Forbidden     |
+	+                                     +-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	|                                     | Rejected    | Yes -> Pending       | Yes if Author -> Pending | Yes if Author -> Pending                 | 403 Forbidden     |
+	+                                     +-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	|                                     | Approved    | 403 Forbidden        | Yes -> Approved          | Yes if Author -> Pending                 | 403 Forbidden     |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Delete/Purge                        | Pending     | Yes                  | Yes                      | Yes if Author                            | 403 Forbidden     |
+	+                                     +-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	|                                     | Rejected    | Yes                  | Yes                      | Yes if Author                            | 403 Forbidden     |
+	+                                     +-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	|                                     | Approved    | 403 Forbidden        | Yes                      | Yes if Author                            | 403 Forbidden     |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Approve a pending item                            | Yes                  | 403 Forbidden            | 403 Forbidden                            | 403 Forbidden     |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Reject a pending item                             | Yes                  | 403 Forbidden            | 403 Forbidden                            | 403 Forbidden     |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+	| Message about an item                             | Yes                  | Yes if Author            | Yes if Author                            | 403 Forbidden     |
+	+-------------------------------------+-------------+----------------------+--------------------------+------------------------------------------+-------------------+
+
+   
+The Moderation process has associated notification to authors and Catalogue-Moderators.
+Please note that the user who has acted is not self-notified, e.g.
+approve operation made by a Catalogue-Moderator notifies the item author and the other Catalogue-Moderators of the VRE.
+
+The following table summarises the addressee of the notification for any action.
+ 
+   
+.. table::
+
+	+--------------+----------------------+--------+----------------------+
+	| Operation    | Notified user/role                                   |
+	+              +----------------------+--------+----------------------+
+	|              | Catalogue-Moderators | Author | User made the action |
+	+==============+======================+========+======================+
+	| Create       | Yes                  | Yes    | Yes (custom message) |
+	+--------------+----------------------+--------+----------------------+
+	| Update       | Yes                  | Yes    | Yes (custom message) |
+	+--------------+----------------------+--------+----------------------+
+	| Approve      | Yes + Social Post if          | No                   |
+	|              | requested (social_post=true)  |                      |
+	|              | and enabled for the VRE       |                      |
+	+--------------+----------------------+--------+----------------------+
+	| Reject       | Yes                  | Yes    | No                   |
+	+--------------+----------------------+--------+----------------------+
+	| Delete/Purge | Yes                  | Yes    | No                   |
+	+--------------+----------------------+--------+----------------------+
+	| Message      | Yes                  | Yes    | No                   |
+	+--------------+----------------------+--------+----------------------+
+
+
+
+Java Client
+===========
+
+We provide the following Java Client out-of-the-box.
+
+ .. TIP::
+    If you're coding in Java, it is recommended that you use this Java Client.
+
+**Maven Coordinates**
+
+.. code:: xml
+
+ <groupId>org.gcube.data-catalogue</groupId>
+ <artifactId>gcat-client</artifactId>
+ <version>[2.2.0, 3.0.0-SNAPSHOT)</version>
+ 
+**Methods Result**
+
+The service exposes `its methods <../api-docs/index.html>`_ using a standard naming approach. Moreover, they accept (in the case of HTTP POST/PUT methods) JSON objects. 
+
+ .. IMPORTANT::
+   The result of all methods is always a JSON object as per below:
+
+.. code:: javascript
+
+	{
+	    "rating": 0.0,
+	    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+	    "maintainer": "Frosini Luca",
+	    "relationships_as_object": [],
+	    "private": false,
+	    "maintainer_email": "luca.frosini@isti.cnr.it",
+	    "num_tags": 1,
+	    "id": "17051d86-c127-4928-9296-d3d7590161fe",
+	    "metadata_created": "2022-10-17T12:45:53.118318",
+	    "metadata_modified": "2022-10-18T10:30:03.362756",
+	    "author": "Frosini Luca",
+	    "author_email": "luca.frosini@isti.cnr.it",
+	    "state": "active",
+	    "version": null,
+	    "creator_user_id": "f1b0265c-9983-4f97-a7b6-be3cc0544b27",
+	    "type": "dataset",
+	    "resources": [],
+	    "num_resources": 0,
+	    "tags": [
+	        {
+	            "vocabulary_id": null,
+	            "state": "active",
+	            "display_name": "Test",
+	            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+	            "name": "Test"
+	        }
+	    ],
+	    "groups": [],
+	    "license_id": "CC-BY-SA-4.0",
+	    "relationships_as_subject": [],
+	    "organization": {
+	        "description": "",
+	        "created": "2016-05-30T11:30:41.710079",
+	        "title": "devVRE",
+	        "name": "devvre",
+	        "is_organization": true,
+	        "state": "active",
+	        "image_url": "",
+	        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+	        "type": "organization",
+	        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+	        "approval_status": "approved"
+	    },
+	    "name": "my_test_item_devvre",
+	    "isopen": true,
+	    "url": "http://www.d4science.org",
+	    "notes": "A test item of Luca Frosini",
+	    "extras": [
+	        {
+	            "key": "Item URL",
+	            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item_devvre"
+	        },
+	        {
+	            "key": "Language",
+	            "value": "EN"
+	        },
+	        {
+	            "key": "system:cm_item_status",
+	            "value": "approved"
+	        },
+	        {
+	            "key": "system:cm_item_visibility",
+	            "value": "public"
+	        },
+	        {
+	            "key": "system:type",
+	            "value": "EmptyProfile"
+	        }
+	    ],
+	    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+	    "ratings_count": 0,
+	    "title": "My Test Item",
+	    "revision_id": "bc0d1f2a-4e97-4810-b951-8b72e8279719"
+	}
+
+*Inputs are automatically validated before the request is served.*
+
+      
+**Usage examples**
+
+- Example 1
+      
+.. code:: java
+
+ import org.gcube.gcat.client.Item;
+
+ // count item number
+ Item item = new Item();
+ int count = item.count();
+ ...
+
+
+
+Service Discovery on IS
+=======================
+
+The service can be discovered in the gCore IS as gCore Endpoint with the following parameter:
+
+.. code:: xml
+
+	<ServiceClass>org.gcube.data-catalogue</ServiceClass>
+	<ServiceName>gcat</ServiceName>
+
+
+The service can be discovered in the Facet-Based IS as EService with the following JSON query:
+
+.. code:: json
+
+	{
+		"@class": "EService",
+		"consistsOf": [
+			{
+				"@class": "IsIdentifiedBy",
+				"target": {
+					"@class": "SoftwareFacet",
+					"group": "org.gcube.data-catalogue",
+					"name": "gcat"
+				}
+			}
+		]
+	}
+
+	
+	
+Service Maven Coordinates
+=========================
+	
+The maven coordinates of the gCat service are:
+
+.. code:: xml
+
+	<groupId>org.gcube.data-catalogue</groupId>
+	<artifactId>gcat</artifactId>
+	

docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

docs/tests.rst

@@ -0,0 +1,23 @@
+Dev and Pre Users used for moderation tests
+========
+
+To perform moderation tests in dev and preproduction infrastructure we use different users with the indicated roles.
+
+.. table::
+
+	+---------------+---------------+----------------------------------------+
+	| User          | Username      | Role                                   |
+	+===============+===============+========================================+
+	| Mister Blonde | mister.blonde | Catalogue-Admin + Catalogue-Moderator  |
+	+---------------+---------------+----------------------------------------+
+	| Mister Blue   | mister.blue   | Catalogue-Admin                        |
+	+---------------+---------------+----------------------------------------+
+	| Mister Brown  | mister.brown  | Catalogue-Moderator                    |
+	+---------------+---------------+----------------------------------------+
+	| Mister Orange | mister.orange | Catalogue-Editor                       |
+	+---------------+---------------+----------------------------------------+
+	| Mister Pink   | mister.pink   | NO ROLE (means Catalogue-Member)       |
+	+---------------+---------------+----------------------------------------+
+	| Mister White  | mister.white  | Catalogue-Manager                      |
+	+---------------+---------------+----------------------------------------+
+	

enunciate.xml

@@ -2,10 +2,11 @@
 <enunciate
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:noNamespaceSchemaLocation="http://enunciate.webcohesion.com/schemas/enunciate-2.14.0.xsd">
+	<description package="org.gcube.gcat.rest"/>
 	<api-classes>
 		<include pattern="org.gcube.gcat.rest.*" />
+		<include pattern="org.gcube.gcat.rest.administration.*" />
 		<exclude pattern="org.gcube.gcat.*" />
-		<exclude pattern="org.gcube.gcat.rest.Docs" />
 	</api-classes>
 	<modules>
 		<gwt-json-overlay disabled="true " />
@@ -13,7 +14,7 @@
 		<ruby-json-client disabled="true" />
 		<java-json-client disabled="true" />
 		<javascript-client disabled="true" />
-		<docs docsDir="${project.build.directory}" docsSubdir="docs" />
+		<docs docsDir="${project.build.directory}" docsSubdir="api-docs" />
 		<swagger basePath="/${project.artifactId}" />
 		<docs freemarkerTemplate="${project.basedir}/src/main/resources/META-INF/enunciate/d4science_docs.fmt">
 			<additional-css

gcube/extra-resources/WEB-INF/gcube-app.xml

@@ -5,5 +5,7 @@
 	<group>${project.groupId}</group>
 	<version>${project.version}</version>
 	<description>${project.description}</description>
-	<exclude>/docs/*</exclude>
+	<exclude>/api-docs.*</exclude>
+	<exclude>/docs.*</exclude>
+	<exclude>/profiles/SCHEMA</exclude>
 </application>

gcube/gcat-export.json

@@ -0,0 +1,329 @@
+{
+    "global": {
+        "name": "gcat",
+        "group": "data-catalogue",
+        "title": "gCube Catalogue (gCat) Service {{version}}",
+        "license": {
+            "id": "EUPL-1.1",
+            "url": "https://opensource.org/licenses/EUPL-1.1"
+        },
+        "keywords": ["gCube", "Catalogue", "D4Science"],
+        "description": "gCube Catalogue (gCat) Service allows the publication of items in the gCube Catalogue.",
+        "html_description": "<p><a href=\"https://www.gcube-system.org/\">gCube</a> Catalogue (gCat) Service allows any client to publish items in the gCube Catalogue.</p>",
+        "authors": [
+            {
+                "affiliation": "Istituto di Scienza e Tecnologie dell'Informazione \"A. Faedo\" - CNR, Italy",
+                "name": "Frosini, Luca",
+                "orcid": "0000-0003-3183-2291"
+            }
+        ],
+        "files": [
+            {
+                "url": "https://code-repo.d4science.org/gCubeSystem/{{name}}/archive/v{{version}}.zip",
+                "desired_name": "{{name}}-v{{version}}.zip"
+            },
+            {
+                "url": "https://code-repo.d4science.org/gCubeSystem/{{name}}/archive/v{{version}}.tar.gz",
+                "desired_name": "{{name}}-v{{version}}.tar.gz"
+            },
+            {
+                "url": "https://nexus.d4science.org/nexus/service/local/repo_groups/gcube-releases-all/content/org/gcube/{{group}}/{{name}}/{{version}}/{{name}}-{{version}}.war",
+                "desired_name": "{{name}}-v{{version}}.war"
+            }
+        ],
+		"code_location": "https://code-repo.d4science.org/gCubeSystem/{{name}}/releases/tag/v{{version}}",
+        "grants": [
+            {
+                "id": "004260",
+                "name": "DILIGENT",
+                "url": "https://cordis.europa.eu/project/id/004260"
+            },
+            {
+                "id": "212488",
+                "name": "D4Science",
+                "url": "https://cordis.europa.eu/project/id/212488"
+            },
+            {
+                "id": "239019",
+                "name": "D4Science-II",
+                "url": "https://cordis.europa.eu/project/id/239019"
+            },
+            {
+                "id": "283465",
+                "name": "ENVRI",
+                "url": "https://cordis.europa.eu/project/id/283465"
+            },
+            {
+                "id": "283644",
+                "name": "iMarine",
+                "url": "https://cordis.europa.eu/project/id/283644"
+            },
+            {
+                "id": "288754",
+                "name": "EUBrazilOpenBio",
+                "url": "https://cordis.europa.eu/project/id/288754"
+            },
+            {
+                "id": "654024",
+                "name": "SoBigData",
+                "url": "https://cordis.europa.eu/project/id/654024"
+            },
+            {
+                "id": "654119",
+                "name": "PARTHENOS",
+                "url": "https://cordis.europa.eu/project/id/654119"
+            },
+            {
+                "id": "654142",
+                "name": "EGI-Engage",
+                "url": "https://cordis.europa.eu/project/id/654142"
+            },
+            {
+                "id": "654182",
+                "name": "ENVRI PLUS",
+                "url": "https://cordis.europa.eu/project/id/654182"
+            },
+            {
+                "id": "675680",
+                "name": "BlueBRIDGE",
+                "url": "https://cordis.europa.eu/project/id/675680"
+            },
+            {
+                "id": "727610",
+                "name": "PerformFISH",
+                "url": "https://cordis.europa.eu/project/id/727610"
+            },
+            {
+                "id": "731001",
+                "name": "AGINFRA PLUS",
+                "url": "https://cordis.europa.eu/project/id/731001"
+            },
+            {
+                "id": "818194",
+                "name": "DESIRA",
+                "url": "https://cordis.europa.eu/project/id/818194"
+            },
+            {
+                "id": "823914",
+                "name": "ARIADNEplus",
+                "url": "https://cordis.europa.eu/project/id/823914"
+            },
+            {
+                "id": "824091",
+                "name": "RISIS 2",
+                "url": "https://cordis.europa.eu/project/id/824091"
+            },
+            {
+                "id": "857650",
+                "name": "EOSC-Pillar",
+                "url": "https://cordis.europa.eu/project/id/857650"
+            },
+            {
+                "id": "862409",
+                "name": "Blue Cloud",
+                "url": "https://cordis.europa.eu/project/id/862409"
+            },
+            {
+                "id": "871042",
+                "name": "SoBigData-PlusPlus",
+                "url": "https://cordis.europa.eu/project/id/871042"
+            }
+        ],
+        "publishers": {
+        	"ZenodoSoftwareVersionPublisher": {
+	        	"elaboration": "NONE",
+	        	"additional_html_description": "\n\n<p><a href=\"https://www.gcube-system.org/\">gCube</a> is an open-source software toolkit used for building and operating Hybrid Data Infrastructures enabling the dynamic deployment of Virtual Research Environments, such as the <a href=\"https://www.d4science.org/\">D4Science Infrastructure</a>, by favouring the realisation of reuse-oriented policies.</p>\n\n<p><a href=\"https://www.gcube-system.org/\">gCube</a> has been used to successfully build and operate infrastructures and virtual research environments for application domains ranging from biodiversity to environmental data management and cultural heritage.</p>\n\n<p><a href=\"https://www.gcube-system.org/\">gCube</a> offers components supporting typical data management workflows including data access, curation, processing, and visualisation on a large set of data typologies ranging from primary biodiversity data to geospatial and tabular data.</p>\n\n<p><a href=\"https://www.d4science.org/\">D4Science</a> is a Hybrid Data Infrastructure combining over 500 software components and integrating data from more than 50 different data providers into a coherent and managed system of hardware, software, and data resources. The D4Science infrastructure drastically reduces the cost of ownership, maintenance, and operation thanks to the exploitation of gCube.</p>\n\n<p>&nbsp;</p>\n\n<p>The official source code location of this software version is available at:</p>\n\n<p><a href=\"{{code_location}}\">{{code_location}}</a></p>",
+	            "skip_grants": ["004260"]
+	        }
+	    },
+	    "exporters": {
+	        "BibLaTeXSoftwareVersionExporter": {
+	        	 "elaboration": "ALL"
+	        }
+	    },
+	    "export_filename": "{{name}}"
+    },
+    "versions": [
+        {
+            "version": "1.0.0",
+            "date": "2019-01-10",
+            "group": "data-publishing",
+            "files": [
+                {
+                    "url": "https://nexus.d4science.org/nexus/service/local/repositories/gcube-snapshots/content/org/gcube/data-publishing/gcat/1.0.0-SNAPSHOT/gcat-1.0.0-20190109.172827-2.war",
+                    "desired_name": "{{name}}-v{{version}}.war"
+                }
+            ],
+            "gcube_release_version": null,
+            "gcube_release_ticket": null,
+            "concept_doi_url": null,
+            "version_doi_url": null,
+            "code_location": "https://code-repo.d4science.org/gCubeSystem/{{name}}"
+        },
+        {
+            "version": "1.1.0",
+            "date": "2019-02-26",
+            "group": "data-publishing",
+            "files": [
+                {
+                    "url": "https://nexus.d4science.org/nexus/service/local/repo_groups/gcube-releases-all/content/org/gcube/data-publishing/gcat/1.1.0-4.13.1-177071/gcat-1.1.0-4.13.1-177071-src.zip",
+                    "desired_name": "{{name}}-v{{version}}.zip"
+                },
+                {
+                    "url": "https://nexus.d4science.org/nexus/service/local/repo_groups/gcube-releases-all/content/org/gcube/data-publishing/gcat/1.1.0-4.13.1-177071/gcat-1.1.0-4.13.1-177071.war",
+                    "desired_name": "{{name}}-v{{version}}.war"
+                }
+            ],
+            "gcube_release_version": "4.13.1",
+            "gcube_release_ticket": "https://support.d4science.org/issues/12988",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null,
+            "code_location": "https://code-repo.d4science.org/gCubeSystem/{{name}}"
+        },
+        {
+            "version": "1.2.0",
+            "date": "2019-05-20",
+            "group": "data-publishing",
+            "files": [
+                {
+                    "url": "https://nexus.d4science.org/nexus/service/local/repositories/gcube-snapshots/content/org/gcube/data-publishing/gcat/1.2.0-SNAPSHOT/gcat-1.2.0-20190520.132914-10.war",
+                    "desired_name": "{{name}}-v{{version}}.war"
+                }
+            ],
+            "gcube_release_version": null,
+            "gcube_release_ticket": null,
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null,
+            "code_location": "https://code-repo.d4science.org/gCubeSystem/{{name}}"
+        },
+        {
+            "version": "1.3.0",
+            "date": "2019-06-27",
+            "group": "data-publishing",
+            "files": [
+                {
+                    "url": "https://nexus.d4science.org/nexus/service/local/repo_groups/gcube-releases-all/content/org/gcube/data-publishing/gcat/1.3.0-4.14.0-179505/gcat-1.3.0-4.14.0-179505-src.zip",
+                    "desired_name": "{{name}}-v{{version}}.zip"
+                },
+                {
+                    "url": "https://nexus.d4science.org/nexus/service/local/repo_groups/gcube-releases-all/content/org/gcube/data-publishing/gcat/1.3.0-4.14.0-179505/gcat-1.3.0-4.14.0-179505.war",
+                    "desired_name": "{{name}}-v{{version}}.war"
+                }
+            ],
+            "gcube_release_version": "4.14.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/16743",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null,
+            "code_location": "https://code-repo.d4science.org/gCubeSystem/{{name}}"
+        },
+        {
+            "version": "1.4.0",
+            "date": "2019-11-06",
+            "group": "data-publishing",
+            "gcube_release_version": "4.15.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/17294",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null
+        },
+        {
+            "version": "1.4.1",
+            "date": "2019-12-20",
+            "group": "data-publishing",
+            "gcube_release_version": "4.18.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/18335",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null
+        },
+        {
+            "version": "1.4.2",
+            "date": "2020-02-14",
+            "group": "data-publishing",
+            "gcube_release_version": "4.20.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/18507",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null
+        },
+        {
+            "version": "1.4.3",
+            "date": "2020-06-16",
+            "group": "data-publishing",
+            "gcube_release_version": "4.23.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/19322",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null
+        },
+        {
+            "version": "1.4.4",
+            "date": "2021-02-24",
+            "group": "data-publishing",
+            "gcube_release_version": "5.0.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/20648",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null
+        },
+        {
+            "version": "1.4.5",
+            "date": "2021-03-31",
+            "group": "data-publishing",
+            "gcube_release_version": "5.1.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/20920",
+            "concept_doi_url": "PREVIOUS",
+            "version_doi_url": null
+        },
+        {
+            "version": "2.0.0",
+            "date": "2021-05-04",
+            "gcube_release_version": "5.2.0",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": "https://doi.org/10.5281/zenodo.7446642"
+        },
+		{
+            "version": "2.1.0",
+            "date": "2022-01-27",
+            "gcube_release_version": "5.7.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/21685/",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": "https://doi.org/10.5281/zenodo.7447405"
+        },
+		{
+            "version": "2.2.0",
+            "date": "2022-05-12",
+            "gcube_release_version": "5.11.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/22943",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": "https://doi.org/10.5281/zenodo.7447427"
+        },
+		{
+            "version": "2.3.0",
+            "date": "2022-07-22",
+            "gcube_release_version": "5.13.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/23374",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": "https://doi.org/10.5281/zenodo.7448628"
+        },
+		{
+            "version": "2.4.0",
+            "date": "2022-09-16",
+            "gcube_release_version": "5.13.1",
+            "gcube_release_ticket": "https://support.d4science.org/issues/23650",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": "https://doi.org/10.5281/zenodo.7448730"
+        },
+		{
+            "version": "2.4.1",
+            "date": "2022-12-07",
+            "gcube_release_version": "5.14.0",
+            "gcube_release_ticket": "https://support.d4science.org/issues/23885",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": "https://doi.org/10.5281/zenodo.7467222"
+        },
+		{
+            "version": "2.5.0",
+            "date": null,
+            "gcube_release_version": null,
+            "gcube_release_ticket": "https://support.d4science.org/issues/24601",
+            "concept_doi_url": "https://doi.org/10.5281/zenodo.7446641",
+            "version_doi_url": null
+        }
+    ]
+}

pom.xml

@@ -5,14 +5,14 @@
 	<parent>
 		<artifactId>maven-parent</artifactId>
 		<groupId>org.gcube.tools</groupId>
-		<version>1.1.0</version>
+		<version>1.2.0</version>
 		<relativePath />
 	</parent>
 
 	<groupId>org.gcube.data-catalogue</groupId>
 	<artifactId>gcat</artifactId>
 	<packaging>war</packaging>
-	<version>2.3.0</version>
+	<version>2.5.3</version>
 	<name>gCube Catalogue (gCat) Service</name>
 	<description>
 		This service allows any client to publish on the gCube Catalogue.
@@ -35,7 +35,7 @@
 			<dependency>
 				<groupId>org.gcube.distribution</groupId>
 				<artifactId>gcube-smartgears-bom</artifactId>
-				<version>2.1.1</version>
+				<version>2.5.0</version>
 				<type>pom</type>
 				<scope>import</scope>
 			</dependency>
@@ -59,10 +59,15 @@
 			<groupId>org.gcube.core</groupId>
 			<artifactId>common-smartgears-app</artifactId>
 		</dependency>
+		<dependency>
+			<groupId>org.gcube.data-catalogue</groupId>
+			<artifactId>catalogue-core</artifactId>
+			<version>[1.0.0-SNAPSHOT, 2.0.0-SNAPSHOT)</version>
+		</dependency>
 		<dependency>
 			<groupId>org.gcube.data-catalogue</groupId>
 			<artifactId>gcat-api</artifactId>
-			<version>[2.0.0,3.0.0-SNAPSHOT)</version>
+			<version>[2.3.2, 3.0.0-SNAPSHOT)</version>
 		</dependency>
 		<dependency>
  			<groupId>org.gcube.social-networking</groupId>
@@ -72,7 +77,7 @@
 		<dependency>
 			<groupId>org.gcube.common</groupId>
 			<artifactId>authorization-utils</artifactId>
-			<version>[2.0.0, 3.0.0-SNAPSHOT)</version>
+			<version>[2.2.0, 3.0.0-SNAPSHOT)</version>
 		</dependency>
 		<dependency>
 			<groupId>org.gcube.common</groupId>
@@ -98,6 +103,10 @@
 			<groupId>org.gcube.information-system</groupId>
 			<artifactId>resource-registry-publisher</artifactId>
 		</dependency>
+		<dependency>
+			<groupId>org.gcube.information-system</groupId>
+			<artifactId>resource-registry-query-template-client</artifactId>
+		</dependency>
 		<dependency>
 			<groupId>org.gcube.resources</groupId>
 			<artifactId>common-gcore-resources</artifactId>
@@ -134,10 +143,28 @@
 		    <groupId>javax.ws.rs</groupId>
 		    <artifactId>javax.ws.rs-api</artifactId>
 		</dependency>
+
+		<!-- Added to support Java 11 JDK -->
+		<dependency>
+    		<groupId>javax.xml.ws</groupId>
+    		<artifactId>jaxws-api</artifactId>
+    		<scope>provided</scope>
+		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<scope>provided</scope>
+		</dependency>
+		<!-- END Added to support Java 11 JDK -->
+		
 		<dependency>
 			<groupId>org.gcube.common</groupId>
 			<artifactId>gxHTTP</artifactId>
 		</dependency>
+		<dependency>
+			<groupId>org.gcube.common</groupId>
+			<artifactId>keycloak-client</artifactId>
+		</dependency>
 
 		<dependency>
 			<groupId>org.gcube.core</groupId>
@@ -175,7 +202,7 @@
 		<dependency>
 			<groupId>org.gcube.data-publishing</groupId>
 			<artifactId>storagehub-application-persistence</artifactId>
-			<version>[3.0.0,4.0.0-SNAPSHOT)</version>
+			<version>[3.3.0-SNAPSHOT,4.0.0-SNAPSHOT)</version>
 		</dependency>
 
 		<!-- Used to automatically convert XML to JSON -->
@@ -185,22 +212,28 @@
 			<version>20211205</version>
 		</dependency>
 
+		<!-- Used to detect Resource MimeTypes -->
 		<dependency>
 			<groupId>org.apache.tika</groupId>
 		    <artifactId>tika-core</artifactId>
 		    <version>2.1.0</version>
 		</dependency>
+
+		<!-- Used by Validator -->
 		<dependency>
-		    <groupId>org.apache.commons</groupId>
-		    <artifactId>commons-lang3</artifactId>
-		    <version>3.12.0</version>
+		    <groupId>commons-lang</groupId>
+		    <artifactId>commons-lang</artifactId>
+		    <version>2.6</version>
 		</dependency>
 		
+		<!-- 
+		Zulip is not used at the moment  
 		<dependency>
 			<groupId>io.taliox</groupId>
 			<artifactId>zulip-java-rest</artifactId>
 			<version>1.0.0</version>
 		</dependency>
+		-->
 		
 		<dependency>
 			<groupId>org.gcube.common</groupId>
@@ -249,28 +282,46 @@
 			<artifactId>logback-classic</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 	</dependencies>
 	
 	<build>
-
        	<plugins>
-				<!-- Enunciate Maven plugin -->
+			<!-- Sphinx plugin' -->
 			<plugin>
-			    <groupId>com.webcohesion.enunciate</groupId>
-			    <artifactId>enunciate-maven-plugin</artifactId>
-			    <version>${enunciate.version}</version>
-			    <executions>
-			        <execution>
-			            <id>assemble</id>
-			            <goals>
-			                <goal>assemble</goal>
-			            </goals>
-			        </execution>
-			    </executions>
+				<groupId>kr.motd.maven</groupId>
+				<artifactId>sphinx-maven-plugin</artifactId>
+				<version>2.10.0</version>
+				<configuration>
+					<outputDirectory>${project.build.directory}/${project.artifactId}-${project.version}/docs</outputDirectory>
+					<builder>html</builder>
+					<configDirectory>${basedir}/docs</configDirectory>
+					<sourceDirectory>${basedir}/docs</sourceDirectory>
+				</configuration>
+				<executions>
+					<execution>
+						<phase>process-resources</phase>
+						<goals>
+							<goal>generate</goal>
+						</goals>
+					</execution>
+				</executions>
 			</plugin>
 			
-				<!-- Copy Enunciate Documentation from your-application/docs into your war -->
+			<!-- Enunciate Maven plugin -->
+			<plugin>
+				<groupId>com.webcohesion.enunciate</groupId>
+				<artifactId>enunciate-maven-plugin</artifactId>
+				<version>${enunciate.version}</version>
+				<executions>
+					<execution>
+		            	<id>assemble</id>
+		            	<goals>
+		                	<goal>assemble</goal>
+		            	</goals>
+		        	</execution>
+		    	</executions>
+			</plugin>
+			<!-- Copy Enunciate Documentation from your-application/api-docs into your war -->
 			<plugin>
 			    <groupId>org.apache.maven.plugins</groupId>
 			    <artifactId>maven-resources-plugin</artifactId>
@@ -285,8 +336,8 @@
 			                <outputDirectory>target</outputDirectory>
 			                <resources>
 			                    <resource>
-			                        <targetPath>${project.build.directory}/${project.artifactId}-${project.version}/docs</targetPath>
-			                        <directory>${project.build.directory}/docs</directory>
+			                        <targetPath>${project.build.directory}/${project.artifactId}-${project.version}/api-docs</targetPath>
+			                        <directory>${project.build.directory}/api-docs</directory>
 			                        <filtering>true</filtering>
 			                    </resource>
 			                </resources>
@@ -294,8 +345,17 @@
 			        </execution>
 			    </executions>
 			</plugin>
+			
+			
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-war-plugin</artifactId>
+				<configuration>
+					<attachClasses>true</attachClasses>
+				</configuration>
+			</plugin>
+			
 		</plugins>
-
 	</build>
 	
 </project>

src/main/java/org/gcube/gcat/GCatInitializator.java

@@ -0,0 +1,131 @@
+package org.gcube.gcat;
+
+import java.io.IOException;
+
+import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
+import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
+import org.gcube.gcat.configuration.isproxies.impl.FacetBasedISConfigurationProxy;
+import org.gcube.gcat.configuration.isproxies.impl.FacetBasedISConfigurationProxyFactory;
+import org.gcube.gcat.configuration.isproxies.impl.GCoreISConfigurationProxyFactory;
+import org.gcube.gcat.rest.RequestFilter;
+import org.gcube.smartgears.ApplicationManager;
+import org.gcube.smartgears.ContextProvider;
+import org.gcube.smartgears.context.application.ApplicationContext;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * @author Luca Frosini (ISTI - CNR)
+ */
+public class GCatInitializator implements ApplicationManager {
+
+	/**
+	 * Logger
+	 */
+	private static Logger logger = LoggerFactory.getLogger(GCatInitializator.class);
+	
+	public static boolean initialised;
+	
+	/** 
+	 * {@inheritDoc}
+	 * The method discover the plugins available on classpath and their own 
+	 * supported capabilities and publish a ServiceEndpoint with the 
+	 * discovered information.
+	 * Furthermore create/connect to DB
+	 */
+	@Override
+	public synchronized void onInit() {
+		RequestFilter requestFilter = new RequestFilter();
+		try {
+			requestFilter.filter(null);
+		} catch (IOException e) {
+			throw new RuntimeException(e);
+		}
+		
+		String context = SecretManagerProvider.instance.get().getContext();
+		
+		logger.trace(
+				"\n-------------------------------------------------------\n"
+				+ "GCat is Starting on context {}\n"
+				+ "-------------------------------------------------------",
+				context);
+		
+		ApplicationContext applicationContext = ContextProvider.get();
+		String gcatEServiceID  = applicationContext.id();
+		
+		
+		try {
+			FacetBasedISConfigurationProxyFactory fbigcpf = new FacetBasedISConfigurationProxyFactory();
+			FacetBasedISConfigurationProxy facetBasedISConfigurationProxy = fbigcpf.getInstance(context);
+			if(!initialised) {
+				CatalogueConfigurationFactory.addISConfigurationProxyFactory(fbigcpf);
+				GCoreISConfigurationProxyFactory gcigcpf = new GCoreISConfigurationProxyFactory();
+				CatalogueConfigurationFactory.addISConfigurationProxyFactory(gcigcpf);
+				initialised = true;
+				facetBasedISConfigurationProxy.installQueryTemplate();
+			}
+			facetBasedISConfigurationProxy.setServiceEServiceID(gcatEServiceID);
+			facetBasedISConfigurationProxy.createCallsForToVirtualService();
+		}catch (Exception e) {
+			logger.warn("Gcat is not configured through the Facet Based IS in context {}. Please create/addToContext the expected resources ASAP. The Gcore IS will be used.", context);
+			logger.trace("Gcat is not configured through the Facet Based IS in context {}. The reason is:\n", context, e);
+		}
+		
+		
+		
+		logger.trace(
+				"\n-------------------------------------------------------\n"
+				+ "GCat Started Successfully on context {}\n"
+				+ "-------------------------------------------------------",
+				context);
+		
+	}
+	
+	/** 
+	 * {@inheritDoc} 
+	 * This function is invoked before the service will stop and unpublish the 
+	 * resource from the IS to maintain the infrastructure integrity.
+	 * Furthermore close the connection to DB.
+	 */
+	@Override
+	public synchronized void onShutdown(){
+		RequestFilter requestFilter = new RequestFilter();
+		try {
+			requestFilter.filter(null);
+		} catch (IOException e) {
+			throw new RuntimeException(e);
+		}
+		
+		String context = SecretManagerProvider.instance.get().getContext();
+		
+		logger.trace(
+				"\n-------------------------------------------------------\n"
+				+ "GCat is Stopping on context {}\n"
+				+ "-------------------------------------------------------", 
+				context);
+		
+		/*
+		 * We don't delete the relation.
+		 * Thanks to the propagation constraint, 
+		 * it will be deleted when the EService will be deleted.
+		 *  
+		ApplicationContext applicationContext = ContextProvider.get();
+		String gcatEServiceID  = applicationContext.id();
+		
+		FacetBasedISGcatConfigurationProxyFactory fbigcpf = new FacetBasedISGcatConfigurationProxyFactory();
+		FacetBasedGcatISConfigurationProxy facetBasedISConfigurationProxy = fbigcpf.getInstance(context);
+		facetBasedISConfigurationProxy.setGcatEServiceID(gcatEServiceID);
+		try {
+			facetBasedISConfigurationProxy.deleteCallsForToVirtualService();
+		}catch (Exception e) {
+			logger.warn("Gcat is not configured through the Facet Based IS in context {}. Please create/addToContext the expected resources ASAP. The Gcore IS will be used.", context, e);
+		}
+		*/
+		
+		logger.trace(
+				"\n-------------------------------------------------------\n"
+				+ "GCat Stopped Successfully on context {}\n"
+				+ "-------------------------------------------------------", 
+				context);
+	}
+}

src/main/java/org/gcube/gcat/ResourceInitializer.java

@@ -2,17 +2,21 @@ package org.gcube.gcat;
 
 import javax.ws.rs.ApplicationPath;
 
-import org.gcube.gcat.rest.Group;
+import org.gcube.gcat.rest.Item;
+import org.gcube.gcat.rest.administration.Configuration;
+import org.gcube.smartgears.annotations.ManagedBy;
 import org.glassfish.jersey.server.ResourceConfig;
 
 /**
  * @author Luca Frosini (ISTI - CNR)
  */
 @ApplicationPath("/")
+@ManagedBy(GCatInitializator.class)
 public class ResourceInitializer extends ResourceConfig {
 	
 	public ResourceInitializer() {
-		packages(Group.class.getPackage().toString());
+		packages(Item.class.getPackage().toString());
+		packages(Configuration.class.getPackage().toString());
 	}
 	
 }

src/main/java/org/gcube/gcat/configuration/CatalogueConfigurationFactory.java

@@ -1,64 +0,0 @@
-package org.gcube.gcat.configuration;
-
-import java.util.HashMap;
-import java.util.Map;
-
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CatalogueConfigurationFactory {
-	
-	private static final Map<String, ServiceCatalogueConfiguration> catalogueConfigurations;
-	
-	static {
-		catalogueConfigurations = new HashMap<>();
-	}
-	
-	protected static ServiceCatalogueConfiguration load(String context) {
-		GCoreISConfigurationProxy gCoreISConfigurationProxy = new GCoreISConfigurationProxy(context);
-		return gCoreISConfigurationProxy.getCatalogueConfiguration();
-	}
-	
-	public synchronized static ServiceCatalogueConfiguration getInstance() {
-		String context = SecretManagerProvider.instance.get().getContext();
-		ServiceCatalogueConfiguration catalogueConfiguration = catalogueConfigurations.get(context);
-		if(catalogueConfiguration == null) {
-			catalogueConfiguration = load(context);
-			catalogueConfigurations.put(context, catalogueConfiguration);
-		}
-		return catalogueConfiguration;
-	}
-	
-	public synchronized static void renew() {
-		String context = SecretManagerProvider.instance.get().getContext();
-		catalogueConfigurations.remove(context);
-		ServiceCatalogueConfiguration catalogueConfiguration = load(context);
-		catalogueConfigurations.put(context, catalogueConfiguration);
-	}
-	
-	public synchronized static void purge() {
-		// Remove the resource from IS
-		String context = SecretManagerProvider.instance.get().getContext();
-		catalogueConfigurations.remove(context);
-		GCoreISConfigurationProxy gCoreISConfigurationProxy = new GCoreISConfigurationProxy(context);
-		gCoreISConfigurationProxy.delete();
-	}
-	
-	public synchronized static ServiceCatalogueConfiguration createOrUpdate(ServiceCatalogueConfiguration catalogueConfiguration) throws Exception {
-		String context = SecretManagerProvider.instance.get().getContext();
-		catalogueConfigurations.remove(context);
-		GCoreISConfigurationProxy gCoreISConfigurationProxy = new GCoreISConfigurationProxy(context, catalogueConfiguration);
-		catalogueConfiguration = gCoreISConfigurationProxy.createOrUpdateOnIS();
-		catalogueConfigurations.put(context, catalogueConfiguration);
-		
-		// The supported organizations could be changed we need to empty the user cache for the context
-		// to avoid to miss to add an user in an organization which has been added.
-		CKANUserCache.emptyUserCache();
-		
-		return catalogueConfiguration;
-	}
-	
-}

src/main/java/org/gcube/gcat/configuration/GCoreISConfigurationProxy.java

@@ -1,704 +0,0 @@
-package org.gcube.gcat.configuration;
-
-import static org.gcube.resources.discovery.icclient.ICFactory.clientFor;
-import static org.gcube.resources.discovery.icclient.ICFactory.queryFor;
-
-import java.io.IOException;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-import java.util.UUID;
-
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.NotFoundException;
-import javax.ws.rs.WebApplicationException;
-
-import org.gcube.com.fasterxml.jackson.core.JsonProcessingException;
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.resources.gcore.GenericResource;
-import org.gcube.common.resources.gcore.ServiceEndpoint;
-import org.gcube.common.resources.gcore.ServiceEndpoint.AccessPoint;
-import org.gcube.common.resources.gcore.ServiceEndpoint.Profile;
-import org.gcube.common.resources.gcore.ServiceEndpoint.Property;
-import org.gcube.common.resources.gcore.ServiceEndpoint.Runtime;
-import org.gcube.common.resources.gcore.common.Platform;
-import org.gcube.common.resources.gcore.utils.Group;
-import org.gcube.gcat.api.GCatConstants;
-import org.gcube.gcat.api.configuration.CatalogueConfiguration;
-import org.gcube.informationsystem.publisher.RegistryPublisher;
-import org.gcube.informationsystem.publisher.RegistryPublisherFactory;
-import org.gcube.resources.discovery.client.api.DiscoveryClient;
-import org.gcube.resources.discovery.client.queries.api.SimpleQuery;
-import org.gcube.resources.discovery.icclient.ICFactory;
-import org.gcube.smartgears.ContextProvider;
-import org.gcube.smartgears.configuration.application.ApplicationConfiguration;
-import org.gcube.smartgears.configuration.container.ContainerConfiguration;
-import org.gcube.smartgears.context.application.ApplicationContext;
-import org.gcube.smartgears.context.container.ContainerContext;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class GCoreISConfigurationProxy {
-
-	private static final Logger logger = LoggerFactory.getLogger(GCoreISConfigurationProxy.class);
-	
-	// property to retrieve the master service endpoint into the /root scope
-	public final static String IS_ROOT_MASTER_PROPERTY_KEY = "IS_ROOT_MASTER"; // true, false.. missing means false as
-
-	public final static String DEFAULT_ORGANIZATION_PROPERTY_KEY = "DEFAULT_ORGANIZATION";
-	public final static String SUPPORTED_ORGANIZATION_PROPERTY_KEY = "SUPPORTED_ORGANIZATION";
-	
-	public final static String API_KEY_PROPERTY_KEY = "API_KEY";
-	public final static String SOLR_INDEX_ADDRESS_PROPERTY_KEY = "SOLR_INDEX_ADDRESS";
-	public final static String SOCIAL_POST_PROPERTY_KEY = "SOCIAL_POST";
-	public final static String ALERT_USERS_ON_POST_CREATION_PROPERTY_KEY = "ALERT_USERS_ON_POST_CREATION";
-	public final static String MODERATION_ENABLED_KEY_PROPERTY_KEY = "MODERATION_ENABLED";
-
-	public static final Map<String, String> gCoreToConfigurationMapping;
-	public static final Map<String, String> configurationToGCoreMapping;
-	
-	static {
-		gCoreToConfigurationMapping = new HashMap<>();
-		configurationToGCoreMapping = new HashMap<>();
-		
-		gCoreToConfigurationMapping.put(API_KEY_PROPERTY_KEY, CatalogueConfiguration.SYS_ADMIN_TOKEN_KEY);
-		
-		gCoreToConfigurationMapping.put(SOLR_INDEX_ADDRESS_PROPERTY_KEY, CatalogueConfiguration.SOLR_URL_KEY);
-		
-		gCoreToConfigurationMapping.put(SOCIAL_POST_PROPERTY_KEY, CatalogueConfiguration.SOCIAL_POST_ENABLED_KEY);
-		gCoreToConfigurationMapping.put(ALERT_USERS_ON_POST_CREATION_PROPERTY_KEY, CatalogueConfiguration.NOTIFICATION_TO_USER_ENABLED_KEY);
-		gCoreToConfigurationMapping.put(MODERATION_ENABLED_KEY_PROPERTY_KEY, CatalogueConfiguration.MODERATION_ENABLED_KEY);
-		
-		for(String key : gCoreToConfigurationMapping.keySet()) {
-			configurationToGCoreMapping.put(gCoreToConfigurationMapping.get(key), key);
-		}
-	}
-	
-	// CKAN Instance info
-	private final static String OLD_CATEGORY = "Application";
-	private final static String OLD_NAME = "CKanDataCatalogue";
-
-	protected final String context;
-	protected ObjectMapper mapper;
-	protected ServiceCatalogueConfiguration catalogueConfiguration;
-	
-	public GCoreISConfigurationProxy(String context) {
-		this.context = context;
-		this.mapper = new ObjectMapper();
-	}
-
-	public GCoreISConfigurationProxy(String context, ServiceCatalogueConfiguration catalogueConfiguration) {
-		this(context);
-		this.catalogueConfiguration = catalogueConfiguration;
-		this.mapper = new ObjectMapper();
-	}
-
-	public ServiceCatalogueConfiguration getCatalogueConfiguration() throws WebApplicationException {
-		if (catalogueConfiguration == null) {
-			catalogueConfiguration = getCatalogueConfigurationFromIS();
-		}
-		return catalogueConfiguration;
-	}
-
-	protected AccessPoint getAccessPoint(Profile profile) {
-		Group<AccessPoint> accessPoints = profile.accessPoints();
-		Iterator<AccessPoint> accessPointIterator = accessPoints.iterator();
-		AccessPoint accessPoint = accessPointIterator.next();
-		return accessPoint;
-	}
-	
-	protected String getDefaultSolrURL(String ckanURL) {
-		StringBuffer stringBuffer = new StringBuffer();
-		stringBuffer.append(ckanURL);
-		stringBuffer.append(ckanURL.endsWith("/")?"":"/");
-		stringBuffer.append("solr/");
-		return stringBuffer.toString();
-	}
-	
-	protected ObjectNode setValue(ObjectNode node, String key, String value) throws IOException {
-		if(value.toLowerCase().compareTo("true")==0 || value.toLowerCase().compareTo("false")==0) {
-			node.put(key, Boolean.parseBoolean(value));
-			return node;
-		}
-		
-		if(value.startsWith("{") || value.startsWith("[")){
-			JsonNode n = mapper.readTree(value);
-			node.set(key, n);
-			return node;
-			
-		}
-		
-		node.put(key, value);
-		return node;
-	}
-	
-	protected ServiceCatalogueConfiguration getConfiguration(ServiceEndpoint serviceEndpoint) throws IOException {
-		Profile profile = serviceEndpoint.profile();
-		AccessPoint accessPoint = getAccessPoint(profile);
-		Map<String, Property> propertyMap = accessPoint.propertyMap();
-		
-		ObjectNode node = mapper.createObjectNode();
-		node.put(CatalogueConfiguration.ID_KEY, serviceEndpoint.id());
-		
-		for(String key : propertyMap.keySet()) {
-			String value = propertyMap.get(key).value().trim();
-			setValue(node, key, value);
-		}
-		
-		return mapper.treeToValue(node, ServiceCatalogueConfiguration.class);
-	}
-	
-	private List<ServiceEndpoint> getServiceEndpoints(String category, String name) {
-		SimpleQuery query = queryFor(ServiceEndpoint.class);
-		query.addCondition("$resource/Scopes/Scope/text() eq '" + SecretManagerProvider.instance.get().getContext() + "'");
-		query.addCondition("$resource/Profile/Category/text() eq '" + category + "'");
-		query.addCondition("$resource/Profile/Name/text() eq '" + name + "'");
-		DiscoveryClient<ServiceEndpoint> client = clientFor(ServiceEndpoint.class);
-		List<ServiceEndpoint> serviceEndpoints = client.submit(query);
-		return serviceEndpoints;
-	}
-	
-	protected ServiceEndpoint getServiceEndpoint() {
-		List<ServiceEndpoint> serviceEndpoints = getServiceEndpoints(GCatConstants.CONFIGURATION_CATEGORY, GCatConstants.CONFIGURATION_NAME);
-		if (serviceEndpoints==null || serviceEndpoints.size() == 0) {
-			logger.error("There is no {} having Category {} and Name {} in this context.",
-					ServiceEndpoint.class.getSimpleName(), GCatConstants.CONFIGURATION_CATEGORY, GCatConstants.CONFIGURATION_NAME);
-			return null;
-		}
-		ServiceEndpoint serviceEndpoint = serviceEndpoints.get(0);
-		return serviceEndpoint;
-	}
-	
-	protected ServiceCatalogueConfiguration getCatalogueConfigurationFromIS() throws WebApplicationException {
-		ServiceEndpoint serviceEndpoint = getServiceEndpoint();
-		if(serviceEndpoint==null) {
-			return getOLDCatalogueConfigurationFromIS();
-		}
-		try {
-			return getConfiguration(serviceEndpoint);
-		}catch (Exception e) {
-			throw new InternalServerErrorException();
-		}
-	}
-	
-	@Deprecated
-	private ServiceEndpoint getOldServiceEndpoint() {
-		List<ServiceEndpoint> serviceEndpoints = getServiceEndpoints(OLD_CATEGORY, OLD_NAME);
-
-		if (serviceEndpoints.size() == 0) {
-			logger.error("There is no {} having Category {} and Name {} in this context.",
-					ServiceEndpoint.class.getSimpleName(), OLD_CATEGORY, OLD_NAME);
-			return null;
-		}
-
-		ServiceEndpoint serviceEndpoint = null;
-
-		if (serviceEndpoints.size() > 1) {
-			logger.info("Too many {} having Category {} and Name {} in this context. Looking for the one that has the property {}",
-					ServiceEndpoint.class.getSimpleName(), OLD_CATEGORY, OLD_NAME, IS_ROOT_MASTER_PROPERTY_KEY);
-
-			for (ServiceEndpoint se : serviceEndpoints) {
-				Iterator<AccessPoint> accessPointIterator = se.profile().accessPoints().iterator();
-				while (accessPointIterator.hasNext()) {
-					ServiceEndpoint.AccessPoint accessPoint = accessPointIterator.next();
-
-					// get the is master property
-					Property entry = accessPoint.propertyMap().get(IS_ROOT_MASTER_PROPERTY_KEY);
-					String isMaster = entry != null ? entry.value() : null;
-
-					if (isMaster == null || !isMaster.equals("true")) {
-						continue;
-					}
-
-					// set this variable
-					serviceEndpoint = se;
-					return serviceEndpoint;
-				}
-			}
-
-			// if none of them was master, throw an exception
-			if (serviceEndpoint == null) {
-				throw new InternalServerErrorException(
-						"Too many catalogue configuration on IS and no one with MASTER property");
-			}
-
-		} else {
-			serviceEndpoint = serviceEndpoints.get(0);
-		}
-
-		return serviceEndpoint;
-	}
-	
-	@Deprecated
-	protected ServiceCatalogueConfiguration getOLDCatalogueConfigurationFromIS() {
-		ServiceCatalogueConfiguration catalogueConfiguration = new ServiceCatalogueConfiguration(context);
-		try {
-			// boolean mustBeUpdated = false;
-			
-			ServiceEndpoint serviceEndpoint = getOldServiceEndpoint();
-			if (serviceEndpoint == null) {
-				throw new NotFoundException("No configuration found in this context");
-			}
-
-			// catalogueConfiguration.setID(serviceEndpoint.id());
-
-			Profile profile = serviceEndpoint.profile();
-			AccessPoint accessPoint = getAccessPoint(profile);
-				
-			// add this host
-			String ckanURL = accessPoint.address();
-			catalogueConfiguration.setCkanURL(ckanURL);
-			
-			Map<String, Property> propertyMap = accessPoint.propertyMap();
-			
-			// retrieve sys admin token
-			String encryptedSysAdminToken = propertyMap.get(API_KEY_PROPERTY_KEY).value();
-			catalogueConfiguration.setEncryptedSysAdminToken(encryptedSysAdminToken);
-
-			
-			String defaultOrganization = CatalogueConfiguration.getOrganizationName(context);
-			
-			
-			String solrURL = null;
-			if (propertyMap.containsKey(SOLR_INDEX_ADDRESS_PROPERTY_KEY)) {
-				solrURL = propertyMap.get(SOLR_INDEX_ADDRESS_PROPERTY_KEY).value();
-			}else {
-				solrURL = getDefaultSolrURL(ckanURL);
-			}
-			catalogueConfiguration.setSolrURL(solrURL);
-			
-			// retrieve option to check if the social post has to be made
-			Boolean socialPostEnabled = true;
-			if (propertyMap.containsKey(SOCIAL_POST_PROPERTY_KEY)) {
-				if (propertyMap.get(SOCIAL_POST_PROPERTY_KEY).value().trim().equalsIgnoreCase("false")) {
-					socialPostEnabled = false;
-				}
-			}
-			catalogueConfiguration.setSocialPostEnabled(socialPostEnabled);
-
-			// retrieve option for user alert
-			boolean notificationToUsersEnabled = false; // default is false
-			if (propertyMap.containsKey(ALERT_USERS_ON_POST_CREATION_PROPERTY_KEY)) {
-				if (propertyMap.get(ALERT_USERS_ON_POST_CREATION_PROPERTY_KEY).value().trim()
-						.equalsIgnoreCase("true")) {
-					notificationToUsersEnabled = true;
-				}
-			}
-			catalogueConfiguration.setNotificationToUsersEnabled(notificationToUsersEnabled);
-
-			boolean moderationEnabled = false; // default is false
-			if (propertyMap.containsKey(MODERATION_ENABLED_KEY_PROPERTY_KEY)) {
-				if (propertyMap.get(MODERATION_ENABLED_KEY_PROPERTY_KEY).value().trim().equalsIgnoreCase("true")) {
-					moderationEnabled = true;
-				}
-			}
-			catalogueConfiguration.setModerationEnabled(moderationEnabled);
-
-			Set<String> supportedOrganizations = getSupportedOrganizationsFromGenericResource();
-			if (supportedOrganizations != null) {
-				catalogueConfiguration.setSupportedOrganizations(supportedOrganizations);
-				if(defaultOrganization==null) {
-					defaultOrganization = supportedOrganizations.toArray(new String[supportedOrganizations.size()])[0];
-					catalogueConfiguration.setDefaultOrganization(defaultOrganization);
-				}
-			}
-			
-			ServiceCKANDB ckanDB = getCKANDBFromIS();
-			catalogueConfiguration.setCkanDB(ckanDB);
-			
-		} catch (WebApplicationException e) {
-			throw e;
-		} catch (Exception e) {
-			throw new InternalServerErrorException("Error while getting configuration on IS", e);
-		}
-
-		return catalogueConfiguration;
-	}
-
-	// CKAN Instance info
-	@Deprecated
-	private final static String CKAN_DB_SERVICE_ENDPOINT_CATEGORY= "Database";
-	@Deprecated
-	private final static String CKAN_DB_SERVICE_ENDPOINT_NAME = "CKanDatabase";
-	
-	@Deprecated
-	protected ServiceCKANDB getCKANDBFromIS() {
-		try {
-			List<ServiceEndpoint> serviceEndpoints = getServiceEndpoints(CKAN_DB_SERVICE_ENDPOINT_CATEGORY, CKAN_DB_SERVICE_ENDPOINT_NAME);
-			if(serviceEndpoints.size() == 0) {
-				String error = String.format("There is no %s having category '%s' and name '%s' in this context.", 
-						ServiceEndpoint.class.getSimpleName(), CKAN_DB_SERVICE_ENDPOINT_CATEGORY, CKAN_DB_SERVICE_ENDPOINT_NAME);
-				logger.error(error);
-				throw new InternalServerErrorException(error);
-			}
-			
-			ServiceEndpoint serviceEndpoint = null;
-			
-			if(serviceEndpoints.size() > 1) {
-				logger.info("Too many {} having category {} and name {} in this context. Looking for the one that has the property {}",
-						ServiceEndpoint.class.getSimpleName(), CKAN_DB_SERVICE_ENDPOINT_CATEGORY,
-						CKAN_DB_SERVICE_ENDPOINT_NAME);
-				
-				for(ServiceEndpoint se : serviceEndpoints) {
-					Iterator<AccessPoint> accessPointIterator = se.profile().accessPoints().iterator();
-					while(accessPointIterator.hasNext()) {
-						ServiceEndpoint.AccessPoint accessPoint = accessPointIterator.next();
-						
-						// get the is master property
-						Property entry = accessPoint.propertyMap().get(IS_ROOT_MASTER_PROPERTY_KEY);
-						String isMaster = entry != null ? entry.value() : null;
-						
-						if(isMaster == null || !isMaster.equals("true")) {
-							continue;
-						}
-						
-						// set this variable
-						serviceEndpoint = se;
-						break;
-					}
-				}
-				
-				// if none of them was master, throw an exception
-				if(serviceEndpoint == null) {
-					throw new InternalServerErrorException(
-							"Too many CKAN configuration on IS and no one with MASTER property");
-				}
-				
-			} else {
-				serviceEndpoint = serviceEndpoints.get(0);
-			}
-			
-			Iterator<AccessPoint> accessPointIterator = serviceEndpoint.profile().accessPoints().iterator();
-			while(accessPointIterator.hasNext()) {
-				AccessPoint accessPoint = accessPointIterator.next();
-				
-				String host = accessPoint.address();
-				String db = accessPoint.name();
-				
-				ServiceCKANDB ckanDB = new ServiceCKANDB();
-				String url = String.format("jdbc:postgresql://%s/%s", host, db);
-				ckanDB.setUrl(url);
-				ckanDB.setUsername(accessPoint.username());
-				ckanDB.setEncryptedPassword(accessPoint.password());
-				return ckanDB;
-			}
-			
-			return null;
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new InternalServerErrorException("Error while getting configuration on IS", e);
-		}
-		
-	}
-
-	@Deprecated
-	public static final String GENERIC_RESOURCE_SECONDARY_TYPE_FOR_ORGANIZATIONS = "ApplicationProfile";
-	@Deprecated
-	public static final String GENERIC_RESOURCE_NAME_FOR_ORGANIZATIONS = "Supported CKAN Organizations";
-	@Deprecated
-	public static final String GENERIC_RESOURCE_CKAN_ORGANIZATIONS = "CKANOrganizations";
-
-	@Deprecated
-	private List<GenericResource> getGenericResources() {
-		SimpleQuery query = ICFactory.queryFor(GenericResource.class);
-		query.addCondition(String.format("$resource/Profile/SecondaryType/text() eq '%s'",
-				GENERIC_RESOURCE_SECONDARY_TYPE_FOR_ORGANIZATIONS));
-		query.addCondition(
-				String.format("$resource/Profile/Name/text() eq '%s'", GENERIC_RESOURCE_NAME_FOR_ORGANIZATIONS));
-
-		DiscoveryClient<GenericResource> client = ICFactory.clientFor(GenericResource.class);
-		List<GenericResource> genericResources = client.submit(query);
-		return genericResources;
-	}
-	
-	protected String marshallSupportedOrganizations() throws JsonProcessingException {
-		Set<String> supportedOrganizations = catalogueConfiguration.getSupportedOrganizations();
-		return marshallSupportedOrganizations(supportedOrganizations);
-	}
-	
-	protected String marshallSupportedOrganizations(Set<String> supportedOrganizations) throws JsonProcessingException {
-		ObjectMapper objectMapper = new ObjectMapper();
-		ArrayNode arrayNode = objectMapper.createArrayNode();
-		for(String org : supportedOrganizations) {
-			arrayNode.add(org);
-		}
-		return objectMapper.writeValueAsString(arrayNode);
-	}
-	
-	@Deprecated
-	protected Set<String> unmarshallSupportedOrganizations(String supportedOrganizationsJsonArray){
-		try {
-			ObjectMapper objectMapper = new ObjectMapper();
-			JsonNode jsonNode = objectMapper.readTree(supportedOrganizationsJsonArray);
-			ArrayNode array = (ArrayNode) jsonNode.get(GENERIC_RESOURCE_CKAN_ORGANIZATIONS);
-			Set<String> supportedOrganizations = new HashSet<>(array.size());
-			for (int i = 0; i < array.size(); i++) {
-				String o = array.get(i).asText();
-				supportedOrganizations.add(o);
-			}
-
-			logger.debug("Supported CKAN Organization for current Context ({}) are {}", context,
-					supportedOrganizations);
-
-			return supportedOrganizations;
-		} catch (Exception e) {
-			return null;
-		}
-	}
-	
-	@Deprecated
-	protected Set<String> getSupportedOrganizationsFromGenericResource() {
-		List<GenericResource> genericResources = getGenericResources();
-
-		if (genericResources == null || genericResources.size() == 0) {
-			logger.trace(
-					"{} with SecondaryType {} and Name %s not found. Item will be only be created in {} CKAN organization",
-					GenericResource.class.getSimpleName(), GENERIC_RESOURCE_SECONDARY_TYPE_FOR_ORGANIZATIONS,
-					GENERIC_RESOURCE_NAME_FOR_ORGANIZATIONS, ServiceCatalogueConfiguration.getOrganizationName(context));
-			return null;
-		}
-
-		GenericResource genericResource = genericResources.get(0);
-		String supportedOrganizationsJsonArray = genericResource.profile().body().getTextContent();
-
-		Set<String> supportedOrganizatins = unmarshallSupportedOrganizations(supportedOrganizationsJsonArray);
-		
-		return supportedOrganizatins;
-	}
-	
-	@Deprecated
-	public void deleteOldConfiguration() {
-		RegistryPublisher registryPublisher = RegistryPublisherFactory.create();
-		deleteOldConfiguration(registryPublisher);
-	}
-	
-	@Deprecated
-	protected void deleteOldConfiguration(RegistryPublisher registryPublisher) {
-		ServiceEndpoint serviceEndpoint = getOldServiceEndpoint();
-		if(serviceEndpoint!=null) {
-			registryPublisher.remove(serviceEndpoint);
-		}
-		
-		List<GenericResource> genericResources = getGenericResources();
-		if(genericResources!=null) {
-			for(GenericResource genericResource : genericResources) {
-				registryPublisher.remove(genericResource);
-			}
-		}
-	}
-	
-	public void delete() {
-		RegistryPublisher registryPublisher = RegistryPublisherFactory.create();
-		
-		ServiceEndpoint serviceEndpoint = getServiceEndpoint();
-		if(serviceEndpoint!=null) {
-			registryPublisher.remove(serviceEndpoint);
-		}
-
-	}
-	
-	protected Property addProperty(Group<Property> properties, String name, String value) {
-		return addProperty(properties, name, value, false);
-	}
-	
-	protected Property addProperty(Group<Property> properties, String name, String value, boolean encrypted) {
-		Property property = new Property();
-		property.nameAndValue(name, value);
-		property.encrypted(encrypted);
-		properties.add(property);
-		return property;
-	}
-
-	protected Group<Property> setAccessPointProperties(AccessPoint accessPoint, String address, boolean update) throws JsonProcessingException {
-		accessPoint.description(String.format("Access Point %s by gcat %s", update ? "updated" : "created", getGcatVersion().toString()));
-		accessPoint.address(address);
-		accessPoint.name(GCatConstants.CONFIGURATION_NAME);
-		
-		Group<Property> properties = accessPoint.properties();
-		
-		JsonNode jsonNode = mapper.valueToTree(catalogueConfiguration);
-		Iterator<String> iterator = jsonNode.fieldNames();
-		while (iterator.hasNext()) {
-			String key = iterator.next();
-			
-			if(key.compareTo(CatalogueConfiguration.ID_KEY)==0) {
-				continue;
-			}
-			
-			if(key.compareTo(CatalogueConfiguration.SYS_ADMIN_TOKEN_KEY)==0) {
-				addProperty(properties, key, catalogueConfiguration.getEncryptedSysAdminToken(), true);
-				continue;
-			}
-			
-			JsonNode valueJsonNode = jsonNode.get(key);
-			
-			String value = valueJsonNode.toString();
-			if(valueJsonNode.isTextual()) {
-				value = valueJsonNode.asText();
-			}	
-			
-			addProperty(properties, key, value);
-			
-		}
-		return properties;
-	}
-	
-	protected Version getGcatVersion() {
-		try {
-			ApplicationContext applicationContext = ContextProvider.get();
-			ApplicationConfiguration applicationConfiguration = applicationContext.configuration();
-			Version version = new Version(applicationConfiguration.version());
-			return version;
-		}catch (Exception e) {
-			return new Version("2.2.0");
-		}
-	}
-	
-	/**
-	 * Set the version of gcat so that in future implementation
-	 * we can understand if the configuration must be updated.
-	 * @param platform
-	 * @return the platform
-	 */
-	protected Platform setVersion(Platform platform) {
-		Version version = getGcatVersion();
-		platform.version((short) version.getMajor());
-		platform.minorVersion((short) version.getMinor());
-		platform.revisionVersion((short) version.getRevision());
-		platform.buildVersion((short) 0);
-		return platform;
-	}
-	
-	
-	protected Platform setPlatformProperty(Platform platform) {
-		/*
-		 * <Platform>
-		 * 	<Name>gcat</Name>
-		 * 	<!-- The version of gcat --> 
-		 *  <Version>2</Version>
-		 * 	<MinorVersion>2</MinorVersion>
-		 * 	<RevisionVersion>0</RevisionVersion>
-		 * 	<BuildVersion>0</BuildVersion>
-		 * </Platform>
-		 */
-		platform.name(GCatConstants.SERVICE_NAME);
-		platform = setVersion(platform);
-		return platform;
-	}
-	
-	private String getRunningOn(ContainerConfiguration containerConfiguration) {
-		return String.format("%s:%s", containerConfiguration.hostname(), containerConfiguration.port());
-	}
-	
-	protected Runtime setRuntimeProperties(Runtime runtime) {
-		try {
-			ApplicationContext applicationContext = ContextProvider.get();
-			ContainerContext containerContext = applicationContext.container();
-			ContainerConfiguration containerConfiguration = containerContext.configuration(); 
-			String runningOn = getRunningOn(containerConfiguration); 
-			runtime.hostedOn(runningOn);
-			runtime.ghnId(containerContext.id());
-			runtime.status(applicationContext.configuration().mode().toString());
-		}catch (Exception e) {
-			runtime.hostedOn("localhost");
-			runtime.ghnId("");
-			runtime.status("READY");
-		}
-		return runtime;
-	}
-	
-	protected Profile setProfileProperties(Profile profile, boolean update) {
-		/*
-		 * <Profile>
-		 * 	<Category>Application</Category>
-		 * 	<Name>CKanDataCatalogue</Name>
-		 * 	<Description>gCat Configuration created/updated by the service via REST</Description>
-		 */
-		profile.category(GCatConstants.CONFIGURATION_CATEGORY);
-		profile.name(GCatConstants.CONFIGURATION_NAME);
-		profile.description(String.format("gCat configuration %s by the service via REST", update ? "updated" : "created"));
-		return profile;
-	}
-	
-//	@Deprecated
-//	protected boolean isRootMaster(ServiceEndpoint serviceEndpoint) {
-//		Profile profile = serviceEndpoint.profile();
-//		AccessPoint accessPoint = getAccessPoint(profile);
-//		Map<String, Property> propertyMap = accessPoint.propertyMap();
-//		if (propertyMap.containsKey(IS_ROOT_MASTER_PROPERTY_KEY)) {
-//			if (propertyMap.get(IS_ROOT_MASTER_PROPERTY_KEY).value().trim().equalsIgnoreCase("true")) {
-//				return true;
-//			}
-//		}
-//		return false;
-//	}
-	
-	protected ServiceEndpoint createServiceEndpoint(ServiceEndpoint serviceEndpoint) throws Exception {
-		boolean update = true;
-		if(serviceEndpoint==null) {
-			serviceEndpoint = new ServiceEndpoint(); 
-			serviceEndpoint.setId(catalogueConfiguration.getID());
-			update = false;
-		}
-		
-		Profile profile = serviceEndpoint.newProfile();
-		profile = setProfileProperties(profile, update);
-		
-		Platform platform = profile.newPlatform();
-		setPlatformProperty(platform);
-		
-		Runtime runtime = profile.newRuntime();
-		runtime = setRuntimeProperties(runtime);
-		
-		Group<AccessPoint> accessPoints = profile.accessPoints();
-		AccessPoint accessPoint = accessPoints.add();
-		setAccessPointProperties(accessPoint, runtime.hostedOn(), update);
-
-		return serviceEndpoint;
-	}
-	
-	public ServiceCatalogueConfiguration createOnIS() throws Exception {
-		RegistryPublisher registryPublisher = RegistryPublisherFactory.create();
-		String id = catalogueConfiguration.getID();
-		if(id==null || id.compareTo("")==0) {
-			id = UUID.randomUUID().toString();
-			catalogueConfiguration.setID(id);
-		}
-		ServiceEndpoint serviceEndpoint = createServiceEndpoint(null);
-		registryPublisher.create(serviceEndpoint);
-		return catalogueConfiguration;
-	}
-	
-	public ServiceCatalogueConfiguration updateOnIS(ServiceEndpoint serviceEndpoint) throws Exception {
-		RegistryPublisher registryPublisher = RegistryPublisherFactory.create();
-		String id = serviceEndpoint.id();
-		catalogueConfiguration.setID(id);
-		serviceEndpoint = createServiceEndpoint(serviceEndpoint);
-		registryPublisher.update(serviceEndpoint);
-		return catalogueConfiguration;
-	}
-	
-	public ServiceCatalogueConfiguration createOrUpdateOnIS() throws Exception {
-		ServiceEndpoint serviceEndpoint = getServiceEndpoint();
-		if(serviceEndpoint!=null) {
-			// It's an update
-			updateOnIS(serviceEndpoint);
-		}else {
-			// It's a create
-			createOnIS();
-		}
-		return catalogueConfiguration;
-	}
-
-}

src/main/java/org/gcube/gcat/configuration/ServiceCKANDB.java

@@ -1,62 +0,0 @@
-package org.gcube.gcat.configuration;
-
-import javax.crypto.BadPaddingException;
-import javax.crypto.IllegalBlockSizeException;
-
-import org.gcube.com.fasterxml.jackson.annotation.JsonGetter;
-import org.gcube.com.fasterxml.jackson.annotation.JsonIgnore;
-import org.gcube.com.fasterxml.jackson.annotation.JsonSetter;
-import org.gcube.common.encryption.encrypter.StringEncrypter;
-import org.gcube.gcat.api.configuration.CKANDB;
-
-/**
- * @author Luca Frosini (ISTI-CNR)
- */
-public class ServiceCKANDB extends CKANDB {
-
-	public static final String PASSWORD_KEY = "password";
-	
-	protected String encryptedPassword;
-	
-	@JsonIgnore
-	public String getPassword() {
-		return password;
-	}
-	
-	@JsonIgnore
-	public String getPlainPassword() {
-		return password;
-	}
-	
-	@JsonGetter(value=PASSWORD_KEY)
-	public String getEncryptedPassword() {
-		return encryptedPassword;
-	}
-	
-	public void setEncryptedPassword(String encryptedPassword) throws Exception {
-		this.encryptedPassword = encryptedPassword;
-		this.password = StringEncrypter.getEncrypter().decrypt(encryptedPassword);
-	}
-	
-	public void setPlainPassword(String plainPassword) throws Exception {
-		this.password = plainPassword;
-		this.encryptedPassword = StringEncrypter.getEncrypter().encrypt(plainPassword);
-	}
-	
-	@Override
-	@JsonSetter(value = PASSWORD_KEY)
-	public void setPassword(String password) {
-		try {
-			try {
-				this.password = StringEncrypter.getEncrypter().decrypt(password);
-				this.encryptedPassword = password;
-			}catch (IllegalBlockSizeException | BadPaddingException e) {
-				this.password = password;
-				this.encryptedPassword = StringEncrypter.getEncrypter().encrypt(password);
-			}
-		}catch (Exception e) {
-			throw new RuntimeException(e);
-		}
-	}
-	
-}

src/main/java/org/gcube/gcat/configuration/ServiceCatalogueConfiguration.java

@@ -1,142 +0,0 @@
-package org.gcube.gcat.configuration;
-
-import javax.crypto.BadPaddingException;
-import javax.crypto.IllegalBlockSizeException;
-
-import org.gcube.com.fasterxml.jackson.annotation.JsonGetter;
-import org.gcube.com.fasterxml.jackson.annotation.JsonIgnore;
-import org.gcube.com.fasterxml.jackson.annotation.JsonSetter;
-import org.gcube.com.fasterxml.jackson.core.JsonProcessingException;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.encryption.encrypter.StringEncrypter;
-import org.gcube.gcat.api.configuration.CKANDB;
-import org.gcube.gcat.api.configuration.CatalogueConfiguration;
-import org.gcube.gcat.api.roles.Role;
-import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
-
-/**
- * @author Luca Frosini (ISTI-CNR)
- */
-public class ServiceCatalogueConfiguration extends CatalogueConfiguration {
-
-	protected ObjectMapper mapper;
-	
-	public ServiceCatalogueConfiguration() {
-		super();
-		mapper = new ObjectMapper();
-	}
-	
-	public ServiceCatalogueConfiguration(String context) {
-		super(context);
-		mapper = new ObjectMapper();
-	}
-
-	@JsonIgnore
-	protected String encryptedSysAdminToken;
-	
-	@JsonIgnore
-	public String getSysAdminToken() {
-		return sysAdminToken;
-	}
-	
-	@JsonIgnore
-	public String getPlainSysAdminToken() {
-		return sysAdminToken;
-	}
-	
-	@JsonGetter(value=SYS_ADMIN_TOKEN_KEY)
-	public String getEncryptedSysAdminToken() {
-		return encryptedSysAdminToken;
-	}
-	
-	public void setEncryptedSysAdminToken(String encryptedSysAdminToken) throws Exception {
-		this.encryptedSysAdminToken = encryptedSysAdminToken;
-		this.sysAdminToken = StringEncrypter.getEncrypter().decrypt(encryptedSysAdminToken);
-	}
-	
-	public void setPlainSysAdminToken(String plainSysAdminToken) throws Exception {
-		this.sysAdminToken = plainSysAdminToken;
-		this.encryptedSysAdminToken = StringEncrypter.getEncrypter().encrypt(plainSysAdminToken);
-	}
-	
-	@Override
-	@JsonSetter(value = SYS_ADMIN_TOKEN_KEY)
-	public void setSysAdminToken(String sysAdminToken) {
-		try {
-			try {
-				this.sysAdminToken = StringEncrypter.getEncrypter().decrypt(sysAdminToken);
-				this.encryptedSysAdminToken = sysAdminToken;
-			}catch (IllegalBlockSizeException | BadPaddingException e) {
-				this.sysAdminToken = sysAdminToken;
-				this.encryptedSysAdminToken = StringEncrypter.getEncrypter().encrypt(sysAdminToken);
-			}
-		}catch (Exception e) {
-			throw new RuntimeException(e);
-		}
-	}
-	
-	@Override
-	@JsonGetter(value = CKAN_DB_KEY)
-	public ServiceCKANDB getCkanDB() {
-		return (ServiceCKANDB) ckanDB;
-	}
-	
-	@Override
-	public void setCkanDB(CKANDB ckanDB) {
-		this.ckanDB = new ServiceCKANDB();
-		this.ckanDB.setUrl(ckanDB.getUrl());
-		this.ckanDB.setUsername(ckanDB.getUsername());
-		this.ckanDB.setPassword(ckanDB.getPassword());
-	}
-	
-	@JsonSetter(value=CKAN_DB_KEY)
-	public void setCkanDB(ServiceCKANDB ckanDB) {
-		this.ckanDB = ckanDB;
-	}
-	
-	public ObjectNode toObjetcNode() throws JsonProcessingException {
-		return toObjetcNode(false);
-	}
-	
-	public ObjectNode toObjetcNode(boolean decryptedValues) throws JsonProcessingException {
-		ObjectNode configuration = mapper.valueToTree(this);
-		CKANUser ckanUser = CKANUserCache.getCurrrentCKANUser();
-		if(ckanUser.getRole().ordinal() < Role.MANAGER.ordinal()) {
-			configuration.remove(ServiceCatalogueConfiguration.SYS_ADMIN_TOKEN_KEY);
-			configuration.remove(ServiceCatalogueConfiguration.CKAN_DB_KEY);
-		}else {
-			if(decryptedValues) {
-				configuration.put(ServiceCatalogueConfiguration.SYS_ADMIN_TOKEN_KEY, getPlainSysAdminToken());
-				ObjectNode node = (ObjectNode) configuration.get(ServiceCatalogueConfiguration.CKAN_DB_KEY);
-				node.put(ServiceCKANDB.PASSWORD_KEY, ((ServiceCKANDB) ckanDB).getPlainPassword());
-			}
-		}
-		return configuration;
-	}
-	
-	public String toJsonString() throws Exception {
-		return toJsonString(false);
-	}
-	
-	public String toJsonString(boolean decryptedValues) throws Exception {
-		ObjectNode objectNode = toObjetcNode(decryptedValues);
-		return mapper.writeValueAsString(objectNode);
-	}
-	
-	public static ServiceCatalogueConfiguration getServiceCatalogueConfiguration(String json) throws Exception {
-		ObjectMapper mapper = new ObjectMapper();
-		ServiceCatalogueConfiguration catalogueConfiguration = mapper.readValue(json, ServiceCatalogueConfiguration.class);
-		return catalogueConfiguration;
-	}
-	
-	public static ServiceCatalogueConfiguration getServiceCatalogueConfiguration(ObjectNode objectNode) throws Exception {
-		ObjectMapper mapper = new ObjectMapper();
-		ServiceCatalogueConfiguration catalogueConfiguration = mapper.treeToValue(objectNode, ServiceCatalogueConfiguration.class);
-		return catalogueConfiguration;
-	}
-	
-	
-	
-}

src/main/java/org/gcube/gcat/configuration/Version.java

@@ -1,127 +0,0 @@
-package org.gcube.gcat.configuration;
-
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class Version implements Comparable<Version> {
-
-	/**
-	 * Regex validating the version
-	 */
-	public final static String VERSION_REGEX = "^[1-9][0-9]{0,}\\.(0|([1-9][0-9]{0,}))\\.(0|([1-9][0-9]{0,}))";
-	
-	private final static Pattern VERSION_PATTERN; 
-	
-	static {
-		VERSION_PATTERN  = Pattern.compile(VERSION_REGEX);
-	}
-	
-	protected int major;
-	protected int minor;
-	protected int revision;
-	
-	protected Version(){}
-	
-	public Version(String version) {
-		setVersion(version);
-	}
-	
-	public Version(int major, int minor, int revision) {
-		this.major = major;
-		this.minor = minor;
-		this.revision = revision;
-	}
-	
-	public void setVersion(String version) {
-		Matcher matcher = VERSION_PATTERN.matcher(version); 
-		if(!matcher.find()) {
-			throw new RuntimeException("The provided version (i.e. " + version + ") MUST comply with the regex " + VERSION_REGEX);
-		}
-		
-		String matched = matcher.group(0);
-		String[] parts = matched.split("\\.");
-		this.major = Integer.valueOf(parts[0]);
-		this.minor = Integer.valueOf(parts[1]);
-		this.revision = Integer.valueOf(parts[2]);
-	}
-	
-	public int getMajor() {
-		return major;
-	}
-
-	protected void setMajor(int major) {
-		this.major = major;
-	}
-
-	public int getMinor() {
-		return minor;
-	}
-
-	protected void setMinor(int minor) {
-		this.minor = minor;
-	}
-
-	public int getRevision() {
-		return revision;
-	}
-
-	protected void setRevision(int revision) {
-		this.revision = revision;
-	}
-
-	@Override
-	public String toString() {
-		return major + "." + minor + "." + revision;
-	}
-	@Override
-	public int compareTo(Version other) {
-		if(other == null) {
-            return 1;
-		}
-		
-		int compare = Integer.compare(major, other.major);
-		if(compare!=0) {
-			return compare;
-		}
-		
-		compare = Integer.compare(minor, other.minor);
-		if(compare!=0) {
-			return compare;
-		}
-		
-		compare = Integer.compare(revision, other.revision);
-		return compare;
-	}
-
-	@Override
-	public int hashCode() {
-		final int prime = 31;
-		int result = 1;
-		result = prime * result + major;
-		result = prime * result + minor;
-		result = prime * result + revision;
-		return result;
-	}
-
-	@Override
-	public boolean equals(Object obj) {
-		if (this == obj)
-			return true;
-		if (obj == null)
-			return false;
-		if (getClass() != obj.getClass())
-			return false;
-		Version other = (Version) obj;
-		if (major != other.major)
-			return false;
-		if (minor != other.minor)
-			return false;
-		if (revision != other.revision)
-			return false;
-		return true;
-	}
-	
-}

src/main/java/org/gcube/gcat/moderation/thread/FakeModerationThread.java

@@ -1,34 +0,0 @@
-package org.gcube.gcat.moderation.thread;
-
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.gcat.api.moderation.CMItemStatus;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class FakeModerationThread extends ModerationThread {
-
-	private static final Logger logger = LoggerFactory.getLogger(FakeModerationThread.class);
-	
-	@Override
-	protected void postMessage(String message) throws Exception {
-		logger.info("gCat is sending a message to the {} for item '{}' (id={}). ItemStatus={}, Message=\"{}\"",
-				ModerationThread.class.getSimpleName(), itemName, itemID, cmItemStatus, message);
-	}
-
-	@Override
-	public void postUserMessage(CMItemStatus cmItemStatus, String userMessage) throws Exception {
-		logger.info("{} is sending a message to the {} for item '{}' (id={}). ItemStatus={}, Message=\"{}\"",
-				SecretManagerProvider.instance.get().getUser().getUsername(), 
-				ModerationThread.class.getSimpleName(), itemName, itemID, cmItemStatus, userMessage);
-	}
-
-	@Override
-	protected void createModerationThread() throws Exception {
-		logger.info("Creating {} for item '{}' (id={})", ModerationThread.class.getSimpleName(), itemName, itemID);
-	}
-
-
-}

src/main/java/org/gcube/gcat/moderation/thread/ModerationThread.java

@@ -1,153 +0,0 @@
-package org.gcube.gcat.moderation.thread;
-
-//import java.util.HashMap;
-//import java.util.Map;
-
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-//import org.gcube.common.authorization.utils.manager.SecretManager;
-//import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-//import org.gcube.gcat.api.configuration.CatalogueConfiguration;
-import org.gcube.gcat.api.moderation.CMItemStatus;
-import org.gcube.gcat.moderation.thread.social.notifications.SocialNotificationModerationThread;
-import org.gcube.gcat.persistence.ckan.CKANUser;
-//import org.gcube.portlets.user.uriresolvermanager.UriResolverManager;
-//import org.gcube.portlets.user.uriresolvermanager.resolvers.query.CatalogueResolverQueryString.MODERATION_OP;
-//import org.gcube.portlets.user.uriresolvermanager.resolvers.query.CatalogueResolverQueryStringBuilder;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public abstract class ModerationThread {
-
-	protected String itemID;
-	protected String itemName;
-	protected String itemTitle;
-	protected String itemURL;
-	
-	protected String moderationURL;
-
-	protected boolean create;
-	protected CMItemStatus cmItemStatus;
-	protected boolean itemAuthor;
-
-	protected CKANUser ckanUser;
-	protected ObjectMapper objectMapper;
-
-	public static ModerationThread getDefaultInstance() {
-		// return new FakeModerationThread();
-		// return new SocialMessageModerationThread();
-		return new SocialNotificationModerationThread();
-	}
-
-	public ModerationThread() {
-		this.objectMapper = new ObjectMapper();
-		this.itemAuthor = false;
-		this.create = false;
-		this.cmItemStatus = CMItemStatus.PENDING;
-	}
-
-	public void setItemCoordinates(String itemID, String itemName, String itemTitle, String itemURL) {
-		this.itemID = itemID;
-		this.itemName = itemName;
-		this.itemTitle = itemTitle;
-		this.itemURL = itemURL;
-	}
-
-	public void setItemAuthor(boolean itemAuthor) {
-		this.itemAuthor = itemAuthor;
-	}
-
-	public void setCKANUser(CKANUser ckanUser) {
-		this.ckanUser = ckanUser;
-	}
-
-	public String getModerationURL() {
-//		
-//		TODO Add the following change in changelog
-//		- Added moderation link in moderation message [#23142]
-//		
-//		if(moderationURL==null) {
-//			try {
-//				SecretManager secretManager = SecretManagerProvider.instance.get();
-//				String context = secretManager.getContext();
-//				UriResolverManager resolver = new UriResolverManager("CTLG");
-//				Map<String, String> params = new HashMap<String, String>();
-//				params.put("gcube_scope", context); //e.g. /gcube/devsec/devVRE
-//				params.put("entity_context", "organization");
-//				params.put("entity_name", CatalogueConfiguration.getOrganizationName(context)); //e.g. devvre
-//			 
-//				CatalogueResolverQueryStringBuilder builder = new CatalogueResolverQueryStringBuilder(itemName); //item name under moderation
-//				builder.itemStatus(cmItemStatus.name()). //e.g. pending, approved, rejected
-//				moderation(MODERATION_OP.show);
-//			 
-//				String queryString = builder.buildQueryParametersToQueryString();
-//				params.put(CatalogueResolverQueryStringBuilder.QUERY_STRING_PARAMETER, queryString);
-//			 
-//				moderationURL = resolver.getLink(params, true);
-//			}catch (Exception e) {
-//				return itemURL;
-//			}
-//		}
-//		return moderationURL;
-		return itemURL;
-	}
-	
-	/**
-	 * The message is sent as gCat
-	 * @param message
-	 * @throws Exception
-	 */
-	protected abstract void postMessage(String message) throws Exception;
-
-	/**
-	 * The message is sent as User
-	 * 
-	 * @param cmItemStatus
-	 * @param userMessage
-	 * @throws Exception
-	 */
-	public abstract void postUserMessage(CMItemStatus cmItemStatus, String userMessage) throws Exception;
-
-	protected abstract void createModerationThread() throws Exception;
-
-	public void postItemCreated() throws Exception {
-		createModerationThread();
-		create = true;
-		cmItemStatus = CMItemStatus.PENDING;
-		String fullName = ckanUser.getNameSurname();
-		String message = String.format(
-				"@**%s** created the item with name '%s' (id='%s'). The item is now in **%s** state and must be moderated.",
-				fullName, itemName, itemID, cmItemStatus.getFancyValue());
-		postMessage(message);
-	}
-
-	public void postItemUpdated() throws Exception {
-		cmItemStatus = CMItemStatus.PENDING;
-		String fullName = ckanUser.getNameSurname();
-		String message = String.format(
-				"@**%s** updated the item with name '%s' (id='%s'). The item is now in **%s** state and must be moderated.",
-				fullName, itemName, itemID, cmItemStatus.getFancyValue());
-		postMessage(message);
-	}
-
-	public void postItemRejected(String userMessage) throws Exception {
-		cmItemStatus = CMItemStatus.REJECTED;
-		String fullName = ckanUser.getNameSurname();
-		String message = String.format(
-				"@**%s** **%s** the item with name '%s' (id='%s'). The author can delete the item or update it to try to meet moderators requests if any.",
-				fullName, cmItemStatus.getFancyValue(), itemName, itemID);
-		postMessage(message);
-		postUserMessage(cmItemStatus, userMessage);
-	}
-
-	public void postItemApproved(String userMessage) throws Exception {
-		cmItemStatus = CMItemStatus.APPROVED;
-		String fullName = ckanUser.getNameSurname();
-		String message = String.format(
-				"@**%s** **%s** the item with name '%s' (id='%s'). The item is now available in the catalogue. The item is available at %s",
-				fullName, cmItemStatus.getFancyValue(), itemName, itemID, itemURL);
-		postMessage(message);
-		postUserMessage(cmItemStatus, userMessage);
-	}
-
-}

src/main/java/org/gcube/gcat/moderation/thread/social/messages/Message.java

@@ -1,86 +0,0 @@
-package org.gcube.gcat.moderation.thread.social.messages;
-
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.List;
-
-import org.gcube.com.fasterxml.jackson.annotation.JsonGetter;
-import org.gcube.com.fasterxml.jackson.annotation.JsonIgnore;
-import org.gcube.com.fasterxml.jackson.annotation.JsonProperty;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class Message {
-
-	public class Recipient {
-		
-		String id;
-		
-		public Recipient(String id) {
-			this.id = id;
-		}
-		
-		public String getId() {
-			return id;
-		}
-
-		public void setId(String id) {
-			this.id = id;
-		}
-		
-	}
-	
-	@JsonProperty(value = "body")
-	protected String message;
-	@JsonProperty(value = "subject")
-	protected String subject;
-	@JsonIgnore
-	protected Collection<String> users;
-	
-	public String getMessage() {
-		return message;
-	}
-	
-	public void setMessage(String message) {
-		this.message = message;
-	}
-	
-	public String getSubject() {
-		return subject;
-	}
-	
-	public void setSubject(String subject) {
-		this.subject = subject;
-	}
-	
-	@JsonIgnore
-	public Collection<String> getUsers() {
-		return users;
-	}
-	
-	@JsonIgnore
-	public void setUsers(Collection<String> users) {
-		this.users = users;
-	}
-	
-	@JsonIgnore
-	public void addUser(String user) {
-		this.users.add(user);
-	}
-
-	@JsonGetter(value = "recipients")
-	public List<Recipient> getRecipients() {
-		List<Recipient> recipients = new ArrayList<>();
-		for(String username : users) {
-			recipients.add(new Recipient(username));
-		}
-		return recipients;		
-	}
-	
-	@Override
-	public String toString() {
-		return "Message [message=" + message + ", subject=" + subject + ", users=" + users + "]";
-	}
-	
-}

src/main/java/org/gcube/gcat/moderation/thread/social/messages/SocialMessage.java

@@ -1,98 +0,0 @@
-package org.gcube.gcat.moderation.thread.social.messages;
-
-import java.net.HttpURLConnection;
-
-import javax.ws.rs.core.HttpHeaders;
-import javax.ws.rs.core.MediaType;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.common.authorization.utils.manager.SecretManager;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.socialservice.SocialService;
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.gcube.gcat.utils.Constants;
-import org.gcube.gcat.utils.HTTPUtility;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class SocialMessage extends Thread {
-	
-	private static final Logger logger = LoggerFactory.getLogger(SocialMessage.class);
-	
-	public static final String ITEM_URL = "Item URL";
-	
-	// https://wiki.gcube-system.org/gcube/Social_Networking_Service#Send_a_message
-	protected static final String SOCIAL_SERVICE_SEND_MESSAGE_PATH = "/2/messages/write-message";
-	
-	protected static final String RESPONSE_SUCCESS_KEY = "success";
-	protected static final String RESPONSE_MESSAGE_KEY = "message";
-	
-	protected final ObjectMapper objectMapper;
-	
-	protected Message message;
-
-	public SocialMessage() throws Exception {
-		super();
-		this.objectMapper = new ObjectMapper();
-	}
-	
-	public Message getMessage() {
-		return message;
-	}
-	
-	public void setMessage(Message message) {
-		this.message = message;
-	}
-	
-	@Override
-	public void run() {
-		
-		try {
-			logger.info("Going to send Message {}", message);
-			// write message
-			sendSocialMessage();
-		} catch(Exception e) {
-			logger.error("Error while executing post creation actions", e);
-		}
-	}
-	
-	public void sendSocialMessage() {
-		
-		try {
-			String basePath = SocialService.getSocialService().getServiceBasePath();
-			if(basePath == null) {
-				logger.info("Unable to send a message because there is no social networking service available");
-				return;
-			}
-			basePath = basePath.endsWith("/") ? basePath : basePath + "/";
-			
-			String messageString = objectMapper.writeValueAsString(message);
-			logger.debug("The message that is going to be send is\n{}", messageString);
-			
-			GXHTTPStringRequest gxhttpStringRequest = GXHTTPStringRequest.newRequest(basePath);
-			gxhttpStringRequest.from(Constants.CATALOGUE_NAME);
-			gxhttpStringRequest.header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON);
-			SecretManager secretManager = SecretManagerProvider.instance.get();
-			gxhttpStringRequest.setSecurityToken(secretManager.getCurrentSecretHolder().getSecrets().first().getToken());
-			gxhttpStringRequest.path(SOCIAL_SERVICE_SEND_MESSAGE_PATH);
-			
-			HttpURLConnection httpURLConnection = gxhttpStringRequest.post(messageString);
-			String ret = HTTPUtility.getResultAsString(httpURLConnection);
-			JsonNode jsonNode = objectMapper.readTree(ret);
-			if(jsonNode.get(RESPONSE_SUCCESS_KEY).asBoolean()) {
-				logger.info("Message sent : {}", messageString);
-			} else {
-				logger.info("Failed to write the message {}. Reason {}", messageString,
-						jsonNode.get(RESPONSE_MESSAGE_KEY).asText());
-			}
-		} catch(Exception e) {
-			logger.error("Unable to send the message : " + message.toString(), e);
-		}
-		
-	}
-
-}

src/main/java/org/gcube/gcat/moderation/thread/social/messages/SocialMessageModerationThread.java

@@ -1,202 +0,0 @@
-package org.gcube.gcat.moderation.thread.social.messages;
-
-import java.io.StringWriter;
-import java.util.Set;
-
-import org.gcube.common.authorization.utils.manager.SecretManager;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.secret.Secret;
-import org.gcube.gcat.api.moderation.CMItemStatus;
-import org.gcube.gcat.api.moderation.Moderated;
-import org.gcube.gcat.moderation.thread.ModerationThread;
-import org.gcube.gcat.social.SocialUsers;
-import org.gcube.gcat.utils.Constants;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class SocialMessageModerationThread extends ModerationThread {
-
-	private static final Logger logger = LoggerFactory.getLogger(SocialMessageModerationThread.class);
-	
-	protected StringBuffer getMainItemInfo(StringBuffer stringBuffer) {
-		stringBuffer.append("Status: ");
-		stringBuffer.append(cmItemStatus.getFancyValue());
-		stringBuffer.append("\n");
-		stringBuffer.append("Title: ");
-		stringBuffer.append(itemTitle);
-		stringBuffer.append("\n");
-		stringBuffer.append("Name: ");
-		stringBuffer.append(itemName);
-		stringBuffer.append("\n");
-		stringBuffer.append("ID: ");
-		stringBuffer.append(itemID);
-		stringBuffer.append("\n");
-		stringBuffer.append("URL: ");
-		if(cmItemStatus == CMItemStatus.APPROVED) {
-			stringBuffer.append(itemURL);
-		}else {
-			stringBuffer.append(getModerationURL());
-		}
-		stringBuffer.append("\n\n");
-		return stringBuffer;
-	}
-	
-	/**
-	 * Create the message for an item that is created/updated
-	 */
-	public void postItemToBeManaged() throws Exception {
-		/* 
-		 * An example of created message is:
-		 * 
-		 * [mister x] created / updated the following item
-		 * 
-		 * Title: RESTful Transaction Model
-		 * Name: my_first_restful_transaction_model
-		 * ID: e31a6ba8-66ef-47b8-b61f-99a1366b4a69
-		 * URL: https://data.dev.d4science.org/ctlg/devVRE/my_first_restful_transaction_model
-		 * 
-		 * You are kindly requested to review it and decide either to APPROVE or REJECT it at <url of the item>
-		 * 
-		 */
-		cmItemStatus = CMItemStatus.PENDING;
-		String fullName = ckanUser.getNameSurname();
-		StringBuffer stringBuffer = new StringBuffer();
-		stringBuffer.append(fullName);
-		stringBuffer.append(create ? " created " : " updated ");
-		stringBuffer.append("the following item\n\n");
-		stringBuffer = getMainItemInfo(stringBuffer);
-		stringBuffer.append("You are kindly requested to review it and decide either to APPROVE or REJECT it.");
-		// stringBuffer.append("You are kindly requested to review it and decide either to APPROVE or REJECT at");
-		// String manageURL = getManageURL();
-		// stringBuffer.append(manageURL);
-		postMessage(stringBuffer.toString());
-	}
-	
-	
-	public void postItemCreated() throws Exception {
-		create = true;
-		cmItemStatus = CMItemStatus.PENDING;
-		postItemToBeManaged();
-	}
-
-	public void postItemUpdated() throws Exception {
-		create = false;
-		cmItemStatus = CMItemStatus.PENDING;
-		postItemToBeManaged();
-	}
-	
-	protected StringBuffer addUserWithRole(String fullName, String role, StringBuffer stringBuffer) {
-		stringBuffer.append(fullName);
-		stringBuffer.append(" [");
-		stringBuffer.append(role);
-		stringBuffer.append("] ");
-		return stringBuffer;
-	}
-	
-	public void postItemManaged(String userMessage) throws Exception {
-		create = false;
-		String fullName = ckanUser.getNameSurname();
-		StringBuffer stringBuffer = new StringBuffer();
-		stringBuffer = addUserWithRole(fullName, Moderated.CATALOGUE_MODERATOR, stringBuffer);
-		stringBuffer.append(cmItemStatus.getValue());
-		stringBuffer.append(" the following item");
-		if(userMessage!=null && userMessage.length()>0) {
-			stringBuffer.append(" with this accompanying message\n\n");
-			stringBuffer = getMainItemInfo(stringBuffer);
-			stringBuffer.append(userMessage);
-		}else {
-			stringBuffer.append("\n\n");
-			stringBuffer = getMainItemInfo(stringBuffer);
-		}
-		postMessage(stringBuffer.toString());
-	}
-
-	@Override
-	public void postItemRejected(String userMessage) throws Exception {
-		create = false;
-		cmItemStatus = CMItemStatus.REJECTED;
-		postItemManaged(userMessage);
-	}
-	
-	@Override
-	public void postItemApproved(String userMessage) throws Exception {
-		create = false;
-		cmItemStatus = CMItemStatus.APPROVED;
-		postItemManaged(userMessage);
-	}
-	
-	protected String getSubject() {
-		StringWriter stringWriter = new StringWriter();
-		if(!create) {
-			logger.trace("It's a reply");
-			stringWriter.append("Re: ");
-		}
-		stringWriter.append("[Catalogue Service] ");
-		stringWriter.append(itemTitle);
-		return stringWriter.toString(); 
-	}
-	
-	protected Message getMessage(String messageString) throws Exception {
-		Message message = new Message(); 
-		message.setMessage(messageString);
-		message.setSubject(getSubject());
-		Set<String> moderators = SocialUsers.getUsernamesByRole(Moderated.CATALOGUE_MODERATOR);
-		message.setUsers(moderators);
-		return message;
-	}
-	
-	@Override
-	protected void postMessage(String messageString) throws Exception {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String username = secretManager.getUser().getUsername();
-		Message message = getMessage(messageString);
-		message.addUser(username);
-		Secret secret = Constants.getCatalogueSecret();
-		secretManager.startSession(secret);
-		try {
-			sendMessage(message);
-		}finally {
-			secretManager.endSession();
-		}
-	}
-
-	@Override
-	public void postUserMessage(CMItemStatus cmItemStatus, String userMessage) throws Exception {
-		this.create = false;
-		this.cmItemStatus = cmItemStatus;
-		String fullName = ckanUser.getNameSurname();
-		StringBuffer stringBuffer = new StringBuffer();
-		stringBuffer = addUserWithRole(fullName, itemAuthor ? "Author" : Moderated.CATALOGUE_MODERATOR, stringBuffer);
-		stringBuffer.append("sent a message regarding the following item\n\n");
-		stringBuffer = getMainItemInfo(stringBuffer);
-		stringBuffer.append(userMessage);
-		Message message = getMessage(stringBuffer.toString());
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String username = secretManager.getUser().getUsername();
-		message.addUser(username);
-		Secret secret = Constants.getCatalogueSecret();
-		secretManager.startSession(secret);
-		try {
-			sendMessage(message);
-		}finally {
-			secretManager.endSession();
-		}
-	}
-
-	protected void sendMessage(Message message) throws Exception {
-		SocialMessage socialMessage = new SocialMessage();
-		socialMessage.setMessage(message);
-		socialMessage.start();
-	}
-
-	@Override
-	protected void createModerationThread() throws Exception {
-		create = true;
-		cmItemStatus = CMItemStatus.PENDING;
-	}
-	
-}
-	

src/main/java/org/gcube/gcat/moderation/thread/social/notifications/SocialNotificationModerationThread.java

@@ -1,297 +0,0 @@
-package org.gcube.gcat.moderation.thread.social.notifications;
-
-import java.net.URL;
-import java.util.Set;
-
-import org.gcube.common.authorization.utils.manager.SecretManager;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.secret.Secret;
-import org.gcube.gcat.api.moderation.CMItemStatus;
-import org.gcube.gcat.api.moderation.Moderated;
-import org.gcube.gcat.moderation.thread.ModerationThread;
-import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.social.SocialUsers;
-import org.gcube.gcat.utils.Constants;
-import org.gcube.social_networking.social_networking_client_library.NotificationClient;
-import org.gcube.social_networking.socialnetworking.model.beans.catalogue.CatalogueEvent;
-import org.gcube.social_networking.socialnetworking.model.beans.catalogue.CatalogueEventType;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class SocialNotificationModerationThread extends ModerationThread {
-
-	private static final Logger logger = LoggerFactory.getLogger(SocialNotificationModerationThread.class);
-	
-	public static final String AUTHOR = "Author";
-	
-	protected CatalogueEventType catalogueEventType;
-	protected boolean comment;
-	
-	protected static final boolean notificationSentByGCat;
-	
-	static {
-		notificationSentByGCat = false;
-	}
-	
-	public SocialNotificationModerationThread() {
-		super();
-		this.comment = false;
-	}
-	
-	/**
-	 * Create the message for an item that is created/updated
-	 */
-	protected void notifyItemToBeManaged() throws Exception {
-		/* 
-		 * An example of created message is:
-		 * 
-		 * [mister x] created/updated the item "[TITLE]". You are kindly requested to review it and decide either to APPROVE or REJECT it. [Go to catalogue]
-		 * 
-		 */
-		String fullName = ckanUser.getNameSurname();
-		StringBuffer stringBuffer = new StringBuffer();
-		if(notificationSentByGCat) {
-			stringBuffer.append(fullName);
-		}
-		stringBuffer.append(create ? " created " : " updated ");
-		stringBuffer.append("the item ");
-		stringBuffer = addQuotedTitle(stringBuffer);
-		stringBuffer.append(". You are kindly requested to review it and decide either to APPROVE or REJECT it. ");
-		postMessage(stringBuffer.toString());
-	}
-	
-	
-	public void postItemCreated() throws Exception {
-		create = true;
-		cmItemStatus = CMItemStatus.PENDING;
-		catalogueEventType = CatalogueEventType.ITEM_SUBMITTED;
-		notifyItemToBeManaged();
-	}
-
-	public void postItemUpdated() throws Exception {
-		create = false;
-		cmItemStatus = CMItemStatus.PENDING;
-		catalogueEventType = CatalogueEventType.ITEM_UPDATED;
-		notifyItemToBeManaged();
-	}
-	
-	protected StringBuffer addUserWithRole(String fullName, String role, StringBuffer stringBuffer, boolean addUserFullName) {
-		if(addUserFullName) {
-			stringBuffer.append(fullName);
-		}
-		if(role!=null) {
-			stringBuffer.append(" [");
-			stringBuffer.append(role);
-			stringBuffer.append("] ");
-		}
-		return stringBuffer;
-	}
-	
-	protected StringBuffer addUserWithRole(String fullName, String role, StringBuffer stringBuffer) {
-		return addUserWithRole(fullName, role, stringBuffer, notificationSentByGCat);
-	}
-	
-	public void postItemManaged(String userMessage) throws Exception {
-		/*
-		 * [mister x] rejected the item "[TITLE]" with this accompanying message "[MESSAGE]". To resubmit it [Go to catalogue]
-		 * 
-		 * [mister x] approved the item "[TITLE]" with this accompanying message "[MESSAGE]". [Go to catalogue]
-		 */
-		create = false;
-		String fullName = ckanUser.getNameSurname();
-		StringBuffer stringBuffer = new StringBuffer();
-		stringBuffer = addUserWithRole(fullName, Moderated.CATALOGUE_MODERATOR, stringBuffer);
-		stringBuffer.append(cmItemStatus.getValue());
-		stringBuffer.append(" the item ");
-		stringBuffer = addQuotedTitle(stringBuffer);
-		if(userMessage!=null && userMessage.length()>0) {
-			stringBuffer.append(" with this accompanying message \"");
-			stringBuffer.append(userMessage);
-			stringBuffer.append("\"");
-		}
-		stringBuffer.append(".");
-		
-		if(cmItemStatus == CMItemStatus.REJECTED) {
-			stringBuffer.append(" To resubmit it ");
-		}
-		postMessage(stringBuffer.toString());
-	}
-
-	@Override
-	public void postItemRejected(String userMessage) throws Exception {
-		create = false;
-		cmItemStatus = CMItemStatus.REJECTED;
-		catalogueEventType = CatalogueEventType.ITEM_REJECTED;
-		postItemManaged(userMessage);
-	}
-	
-	@Override
-	public void postItemApproved(String userMessage) throws Exception {
-		create = false;
-		cmItemStatus = CMItemStatus.APPROVED;
-		catalogueEventType = CatalogueEventType.ITEM_PUBLISHED;
-		postItemManaged(userMessage);
-	}
-	
-	protected StringBuffer addQuotedTitle(StringBuffer stringBuffer, String quotingCharacter) {
-		stringBuffer.append(quotingCharacter);
-		stringBuffer.append(itemTitle);
-		stringBuffer.append(quotingCharacter);
-		return stringBuffer;
-	}
-	
-	protected StringBuffer addQuotedTitle(StringBuffer stringBuffer) {
-		return addQuotedTitle(stringBuffer, "\"");
-	}
-	
-	protected String getSubject() {
-		StringBuffer stringBuffer = new StringBuffer();
-		String fullName = ckanUser.getNameSurname();
-		if(!comment) {
-			switch (catalogueEventType) {
-				case ITEM_SUBMITTED:
-					stringBuffer.append(fullName);
-					stringBuffer.append(" created the item ");
-					break;
-		
-				case ITEM_UPDATED:
-					stringBuffer.append(fullName);
-					stringBuffer.append(" updated the item ");
-					break;
-				
-				case ITEM_REJECTED:
-				case ITEM_PUBLISHED:
-					addUserWithRole(fullName, Moderated.CATALOGUE_MODERATOR, stringBuffer, true);
-					stringBuffer.append(cmItemStatus.getValue());
-					stringBuffer.append(" the item ");
-					break;
-					
-				default:
-					break;
-			}
-		}else {
-			addUserWithRole(fullName, itemAuthor ? SocialNotificationModerationThread.AUTHOR : Moderated.CATALOGUE_MODERATOR, stringBuffer, true);
-			stringBuffer.append("commented on the item ");
-		}
-		stringBuffer = addQuotedTitle(stringBuffer);
-		return stringBuffer.toString(); 
-	}
-	
-	protected CatalogueEvent getCatalogueEvent(String messageString) throws Exception {
-		CatalogueEvent catalogueEvent = new CatalogueEvent();
-		catalogueEvent.setType(catalogueEventType);
-		catalogueEvent.setNotifyText(messageString);
-		catalogueEvent.setItemId(getSubject());
-		if(cmItemStatus == CMItemStatus.APPROVED) {
-			catalogueEvent.setItemURL(new URL(itemURL));
-		}else {
-			catalogueEvent.setItemURL(new URL(getModerationURL()));
-		}
-		
-		Set<String> users = SocialUsers.getUsernamesByRole(Moderated.CATALOGUE_MODERATOR);
-		users.add("luca.frosini");
-		
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String username = secretManager.getUser().getUsername();
-		// Adding the user is generating the event
-		users.add(username);
-		// Adding item creator
-		users.add(CKANUser.getUsernameFromCKANUsername(ckanUser.getName()));
-		
-		catalogueEvent.setIdsToNotify(users.toArray(new String[users.size()]));
-		catalogueEvent.setIdsAsGroup(false);
-		
-		return catalogueEvent;
-	}
-	
-	@Override
-	protected void postMessage(String messageString) throws Exception {
-		CatalogueEvent catalogueEvent = getCatalogueEvent(messageString);
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		if(notificationSentByGCat) {
-			secretManager.startSession(secret);
-		}
-		try {
-			sendNotification(catalogueEvent);
-		}finally {
-			if(notificationSentByGCat) {
-				secretManager.endSession();
-			}
-		}
-	}
-
-	@Override
-	public void postUserMessage(CMItemStatus cmItemStatus, String userMessage) throws Exception {
-		/*
-		 * [mister x] ([Role]) commented on the item "[TITLE]" as follows "[MESSAGE]". [Go to catalogue]
-		 */
-		this.create = false;
-		this.cmItemStatus = cmItemStatus;
-		this.comment = true;
-		
-		switch (cmItemStatus) {
-			case PENDING:
-				catalogueEventType = CatalogueEventType.ITEM_UPDATED;
-				break;
-				
-			case APPROVED:
-				catalogueEventType = CatalogueEventType.ITEM_PUBLISHED;
-				break;
-				
-			case REJECTED:
-				catalogueEventType = CatalogueEventType.ITEM_REJECTED;
-				break;
-			
-			default:
-				break;
-		}
-		
-		String fullName = ckanUser.getNameSurname();
-		StringBuffer stringBuffer = new StringBuffer();
-		stringBuffer = addUserWithRole(fullName, itemAuthor ? SocialNotificationModerationThread.AUTHOR : Moderated.CATALOGUE_MODERATOR, stringBuffer);
-		stringBuffer.append("commented on the item ");
-		stringBuffer = addQuotedTitle(stringBuffer);
-		stringBuffer.append(" as follows \"");
-		stringBuffer.append(userMessage);
-		stringBuffer.append("\".");
-		CatalogueEvent catalogueEvent = getCatalogueEvent(stringBuffer.toString());
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		if(notificationSentByGCat) {
-			secretManager.startSession(secret);
-		}
-		try {
-			sendNotification(catalogueEvent);
-		}finally {
-			if(notificationSentByGCat) {
-				secretManager.endSession();
-			}
-		}
-	}
-
-	protected void sendNotification(CatalogueEvent catalogueEvent) throws Exception {
-		Thread thread = new Thread() {
-		    public void run() {
-		        try {
-		        	NotificationClient nc = new NotificationClient();
-		    		nc.sendCatalogueEvent(catalogueEvent);
-		        } catch(Exception e) {
-		            logger.error("Error while sending notification.", e);
-		        }
-		    }  
-		};
-		thread.run();
-		// thread.start();
-	}
-
-	@Override
-	protected void createModerationThread() throws Exception {
-		create = true;
-		cmItemStatus = CMItemStatus.PENDING;
-	}
-	
-}

src/main/java/org/gcube/gcat/moderation/thread/zulip/ZulipAuth.java

@@ -1,43 +0,0 @@
-package org.gcube.gcat.moderation.thread.zulip;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.Properties;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class ZulipAuth {
-
-	public static final String ZULIP_RC_FILENAME = "zuliprc";
-	
-	public static final String EMAIL_KEY = "email";
-	public static final String KEY_KEY = "key";
-	public static final String SITE_KEY = "site";
-	
-	protected final Properties properties;
-	
-	public ZulipAuth(String username) {
-		properties = new Properties();
-		InputStream input = ZulipAuth.class.getClassLoader().getResourceAsStream(username+"_"+ZULIP_RC_FILENAME);
-		try {
-			// load the properties file
-			properties.load(input);
-		} catch(IOException e) {
-			throw new RuntimeException(e);
-		}
-	}
-	
-	public String getEmail() {
-		return properties.getProperty(EMAIL_KEY);
-	}
-	
-	public String getAPIKey() {
-		return properties.getProperty(KEY_KEY);
-	}
-	
-	public String getSite() {
-		return properties.getProperty(SITE_KEY);
-	}
-	
-}

src/main/java/org/gcube/gcat/moderation/thread/zulip/ZulipResponse.java

@@ -1,57 +0,0 @@
-package org.gcube.gcat.moderation.thread.zulip;
-
-import java.io.IOException;
-
-import org.gcube.com.fasterxml.jackson.core.JsonProcessingException;
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class ZulipResponse {
-	
-	public static final String RESULT_KEY = "result";
-	public static final String MSG_KEY = "msg";
-	
-	public enum Result {
-		success,
-		error
-	}
-	
-	protected ObjectMapper objectMapper;
-	
-	protected String responseString;
-	protected JsonNode response;
-	
-	protected Result result;
-	protected String message; 
-	
-	public ZulipResponse(String responseString) {
-		this.responseString = responseString;
-		this.objectMapper = new ObjectMapper();
-	}
-	
-	public Result getResponseResult() throws JsonProcessingException, IOException {
-		if(result==null) {
-			String resultString = getResponse().get(RESULT_KEY).asText();
-			result = Result.valueOf(resultString);
-		}
-		return result;
-	}
-	
-	public String getResponseMessage() throws JsonProcessingException, IOException {
-		if(message==null) {
-			message = getResponse().get(MSG_KEY).asText();
-		}
-		return message;
-	}
-	
-	public JsonNode getResponse() throws JsonProcessingException, IOException {
-		if(response == null) {
-			response = objectMapper.readTree(responseString);
-		}
-		return response;
-	}
-	
-}

src/main/java/org/gcube/gcat/moderation/thread/zulip/ZulipStream.java

@@ -1,153 +0,0 @@
-package org.gcube.gcat.moderation.thread.zulip;
-
-import java.util.Set;
-
-import javax.ws.rs.InternalServerErrorException;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.authorization.utils.manager.SecretManager;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.secret.Secret;
-import org.gcube.gcat.api.moderation.CMItemStatus;
-import org.gcube.gcat.api.moderation.Moderated;
-import org.gcube.gcat.moderation.thread.ModerationThread;
-import org.gcube.gcat.moderation.thread.zulip.ZulipResponse.Result;
-import org.gcube.gcat.social.SocialUsers;
-import org.gcube.gcat.utils.Constants;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import io.taliox.zulip.ZulipRestExecutor;
-import io.taliox.zulip.calls.ZulipRestAPICall;
-import io.taliox.zulip.calls.messages.PostMessage;
-import io.taliox.zulip.calls.streams.GetStreamID;
-import io.taliox.zulip.calls.streams.PostCreateStream;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class ZulipStream extends ModerationThread {
-	
-	private static final Logger logger = LoggerFactory.getLogger(ZulipStream.class);
-	
-	public static final String TOPICS_KEY = "topics";
-	public static final String NAME_KEY = "name";
-	public static final String MAX_ID_KEY = "max_id";
-	public static final String INITIAL_TOPIC_NAME = "hello";
-	
-	protected ZulipRestExecutor gCatZulipRestExecutor;
-	protected ZulipRestExecutor userZulipRestExecutor;
-	
-	protected String streamName;
-	protected String streamDescription;
-	
-	public ZulipStream() {
-		super();
-	}
-	
-	protected ZulipRestExecutor getZulipRestExecutor() {
-		ZulipAuth zulipAuth = new ZulipAuth(SecretManagerProvider.instance.get().getUser().getUsername());
-		return new ZulipRestExecutor(zulipAuth.getEmail(), zulipAuth.getAPIKey(), zulipAuth.getSite());
-	}
-	
-	public ZulipRestExecutor getGCatZulipRestExecutor() throws Exception {
-		if(gCatZulipRestExecutor==null) {
-			SecretManager secretManager = SecretManagerProvider.instance.get();
-			Secret secret = Constants.getCatalogueSecret();
-			secretManager.startSession(secret);
-			gCatZulipRestExecutor = getZulipRestExecutor();
-			secretManager.endSession();
-		}
-		return gCatZulipRestExecutor;
-	}
-	
-	public ZulipRestExecutor getUserZulipRestExecutor() {
-		if(userZulipRestExecutor==null) {
-			userZulipRestExecutor = getZulipRestExecutor();
-		}
-		return userZulipRestExecutor;
-	}
-	
-	protected String getStreamName() {
-		if(streamName==null) {
-			streamName = String.format("Item '%s' moderation", itemID);
-		}
-		return streamName;
-	}
-	
-	protected Integer getStreamID() throws Exception {
-		GetStreamID getStreamID = new GetStreamID(getStreamName());
-		ZulipResponse zulipResponse = executeZulipCall(gCatZulipRestExecutor, getStreamID);
-		JsonNode response = zulipResponse.getResponse();
-		return response.get("stream_id").asInt();
-	}
-	
-	protected String getStreamDescription() {
-		if(streamDescription==null) {
-			streamDescription = String.format("This stream is used to discuss about the moderation of the item '%s' with id '%s'", itemName, itemID);
-		}
-		return streamDescription;
-	}
-	
-	protected ZulipResponse executeZulipCall(ZulipRestExecutor zulipRestExecutor, ZulipRestAPICall call) throws Exception {
-		logger.trace("Going to execute {}", call);
-		String responseString = zulipRestExecutor.executeCall(call);
-		logger.trace("Response from {} is {}", call.getClass().getSimpleName(), responseString);
-		ZulipResponse zulipResponse = new ZulipResponse(responseString);
-		if(zulipResponse.getResponseResult()==Result.error) {
-			throw new InternalServerErrorException(zulipResponse.getResponseMessage());
-		}
-		return zulipResponse;
-	}
-
-	@Override
-	protected void createModerationThread() throws Exception {
-		ArrayNode streamsArrayNode = objectMapper.createArrayNode();
-		ObjectNode streamobjectNode = objectMapper.createObjectNode();
-		streamobjectNode.put("name", getStreamName());
-		streamobjectNode.put("description", getStreamDescription());
-		streamsArrayNode.add(streamobjectNode);
-		
-		ArrayNode principalsArrayNode = objectMapper.createArrayNode();
-		// Going to add the item creator
-		String itemCreatorEmail = ckanUser.getEMail();
-		principalsArrayNode.add(itemCreatorEmail);
-		
-		getGCatZulipRestExecutor();
-		
-		principalsArrayNode.add(gCatZulipRestExecutor.httpController.getUserName());
-		
-		// Going to add the catalogue moderators
-		Set<String> moderators = SocialUsers.getUsernamesByRole(Moderated.CATALOGUE_MODERATOR);
-		for(String moderator : moderators) {
-			principalsArrayNode.add(moderator);
-		}
-		
-		PostCreateStream postCreateStream = new PostCreateStream(streamsArrayNode.toString());
-		postCreateStream.setPrincipals(principalsArrayNode.toString());
-		postCreateStream.setInvite_only(true);
-		postCreateStream.setAnnounce(false);
-		
-		executeZulipCall(gCatZulipRestExecutor, postCreateStream);
-	}
-	
-	protected void postMessageToStream(ZulipRestExecutor zulipRestExecutor, String message) throws Exception {
-		PostMessage postMessage = new PostMessage(getStreamName(), cmItemStatus.getFancyValue(), message);
-		logger.debug("Going to send the following message: {}", message);
-		executeZulipCall(zulipRestExecutor, postMessage);
-	}
-	
-	@Override
-	protected void postMessage(String message) throws Exception {
-		postMessageToStream(getGCatZulipRestExecutor(), message);
-	}
-	
-	@Override
-	public void postUserMessage(CMItemStatus cmItemStatus, String message) throws Exception {
-		this.cmItemStatus = cmItemStatus;
-		postMessageToStream(getUserZulipRestExecutor(), message);
-	}
-	
-}

src/main/java/org/gcube/gcat/oldutils/CustomField.java

@@ -1,131 +0,0 @@
-package org.gcube.gcat.oldutils;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-
-/**
- * A custom field bean. It also stores index of the category and of the metadata field associated.
- * These are used to sort them before pushing the content to CKAN.
- * If they are missing, indexes are set to Integer.MAX_VALUE.
- * @author Costantino Perciante (ISTI - CNR)
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CustomField implements Comparable<CustomField> {
-	
-	private String key;
-	private String qualifiedKey;
-	private String value;
-	
-	private int indexCategory = Integer.MAX_VALUE;
-	private int indexMetadataField = Integer.MAX_VALUE;
-	
-	private void init(String key, String value, int indexCategory, int indexMetadataField) {
-		if(key == null || value == null || key.isEmpty()) {
-			throw new IllegalArgumentException(
-					"A custom field must have a key and a value! Provided values are " + key + "=" + value);
-		}
-		
-		this.key = key;
-		this.qualifiedKey = key;
-		this.value = value;
-		
-		this.indexMetadataField = indexMetadataField;
-		this.indexCategory = indexCategory;
-		
-		if(this.indexCategory < 0) {
-			this.indexCategory = Integer.MAX_VALUE;
-		}
-		
-		if(this.indexMetadataField < 0) {
-			this.indexMetadataField = Integer.MAX_VALUE;
-		}
-	}
-	
-	public CustomField(JsonNode object) {
-		super();
-		init(object.get("key").asText(), object.get("value").asText(), -1, -1);
-	}
-	
-	/**
-	 * @param key
-	 * @param value
-	 */
-	public CustomField(String key, String value) {
-		super();
-		init(key, value, -1, -1);
-	}
-	
-	/**
-	 * @param key
-	 * @param value
-	 * @param indexMetadataField
-	 * @param indexCategory
-	 */
-	public CustomField(String key, String value, int indexCategory, int indexMetadataField) {
-		super();
-		init(key, value, indexCategory, indexMetadataField);
-	}
-	
-	public String getKey() {
-		return key;
-	}
-	
-	public void setKey(String key) {
-		this.key = key;
-	}
-	
-	public String getValue() {
-		return value;
-	}
-	
-	public void setValue(String value) {
-		this.value = value;
-	}
-	
-	public String getQualifiedKey() {
-		return qualifiedKey;
-	}
-	
-	public void setQualifiedKey(String qualifiedKey) {
-		this.qualifiedKey = qualifiedKey;
-	}
-	
-	public int getIndexCategory() {
-		return indexCategory;
-	}
-	
-	public void setIndexCategory(int indexCategory) {
-		this.indexCategory = indexCategory;
-		if(this.indexCategory < 0)
-			this.indexCategory = Integer.MAX_VALUE;
-	}
-	
-	public int getIndexMetadataField() {
-		return indexMetadataField;
-	}
-	
-	public void setIndexMetadataField(int indexMetadataField) {
-		this.indexMetadataField = indexMetadataField;
-		if(this.indexMetadataField < 0) {
-			this.indexMetadataField = Integer.MAX_VALUE;
-		}
-	}
-	
-	@Override
-	public String toString() {
-		return "CustomField [key=" + key + ", qualifiedKey=" + qualifiedKey + ", value=" + value
-				+ ", indexMetadataField=" + indexMetadataField + ", indexCategory=" + indexCategory + "]";
-	}
-	
-	@Override
-	public int compareTo(CustomField o) {
-		if(this.indexCategory == o.indexCategory) {
-			if(this.indexMetadataField == o.indexMetadataField) {
-				return 0;
-			} else {
-				return this.indexMetadataField > o.indexMetadataField ? 1 : -1;
-			}
-		} else {
-			return this.indexCategory > o.indexCategory ? 1 : -1;
-		}
-	}
-}

src/main/java/org/gcube/gcat/oldutils/Validator.java

@@ -1,644 +0,0 @@
-package org.gcube.gcat.oldutils;
-
-import java.text.SimpleDateFormat;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Map;
-import java.util.Map.Entry;
-import java.util.Set;
-
-import javax.ws.rs.BadRequestException;
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.Response.Status;
-
-import org.apache.commons.lang3.math.NumberUtils;
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.scope.api.ScopeProvider;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.DataType;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataField;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataFormat;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataGrouping;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataTagging;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataVocabulary;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.NamespaceCategory;
-import org.gcube.gcat.persistence.ckan.CKANGroup;
-import org.gcube.gcat.persistence.ckan.CKANPackage;
-import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.persistence.ckan.CKANUtility;
-import org.gcube.gcat.profile.MetadataUtility;
-import org.gcube.gcat.social.SocialPost;
-import org.geojson.GeoJsonObject;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * Validate creation item requests utilities.
- * @author Costantino Perciante (ISTI - CNR)
- * @author Luca Frosini (ISTI - CNR)
- */
-public class Validator {
-	
-	private static final Logger logger = LoggerFactory.getLogger(Validator.class);
-	
-	private static final SimpleDateFormat DATE_SIMPLE = new SimpleDateFormat("yyyy-MM-dd");
-	private static final SimpleDateFormat DATE_HOUR_MINUTES = new SimpleDateFormat("yyyy-MM-dd HH:mm");
-	
-	public static final int MAX_TAG_CHARS = 100;
-	
-	protected ObjectMapper mapper;
-	
-	public Validator() {
-		this.mapper = new ObjectMapper();
-	}
-	
-	public Validator(ObjectMapper mapper) {
-		this.mapper = mapper;
-	}
-	
-	public ObjectNode validateAgainstProfile(ObjectNode objectNode, MetadataUtility metadataUtility) throws Exception {
-		
-		ArrayNode extrasArrayOriginal = (ArrayNode) objectNode.get(CKANPackage.EXTRAS_KEY);
-		if(extrasArrayOriginal == null || extrasArrayOriginal.size() == 0) {
-			throw new BadRequestException(
-					"'extras' field is missing in context where metadata profile(s) are defined!");
-		}
-		
-		ArrayNode groupsArrayOriginal = (ArrayNode) objectNode.get(CKANPackage.GROUPS_KEY);
-		if(groupsArrayOriginal == null) {
-			groupsArrayOriginal = mapper.createArrayNode();
-		}
-		
-		ArrayNode tagsArrayOriginal = (ArrayNode) objectNode.get(CKANPackage.TAGS_KEY);
-		if(tagsArrayOriginal == null) {
-			tagsArrayOriginal = mapper.createArrayNode();
-		}
-		
-		// get the metadata profile specifying the type
-		CustomField metadataTypeCF = null;
-		List<CustomField> customFields = new ArrayList<CustomField>(extrasArrayOriginal.size());
-		Iterator<JsonNode> iterator = extrasArrayOriginal.iterator();
-		while(iterator.hasNext()) {
-			JsonNode object = iterator.next();
-			CustomField cf = new CustomField(object);
-			if(cf.getKey().equals(CKANPackage.EXTRAS_KEY_VALUE_SYSTEM_TYPE)) {
-				metadataTypeCF = cf;
-			} else if(cf.getKey().equals(SocialPost.ITEM_URL)) {
-				continue;
-			} else {
-				customFields.add(cf);
-			}
-		}
-		
-		if(metadataTypeCF == null) {
-			throw new BadRequestException("'" + CKANPackage.EXTRAS_KEY_VALUE_SYSTEM_TYPE
-					+ "' extra field is missing in context where metadata profile(s) are defined!");
-		}
-		
-		String profileName = metadataTypeCF.getValue();
-		// fetch the profile by metadata type specified above
-		
-		if(metadataUtility == null) {
-			metadataUtility = new MetadataUtility();
-		}
-		MetadataFormat profile = metadataUtility.getMetadataFormat(profileName);
-		if(profile == null) {
-			throw new BadRequestException("'" + CKANPackage.EXTRAS_KEY_VALUE_SYSTEM_TYPE + "' extra field's value ('"
-					+ profileName
-					+ "') specified as custom field doesn't match any of the profiles defined in this context!");
-		} else {
-			ArrayNode extrasArrayUpdated = null;
-			List<MetadataField> metadataFields = profile.getMetadataFields();
-			
-			if(metadataFields == null || metadataFields.isEmpty()) {
-				extrasArrayUpdated = extrasArrayOriginal;
-			} else {
-				extrasArrayUpdated = mapper.createArrayNode();
-				
-				List<NamespaceCategory> categories = metadataUtility.getNamespaceCategories();
-				logger.debug("Retrieved namespaces are {}", categories);
-				List<String> categoriesIds = new ArrayList<String>(categories == null ? 0 : categories.size());
-				if(categories == null || categories.isEmpty()) {
-					logger.warn("No category defined in context {}", ScopeProvider.instance.get());
-				} else {
-					for(NamespaceCategory metadataCategory : categories) {
-						categoriesIds.add(metadataCategory.getId()); // save them later for matching with custom fields
-					}
-				}
-				
-				// the list of already validated customFields
-				List<CustomField> validatedCustomFields = new ArrayList<CustomField>(customFields.size());
-				
-				// keep track of mandatory fields and their cardinality
-				Map<String,Integer> fieldsMandatoryLowerBoundMap = new HashMap<String,Integer>(metadataFields.size());
-				Map<String,Integer> fieldsMandatoryUpperBoundMap = new HashMap<String,Integer>(metadataFields.size());
-				Map<String,Integer> numberFieldsMandatorySameKeyMap = new HashMap<String,Integer>(
-						metadataFields.size());
-				
-				// keep track of the groups that must be created AFTER validation but BEFORE item creation
-				List<String> groupsToCreateAfterValidation = new ArrayList<String>();
-				
-				// now validate fields
-				int metadataIndex = 0;
-				
-				Map<String, MetadataField> metadataFieldMap = new HashMap<>();
-				for(MetadataField metadataField : metadataFields) {
-					
-					metadataFieldMap.put(metadataField.getFieldName(), metadataField);
-					
-					int categoryIdIndex = categoriesIds.indexOf(metadataField.getCategoryRef());
-					logger.debug("Found index for category " + metadataField.getCategoryRef() + " " + categoryIdIndex);
-					List<CustomField> validCFs = validateAgainstMetadataField(metadataIndex, categoryIdIndex,
-							customFields, tagsArrayOriginal, groupsArrayOriginal, metadataField, categories,
-							fieldsMandatoryLowerBoundMap, fieldsMandatoryUpperBoundMap, numberFieldsMandatorySameKeyMap,
-							groupsToCreateAfterValidation);
-					validatedCustomFields.addAll(validCFs);
-					metadataIndex++;
-					
-				}
-				
-				// check mandatory fields
-				Iterator<Entry<String,Integer>> iteratorLowerBounds = fieldsMandatoryLowerBoundMap.entrySet()
-						.iterator();
-				while(iteratorLowerBounds.hasNext()) {
-					Map.Entry<java.lang.String,java.lang.Integer> entry = (Map.Entry<java.lang.String,java.lang.Integer>) iteratorLowerBounds
-							.next();
-					int lowerBound = entry.getValue();
-					
-					// int upperBound = fieldsMandatoryUpperBoundMap.get(entry.getKey());
-					int upperBound = Integer.MAX_VALUE;
-					try {
-						String maxOccurs = metadataFieldMap.get(entry.getKey()).getMaxOccurs();
-						if(maxOccurs==null || maxOccurs.compareTo("*")==0) {
-							upperBound = Integer.MAX_VALUE;
-						}else {
-							try {
-								upperBound = Integer.valueOf(maxOccurs);
-							}catch (Exception e) {
-								
-							}
-						}
-					}catch (Exception e) {
-						upperBound = Integer.MAX_VALUE;
-					}
-					
-					int inserted = numberFieldsMandatorySameKeyMap.get(entry.getKey());
-					
-					logger.info("Field with key '" + entry.getKey() + "' has been found " + inserted
-							+ " times and its lower bound is " + lowerBound + " and upper bound " + upperBound);
-					
-					if(inserted < lowerBound || inserted > upperBound) {
-						throw new BadRequestException("Field with key '" + entry.getKey()
-								+ "' is mandatory, but it's not present among the provided fields or its cardinality is not respected ([min = "
-								+ lowerBound + ", max=" + upperBound + "]).");
-					}
-				}
-				
-				// if there are no tags, throw an exception
-				if(tagsArrayOriginal.size() == 0) {
-					throw new BadRequestException("Please define at least one tag for this item!");
-				}
-				
-				// sort validated custom fields and add to the extrasArrayUpdated json array 
-				Collections.sort(validatedCustomFields);
-				
-				logger.debug("Sorted list of custom fields is " + validatedCustomFields);
-				
-				// add missing fields with no match (append them at the end, since no metadataIndex or categoryIndex was defined for them)
-				for(CustomField cf : customFields)
-					validatedCustomFields.add(cf);
-				
-				// convert back to json
-				for(CustomField customField : validatedCustomFields) {
-					ObjectNode jsonObj = mapper.createObjectNode();
-					jsonObj.put(CKANPackage.EXTRAS_KEY_KEY, customField.getQualifiedKey());
-					jsonObj.put(CKANPackage.EXTRAS_VALUE_KEY, customField.getValue());
-					extrasArrayUpdated.add(jsonObj);
-				}
-				
-				// add metadata type field as last element
-				ObjectNode metadataTypeJSON = mapper.createObjectNode();
-				metadataTypeJSON.put(CKANPackage.EXTRAS_KEY_KEY, metadataTypeCF.getKey());
-				metadataTypeJSON.put(CKANPackage.EXTRAS_VALUE_KEY, metadataTypeCF.getValue());
-				extrasArrayUpdated.add(metadataTypeJSON);
-				
-				// create groups
-				for(String title : groupsToCreateAfterValidation) {
-					try {
-						createGroupAsSysAdmin(title);
-					} catch(Exception e) {
-						logger.trace("Failed to create group with title " + title, e);
-					}
-				}
-			}
-			
-			objectNode.replace(CKANPackage.TAGS_KEY, tagsArrayOriginal);
-			objectNode.replace(CKANPackage.GROUPS_KEY, groupsArrayOriginal);
-			objectNode.replace(CKANPackage.EXTRAS_KEY, extrasArrayUpdated);
-			
-			return objectNode;
-		}
-		
-	}
-	
-	/**
-	 * Retrieve an instance of the library for the scope
-	 */
-	public void createGroupAsSysAdmin(String title) throws Exception {
-		String sysAdminAPI = CKANUtility.getSysAdminAPI();
-		CKANGroup ckanGroup = new CKANGroup();
-		ckanGroup.setApiKey(sysAdminAPI);
-		ckanGroup.setName(CKANGroup.getCKANGroupName(title));
-		try {
-			ckanGroup.read();
-		} catch(WebApplicationException e) {
-			if(e.getResponse().getStatus() == Status.NOT_FOUND.getStatusCode()) {
-				ckanGroup.create();
-			} else {
-				throw e;
-			}
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		} finally {
-			try {
-				addUserToGroupAsSysAdmin(title);
-			} catch(WebApplicationException e) {
-				throw e;
-			} catch(Exception e) {
-				throw new InternalServerErrorException(e);
-			}
-		}
-	}
-	
-	public void addUserToGroupAsSysAdmin(String groupName) throws Exception {
-		String username = CKANUser.getCKANUsername();
-		addUserToGroupAsSysAdmin(groupName, username);
-	}
-	
-	public void addUserToGroupAsSysAdmin(String groupName, String username) throws Exception {
-		String sysAdminAPI = CKANUtility.getSysAdminAPI();
-		CKANUser ckanUser = new CKANUser();
-		ckanUser.setApiKey(sysAdminAPI);
-		ckanUser.setName(username);
-		ckanUser.addToGroup(CKANGroup.getCKANGroupName(groupName));
-	}
-	
-	/**
-	 * Validate this field and generate a new value (or returns the same if there is nothing to update)
-	 * @param metadataIndex
-	 * @param categoryIndex
-	 * @param customFields
-	 * @param tagsArrayOriginal
-	 * @param groupsArrayOriginal
-	 * @param metadataField
-	 * @param categories
-	 * @param numberFieldsSameKeyMap 
-	 * @param fieldsMandatoryLowerBoundMap 
-	 * @param isApplication 
-	 * @return
-	 * @throws Exception
-	 */
-	private List<CustomField> validateAgainstMetadataField(int metadataIndex, int categoryIndex,
-			List<CustomField> customFields, ArrayNode tagsArrayOriginal, ArrayNode groupsArrayOriginal,
-			MetadataField metadataField, List<NamespaceCategory> categories,
-			Map<String,Integer> fieldsMandatoryLowerBoundMap, Map<String,Integer> fieldsMandatoryUpperBoundMap,
-			Map<String,Integer> numberFieldsMandatorySameKeyMap, List<String> groupToCreate) throws Exception {
-		
-		List<CustomField> toReturn = new ArrayList<CustomField>();
-		String metadataFieldName = metadataField.getCategoryFieldQName(); // get the qualified one, if any
-		int fieldsFoundWithThisKey = 0;
-		
-		Iterator<CustomField> iterator = customFields.iterator();
-		while(iterator.hasNext()) {
-			CustomField cf = (CustomField) iterator.next();
-			if(cf.getKey().equals(metadataFieldName)) {
-				validate(cf, metadataField);
-				fieldsFoundWithThisKey++;
-				cf.setIndexCategory(categoryIndex);
-				cf.setIndexMetadataField(metadataIndex);
-				checkAsGroup(cf, metadataField, groupsArrayOriginal, groupToCreate);
-				checkAsTag(cf, metadataField, tagsArrayOriginal);
-				toReturn.add(cf);
-				iterator.remove();
-			}
-		}
-		
-		// in case of mandatory fields, keep track of the number of times they appear
-		if(metadataField.getMandatory()) {
-			// lower bound
-			int lowerBound = 1;
-			if(fieldsMandatoryLowerBoundMap.containsKey(metadataFieldName))
-				lowerBound = fieldsMandatoryLowerBoundMap.get(metadataFieldName) + 1;
-			fieldsMandatoryLowerBoundMap.put(metadataFieldName, lowerBound);
-			
-			// upper bound
-			boolean hasVocabulary = metadataField.getVocabulary() != null;
-			int upperBound = hasVocabulary ? (metadataField.getVocabulary().isMultiSelection()
-					? metadataField.getVocabulary().getVocabularyFields().size()
-					: 1) : 1;
-			
-			if(fieldsMandatoryUpperBoundMap.containsKey(metadataFieldName))
-				upperBound += fieldsMandatoryUpperBoundMap.get(metadataFieldName);
-			
-			fieldsMandatoryUpperBoundMap.put(metadataFieldName, upperBound);
-			
-			// fields with this same key
-			int countPerFields = fieldsFoundWithThisKey;
-			if(numberFieldsMandatorySameKeyMap.containsKey(metadataFieldName))
-				countPerFields += numberFieldsMandatorySameKeyMap.get(metadataFieldName);
-			numberFieldsMandatorySameKeyMap.put(metadataFieldName, countPerFields);
-		}
-		
-		// if there was no field with this key and it was not mandatory, just add an entry of the kind {"key": "key-value", "value" : ""}. 
-		// Sometimes it is important to view the field as empty.
-		/*
-		if(fieldsFoundWithThisKey == 0 && !metadataField.getMandatory()) {
-			toReturn.add(new CustomField(metadataFieldName, "", -1, -1));
-		}
-		*/
-		
-		return toReturn;
-		
-	}
-	
-	/**
-	 * Check if a tag must be generated
-	 * @param fieldToValidate
-	 * @param metadataField
-	 * @param tagsArrayOriginal
-	 */
-	private void checkAsTag(CustomField fieldToValidate, MetadataField metadataField, ArrayNode tagsArrayOriginal) {
-		MetadataTagging tagging = metadataField.getTagging();
-		if(tagging != null) {
-			
-			String tag = "";
-			
-			switch(tagging.getTaggingValue()) {
-				case onFieldName:
-					tag = metadataField.getFieldName();
-					break;
-				case onValue:
-					tag = fieldToValidate.getValue();
-					break;
-				case onFieldName_onValue:
-					tag = metadataField.getFieldName() + tagging.getSeparator() + fieldToValidate.getValue();
-					break;
-				case onValue_onFieldName:
-					tag = fieldToValidate.getValue() + tagging.getSeparator() + metadataField.getFieldName();
-					break;
-				default:
-					return;
-			}
-			
-			tag = tag.substring(0, MAX_TAG_CHARS > tag.length() ? tag.length() : MAX_TAG_CHARS);
-			logger.debug("Tag is " + tag);
-			
-			ObjectNode tagJSON = mapper.createObjectNode();
-			tagJSON.put("name", tag);
-			tagJSON.put("display_name", tag);
-			tagsArrayOriginal.add(tagJSON);
-			
-		}
-		
-	}
-	
-	/**
-	 * Check if a group must be generated
-	 * @param fieldToValidate
-	 * @param metadataField
-	 * @param groupsArrayOriginal
-	 * @param isApplication 
-	 * @throws Exception 
-	 */
-	private void checkAsGroup(CustomField fieldToValidate, MetadataField metadataField, ArrayNode groupsArrayOriginal,
-			List<String> groupToCreate) throws Exception {
-		
-		logger.debug("Custom field is " + fieldToValidate);
-		logger.debug("MetadataField field is " + metadataField);
-		logger.debug("JSONArray field is " + groupsArrayOriginal);
-		
-		MetadataGrouping grouping = metadataField.getGrouping();
-		if(grouping != null) {
-			
-			boolean propagateUp = grouping.getPropagateUp();
-			final Set<String> groupNames = new HashSet<String>();
-			
-			switch(grouping.getGroupingValue()) {
-				case onFieldName:
-					groupNames.add(metadataField.getFieldName());
-					break;
-				case onValue:
-					if(fieldToValidate.getValue() != null && !fieldToValidate.getValue().isEmpty())
-						groupNames.add(fieldToValidate.getValue());
-					break;
-				case onFieldName_onValue:
-				case onValue_onFieldName:
-					groupNames.add(metadataField.getFieldName());
-					if(fieldToValidate.getValue() != null && !fieldToValidate.getValue().isEmpty())
-						groupNames.add(fieldToValidate.getValue());
-					break;
-				default:
-					return;
-			}
-			
-			for(String title : groupNames) {
-				String groupName = CKANGroup.getCKANGroupName(title);
-				logger.debug("Adding group to which add this item {}", groupName);
-				ObjectNode group = mapper.createObjectNode();
-				group.put("name", groupName);
-				if(propagateUp) {
-					List<String> parents = Validator.getGroupHierarchyNames(groupName);
-					for(String parent : parents) {
-						ObjectNode groupP = mapper.createObjectNode();
-						groupP.put("name", parent);
-						groupsArrayOriginal.add(groupP);
-					}
-				}
-				groupsArrayOriginal.add(group);
-			}
-			
-			// force group creation if needed
-			if(grouping.getCreate()) {
-				for(String title : groupNames)
-					groupToCreate.add(title);
-			}
-		}
-		
-	}
-	
-	/**
-	 * Validate the single field
-	 * @param fieldToValidate
-	 * @param metadataField
-	 * @param isFirst 
-	 * @return
-	 * @throws Exception 
-	 */
-	private void validate(CustomField fieldToValidate, MetadataField metadataField) throws Exception {
-		
-		DataType dataType = metadataField.getDataType();
-		String regex = metadataField.getValidator() != null ? metadataField.getValidator().getRegularExpression()
-				: null;
-		boolean hasControlledVocabulary = false;
-		MetadataVocabulary metadataVocabulary = metadataField.getVocabulary();
-		if(metadataVocabulary!=null) {
-			List<String> vocabularyFields = metadataVocabulary.getVocabularyFields();
-			if(vocabularyFields!=null && vocabularyFields.size()>0) {
-				hasControlledVocabulary = true;
-			}
-		}
-		String value = fieldToValidate.getValue();
-		String key = fieldToValidate.getKey();
-		String defaultValue = metadataField.getDefaultValue();
-		
-		// replace key by prepending the qualified name of the category, if needed
-		fieldToValidate.setQualifiedKey(metadataField.getCategoryFieldQName());
-		
-		if((value == null || value.isEmpty()))
-			if(metadataField.getMandatory() || hasControlledVocabulary)
-				throw new BadRequestException("Mandatory field with name '" + key
-						+ "' doesn't have a value but it is mandatory or has a controlled vocabulary!");
-			else {
-				if(defaultValue != null && !defaultValue.isEmpty()) {
-					value = defaultValue;
-					fieldToValidate.setValue(defaultValue);
-				}
-				return; // there is no need to check other stuff
-			}
-		
-		switch(dataType) {
-			
-			case String:
-			case Text:
-				
-				if(regex != null && !value.matches(regex))
-					throw new BadRequestException("Field with key '" + key
-							+ "' doesn't match the provided regular expression (" + regex + ")!");
-				
-				if(hasControlledVocabulary) {
-					
-					List<String> valuesVocabulary = metadataField.getVocabulary().getVocabularyFields();
-					
-					if(valuesVocabulary == null || valuesVocabulary.isEmpty())
-						return;
-					
-					boolean match = false;
-					for(String valueVocabulary : valuesVocabulary) {
-						match = value.equals(valueVocabulary);
-						if(match)
-							break;
-					}
-					
-					if(!match)
-						throw new BadRequestException("Field with key '" + key + "' has a value '" + value
-								+ "' but it doesn't match any of the vocabulary's values (" + valuesVocabulary + ")!");
-					
-				}
-				
-				break;
-			case Time:
-				
-				if(!isValidDate(value))
-					throw new BadRequestException("Field with key '" + key + "' doesn't seem a valid time!");
-				
-				break;
-			case Time_Interval:
-				
-				String[] timeValues = value.split("/");
-				for(int i = 0; i < timeValues.length; i++) {
-					String time = timeValues[i];
-					if(!isValidDate(time))
-						throw new BadRequestException(
-								"Field with key '" + key + "' doesn't seem a valid time interval!");
-				}
-				
-				break;
-			case Times_ListOf:
-				
-				String[] timeIntervals = value.split(",");
-				for(int i = 0; i < timeIntervals.length; i++) {
-					String[] timeIntervalValues = timeIntervals[i].split("/");
-					if(timeIntervalValues.length > 2)
-						throw new BadRequestException(
-								"Field with key '" + key + "' doesn't seem a valid list of times!");
-					for(i = 0; i < timeIntervalValues.length; i++) {
-						String time = timeIntervalValues[i];
-						if(!isValidDate(time))
-							throw new BadRequestException(
-									"Field with key '" + key + "' doesn't seem a valid list of times!");
-					}
-				}
-				
-				break;
-			case Boolean:
-				
-				if(value.equalsIgnoreCase("true") || value.equalsIgnoreCase("false")) {
-					
-				} else
-					throw new BadRequestException("Field with key '" + key + "' doesn't seem a valid boolean value!");
-				
-				break;
-			case Number:
-				
-				if(!NumberUtils.isCreatable(value))
-					throw new BadRequestException("Field's value with key '" + key + "' is not a valid number!");
-				
-				break;
-			case GeoJSON:
-				
-				try {
-					new com.fasterxml.jackson.databind.ObjectMapper().readValue(fieldToValidate.getValue(), GeoJsonObject.class);
-				} catch(Exception e) {
-					throw new BadRequestException("GeoJSON field with key '" + key + "' seems not valid!");
-				}
-				
-				break;
-			default:
-				break;
-		}
-		
-	}
-	
-	/**
-	 * Validate a time date against a formatter
-	 * @param value
-	 * @param formatter
-	 * @return
-	 */
-	private static boolean isValidDate(String value) {
-		
-		try {
-			DATE_HOUR_MINUTES.parse(value);
-			return true;
-		} catch(Exception e) {
-			logger.debug("failed to parse date with hours and minutes, trying the other one");
-			try {
-				DATE_SIMPLE.parse(value);
-				return true;
-			} catch(Exception e2) {
-				logger.warn("failed to parse date with simple format, returning false");
-				return false;
-			}
-		}
-		
-	}
-	
-	/**
-	 * Get the group hierarchy
-	 * @param groupName
-	 * @throws Exception 
-	 */
-	public static List<String> getGroupHierarchyNames(String groupName) throws Exception {
-		CKANGroup ckanGroup = new CKANGroup();
-		ckanGroup.setName(groupName);
-		return ckanGroup.getGroups();
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKAN.java

@@ -1,367 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.UnsupportedEncodingException;
-import java.net.HttpURLConnection;
-import java.util.HashMap;
-import java.util.Map;
-
-import javax.ws.rs.BadRequestException;
-import javax.ws.rs.ForbiddenException;
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.NotFoundException;
-import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.HttpHeaders;
-import javax.ws.rs.core.Response.Status;
-import javax.ws.rs.core.UriInfo;
-
-import org.gcube.com.fasterxml.jackson.core.JsonProcessingException;
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.NullNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
-import org.gcube.gcat.utils.HTTPUtility;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public abstract class CKAN {
-	
-	private static final Logger logger = LoggerFactory.getLogger(CKAN.class);
-	
-	protected static final String ID_KEY = "id";
-	protected static final String TITLE_KEY = "title";
-	protected static final String NAME_KEY = "name";
-	
-	protected static final String ERROR_KEY = "error";
-	protected static final String ERROR_TYPE_KEY = "__type";
-	protected static final String MESSAGE_KEY = "message";
-	protected static final String OWNER_ORG_KEY = "owner_org";
-	
-	protected static final String RESULT_KEY = "result";
-	protected static final String SUCCESS_KEY = "success";
-	
-	public static final String LIMIT_KEY = "limit";
-	public static final String OFFSET_KEY = "offset";
-	
-	protected static final String NOT_FOUND_ERROR = "Not Found Error";
-	protected static final String AUTHORIZATION_ERROR = "Authorization Error";
-	protected static final String VALIDATION_ERROR = "Validation Error";
-	
-	// api rest path CKAN
-	public final static String CKAN_API_PATH = "/api/3/action/";
-	
-	// ckan header authorization 
-	public final static String AUTH_CKAN_HEADER = HttpHeaders.AUTHORIZATION;
-	
-	public final static String NAME_REGEX = "^[a-z0-9_\\\\-]{2,100}$";
-	
-	protected String LIST;
-	protected String CREATE;
-	protected String READ;
-	protected String UPDATE;
-	protected String PATCH;
-	protected String DELETE;
-	protected String PURGE;
-	
-	protected final ObjectMapper mapper;
-	
-	protected String name;
-	protected String apiKey;
-	
-	protected JsonNode result;
-	
-	protected String nameRegex;
-	
-	protected UriInfo uriInfo;
-	
-	public void setUriInfo(UriInfo uriInfo) {
-		this.uriInfo = uriInfo;
-	}
-	
-	public String getApiKey() {
-		if(apiKey == null) {
-			try {
-				return CKANUtility.getApiKey();
-			} catch(Exception e) {
-				throw new InternalServerErrorException(e);
-			}
-		}
-		return apiKey;
-	}
-	
-	public void setApiKey(String apiKey) {
-		this.apiKey = apiKey;
-	}
-	
-	public String getName() {
-		return name;
-	}
-	
-	public void setName(String name) {
-		this.name = name;
-	}
-	
-	public ObjectMapper getMapper() {
-		return mapper;
-	}
-	
-	public JsonNode getJsonNodeResult() {
-		return result;
-	}
-	
-	protected CKAN() {
-		try {
-			this.mapper = new ObjectMapper();
-			this.nameRegex = CKAN.NAME_REGEX;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	protected JsonNode getAsJsonNode(String json) {
-		try {
-			return mapper.readTree(json);
-		} catch(IOException e) {
-			throw new BadRequestException(e);
-		}
-	}
-
-	
-	/**
-	 * Validate the CKAN response and return the 
-	 * @param json
-	 * @return the validated response as JsonNode
-	 */
-	protected JsonNode validateCKANResponse(String json) {
-		JsonNode jsonNode = getAsJsonNode(json);
-		if(jsonNode.get(SUCCESS_KEY).asBoolean()) {
-			return jsonNode.get(RESULT_KEY);
-		} else {
-			try {
-				JsonNode error = jsonNode.get(ERROR_KEY);
-				
-				String errorType = error.get(ERROR_TYPE_KEY).asText();
-				
-				if(errorType.compareTo(VALIDATION_ERROR) == 0) {
-					throw new BadRequestException(getAsString(error));
-				}
-				
-				String message = error.get(MESSAGE_KEY).asText();
-				
-				if(errorType.compareTo(NOT_FOUND_ERROR) == 0) {
-					throw new NotFoundException(message);
-				}
-				
-				if(errorType.compareTo(AUTHORIZATION_ERROR) == 0) {
-					throw new ForbiddenException(message);
-				}
-				
-				// TODO parse more cases
-			} catch(WebApplicationException e) {
-				throw e;
-			} catch(Exception e) {
-				throw new BadRequestException(json);
-			}
-			throw new BadRequestException(json);
-		}
-	}
-	
-	protected String getAsString(JsonNode node) {
-		try {
-			String json = mapper.writeValueAsString(node);
-			return json;
-		} catch(JsonProcessingException e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	protected JsonNode checkName(JsonNode jsonNode) {
-		try {
-			String gotName = jsonNode.get(NAME_KEY).asText();
-			if(!gotName.matches(nameRegex)) {
-				throw new BadRequestException(
-						"The 'name' must be between 2 and 100 characters long and contain only lowercase alphanumeric characters, '-' and '_'. You can validate your name using the regular expression : "
-								+ NAME_REGEX);
-			}
-			
-			if(name == null) {
-				name = gotName;
-			}
-			
-			if(gotName != null && gotName.compareTo(name) != 0) {
-				String error = String.format(
-						"The name (%s) does not match with the '%s' contained in the provided content (%s).", name,
-						NAME_KEY, gotName);
-				throw new BadRequestException(error);
-			}
-			return jsonNode;
-		} catch(BadRequestException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new BadRequestException("Unable to obtain a correct 'name' from the provided content");
-		}
-	}
-	
-	protected JsonNode checkName(String json) {
-		JsonNode jsonNode = getAsJsonNode(json);
-		checkName(jsonNode);
-		return jsonNode;
-	}
-	
-	protected JsonNode createJsonNodeWithID(String id) {
-		ObjectNode objectNode = mapper.createObjectNode();
-		objectNode.put(ID_KEY, id);
-		return objectNode;
-	}
-	
-	protected JsonNode createJsonNodeWithNameAsID() {
-		return createJsonNodeWithID(name);
-	}
-	
-	protected Map<String,String> getMapWithNameAsID() {
-		return getMapWithID(name);
-	}
-	
-	protected Map<String,String> getMapWithID(String id) {
-		Map<String,String> map = new HashMap<>();
-		map.put(ID_KEY, id);
-		return map;
-	}
-	
-	protected GXHTTPStringRequest getGXHTTPStringRequest(String path, boolean post)
-			throws UnsupportedEncodingException {
-		String catalogueURL = CKANUtility.getCkanURL();
-		
-		GXHTTPStringRequest gxhttpStringRequest = HTTPUtility.createGXHTTPStringRequest(catalogueURL, path, post);
-		gxhttpStringRequest.isExternalCall(true);
-		gxhttpStringRequest.header(AUTH_CKAN_HEADER, getApiKey());
-		
-		return gxhttpStringRequest;
-	}
-	
-	protected String getResultAsString(HttpURLConnection httpURLConnection) throws IOException {
-		int responseCode = httpURLConnection.getResponseCode();
-		if(responseCode >= Status.BAD_REQUEST.getStatusCode()) {
-			Status status = Status.fromStatusCode(responseCode);
-			switch (status) {
-				case NOT_FOUND:
-					throw new NotFoundException();
-	
-				default:
-					break;
-			}
-			InputStream inputStream = httpURLConnection.getErrorStream();
-			StringBuilder result = HTTPUtility.getStringBuilder(inputStream);
-			logger.trace(result.toString());
-			try {
-				JsonNode jsonNode = getAsJsonNode(result.toString());
-				JsonNode error = jsonNode.get(ERROR_KEY);
-				throw new WebApplicationException(getAsString(error), status);
-			}catch (WebApplicationException e) {
-				throw e;
-			}catch (Exception e) {
-				throw new WebApplicationException(result.toString(), status);
-			}
-		}
-		InputStream inputStream = httpURLConnection.getInputStream();
-		String ret = HTTPUtility.getStringBuilder(inputStream).toString();
-		logger.trace("Got Respose is {}", ret);
-		return ret;
-	}
-	
-	protected String getResultAndValidate(HttpURLConnection httpURLConnection) throws IOException {
-		String ret = getResultAsString(httpURLConnection);
-		logger.trace("Got Respose is {}", ret);
-		result = validateCKANResponse(ret);
-		if(result instanceof NullNode) {
-			result = mapper.createObjectNode();
-		}
-		return getAsString(result);
-	}
-	
-	protected String sendGetRequest(String path, Map<String,String> parameters) {
-		try {
-			logger.debug("Going to send GET request with parameters {}", parameters);
-			GXHTTPStringRequest gxhttpStringRequest = getGXHTTPStringRequest(path, false);
-			gxhttpStringRequest.queryParams(parameters);
-			HttpURLConnection httpURLConnection = gxhttpStringRequest.get();
-			return getResultAndValidate(httpURLConnection);
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	protected String sendPostRequest(String path, String body) {
-		try {
-			logger.debug("Going to send POST request with body {}", body);
-			GXHTTPStringRequest gxhttpStringRequest = getGXHTTPStringRequest(path, true);
-			HttpURLConnection httpURLConnection = gxhttpStringRequest.post(body);
-			return getResultAndValidate(httpURLConnection);
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	protected String sendPostRequest(String path, JsonNode jsonNode) {
-		return sendPostRequest(path, getAsString(jsonNode));
-	}
-	
-	public String list(int limit, int offset) {
-		Map<String,String> parameters = new HashMap<>();
-		if(limit > 0) {
-			parameters.put(LIMIT_KEY, String.valueOf(limit));
-		}
-		if(offset >= 0) {
-			parameters.put(OFFSET_KEY, String.valueOf(offset));
-		}
-		return sendGetRequest(LIST, parameters);
-	}
-	
-	public String create(String json) {
-		return sendPostRequest(CREATE, json);
-	}
-	
-	public String read() {
-		return sendGetRequest(READ, getMapWithNameAsID());
-	}
-	
-	public String update(String json) {
-		checkName(json);
-		return sendPostRequest(UPDATE, json);
-	}
-	
-	public String patch(String json) {
-		JsonNode jsonNode = checkName(json);
-		ObjectNode objectNode = ((ObjectNode) jsonNode);
-		objectNode.put(ID_KEY, name);
-		objectNode.remove(NAME_KEY);
-		return sendPostRequest(PATCH, objectNode);
-	}
-	
-	protected void delete() {
-		sendPostRequest(DELETE, createJsonNodeWithNameAsID());
-	}
-	
-	public void delete(boolean purge) {
-		if(purge) {
-			purge();
-		} else {
-			delete();
-		}
-	}
-	
-	public void purge() {
-		sendPostRequest(PURGE, createJsonNodeWithNameAsID());
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANGroup.java

@@ -1,108 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import java.util.ArrayList;
-import java.util.Iterator;
-import java.util.List;
-
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.WebApplicationException;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANGroup extends CKAN {
-	
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.group_list
-	public static final String GROUP_LIST = CKAN.CKAN_API_PATH + "group_list";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.create.group_create
-	public static final String GROUP_CREATE = CKAN.CKAN_API_PATH + "group_create";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.group_show
-	public static final String GROUP_SHOW = CKAN.CKAN_API_PATH + "group_show";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.update.group_update
-	public static final String GROUP_UPDATE = CKAN.CKAN_API_PATH + "group_update";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.patch.group_patch
-	public static final String GROUP_PATCH = CKAN.CKAN_API_PATH + "group_patch";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.delete.group_delete
-	public static final String GROUP_DELETE = CKAN.CKAN_API_PATH + "group_delete";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.delete.group_purge
-	public static final String GROUP_PURGE = CKAN.CKAN_API_PATH + "group_purge";
-	
-	public static final String GROUPS_KEY = "groups";
-	
-	public CKANGroup() {
-		super();
-		LIST = GROUP_LIST;
-		CREATE = GROUP_CREATE;
-		READ = GROUP_SHOW;
-		UPDATE = GROUP_UPDATE;
-		PATCH = GROUP_PATCH;
-		DELETE = GROUP_DELETE;
-		PURGE = GROUP_PURGE;
-	}
-	
-	public static String fromGroupTitleToName(String groupName) {
-		if(groupName == null)
-			return null;
-		
-		String regexGroupNameTransform = "[^A-Za-z0-9-]";
-		String modified = groupName.trim().replaceAll(regexGroupNameTransform, "-").replaceAll("-+", "-").toLowerCase();
-		
-		if(modified.startsWith("-"))
-			modified = modified.substring(1);
-		if(modified.endsWith("-"))
-			modified = modified.substring(0, modified.length() - 1);
-		
-		return modified;
-		
-	}
-	
-	public static String getCKANGroupName(String name) {
-		return CKANGroup.fromGroupTitleToName(name);
-	}
-	
-	public String create() throws WebApplicationException {
-		try {
-			ObjectNode objectNode = mapper.createObjectNode();
-			objectNode.put(NAME_KEY, CKANGroup.getCKANGroupName(name));
-			objectNode.put("title", name);
-			objectNode.put("display_name", name);
-			objectNode.put("description", "");
-			return super.create(mapper.writeValueAsString(objectNode));
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	public List<String> getGroups() {
-		if(result == null) {
-			read();
-		}
-		List<String> groups = new ArrayList<String>();
-		if(result.has(GROUPS_KEY)) {
-			JsonNode jsonNode = result.get(GROUPS_KEY);
-			if(jsonNode.isArray()) {
-				ArrayNode arrayNode = (ArrayNode) jsonNode;
-				if(arrayNode.size() > 0) {
-					Iterator<JsonNode> iterator = arrayNode.iterator();
-					while(iterator.hasNext()) {
-						groups.add(iterator.next().asText());
-					}
-				}
-			}
-		}
-		return groups;
-	}
-	
-	public int count() {
-		list(100000, 0);
-		ArrayNode arrayNode = (ArrayNode) result;
-		return arrayNode.size();
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANLicense.java

@@ -1,49 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANLicense extends CKAN {
-	
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.license_list
-	public static final String LICENSES_LIST = CKAN.CKAN_API_PATH + "license_list";
-	
-	public CKANLicense() {
-		super();
-		LIST = LICENSES_LIST;
-	}
-	
-	protected static ArrayNode getLicenses() {
-		CKANLicense ckanLicense = new CKANLicense();
-		ckanLicense.list(-1, -1);
-		ArrayNode arrayNode = (ArrayNode) ckanLicense.getJsonNodeResult();
-		return arrayNode;
-	}
-	
-	public static boolean checkLicenseId(String licenseId) throws Exception {
-		return checkLicenseId(getLicenses(), licenseId);
-	}
-	
-	// TODO Use a Cache
-	protected static boolean checkLicenseId(ArrayNode arrayNode, String licenseId) throws Exception {
-		try {
-			for(JsonNode jsonNode : arrayNode) {
-				try {
-					String id = jsonNode.get(ID_KEY).asText();
-					if(id.compareTo(licenseId) == 0) {
-						return true;
-					}
-				} catch(Exception e) {
-					
-				}
-			}
-			return false;
-		} catch(Exception e) {
-			throw e;
-		}
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANOrganization.java

@@ -1,86 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.scope.impl.ScopeBean;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANOrganization extends CKAN {
-	
-	private static Logger logger = LoggerFactory.getLogger(CKANOrganization.class);
-	
-	// CKAN Connector sanitize the Organization name as following
-	//organizationName.replaceAll(" ", "_").replace(".", "_").toLowerCase()
-	
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.organization_list
-	public static final String ORGANIZATION_LIST = CKAN.CKAN_API_PATH + "organization_list";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.create.organization_create
-	public static final String ORGANIZATION_CREATE = CKAN.CKAN_API_PATH + "organization_create";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.organization_show
-	public static final String ORGANIZATION_SHOW = CKAN.CKAN_API_PATH + "organization_show";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.update.organization_update
-	public static final String ORGANIZATION_UPDATE = CKAN.CKAN_API_PATH + "organization_update";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.patch.organization_patch
-	public static final String ORGANIZATION_PATCH = CKAN.CKAN_API_PATH + "organization_patch";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.delete.organization_delete
-	public static final String ORGANIZATION_DELETE = CKAN.CKAN_API_PATH + "organization_delete";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.delete.organization_purge
-	public static final String ORGANIZATION_PURGE = CKAN.CKAN_API_PATH + "organization_purge";
-	
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.create.organization_member_create
-	public static final String ORGANIZATION_MEMBER_CREATE = CKAN.CKAN_API_PATH + "organization_member_create";
-	
-	// https://docs.ckan.org/en/latest/api/index.html#ckan.logic.action.get.organization_list_for_user
-	public static final String ORGANIZATION_LIST_FOR_USER = CKAN.CKAN_API_PATH + "organization_list_for_user";
-	
-	protected static final String USERNAME_KEY = "username";
-	protected static final String ROLE_KEY = "role";
-	
-	public CKANOrganization() {
-		super();
-		LIST = ORGANIZATION_LIST;
-		CREATE = ORGANIZATION_CREATE;
-		READ = ORGANIZATION_SHOW;
-		UPDATE = ORGANIZATION_UPDATE;
-		PATCH = ORGANIZATION_PATCH;
-		DELETE = ORGANIZATION_DELETE;
-		PURGE = ORGANIZATION_PURGE;
-	}
-	
-	protected static final String ORGANIZATION_PERMISSION_KEY = "permission";
-	protected static final String ORGANIZATION_PERMISSION_VALUE_READ = "read";
-	
-	public void addUserToOrganisation(String gCubeUsername, String role) {
-		String ckanUsername = CKANUser.getCKANUsername(gCubeUsername);
-		
-		ObjectNode objectNode = mapper.createObjectNode();
-		objectNode.put(ID_KEY, name);
-		objectNode.put(USERNAME_KEY, ckanUsername);
-		objectNode.put(ROLE_KEY, role);
-		sendPostRequest(ORGANIZATION_MEMBER_CREATE, getAsString(objectNode));
-		logger.debug("User {} successfully added to Organisation {} with role {}", ckanUsername, name, role);
-		
-	}
-	
-	public static String getCKANOrganizationName() {
-		String context = SecretManagerProvider.instance.get().getContext();
-		return getCKANOrganizationName(context);
-	}
-	
-	public static String getCKANOrganizationName(String context) {
-		ScopeBean scopeBean = new ScopeBean(context);
-		return scopeBean.name().toLowerCase();
-	}
-	
-	public int count() {
-		list(100000, 0);
-		ArrayNode arrayNode = (ArrayNode) result;
-		return arrayNode.size();
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANPackageTrash.java

@@ -1,218 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import java.sql.Connection;
-import java.sql.DriverManager;
-import java.sql.ResultSet;
-import java.sql.SQLException;
-import java.sql.Statement;
-import java.util.Set;
-import java.util.concurrent.TimeUnit;
-
-import javax.ws.rs.WebApplicationException;
-
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.gcat.api.configuration.CKANDB;
-import org.gcube.gcat.api.configuration.CatalogueConfiguration;
-import org.gcube.gcat.api.roles.Role;
-import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
-import org.postgresql.core.Utils;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANPackageTrash {
-	
-	protected static final Logger logger = LoggerFactory.getLogger(CKANPackageTrash.class);
-	
-	private static final String GROUP_TABLE_KEY = "group";
-	private static final String GROUP_ID_KEY = "id";
-	private static final String GROUP_NAME_KEY = "name";
-	
-	private static final String PACKAGE_TABLE_KEY = "package";
-	
-	private static final String PACKAGE_NAME_KEY = "name";
-	
-	private static final String PACKAGE_TYPE_KEY = "type";
-	private static final String PACKAGE_TYPE_VALUE = "dataset";
-	
-	private static final String PACKAGE_STATE_KEY = "state";
-	private static final String PACKAGE_STATE_VALUE = "deleted";
-	
-	private static final String PACKAGE_OWNER_ORG_KEY = "owner_org";
-	
-	protected ObjectMapper mapper;
-	
-	protected final CKANUser ckanUser;
-	protected final CatalogueConfiguration configuration;
-	protected final Set<String> supportedOrganizations;
-	
-	protected boolean ownOnly; 
-	
-	public CKANPackageTrash() {
-		mapper = new ObjectMapper();
-		ckanUser = CKANUserCache.getCurrrentCKANUser();
-		configuration = CatalogueConfigurationFactory.getInstance();
-		supportedOrganizations = configuration.getSupportedOrganizations();
-		ownOnly = true;
-	}
-	
-	public void setOwnOnly(boolean ownOnly) {
-		this.ownOnly = ownOnly;
-	}
-	
-	protected Connection getConnection() throws Exception {
-		Class.forName("org.postgresql.Driver");
-		CKANDB ckanDB = configuration.getCkanDB();
-		String url = ckanDB.getUrl();
-		String username = ckanDB.getUsername();
-		String password = ckanDB.getPassword();
-		Connection connection = DriverManager.getConnection(url, username, password);
-		logger.trace("Database {} opened successfully", url);
-		connection.setAutoCommit(false);
-		return connection;
-	}
-	
-	protected String getQuotedString(String string) throws SQLException {
-		StringBuilder builder = new StringBuilder();
-		builder.append("'");
-		Utils.escapeLiteral(builder, string, false);
-		builder.append("'");
-		return builder.toString();
-	}
-		
-	protected ArrayNode getItems() throws WebApplicationException {
-		Connection connection = null;
-		try {
-			StringBuffer stringBufferOrg = new StringBuffer();
-			stringBufferOrg.append("SELECT ");
-			stringBufferOrg.append(GROUP_ID_KEY);
-			stringBufferOrg.append(" FROM \"");
-			stringBufferOrg.append(GROUP_TABLE_KEY);
-			stringBufferOrg.append("\" WHERE ");
-			stringBufferOrg.append(GROUP_NAME_KEY);
-			stringBufferOrg.append(" IN ");
-			stringBufferOrg.append("(");
-			boolean first = true;
-			for(String organizationName : supportedOrganizations) {
-				if(first) {
-					first = false;
-				}else {
-					stringBufferOrg.append(",");
-				}
-				stringBufferOrg.append(getQuotedString(organizationName));
-			}
-			stringBufferOrg.append(")");
-			
-			
-			StringBuffer stringBuffer = new StringBuffer();
-			stringBuffer.append("SELECT ");
-			stringBuffer.append(PACKAGE_NAME_KEY);
-			stringBuffer.append(" FROM ");
-			stringBuffer.append(PACKAGE_TABLE_KEY);
-			stringBuffer.append(" WHERE ");
-			stringBuffer.append(PACKAGE_TYPE_KEY);
-			stringBuffer.append("=");
-			stringBuffer.append(getQuotedString(PACKAGE_TYPE_VALUE));
-			stringBuffer.append(" AND ");
-			stringBuffer.append(PACKAGE_STATE_KEY);
-			stringBuffer.append("=");
-			stringBuffer.append(getQuotedString(PACKAGE_STATE_VALUE));
-			
-			if(ownOnly || ckanUser.getRole().ordinal()<Role.ADMIN.ordinal()) {
-				// add only own items
-				stringBuffer.append(" AND ");
-				stringBuffer.append(CKANPackage.AUTHOR_EMAIL_KEY);
-				stringBuffer.append("=");
-				stringBuffer.append(getQuotedString(ckanUser.getEMail()));
-			}
-			
-			stringBuffer.append(" AND ");
-			stringBuffer.append(PACKAGE_OWNER_ORG_KEY);
-			stringBuffer.append(" IN (");
-			stringBuffer.append(stringBufferOrg);
-			stringBuffer.append(")");
-			
-			ArrayNode items = mapper.createArrayNode();
-			connection = getConnection();
-			
-			Statement statement = connection.createStatement();
-		
-			String sql = stringBuffer.toString();
-			logger.trace("Going to request the following query: {}", sql);
-			ResultSet resultSet = statement.executeQuery(sql);
-			
-			while (resultSet.next()) {
-				String id = resultSet.getString(PACKAGE_NAME_KEY);
-				items.add(id);
-			}
-			
-			return items;
-		} catch (WebApplicationException e) {
-			throw e;
-		} catch (Exception e) {
-			throw new WebApplicationException(e);
-		}finally {
-			if(connection!=null) {
-				try {
-					connection.close();
-				} catch (SQLException e) {
-					
-				}
-			}
-		}
-	}
-	
-	public String list() throws WebApplicationException {
-		try {
-			return mapper.writeValueAsString(getItems());
-		} catch (WebApplicationException e) {
-			throw e;
-		} catch (Exception e) {
-			throw new WebApplicationException(e);
-		}
-	}
-	
-	public ObjectNode removeAll() throws WebApplicationException {
-		ObjectNode objectNode = mapper.createObjectNode();
-		ArrayNode deleted = mapper.createArrayNode();
-		ArrayNode notDeleted = mapper.createArrayNode();
-		
-		ArrayNode itemNames = getItems();
-		CKANPackage ckanPackage = new CKANPackage();
-		for(int i=0; i<itemNames.size(); i++) {
-			String name = itemNames.get(i).asText();
-			try {
-				ckanPackage.reuseInstance();
-				ckanPackage.setName(name);
-				ckanPackage.purge();
-				deleted.add(name);
-			}catch (Exception e) {
-				notDeleted.add(name);
-			}
-			try {
-				Thread.sleep(TimeUnit.MILLISECONDS.toMillis(300));
-			} catch (InterruptedException e) {
-				
-			}
-		}
-		
-		objectNode.set("deleted", deleted);
-		objectNode.set("failed", notDeleted);
-		return objectNode;
-	}
-	
-	public String empty() throws WebApplicationException {
-		try {
-			return mapper.writeValueAsString(removeAll());
-		} catch (WebApplicationException e) {
-			throw e;
-		} catch (Exception e) {
-			throw new WebApplicationException(e);
-		}
-	}
-
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANResource.java

@@ -1,522 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import java.net.HttpURLConnection;
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.util.UUID;
-
-import javax.ws.rs.BadRequestException;
-import javax.ws.rs.DELETE;
-import javax.ws.rs.GET;
-import javax.ws.rs.HEAD;
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.NotAllowedException;
-import javax.ws.rs.OPTIONS;
-import javax.ws.rs.PUT;
-import javax.ws.rs.WebApplicationException;
-
-import org.apache.commons.io.FilenameUtils;
-import org.apache.tika.mime.MimeType;
-import org.apache.tika.mime.MimeTypes;
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.gcube.gcat.utils.Constants;
-import org.gcube.gcat.utils.HTTPCall;
-import org.gcube.gcat.workspace.CatalogueStorageHubManagement;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANResource extends CKAN {
-	
-	private static final Logger logger = LoggerFactory.getLogger(CKANResource.class);
-	
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.create.resource_create
-	public static final String RESOURCE_CREATE = CKAN.CKAN_API_PATH + "resource_create";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.resource_show
-	public static final String RESOURCE_SHOW = CKAN.CKAN_API_PATH + "resource_show";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.update.resource_update
-	public static final String RESOURCE_UPDATE = CKAN.CKAN_API_PATH + "resource_update";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.patch.resource_patch
-	public static final String RESOURCE_PATCH = CKAN.CKAN_API_PATH + "resource_patch";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.delete.resource_delete
-	public static final String RESOURCE_DELETE = CKAN.CKAN_API_PATH + "resource_delete";
-	
-	protected static final String URL_KEY = "url";
-	
-	private static final String RESOURCES_KEY = "resources";
-	private static final String PACKAGE_ID_KEY = "package_id";
-	private static final String FORMAT_KEY = "format";
-	private static final String MIME_TYPE_KEY = "mimetype";
-	private static final String REVISION_ID_KEY = "revision_id";
-	
-	private static final String TEMP = "TEMP_";
-	
-	public final static String RESOURCE_NAME_REGEX = "^[\\s\\S]*$";
-	
-	public static final MimeTypes ALL_MIME_TYPES;
-	
-	/* TODO Remove this code ASAP. It requires a function from Storage HUB */
-	private static final String URI_RESOLVER_STORAGE_HUB_HOST_PROD = "data.d4science.org";
-	private static final String URI_RESOLVER_STORAGE_HUB_HOST_PRE = "data-pre.d4science.org";
-	private static final String URI_RESOLVER_STORAGE_HUB_HOST_DEV = "data.dev.d4science.org";
-
-	public static final String URI_RESOLVER_STORAGE_HUB_HOST;
-	public static final String URI_RESOLVER_STORAGE_HUB_PATH = "/shub/";
-	
-	static {
-		String context = SecretManagerProvider.instance.get().getContext();
-		if(context.startsWith("/gcube")) {
-			URI_RESOLVER_STORAGE_HUB_HOST = URI_RESOLVER_STORAGE_HUB_HOST_DEV;
-		} else if(context.startsWith("/pred4s")){
-			URI_RESOLVER_STORAGE_HUB_HOST = URI_RESOLVER_STORAGE_HUB_HOST_PRE;
-		} else {
-			URI_RESOLVER_STORAGE_HUB_HOST = URI_RESOLVER_STORAGE_HUB_HOST_PROD;
-		}
-		// If you might be dealing with custom mimetypes too, then Tika supports those, and change line one to be:
-		// TikaConfig config = TikaConfig.getDefaultConfig();
-		// MimeTypes ALL_MIME_TYPES = config.getMimeRepository();
-		ALL_MIME_TYPES = MimeTypes.getDefaultMimeTypes();
-	}
-	/* TODO END Code to be Removed */
-	
-	protected String itemID;
-	
-	public String getItemID() {
-		return itemID;
-	}
-	
-	protected String resourceID;
-	
-	protected boolean persisted;
-	protected URL persistedURL;
-	
-	protected String mimeType;
-	protected String originalFileExtension;
-	
-	protected JsonNode previousRepresentation;
-	
-	protected CatalogueStorageHubManagement storageHubManagement;
-	
-	public URL getPersistedURL() {
-		return persistedURL;
-	}
-	
-	public static String extractResourceID(JsonNode jsonNode) {
-		String resourceID = null;
-		if(jsonNode.has(ID_KEY)) {
-			resourceID = jsonNode.get(ID_KEY).asText();
-		}
-		return resourceID;
-	}
-	
-	public String getResourceID() {
-		if(resourceID == null && previousRepresentation != null) {
-			resourceID = CKANResource.extractResourceID(previousRepresentation);
-		}
-		return resourceID;
-	}
-	
-	public void setResourceID(String resourceID) {
-		this.resourceID = resourceID;
-	}
-	
-	public void setPreviousRepresentation(JsonNode jsonNode) {
-		validate(jsonNode);
-		previousRepresentation = jsonNode;
-	}
-	
-	public JsonNode getPreviousRepresentation() {
-		if(previousRepresentation == null && resourceID != null) {
-			sendGetRequest(READ, getMapWithID(resourceID));
-			validate(result);
-			previousRepresentation = result;
-		}
-		return previousRepresentation;
-	}
-	
-	public CKANResource(String itemID) {
-		super();
-		this.nameRegex = RESOURCE_NAME_REGEX;
-		this.itemID = itemID;
-		CREATE = RESOURCE_CREATE;
-		READ = RESOURCE_SHOW;
-		UPDATE = RESOURCE_UPDATE;
-		PATCH = RESOURCE_PATCH;
-		DELETE = RESOURCE_DELETE;
-		PURGE = null;
-		persisted = false;
-		previousRepresentation = null;
-	}
-	
-	@Override
-	public String list(int limit, int offeset) {
-		return list();
-	}
-	
-	public String list() {
-		CKANPackage ckanPackage = new CKANPackage();
-		ckanPackage.setName(itemID);
-		String itemJson = ckanPackage.read();
-		JsonNode item = getAsJsonNode(itemJson);
-		JsonNode resources = item.get(RESOURCES_KEY);
-		return getAsString(resources);
-	}
-	
-	protected String getFormat() {
-		String format = null;
-		if(originalFileExtension != null) {
-			format = originalFileExtension;
-		} else {
-			try {
-				MimeType mimeTypeClzInstance = ALL_MIME_TYPES.forName(mimeType);
-				format = mimeTypeClzInstance.getExtension();
-				// List<String> extensions = mimeTypeClzInstance.getExtensions();
-				if(format == null || format.compareTo("") == 0) {
-					format = mimeType.split("/")[1].split(";")[0];
-				}
-			} catch(Exception e) {
-				try {
-					format = mimeType.split("/")[1].split(";")[0];
-				} catch(Exception ex) {
-					format = null;
-				}
-			}
-		}
-		if(format != null && format.startsWith(".")) {
-			format = format.substring(1);
-		}
-		return format;
-	}
-	
-	protected ObjectNode persistStorageFile(ObjectNode objectNode) {
-		
-		if(objectNode.has(URL_KEY)) {
-			String urlString = objectNode.get(URL_KEY).asText();
-			
-			URL url;
-			try {
-				url = new URL(urlString);
-			} catch(MalformedURLException e) {
-				throw new BadRequestException(e);
-			}
-			
-			url = copyStorageResource(url);
-			
-			if(name != null) {
-				objectNode.put(NAME_KEY, name);
-			}
-			
-			if(mimeType != null) {
-				objectNode.put(MIME_TYPE_KEY, mimeType);
-				
-				if(!objectNode.has(FORMAT_KEY)) {
-					String format = getFormat();
-					if(format != null) {
-						objectNode.put(FORMAT_KEY, format);
-					}
-				}
-			}
-			
-			objectNode.put(URL_KEY, url.toString());
-			return objectNode;
-		}
-		
-		String error = String.format("The content must contains the %s property", URL_KEY);
-		throw new BadRequestException(error);
-		
-	}
-	
-	protected ObjectNode validate(String json) throws MalformedURLException {
-		JsonNode jsonNode = getAsJsonNode(json);
-		return validate(jsonNode);
-	}
-	
-	protected ObjectNode validate(JsonNode jsonNode) {
-		
-		ObjectNode objectNode = (ObjectNode) jsonNode;
-		
-		if(objectNode.has(PACKAGE_ID_KEY)) {
-			String packageId = objectNode.get(PACKAGE_ID_KEY).asText();
-			if(packageId.compareTo(itemID) != 0) {
-				String error = String.format(
-						"Item ID %s does not match %s which is the value of %s contained in the representation.",
-						itemID, packageId, PACKAGE_ID_KEY);
-				throw new BadRequestException(error);
-			}
-		} else {
-			objectNode.put(PACKAGE_ID_KEY, itemID);
-		}
-		
-		if(objectNode.has(ID_KEY)) {
-			String gotId = objectNode.get(ID_KEY).asText();
-			if(resourceID == null) {
-				resourceID = gotId;
-			} else {
-				if(resourceID.compareTo(gotId) != 0) {
-					String error = String.format(
-							"Resource ID %s does not match %s which is the value of %s contained in the representation.",
-							resourceID, gotId, ID_KEY);
-					throw new BadRequestException(error);
-				}
-			}
-		} else {
-			resourceID = TEMP + UUID.randomUUID().toString();
-			logger.trace(
-					"The id of the resource with name {} for package {} has not been provided. It has been generated : {}",
-					name, itemID, resourceID);
-		}
-		
-		return objectNode;
-	}
-	
-	protected URL getFinalURL(String url) {
-		try {
-			URL urlURL = new URL(url);
-			return CKANResource.getFinalURL(urlURL);
-		} catch(MalformedURLException e) {
-			throw new BadRequestException(e);
-		}
-	}
-	
-	public static URL getFinalURL(URL url) {
-		HTTPCall httpCall = new HTTPCall(url.toString());
-		httpCall.setgCubeTargetService(false);
-		URL finalURL = httpCall.getFinalURL(url);
-		return finalURL;
-	}
-	
-	protected boolean isStorageFile(URL url) {
-		URL urlToCheck = url;
-		try {
-			urlToCheck = getFinalURL(url);
-		} catch(Exception e) {
-			// TODO Evaluate if we want to validate the URL. If the URL does not exists the service
-			// could decide to refuse the Resource Creation
-		}
-		if(urlToCheck.getHost().compareTo(URI_RESOLVER_STORAGE_HUB_HOST) == 0) {
-			if(urlToCheck.getPath().startsWith(URI_RESOLVER_STORAGE_HUB_PATH)) {
-				persistedURL = urlToCheck;
-				return true;
-			}
-		}
-		return false;
-	}
-	
-	/**
-	 * Check if the URl is a workspace URL so that is has to copy the resource to guarantee 
-	 * the resource remain persistent
-	 * @param url the URL to check
-	 * @return the public URL of the copied resource if any. It return the original URL otherwise
-	 */
-	protected URL copyStorageResource(URL url) {
-		persistedURL = url;
-		if(isStorageFile(persistedURL)) {
-			storageHubManagement = new CatalogueStorageHubManagement();
-			try {
-				persistedURL = storageHubManagement.ensureResourcePersistence(persistedURL, itemID, resourceID);
-				String originalFilename = storageHubManagement.getOriginalFilename();
-				name = FilenameUtils.removeExtension(originalFilename);
-				originalFileExtension = FilenameUtils.getExtension(originalFilename);
-				mimeType = storageHubManagement.getMimeType();
-				persisted = true;
-			} catch(Exception e) {
-				throw new InternalServerErrorException(e);
-			}
-		}
-		return persistedURL;
-	}
-	
-	protected void deleteStorageResource(URL url, String resourceID, String mimetype) {
-		persistedURL = url;
-		if(isStorageFile(persistedURL)) {
-			try {
-				GXHTTPStringRequest gxhttpStringRequest = GXHTTPStringRequest.newRequest(persistedURL.toString());
-				HttpURLConnection httpURLConnection = gxhttpStringRequest.from(Constants.CATALOGUE_NAME).head();
-				String storageHubContentType = httpURLConnection.getContentType().split(";")[0];
-				if(mimetype.compareTo(storageHubContentType) != 0) {
-					mimetype = storageHubContentType;
-					// Using storage hub mimetype
-				}
-			} catch(Exception e) {
-				// using provided mimetype
-			}
-			storageHubManagement = new CatalogueStorageHubManagement();
-			try {
-				storageHubManagement.deleteResourcePersistence(itemID, resourceID, mimetype);
-			} catch(Exception e) {
-				throw new InternalServerErrorException(e);
-			}
-		}
-	}
-	
-	protected String create(JsonNode jsonNode) {
-		try {
-			ObjectNode objectNode = validate(jsonNode);
-			objectNode = persistStorageFile(objectNode);
-			String ret = super.create(getAsString(objectNode));
-			if(persisted) {
-				String gotResourceID = result.get(ID_KEY).asText();
-				if(gotResourceID != null && gotResourceID.compareTo(resourceID) != 0) {
-					resourceID = gotResourceID;
-					String revisionID = result.get(REVISION_ID_KEY).asText();
-					storageHubManagement.renameFile(resourceID, revisionID);
-				}
-			}
-			return ret;
-		} catch(WebApplicationException e) {
-			// TODO Remove created file if any
-			throw e;
-		} catch(Exception e) {
-			// TODO Remove created file if any
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	@Override
-	public String create(String json) {
-		JsonNode jsonNode = getAsJsonNode(json);
-		return create(jsonNode);
-	}
-	
-	@Override
-	public String read() {
-		return sendGetRequest(READ, getMapWithID(resourceID));
-	}
-	
-	protected String update(JsonNode jsonNode) throws Exception {
-		ObjectNode resourceNode = (ObjectNode) jsonNode;
-		// This cannot be moved outside otherwise we don't 
-		resourceNode = validate(resourceNode);
-		
-		getPreviousRepresentation();
-		
-		String oldURL = previousRepresentation.get(CKANResource.URL_KEY).asText();
-		String newURL = resourceNode.get(CKANResource.URL_KEY).asText();
-		
-		if(!previousRepresentation.equals(resourceNode)) {
-			if(oldURL.compareTo(newURL) != 0) {
-				logger.trace("The URL of the resource with id {} was not changed", resourceID);
-				storageHubManagement = new CatalogueStorageHubManagement();
-				this.mimeType = previousRepresentation.get(CKANResource.MIME_TYPE_KEY).asText();
-				
-				try {
-					storageHubManagement.retrievePersistedFile(resourceID, mimeType);
-				}catch (Exception e) {
-					// If the file was not persisted by gCat (e.g. created with the portlet) some errors can occurs
-				}
-				
-			} else {
-				logger.trace("The URL of resource with id {} has been changed the old URL was {}, the new URL is {}",
-						resourceID, oldURL, newURL);
-				resourceNode = persistStorageFile(resourceNode);
-				/*
-				try {
-					URL urlOLD = new URL(oldURL);
-					deleteStorageResource(urlOLD);
-				}catch (Exception e) {
-					logger.error("Unable to remove old file at URL {}", oldURL);
-				}
-				*/
-			}
-			String ret = super.update(getAsString(resourceNode));
-			if(storageHubManagement.getPersistedFile()!= null) {
-				String revisionID = result.get(REVISION_ID_KEY).asText();
-				storageHubManagement.addRevisionID(resourceID, revisionID);
-			}
-			return ret;
-		}
-		
-		return previousRepresentation.asText();
-	}
-	
-	@Override
-	public String update(String json) {
-		try {
-			JsonNode jsonNode = getAsJsonNode(json);
-			return update(jsonNode);
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new WebApplicationException(e);
-		}
-	}
-	
-	@Override
-	public String patch(String json) {
-		String[] moreAllowed = new String[] {HEAD.class.getSimpleName(), GET.class.getSimpleName(),
-				PUT.class.getSimpleName(), DELETE.class.getSimpleName()};
-		throw new NotAllowedException(OPTIONS.class.getSimpleName(), moreAllowed);
-	}
-	
-	@Override
-	public void delete(boolean purge) {
-		delete();
-	}
-	
-	@Override
-	public void delete() {
-		try {
-			deleteFile();
-			sendPostRequest(DELETE, createJsonNodeWithID(resourceID));
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new WebApplicationException(e);
-		}
-	}
-	
-	@Override
-	public void purge() {
-		String[] moreAllowed = new String[] {HEAD.class.getSimpleName(), GET.class.getSimpleName(),
-				PUT.class.getSimpleName(), DELETE.class.getSimpleName()};
-		throw new NotAllowedException(OPTIONS.class.getSimpleName(), moreAllowed);
-	}
-	
-	public JsonNode createOrUpdate(JsonNode jsonNode) {
-		ObjectNode resourceNode = (ObjectNode) jsonNode;
-		if(resourceNode.has(ID_KEY)) {
-			try {
-				update(resourceNode);
-			} catch(WebApplicationException e) {
-				throw e;
-			} catch(Exception e) {
-				throw new WebApplicationException(e);
-			}
-		} else {
-			create(resourceNode);
-		}
-		return result;
-	}
-	
-	public void deleteFile() {
-		try {
-			getPreviousRepresentation();
-			URL url = new URL(previousRepresentation.get(URL_KEY).asText());
-			mimeType = previousRepresentation.get(MIME_TYPE_KEY).asText();
-			deleteStorageResource(url, resourceID, mimeType);
-		} catch(Exception e) {
-			logger.error("Unable to delete resource {}",
-					previousRepresentation != null ? getAsString(previousRepresentation) : "");
-		}
-	}
-	
-	public void rollback() {
-		if(previousRepresentation != null) {
-			try {
-				update(previousRepresentation);
-			} catch(WebApplicationException e) {
-				throw e;
-			} catch(Exception e) {
-				throw new WebApplicationException(e);
-			}
-		} else {
-			delete();
-		}
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANUser.java

@@ -1,295 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import java.util.Collection;
-
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.Response.Status;
-
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.user.User;
-import org.gcube.gcat.api.configuration.CatalogueConfiguration;
-import org.gcube.gcat.api.moderation.Moderated;
-import org.gcube.gcat.api.roles.Role;
-import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
-import org.gcube.gcat.utils.RandomString;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANUser extends CKAN {
-	
-	private static final Logger logger = LoggerFactory.getLogger(CKANUser.class);
-	
-	/* User Paths */
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.user_list
-	public static final String USER_LIST = CKAN.CKAN_API_PATH + "user_list";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.create.user_create
-	public static final String USER_CREATE = CKAN.CKAN_API_PATH + "user_create";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.get.user_show
-	public static final String USER_SHOW = CKAN.CKAN_API_PATH + "user_show";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.update.user_update
-	public static final String USER_UPDATE = CKAN.CKAN_API_PATH + "user_update";
-	// see https://docs.ckan.org/en/latest/api/#ckan.logic.action.delete.user_delete
-	public static final String USER_DELETE = CKAN.CKAN_API_PATH + "user_delete";
-	
-	public static final String ADD_USER_TO_GROUP = CKAN.CKAN_API_PATH + "member_create";
-	
-	public static final String NAME = "name";
-	public static final String DISPLAY_NAME = "display_name";
-	public static final String FULL_NAME = "fullname";
-	public static final String ABOUT = "about";
-	public static final String EMAIL = "email";
-	public static final String PASSWORD = "password";
-	
-	private static final String API_KEY = "apikey";
-	
-	protected Role role;
-	protected Boolean catalogueModerator;
-	
-	public CKANUser() {
-		super();
-		LIST = USER_LIST;
-		CREATE = USER_CREATE;
-		READ = USER_SHOW;
-		UPDATE = USER_UPDATE;
-		PATCH = null;
-		DELETE = USER_DELETE;
-		PURGE = null;
-		catalogueModerator = null;
-	}
-	
-	public String create() {
-		RandomString randomString = new RandomString(12);
-		ObjectNode objectNode = mapper.createObjectNode();
-		objectNode.put(NAME, name);
-		objectNode.put(PASSWORD, randomString.nextString());
-		checkAndSetEmail(objectNode);
-		checkAndSetFullName(objectNode);
-		checkAndSetJobTitle(objectNode);
-		return create(getAsString(objectNode));
-	}
-	
-	@Override
-	public void delete(boolean purge) {
-		this.delete();
-	}
-	
-	/**
-	 * 
-	 * @param objectNode
-	 * @return true if the display name and the full name has been updated in objectNode
-	 */
-	private boolean checkAndSetJobTitle(ObjectNode objectNode) {
-		String jobTitle = SecretManagerProvider.instance.get().getUser().getAbout();
-		
-		String ckanJobTitle = "";
-		if(objectNode.has(ABOUT)) {
-			ckanJobTitle = objectNode.get(ABOUT).asText();
-		}
-		if(jobTitle!=null && jobTitle.compareTo(ckanJobTitle) != 0) {
-			objectNode.put(ABOUT, jobTitle);
-			return true;
-		}
-		return false;
-	}
-	
-	/**
-	 * 
-	 * @param objectNode
-	 * @return true if the display name and the full name has been updated in objectNode
-	 */
-	private boolean checkAndSetFullName(ObjectNode objectNode) {
-		String portalFullname = getSurnameName();
-		
-		String ckanFullname = "";
-		if(objectNode.has(FULL_NAME)) {
-			ckanFullname = objectNode.get(FULL_NAME).asText();
-		}
-		if(portalFullname!=null && portalFullname.compareTo(ckanFullname) != 0) {
-			objectNode.put(FULL_NAME, portalFullname);
-			objectNode.put(DISPLAY_NAME, portalFullname);
-			return true;
-		}
-		return false;
-	}
-	
-	/**
-	 * 
-	 * @param objectNode
-	 * @return true if the display name and the full name has been updated
-	 */
-	private boolean checkAndSetEmail(ObjectNode objectNode) {
-		User user = SecretManagerProvider.instance.get().getUser();
-		String portalEmail = user.getEmail();
-		
-		String ckanEmail = "";
-		if(objectNode.has(EMAIL)) {
-			ckanEmail = objectNode.get(EMAIL).asText();
-		}
-		if(portalEmail==null) {
-			String username = user.getUsername();
-			String eMail = username + "@d4science.org";
-			objectNode.put(EMAIL, eMail);
-			return true;
-		} else if(portalEmail.compareTo(ckanEmail) != 0) {
-			objectNode.put(EMAIL, portalEmail);
-			return true;
-		}
-		return false;
-	}
-	
-	/**
-	 * Update the user profile on CKAN if the got got informations differs from the portal information
-	 * @return true if the profile information has been updated
-	 */
-	protected boolean updateProfileIfNeeded() {
-		ObjectNode objectNode = (ObjectNode) result;
-		boolean toBeUpdated = false;
-		
-		toBeUpdated = checkAndSetEmail(objectNode) || toBeUpdated;
-		toBeUpdated = checkAndSetFullName(objectNode) || toBeUpdated;
-		toBeUpdated = checkAndSetJobTitle(objectNode) || toBeUpdated;
-		
-		if(toBeUpdated) {
-			update(getAsString(objectNode));
-		}
-		return toBeUpdated;
-	}
-	
-	protected void retrieve() {
-		setApiKey(CKANUtility.getSysAdminAPI());
-		try {
-			if(name == null || name.compareTo("") == 0) {
-				setName(getCKANUsername());
-			}
-			read();
-			updateProfileIfNeeded();
-		} catch(WebApplicationException e) {
-			if(e.getResponse().getStatusInfo() == Status.NOT_FOUND) {
-				create();
-			} else {
-				throw e;
-			}
-		}
-		try {
-			CatalogueConfiguration configuration = CatalogueConfigurationFactory.getInstance();
-			for(String supportedOrganization : configuration.getSupportedOrganizations()) {
-				addUserToOrganization(supportedOrganization);
-			}
-		}catch (Exception e) {
-			// The organization could not exists and this is fine in some cases like organization create or 
-			// for listing items at VO level. The organization corresponding to the VO could not exists.
-			logger.warn("Add user to organization {} failed. This is acceptable in the case the request is at VO level and the corresponding orgnization does not esists and should not, as well as when the organization is going to be created", CKANOrganization.getCKANOrganizationName());
-		}
-	}
-	
-	protected void parseResult() {
-		name = result.get(NAME).asText();
-		try {
-			apiKey = result.get(API_KEY).asText();
-		}catch (Exception e) {
-			if(name.compareTo(getCKANUsername())==0) {
-				throw e;
-			}
-		}
-	}
-	
-	protected static String getCKANUsername(String username) {
-		if(username == null) {
-			return null;
-		}
-		return username.trim().replaceAll("\\.", "_");
-	}
-	
-	public static String getUsernameFromCKANUsername(String ckanUsername) {
-		if(ckanUsername == null) {
-			return null;
-		}
-		return ckanUsername.trim().replaceAll("_", ".");
-	}
-	
-	
-	public static String getCKANUsername() {
-		String username = SecretManagerProvider.instance.get().getUser().getUsername();
-		return getCKANUsername(username);
-	}
-	
-	public String read() {
-		String ret = super.read();
-		parseResult();
-		return ret;
-	}
-	
-	public void addUserToOrganization(String organizationName, String ckanUsername, String role) {
-		logger.trace("Going to add user {} to organization {} with role {}", ckanUsername, organizationName, role);
-		CKANOrganization ckanOrganization = new CKANOrganization();
-		ckanOrganization.setApiKey(CKANUtility.getSysAdminAPI());
-		ckanOrganization.setName(organizationName);
-		ckanOrganization.addUserToOrganisation(ckanUsername, role);
-	}
-	
-	public Role getRole() {
-		if(role == null) {
-			role = Role.MEMBER;
-			Collection<String> roles = SecretManagerProvider.instance.get().getUser().getRoles();
-			for(String portalRole : roles) {
-				Role gotRole = Role.getRoleFromPortalRole(portalRole);
-				if(gotRole != null && gotRole.ordinal() > role.ordinal()) {
-					role = gotRole;
-				}
-			}
-		}
-		return role;
-	}
-	
-	public void addUserToOrganization(String organizationName) {
-		addUserToOrganization(organizationName, name, getRole().getCkanRole());
-	}
-	
-	public void addUserToOrganization() {
-		String organizationName = CKANOrganization.getCKANOrganizationName();
-		addUserToOrganization(organizationName);
-	}
-	
-	public void addToGroup(String groupName) throws WebApplicationException {
-		try {
-			ObjectNode objectNode = mapper.createObjectNode();
-			objectNode.put(ID_KEY, CKANGroup.getCKANGroupName(groupName));
-			objectNode.put("object", name);
-			objectNode.put("object_type", "user");
-			objectNode.put("capacity", "member");
-			sendPostRequest(ADD_USER_TO_GROUP, getAsString(objectNode));
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-
-	public boolean isCatalogueModerator() {
-		if(catalogueModerator == null) {
-			catalogueModerator = SecretManagerProvider.instance.get().getUser().getRoles().contains(Moderated.CATALOGUE_MODERATOR);
-		}
-		return catalogueModerator;
-	}
-
-	public String getSurnameName(){
-		User user = SecretManagerProvider.instance.get().getUser();
-		return user.getFullName();
-	}
-	
-	public String getNameSurname() {
-		User user = SecretManagerProvider.instance.get().getUser();
-		return user.getFullName(true);
-	}
-	
-	public String getEMail() {
-		User user = SecretManagerProvider.instance.get().getUser();
-		return user.getEmail();
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANUserCache.java

@@ -1,82 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import java.util.concurrent.TimeUnit;
-
-import javax.cache.Cache;
-import javax.cache.CacheManager;
-import javax.cache.Caching;
-import javax.cache.configuration.MutableConfiguration;
-import javax.cache.expiry.CreatedExpiryPolicy;
-import javax.cache.expiry.Duration;
-import javax.cache.spi.CachingProvider;
-
-import org.gcube.common.authorization.utils.manager.SecretManager;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public abstract class CKANUserCache {
-	
-	private static final CacheManager cacheManager;
-	
-	private static final MutableConfiguration<String,CKANUser> userCacheConfiguration;
-	
-	static {
-		CachingProvider provider = Caching.getCachingProvider();
-		cacheManager = provider.getCacheManager();
-		
-		userCacheConfiguration = new MutableConfiguration<String,CKANUser>().setTypes(String.class, CKANUser.class)
-				.setStoreByValue(false)
-				.setExpiryPolicyFactory(CreatedExpiryPolicy.factoryOf(new Duration(TimeUnit.MINUTES, 15)));
-	}
-	
-	private CKANUserCache() {
-	}
-	
-	public synchronized static CKANUser getCurrrentCKANUser() {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String context = secretManager.getContext();
-		Cache<String,CKANUser> userCache = cacheManager.getCache(context);
-		if(userCache == null) {
-			userCache = cacheManager.createCache(context, userCacheConfiguration);
-		}
-		
-		String gcubeUsername = secretManager.getUser().getUsername();
-		CKANUser ckanUser = userCache.get(gcubeUsername);
-		if(ckanUser == null) {
-			ckanUser = new CKANUser();
-			ckanUser.retrieve();
-			userCache.put(gcubeUsername, ckanUser);
-		}
-		return ckanUser;
-	}
-	
-	public synchronized static void removeUserFromCache() {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String gcubeUsername = secretManager.getUser().getUsername();
-		removeUserFromCache(gcubeUsername);
-	}
-	
-	public synchronized static void removeUserFromCache(String gcubeUsername) {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String context = secretManager.getContext();
-		Cache<String,CKANUser> userCache = cacheManager.getCache(context);
-		if(userCache != null) {
-			userCache.remove(gcubeUsername);
-		}
-	}
-	
-	public synchronized static void emptyUserCache() {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		String context = secretManager.getContext();
-		cacheManager.destroyCache(context);
-	}
-	
-	@Override
-	protected void finalize() throws Throwable {
-		super.finalize();
-		cacheManager.close();
-	}
-	
-}

src/main/java/org/gcube/gcat/persistence/ckan/CKANUtility.java

@@ -1,37 +0,0 @@
-package org.gcube.gcat.persistence.ckan;
-
-import javax.ws.rs.InternalServerErrorException;
-
-import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CKANUtility {
-	
-	public static String getCkanURL() {
-		try {
-			return CatalogueConfigurationFactory.getInstance().getCkanURL();
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	public static String getSysAdminAPI() {
-		try {
-			return CatalogueConfigurationFactory.getInstance().getSysAdminToken();
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-	public static String getApiKey() {
-		try {
-			CKANUser ckanUser = CKANUserCache.getCurrrentCKANUser();
-			return ckanUser.getApiKey();
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-	
-}

src/main/java/org/gcube/gcat/profile/ISProfile.java

@@ -1,21 +1,36 @@
 package org.gcube.gcat.profile;
 
+import java.io.ByteArrayInputStream;
+import java.io.InputStream;
 import java.io.StringWriter;
 import java.util.List;
 import java.util.Set;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import java.util.regex.PatternSyntaxException;
 
+import javax.ws.rs.BadRequestException;
 import javax.ws.rs.InternalServerErrorException;
 import javax.ws.rs.NotAuthorizedException;
 import javax.ws.rs.NotFoundException;
 import javax.ws.rs.WebApplicationException;
+import javax.xml.bind.JAXBContext;
+import javax.xml.bind.JAXBException;
+import javax.xml.bind.Unmarshaller;
 
+import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
+import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
 import org.gcube.common.resources.gcore.GenericResource;
 import org.gcube.common.resources.gcore.Resources;
+import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataField;
+import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataFormat;
+import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataValidator;
+import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataVocabulary;
 import org.gcube.datacatalogue.metadatadiscovery.reader.MetadataFormatDiscovery;
 import org.gcube.datacatalogue.metadatadiscovery.reader.QueryForResourceUtil;
 import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
+import org.gcube.gcat.persistence.ckan.cache.CKANUserCache;
 import org.gcube.gcat.utils.Constants;
 import org.gcube.informationsystem.publisher.RegistryPublisher;
 import org.gcube.informationsystem.publisher.RegistryPublisherFactory;
@@ -29,9 +44,6 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.xml.sax.SAXException;
 
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-
 /**
  * @author Luca Frosini (ISTI - CNR)
  */
@@ -169,7 +181,61 @@ public class ISProfile {
 		}
 	}
 	
-	public boolean createOrUpdate(String name, String xml) throws SAXException {
+	public static MetadataFormat getMetadataFormat(String xml) throws JAXBException {
+		JAXBContext jaxbContext = JAXBContext.newInstance(MetadataFormat.class);
+	    Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
+	    InputStream stream = new ByteArrayInputStream(xml.getBytes());
+	    MetadataFormat metadataFormat = (MetadataFormat) unmarshaller.unmarshal(stream);
+	    return metadataFormat;
+	}
+	
+	public static void checkRegex(String regex, String text) {
+		try {
+			Pattern pattern = Pattern.compile(regex);
+			if(text!=null) {
+		    	Matcher matcher = pattern.matcher(text);
+		    	if(!matcher.find()) {
+		    		throw new RuntimeException();
+		    	}
+		    }
+		} catch (PatternSyntaxException e) {
+			throw e;
+		} catch (RuntimeException e) {
+			throw e;
+		}
+
+	}
+	
+	public static void validateMetadataFormat(MetadataFormat metadataFormat) throws BadRequestException {
+		List<MetadataField> metadataFields = metadataFormat.getMetadataFields();
+		for(MetadataField metadataField : metadataFields) {
+			String defaultValue = metadataField.getDefaultValue();
+			
+			MetadataValidator metadataValidator = metadataField.getValidator();
+			if(metadataValidator!=null) {
+				String regularExpression = metadataValidator.getRegularExpression();
+				if(regularExpression!=null && regularExpression.length()>0) {
+					try {
+						checkRegex(regularExpression, defaultValue);
+					} catch (PatternSyntaxException e) {
+						throw new BadRequestException("The regular expression provided for metadata field '" + metadataField.getFieldName() + "' (i.e. '" + regularExpression + "') is not valid." );
+					} catch (RuntimeException e) {
+						throw new BadRequestException("The default value provided for metadata field '" + metadataField.getFieldName() + "' (i.e. '" + defaultValue + "') does not match the regular expression defined (i.e. '" + regularExpression + "')");
+					}
+				}
+			}
+			
+			MetadataVocabulary metadataVocabulary = metadataField.getVocabulary();
+			if(metadataVocabulary!=null && defaultValue!=null) {
+				List<String> vocabularyFields = metadataVocabulary.getVocabularyFields();
+				if(!vocabularyFields.contains(defaultValue)) {
+					throw new BadRequestException("The default value provided for metadata field '" + metadataField.getFieldName() + "' (i.e. '" + defaultValue + "') does not match the vocabulary (i.e. '" + vocabularyFields.toString() + "')");
+				}
+			}
+		}
+	}
+	
+	public boolean createOrUpdate(String name, String xml) throws Exception {
 		try {
 			CKANUser ckanUser = CKANUserCache.getCurrrentCKANUser();
 			if(ckanUser.getRole().ordinal()<Role.EDITOR.ordinal()) {
@@ -177,7 +243,12 @@ public class ISProfile {
 			}
 			MetadataUtility metadataUtility = new MetadataUtility();
 			metadataUtility.validateProfile(xml);
-			if(metadataUtility.getMetadataFormat(name) == null) {
+			
+			MetadataFormat newMetadataFormat = getMetadataFormat(xml);
+			validateMetadataFormat(newMetadataFormat);
+			
+			MetadataFormat oldMetadataFormat = metadataUtility.getMetadataFormat(name);
+			if(oldMetadataFormat == null) {
 				createGenericResource(name, xml);
 				return true;
 			} else {

src/main/java/org/gcube/gcat/profile/MetadataUtility.java

@@ -1,70 +0,0 @@
-package org.gcube.gcat.profile;
-
-import java.io.IOException;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-
-import javax.xml.parsers.ParserConfigurationException;
-
-import org.gcube.datacatalogue.metadatadiscovery.DataCalogueMetadataFormatReader;
-import org.gcube.datacatalogue.metadatadiscovery.bean.MetadataProfile;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.MetadataFormat;
-import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.NamespaceCategory;
-import org.xml.sax.SAXException;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class MetadataUtility {
-	
-	private DataCalogueMetadataFormatReader dataCalogueMetadataFormatReader;
-	
-	/*
-	 * this map contains the Metadata Profiles. The key is the name of the profile.
-	 */
-	private Map<String,MetadataProfile> metadataProfiles;
-	
-	public MetadataUtility() throws Exception {
-		dataCalogueMetadataFormatReader = new DataCalogueMetadataFormatReader();
-	}
-	
-	public void validateProfile(String xmlProfile) throws ParserConfigurationException, SAXException, IOException {
-		dataCalogueMetadataFormatReader.validateProfile(xmlProfile);
-	}
-	
-	public Map<String,MetadataProfile> getMetadataProfiles() throws Exception {
-		if(metadataProfiles == null) {
-			metadataProfiles = new HashMap<>();
-			List<MetadataProfile> list = dataCalogueMetadataFormatReader.getListOfMetadataProfiles();
-			for(MetadataProfile profile : list) {
-				metadataProfiles.put(profile.getName(), profile);
-			}
-		}
-		return metadataProfiles;
-	}
-	
-	/**
-	 * Returns the names of the metadata profiles in a given context
-	 * @return the set of profile names
-	 * @throws Exception 
-	 */
-	public Set<String> getProfilesNames() throws Exception {
-		return getMetadataProfiles().keySet();
-	}
-	
-	public MetadataFormat getMetadataFormat(String profileName) throws Exception {
-		MetadataProfile profile = getMetadataProfiles().get(profileName);
-		if(profile != null) {
-			return dataCalogueMetadataFormatReader.getMetadataFormatForMetadataProfile(profile);
-		}
-		return null;
-	}
-	
-	public List<NamespaceCategory> getNamespaceCategories() throws Exception {
-		return dataCalogueMetadataFormatReader.getListOfNamespaceCategories();
-		
-	}
-	
-}

src/main/java/org/gcube/gcat/profile/ResourceRegistryProfile.java

@@ -21,7 +21,7 @@ import org.gcube.datacatalogue.metadatadiscovery.reader.MetadataFormatDiscovery;
 import org.gcube.datacatalogue.metadatadiscovery.reader.QueryForResourceUtil;
 import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
+import org.gcube.gcat.persistence.ckan.cache.CKANUserCache;
 import org.gcube.gcat.utils.Constants;
 import org.gcube.informationsystem.publisher.RegistryPublisher;
 import org.gcube.informationsystem.publisher.RegistryPublisherFactory;

src/main/java/org/gcube/gcat/rest/BaseREST.java

@@ -1,6 +1,7 @@
 package org.gcube.gcat.rest;
 
 import javax.ws.rs.core.Context;
+import javax.ws.rs.core.HttpHeaders;
 import javax.ws.rs.core.Response.ResponseBuilder;
 import javax.ws.rs.core.UriInfo;
 
@@ -16,12 +17,15 @@ import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
  * @author Luca Frosini (ISTI - CNR)
  */
 @RequestHeaders ({
-	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources")
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see <a href=\"https://dev.d4science.org/how-to-access-resources\">https://dev.d4science.org/how-to-access-resources</a>")
 })
 public class BaseREST {
 	
 	private final Logger logger = LoggerFactory.getLogger(this.getClass());
 	
+	@Context
+	protected HttpHeaders httpHeaders;
+	
 	@Context
 	protected UriInfo uriInfo;
 	

src/main/java/org/gcube/gcat/rest/Docs.java

@@ -1,52 +0,0 @@
-package org.gcube.gcat.rest;
-
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.InputStream;
-
-import javax.servlet.http.HttpServletRequest;
-import javax.ws.rs.GET;
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.Path;
-import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.Context;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Francesco Mangiacrapa (ISTI-CNR)
- * @author Luca Frosini (ISTI-CNR)
- */
-@Path("docs")
-public class Docs {
-
-	private static Logger logger = LoggerFactory.getLogger(Docs.class);
-
-	@GET
-	@Path("{any: .*}")
-	public InputStream toDoc(@Context HttpServletRequest req) throws WebApplicationException {
-		
-		String pathInfo = req.getPathInfo();
-		try {
-			
-			if (pathInfo.endsWith("/docs")) {
-				pathInfo += "/index.html";
-			}
-			
-			if (pathInfo.endsWith("/docs/")) {
-				pathInfo += "index.html";
-			}
-
-			logger.info("redirecting to {}", pathInfo);
-
-			String realPath = req.getServletContext().getRealPath(pathInfo);
-			return new FileInputStream(new File(realPath));
-
-		} catch (Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-	}
-
-}
-

src/main/java/org/gcube/gcat/rest/Item.java

@@ -11,6 +11,7 @@ import javax.ws.rs.Path;
 import javax.ws.rs.PathParam;
 import javax.ws.rs.Produces;
 import javax.ws.rs.QueryParam;
+import javax.ws.rs.core.MultivaluedMap;
 import javax.ws.rs.core.Response;
 import javax.ws.rs.core.Response.ResponseBuilder;
 import javax.ws.rs.core.Response.Status;
@@ -26,10 +27,20 @@ import org.gcube.gcat.persistence.ckan.CKANPackage;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
+import com.webcohesion.enunciate.metadata.rs.ResponseCode;
+import com.webcohesion.enunciate.metadata.rs.StatusCodes;
+
 /**
+ * Item is a set of metadata to describe a concept.
+ * An Item can has one or more <a href="./resource_Resource.html">Resource</a> attached.  
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Item.ITEMS)
+@ResourceGroup("Item APIs")
+@ResourceLabel("Item APIs")
 public class Item extends REST<CKANPackage> implements org.gcube.gcat.api.interfaces.Item<Response,Response> {
 	
 	private final Logger logger = LoggerFactory.getLogger(Item.class);
@@ -42,44 +53,380 @@ public class Item extends REST<CKANPackage> implements org.gcube.gcat.api.interf
 		super(ITEMS, ITEM_ID_PARAMETER, CKANPackage.class);
 	}
 	
+	/**
+	 * <p>
+	 * 	The listing API provides paginated results by using the query parameters limit and offset.<br/>
+	 * 	It returns an array list of string containing the ids (i.e. names) of the items.<br/>
+	 * 	Each name can be used as <code>{ITEM_ID}</code> path parameter to manage such item.
+	 * </p>
+	 * 
+	 * <h3>Filtering options</h3>
+	 * <p>
+	 * 	The listing method offers options to filter the results, thus enacting to search for items including spatial search (see ext_bbox below).<br/>
+	 * </p>
+	 * 
+	 * <h4>Basic Filtering options</h4>
+	 * <dl>
+	 * 	<dt>include_private (bool)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:false</em>.<br/>
+	 * 		If True, private datasets will be included in the results.<br/>
+	 * 		Only private datasets from the user’s organizations will be returned. 
+	 * 		For the sysadmins will be returned all private datasets.<br/>
+	 * 		E.g. <code>/items?include_private=true</code>
+	 * 	</dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">ext_bbox</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:null</em>.<br/>
+	 * 		The coordinates of the upper-right and bottom-left angle of a rectangular to query for.
+	 * 		The form is <code>Lat,Long,Lat,Long</code><br/>
+	 * 		E.g. <code>/items?limit=10&offset=0&q=Pollution&ext_bbox=-7.535093,49.208494,3.890688,57.372349</code> 
+	 * 		returns the first 10 items with 'Pollution' having a spatial coverage in the specified bounding box.
+	 * 	</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">own_only (bool)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:false</em>.<br/>
+	 * 		If True, only the items of the requester user will be included in the result.<br/>
+	 * 		E.g. <code>/items?limit=10&offset=0&own_only=true</code>
+	 * 	</dd>
+	 * </dl>
+	 * 
+	 * <h4>Filtering options based on Solr query parameters</h4>
+	 * <p>
+	 * 	It accepts the following query parameters (a subset of Solr search query parameters, see {@see <a href="https://solrtutorial.com/solr-query-syntax.html">Solr Query Syntax</a>}):
+	 * </p>
+	 * <dl>
+	 * 	<dt>q (string)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:"*:*"</em><br/>
+	 * 		The solr query.<br/>
+	 *  	E.g. <code>/items?q=title:foo</code> returns the items with word "foo" in the title.<br/>
+	 *  	E.g. <code>/items?q=extras_systemtype:MyProfile</code> returns the items having the profile <em>MyProfile</em> 
+	 *  </dd>
+	 * 
+	 *  <dt style="margin-top: 5px;">fq (string)</dt>
+	 *  <dd>
+	 *  	<em>Optional</em>.<em>Default:null</em>.<br/>
+	 *  	Filter query. A query string that limits the query results without influencing their scores.<br/>
+	 *  	E.g. <code>/items?q=title:foo&fq=notes:bar</code> returns with word "foo" in the 'title' and the word "bar" in the 'notes'.
+	 * 	</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">fq_list (list of strings)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:null</em>.<br/>
+	 * 		Additional filter queries to apply.<br/>
+	 * 		E.g. <code>/items?q=title:foo&fq_list=...</code> returns the items with word "foo" in the 'title'.
+	 * 	</dd> 
+	 * 
+	 * 	<dt style="margin-top: 5px;">sort (string)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:"relevance asc, metadata_modified desc"</em>.<br/>
+	 * 		Sorting of the search results.<br/> 
+	 * 		As per the solr documentation, this is a comma-separated string of field names and sort-orderings.<br/>
+	 * 		E.g. <code>/items?q=title:foo&sort=name+asc</code> returns the items with word "foo" in the 'title' 
+	 * 		sorting the results by name ascending.
+	 * 	</dd>
+	 * <dl>
+	 * 
+	 * <h4>Moderated Catalogue filtering options</h4>
+	 * <dl>
+	 * 	<dt>status (enum)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:null</em>.<br/>
+	 * 		
+	 * 		<span style="font-weight:bold;">It has sense only for moderated catalogues</span>.<br/>
+	 * 		When no value is provided, it returns both the items which have been published before the activation of the moderation, 
+	 * 		as well as the items explicitly <code>approved</code> after the moderation activation.
+	 * 
+	 * 		It can assume the following values:
+	 * 		<ul>
+	 * 			<li><code>pending</code>: it returns only the pending items, i.e. the item published by any allowed users and still not <span style="font-weight:bold;">Catalogue-Moderator</span>;</li>
+	 * 			<li><code>rejected</code>: it returns only the rejected items, i.e. the item published by any allowed users and rejected by a <span style="font-weight:bold;">Catalogue-Moderator</span>;</li>
+	 * 			<li><code>approved</code>: it returns only the approved items, i.e. the item published by any allowed users and approved by a <span style="font-weight:bold;">Catalogue-Moderator</span>.</li>
+	 * 		</ul>
+	 * 
+	 * 		<p>
+	 * 			Please note that only Catalogue-Moderators can filter all items by status.<br />
+	 * 			Other users using this query parameter will get only its own items with such a status in the results. 
+	 * 		</p>
+	 * 	</dd>
+	 * </dl>
+	 * 
+	 * 
+	 * <h3>Query results options</h3>
+	 * <p>
+	 * 	The result is by default an array list of string containing the ids (i.e. names) of the items.
+	 * 	Anyway, there are two options to get a different results.
+	 * </p>
+	 * <dl>
+	 * 	<dt>count (bool)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:false</em>.<br/>
+	 * 		If True, it indicates that the result must contains only the total number of items of the query.<br/>
+	 * 		E.g. <code>/items?limit=10&offset=0&count=true</code>
+	 * 	</dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">all_fields (bool)</dt>
+	 * 	<dd>
+	 * 		<em>Optional</em>.<em>Default:false</em>.
+	 * 		If True, the returned array list contains the whole item representation and not only the id (i.e. the name).</br/>
+	 * 		E.g. <code>/items?limit=10&offset=0&all_fields=true</code>
+	 * 	</dd>
+	 * </dl>
+	 * <p>
+	 * 	Please note that, <code>count</code> query parameter has priority over <code>all_fields</code> query parameter.
+	 * 	In other words,  <code>all_fields</code> query parameter is not considered is <code>count</code> query parameter is true.
+	 * </p> 
+	 * 
+	 * 
+	 * @param limit (<em>Default:10</em>) To get unlimited results the limit query parameters must be set to -1. 
+	 * 	If the results are too much the operation could fail. 
+	 * 	It is recommended to request no more than 1000 results. 
+	 * @param offset (<em>Default:0</em>) The offset parameter indicates the starting position of the result.
+	 * @return It returns an array list of string containing the ids (i.e. names) of the items.
+	 * 	E.g.<pre>["item0","items1",...,"item10"]</pre>
+	 * 	
+	 * 	In the case the query parameter <code>count=true</code> it returns the total number of items of the query.
+	 *  E.g. <pre>{"count":148}</pre>
+	 *  
+	 *  In the case the query parameter <code>all_fields=true</code> each element of the resulting array contains the item representation: 
+	 *  E.g.
+	 *  <pre>
+	 *  [
+	 *  	{
+	 *  		"name"="item0",
+	 *  		...,
+	 *  		"private": false,
+	 *  		"license_url": "http://www.opensource.org/licenses/AFL-3.0"
+	 *  	},
+	 *  	{
+	 *  		"name"="item1",
+	 *  		...,
+	 *  		"private": true,
+	 *  		"license_url": "http://www.opensource.org/licenses/AFL-3.0"
+	 *  	},
+	 *  	...,
+	 *  	{
+	 *  		"name"="itemN",
+	 *  		...,
+	 *  		"private": false,
+	 *  		"license_url": "http://www.opensource.org/licenses/AFL-3.0"
+	 *  	}
+	 *  
+	 *  ]</pre>
+	 *  
+	 *  @pathExample /items?limit=10&offset=0
+	 *  @responseExample application/json;charset=UTF-8 ["item0","items1",...,"item10"]
+	 */
 	@GET
-	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@Produces({GCatConstants.APPLICATION_JSON_CHARSET_UTF_8, GCatConstants.APPLICATION_JSON_API})
+	@StatusCodes ({
+		@ResponseCode ( code = 200, condition = "The request succeeded.")
+	})
 	/* Catalogue-Member is not added to VRE members and is assumed as the default role in the catalogue for the VRE members. So we can't enforce
 	 * @AuthorizationControl(allowedRoles={Role.CATALOGUE_MEMBER, Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	 */
-	public String list(@QueryParam(GCatConstants.LIMIT_PARAMETER) @DefaultValue("10") int limit,
-			@QueryParam(GCatConstants.OFFSET_PARAMETER) @DefaultValue("0") int offset, 
-			@QueryParam(GCatConstants.COUNT_PARAMETER) @DefaultValue("false") Boolean countOnly) {
-		if(countOnly) {
-			CKANPackage ckan = getInstance();
-			int count = ckan.count();
-			return createCountJson(count);
-		}else {
-			return list(limit, offset);
-		}
-	}
-	
-	/*
-	 * Not used as REST method, implemented to respect {@link org.gcube.gcat.api.interfaces.Item} interface
-	 */
 	@Override
-	public String list(@QueryParam(GCatConstants.LIMIT_PARAMETER) @DefaultValue("10") int limit,
-			@QueryParam(GCatConstants.OFFSET_PARAMETER) @DefaultValue("0") int offset) {
-		return super.list(limit, offset);
+	public String list(@QueryParam(GCatConstants.LIMIT_QUERY_PARAMETER) @DefaultValue("10") int limit,
+			@QueryParam(GCatConstants.OFFSET_QUERY_PARAMETER) @DefaultValue("0") int offset) {
+		
+		Boolean countOnly = false;
+		MultivaluedMap<String,String> queryParameters = uriInfo.getQueryParameters();
+		if(queryParameters.containsKey(GCatConstants.COUNT_QUERY_PARAMETER)) {
+			countOnly = Boolean.parseBoolean(queryParameters.get(GCatConstants.COUNT_QUERY_PARAMETER).get(0));
+		}
+		
+		String ret = null;
+		
+		if(countOnly) {
+			setCalledMethod("GET /" + COLLECTION_PARAMETER);
+			CKANPackage ckan = getInstance();
+			int size = ckan.count();
+			ret = createCountJson(size);
+		}else {
+			ret = super.list(limit, offset);
+		}
+		
+		String accept = httpHeaders.getHeaderString("Accept");
+		if(accept!=null && accept.contains(GCatConstants.APPLICATION_JSON_API)) {
+			return resultAsJsonAPI(ret);
+		}
+		return ret;
 	}
 	
+	/**
+	 * 
+	 * The create API allows to create an item.
+	 * An Item is mainly described by the following attributes (* indicate mandatory attributes):
+	 *  
+	 * <dl>
+	 * 	<dt>name* (string)</dt>
+	 * 	<dd>
+	 * 		the name of the new item, must be between 2 and 100 characters long 
+	 * 		and contain only lowercase alphanumeric characters, '-' and '_';
+	 * </dd>
+	 * 
+	 * 	
+	 *  <dt style="margin-top: 5px;">title (string)</dt>
+	 *  <dd>
+	 *  	If not specified it assumes the same value of <em>name</em> attribute.
+	 *  	The title of the item;  	
+	 *  </dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">maintainer (string)</dt>
+	 *  <dd>the name of the item’s maintainer;</dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">maintainer_email (string)</dt>
+	 *  <dd>the email address of the item’s maintainer;</dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">license_id* (string)</dt>
+	 *  <dd>the id of the item’s license, use <a href="resource_License.html">License listing</a> API to get available values;</dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">notes (string)</dt>
+	 *  <dd>a description of the item;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">url (string)</dt>
+	 *  <dd>a URL for the item’s source;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">version (string)</dt>
+	 *  <dd>must be between no longer than 100 characters</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">state (string, default='active')</dt>
+	 *  <dd>
+	 *  	the current state of the item, e.g. 'active' or 'deleted', only active items show up in search results and other lists of items, 
+	 *  	this parameter will be ignored if you are not authorized to change the state of the item;
+	 * 	</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">groups (list of dictionaries)</dt>
+	 *  <dd>
+	 *  	the groups to which the item belongs, each group dictionary should have one or more of the 
+	 *  	following keys which identify an existing group: 
+	 *  	'id' (the id of the group, string), or 'name' (the name of the group, string).
+	 *  	To see which groups exist use <a href="resource_Group.html#resource_Group_list_limit_offset_countOnly_GET">Group listing</a> API.</dd>
+	 * 	</dd>
+	 * 
+	 *  <dt style="margin-top: 5px;">tags (list of tag dictionaries)</dt>
+	 *  <dd>
+	 *  	the item’s tags. The tag is a dictionary in the format:
+	 *  	name : the name for the tag, i.e. a string between 2 and 100 characters long containing only alphanumeric characters and '-', '_' and '.'.
+	 *  </dd>
+	 *  
+	 * 
+	 *  <dt style="margin-top: 5px;">resources (list of resource dictionaries)</dt>
+	 *  <dd>the item’s resources, see <a href="resource_Resource.html">Resource collection</a> for the format of resource dictionaries;</dd>
+	 *  
+	 * 
+	 *  <dt style="margin-top: 5px;">extras (list of item extra dictionaries)</dt>
+	 *  <dd>the item’s extras, extras are arbitrary (key: value) metadata items that can be added to items, each extra dictionary should have keys 'key' (a string), 'value' (a string);</dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">owner_org (string)</dt>
+	 *  <dd>
+	 *  	the id of the item’s owning organization, see <code>supportedOrganizations</code> property in
+	 *  	<a href="resource_Configuration.html#resource_Configuration_read_context_GET">Read Configuration</a>.
+	 *  	The <code>defaultOrganization</code> is used if the author does not specify the organization. 
+	 *  </dd>
+	 *  
+	 * </dl>
+	 * 
+	 * 
+	 * <h3>Parameter automatically managed:</h3>
+	 * <dl>
+	 * 
+	 *  <dt>author (string)</dt>
+	 *  <dd>the name of the item’s author (the owner of the gcube-token);</dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">author_email (string)</dt>
+	 *  <dd>the email address of the item’s author (the email of the owner of gcube-token);</dd>
+	 *   
+	 * </dl> 
+	 * 
+	 * 
+	 * <h3>Geo-Indexing your datasets:</h3>
+	 * <p>
+	 * 	In order to make an Item searchable by location, it must have a special extra, with its key named ‘spatial’. 
+	 * 	The value must be a valid GeoJSON geometry, for example:
+	 * </p>
+	 * <pre>
+	 * 	{
+	 * 		"type":"Polygon",
+	 * 		"coordinates":[[[2.05827, 49.8625],[2.05827, 55.7447], [-6.41736, 55.7447], [-6.41736, 49.8625], [2.05827, 49.8625]]]
+	 * 	}
+	 * </pre>
+	 * 
+	 * or
+	 * 
+	 * <pre>
+	 * 	{
+	 * 		"type": "Point",
+	 * 		"coordinates": [-3.145,53.078]
+	 * 	}
+	 * </pre>
+	 * 
+	 * 
+	 * <h3>Profile</h3>
+	 * <p>
+	 * 	If at least one profile has been defined within this context, then you need to specify the profile's 
+	 * 	type when creating the item. 
+	 * 	You need to insert, among the extras of the JSON object describing the item, a <code>system:type</code> 
+	 * 	property with one of the available profile, see <a href="resource_Profile.html#resource_Profile_listOrCount_countOnly_GET">List Profiles</a> API.
+	 * 	The validation of the submitted request will be performed against the profile whose type has been specified. 
+	 * 	The profile's properties need to be specified within the extras field as well.
+	 * </p>
+	 * <p>
+	 * 	If no profile has been defined, then no validation will be performed. 
+	 * 	Thus you do not need to set any <code>system:type</code> property.
+	 * </p>
+	 * 
+	 * <h3>Social Post</h3>
+	 * <p>
+	 * 	The user is going to crreate an item can indicate if he/she desires the creation of a social post 
+	 * 	to inform all the users of the VRE that he/she has created the item.</br>
+	 * 	To request the social post he/she must indicate <code>social_post=true</code> query parameter.<br/>
+	 * 	The <code>social_post</code> query parameter is optional and the default value is <code>false</code>.<br/>
+	 * 	Please note that even the user indicates <code>social_post=true</code> the social post 
+	 * 	is create only and only if the Catalogue-Manager enabled this feature, see <code>socialPostEnabled</code> property in
+	 *  <a href="resource_Configuration.html#resource_Configuration_read_context_GET">Read Configuration</a>.
+	 *  When the social post is created the a notification to the VRe user is sent if the property
+	 *  <code>notificationToUsersEnabled</code> is true in the above mentioned configuration.
+	 *  If false <code>notificationToUsersEnabled=false</code> the social post will not produce a notification
+	 *  to the VRE user which will be only informed about the item pubblication by reading the generated
+	 *  social post in the VRE.  
+	 * </p> 
+	 * 
+	 * 
+	 * @param json containing the item to be created
+	 * @return <code>201 Created</code> HTTP Status to indicate that the item has been created.
+	 * 	Some operation could continue in background such as the social post creation.
+	 * 
+	 * @pathExample /items?social_post=true
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/create-item-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/create-item-response.json
+	 * 
+	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 201, condition = "The item has been created successfully.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response create(String json) {
 		return super.create(json);
 	}
 	
+	/**
+	 * @pathExample /items/my_test_item
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/read-item-response.json
+	 */
 	@GET
 	@Path("/{" + ITEM_ID_PARAMETER + "}")
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 200, condition = "The item exists.")
+	})
 	@Override
 	/* Catalogue-Member is not added to VRE members and is assumed as the default role in the catalogue for the VRE members. So we can't enforce
 	 * @AuthorizationControl(allowedRoles={Role.CATALOGUE_MEMBER, Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
@@ -88,28 +435,54 @@ public class Item extends REST<CKANPackage> implements org.gcube.gcat.api.interf
 		return super.read(id);
 	}
 	
+	/**
+	 * Any Catalogue-Admins or above is capable of modifying the authorship of the item.<br/>
+	 * The service does not perform any checks on author information provided by the user.
+	 * 
+	 * @pathExample /items/my_test_item
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/update-item-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/update-item-response.json
+	 */
 	@PUT
 	@Path("/{" + ITEM_ID_PARAMETER + "}")
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 200, condition = "The item has been updated successfully.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public String update(@PathParam(ITEM_ID_PARAMETER) String id, String json) {
 		return super.update(id, json);
 	}
 	
+	/**
+	 * @pathExample /items/my_test_item
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/patch-item-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/patch-item-response.json
+	 */
 	@PATCH
 	@Path("/{" + ITEM_ID_PARAMETER + "}")
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 200, condition = "The item has been patched successfully.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public String patch(@PathParam(ITEM_ID_PARAMETER) String id, String json) {
 		return super.patch(id, json);
 	}
 	
+	/**
+	 * @pathExample /items/my_test_item
+	 */
 	@DELETE
 	@Path("/{" + ITEM_ID_PARAMETER + "}")
+	@StatusCodes ({
+		@ResponseCode ( code = 204, condition = "The item has been deleted successfully."),
+		@ResponseCode ( code = 404, condition = "The item was not found.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response delete(@PathParam(ITEM_ID_PARAMETER) String id,
@@ -117,8 +490,15 @@ public class Item extends REST<CKANPackage> implements org.gcube.gcat.api.interf
 		return super.delete(id, purge);
 	}
 	
+	/**
+	 * @pathExample /items/my_test_item
+	 */
 	@PURGE
 	@Path("/{" + ITEM_ID_PARAMETER + "}")
+	@StatusCodes ({
+		@ResponseCode ( code = 204, condition = "The item has been purged successfully."),
+		@ResponseCode ( code = 404, condition = "The item was not found.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response purge(@PathParam(ITEM_ID_PARAMETER) String id) {
@@ -142,8 +522,54 @@ public class Item extends REST<CKANPackage> implements org.gcube.gcat.api.interf
 		thread.start();
 	}
 	
+	/**
+	 * <p>
+	 * 	The bulk delete API provides a way to delete all the items matching certain criteria 
+	 * 	(see Filtering Listing options).
+	 * 	The operation returns immediately to the client and continues in background.
+	 * 	There is no way to monitor or stop the running operation.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	When invoked with no arguments, it deletes all the items of the invoking user in the default 
+	 * 	CKAN organization for the current context.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	If a <em>Catalogue-Admin</em> or above specifies the query parameter <em>own_only=false</em> 
+	 * 	it deletes all the items of all users for the CKAN organization for the current context. 
+	 * 	The service ignores the query parameter <em>own_only=false</em> if the requesting user is not 
+	 * 	Catalogue-Admin or above.
+	 * </p>
+	 * 
+	 * <p style="font-weight:bold;">
+	 * 	Please check the result using the items listing APIs to verify what you will delete.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	The deleted items are moved to the thrash by default.
+	 * 	To completely remove the items (i.e. purge) the user can use the query parameter <em>purge=true</em>.
+	 * 	<span style="font-weight:bold;">Please note that the purge action is not reversible.</span>
+	 * </p>
+	 * 
+	 * <p>
+	 * 	By indicating the query parameter <em>purge=true</em> has the same result of using the bulk 
+	 * 	purge API using the <code>PURGE</code> HTTP Method.
+	 * </p>
+	 * 
+	 * @param purge <em>(Default:false)</em> it completely removes all the items in the default CKAN organization.
+	 * @return <code>202 Accepted</code> HTTP Status to indicate that the request has been properly take in charge.
+	 * 	The operation will continue in background.
+	 * @throws WebServiceException if an error occurs.
+	 * 
+	 * @pathExample /items?purge=false
+	 * 
+	 */
 	@DELETE
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 202, condition = "The bulk delete/purge has been accepted successfully.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response bulkDelete(@QueryParam(GCatConstants.PURGE_QUERY_PARAMETER) @DefaultValue("false") boolean purge) {
@@ -151,18 +577,96 @@ public class Item extends REST<CKANPackage> implements org.gcube.gcat.api.interf
 		return Response.status(Status.ACCEPTED).build();
 	}
 	
+	/**
+	 * <p>
+	 * 	The bulk purge API provides a way to completely remove all the items matching certain criteria 
+	 * 	(see Filtering Listing options). Please note that this action is not reversible.
+	 * 	The operation returns immediately to the client and continues in background.
+	 *	There is no way to monitor or stop the running operation.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	When invoked with no arguments, it purges all the items of the invoking user in the default 
+	 * 	CKAN organization for the current context.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	If a Catalogue-Admin or above specifies the query parameter <em>own_only=false</em>,
+	 * 	it purges all the items of all users for the CKAN organization for the current context. 
+	 * 	The service ignores the query parameter <em>own_only=false</em> if the requesting user is not 
+	 * 	Catalogue-Admin or above.
+	 * </p>
+	 * 
+	 * <p style="font-weight:bold;">
+	 * 	Please check the result using the items listing APIs to verify what you will purge.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	Invoking this API has the same result of using the bulk delete API using the <code>DELETE</code> HTTP Method
+	 *  with the query parameters <em>purge=true</em>.
+	 * </p>
+	 * 
+	 * @return <code>202 Accepted</code> HTTP Status to indicate that the request has been 
+	 * 	properly taken in charge.<br />
+	 * 	The operation will continue in background.
+	 * 
+	 * @throws WebServiceException if an error occurs.
+	 * 
+	 * @pathExample /items
+	 */
 	@PURGE
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 202, condition = "The bulk purge has been accepted successfully.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response bulkPurge() {
 		return bulkDelete(true);
 	}
 	
+	/**
+	 * 
+	 * @param id the name of the item to moderate
+	 * @param json It contains the moderation action to perform on the item.
+	 * 
+	 * <p>The format is the following</p>
+	 * 
+	 * <pre>
+	 * 	{
+	 * 		"system:cm_item_status":"approved",
+	 * 		"message": "..."
+	 * 	}
+	 * </pre>
+	 *  
+	 * <p>
+	 * 	The field <code>system:cm_item_status</code> can have 
+	 * 	the following values: <code>approved</code> or <code>rejected</code>, indicating the 
+	 * 	item's new status.<br />
+	 * 	It is possible to send an optional message together with the new status by adding 
+	 * 	the field <code>message</code>.<br />
+	 * 	This operation is available for Catalogue-Moderator only.
+	 * </p>
+	 * 
+	 * <p>
+	 * 	Catalogue-Moderator and item author can send just a message to discuss 
+	 *  the approval of the item by indicating the field <code>message</code> only.
+	 * </p>
+	 * 
+	 * @return <code>202 Accepted</code> HTTP Status to indicate that the request has been 
+	 * 	properly taken in charge.<br />
+	 * 	The operation will continue in background.
+	 * 
+	 * @pathExample /items/my_test_item
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/item/reject.json
+	 */
 	@POST
 	@Path("/{" + ITEM_ID_PARAMETER + "}")
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@StatusCodes ({
+		@ResponseCode ( code = 202, condition = "The moderation operation has been accepted successfully.")
+	})
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER, Moderated.CATALOGUE_MODERATOR}, exception=NotAuthorizedException.class)
 	public Response moderate(@PathParam(ITEM_ID_PARAMETER) String id, String json) {
 		setCalledMethod("POST /" + COLLECTION_PARAMETER + "/{" + ID_PARAMETER + "}");

src/main/java/org/gcube/gcat/rest/License.java

@@ -3,24 +3,47 @@ package org.gcube.gcat.rest;
 import javax.ws.rs.GET;
 import javax.ws.rs.Path;
 import javax.ws.rs.Produces;
+import javax.ws.rs.core.MediaType;
+import javax.xml.ws.WebServiceException;
 
 import org.gcube.gcat.api.GCatConstants;
 import org.gcube.gcat.persistence.ckan.CKANLicense;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
+
 /**
+ * A collection to interact with licenses that are available in the catalogue.
+ * A license is associated with items to define the legal right
+ * to use such an item.
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(License.LICENSES)
+@ResourceGroup("Item Related APIs")
+@ResourceLabel("License APIs")
 public class License extends REST<CKANLicense> implements org.gcube.gcat.api.interfaces.License {
 	
 	public License() {
 		super(LICENSES, null, CKANLicense.class);
 	}
 	
+	/**
+	 * @return the json array containing the licenses available in the catalogue
+	 * 
+	 * @pathExample /licenses
+	 * @responseExample application/json classpath:/api-docs-examples/license/list-license-response.json
+	 */
 	@GET
-	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
-	public String list() {
-		return super.list(-1, -1);
+	@Produces({MediaType.APPLICATION_JSON,GCatConstants.APPLICATION_JSON_API})
+	public String list() throws WebServiceException {
+		String ret = super.list(-1, -1);
+		
+		String accept = httpHeaders.getHeaderString("Accept");
+		if(accept!=null && accept.contains(GCatConstants.APPLICATION_JSON_API)) {
+			return resultAsJsonAPI(ret);
+		}
+		return ret;
 	}
 	
 }

src/main/java/org/gcube/gcat/rest/Namespace.java

@@ -6,22 +6,35 @@ import javax.ws.rs.GET;
 import javax.ws.rs.InternalServerErrorException;
 import javax.ws.rs.Path;
 import javax.ws.rs.Produces;
+import javax.ws.rs.core.MediaType;
 
 import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
 import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
 import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
 import org.gcube.datacatalogue.metadatadiscovery.bean.jaxb.NamespaceCategory;
-import org.gcube.gcat.api.GCatConstants;
 import org.gcube.gcat.profile.MetadataUtility;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
+
 /**
+ * A namespace defines a logical grouping for metadata contained in items.
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Namespace.NAMESPACES)
+@ResourceGroup("Item Related APIs")
+@ResourceLabel("Namespace APIs")
 public class Namespace extends BaseREST implements org.gcube.gcat.api.interfaces.Namespace {
 	
+	/**
+	 * @return the json array containing the licenses available in the catalogue
+	 * 
+	 * @pathExample /namespaces
+	 * @responseExample application/json classpath:/api-docs-examples/namespace/list-namespace-response.json
+	 */
 	@GET
-	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@Produces(MediaType.APPLICATION_JSON)
 	public String list() {
 		setCalledMethod("GET /" + NAMESPACES);
 		

src/main/java/org/gcube/gcat/rest/Profile.java

@@ -5,7 +5,6 @@ import javax.ws.rs.Consumes;
 import javax.ws.rs.DELETE;
 import javax.ws.rs.DefaultValue;
 import javax.ws.rs.GET;
-import javax.ws.rs.HeaderParam;
 import javax.ws.rs.HttpMethod;
 import javax.ws.rs.InternalServerErrorException;
 import javax.ws.rs.NotAllowedException;
@@ -16,12 +15,10 @@ import javax.ws.rs.PathParam;
 import javax.ws.rs.Produces;
 import javax.ws.rs.QueryParam;
 import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.Context;
 import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 import javax.ws.rs.core.Response.ResponseBuilder;
 import javax.ws.rs.core.Response.Status;
-import javax.ws.rs.core.UriInfo;
 
 import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
 //import org.gcube.common.authorization.control.annotations.AuthorizationControl;
@@ -31,10 +28,19 @@ import org.gcube.gcat.api.GCatConstants;
 import org.gcube.gcat.profile.ISProfile;
 import org.xml.sax.SAXException;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
+import com.webcohesion.enunciate.metadata.rs.ResponseCode;
+import com.webcohesion.enunciate.metadata.rs.StatusCodes;
+
 /**
+ * A profile defines a type and the schema any item of such a type must comply with.
+ *  
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Profile.PROFILES)
+@ResourceGroup("Item Related APIs")
+@ResourceLabel("Profile APIs")
 public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.Profile<Response,Response> {
 	
 	public static final String PROFILE_NAME_PARAMETER = "PROFILE_NAME";
@@ -53,9 +59,6 @@ public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.P
 		PROFILE_VALIDATION_ERROR = validationError.toString();
 	}
 	
-	@Context
-	private UriInfo uriInfo;
-	
 	/*
 	 * Not used as REST method, implemented to respect {@link org.gcube.gcat.api.interfaces.Item} interface
 	 */
@@ -72,13 +75,25 @@ public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.P
 		}
 	}
 	
+	/**
+	 * Returns the list of profiles name available for the 
+	 * context of the request 
+	 * (i.e. the context where the token has been generated).
+	 * 
+	 * @param count (<em>Default:false</em>) If <code>count=true</code> the API returns total number of profile instead of the list.
+	 * @return a JSON Array. 
+	 * 
+	 * @pathExample /profiles
+	 * @responseExample application/json ["EmptyProfile","TestProfile","ComplexProfile"]
+	 * 
+	 */
 	@GET
 	@Produces(MediaType.APPLICATION_JSON)
-	public String listOrCount(@QueryParam(GCatConstants.COUNT_PARAMETER) @DefaultValue("false") Boolean countOnly) {
+	public String listOrCount(@QueryParam(GCatConstants.COUNT_QUERY_PARAMETER) @DefaultValue("false") Boolean count) {
 		setCalledMethod("GET /" + PROFILES);
 		try {
 			ISProfile isProfile = new ISProfile();
-			if(countOnly) {
+			if(count) {
 				return createCountJson(isProfile.count());
 			}else{
 				ArrayNode arrayNode = isProfile.list();
@@ -109,11 +124,32 @@ public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.P
 	
 	public static int PRETTY_PRINT_INDENT_FACTOR = 4;
 	
+	/**
+	 * This API allow to read a profile definition.<br/>
+	 * 
+	 * This API return by default the content in XML.
+	 * <p>
+	 * 	It is possible reading a profile in JSON by specifing the HTTP Header:<br/>
+	 * 	<code>Accept: application/json</code>
+	 * </p> 
+	 *
+	 * @param name the name of the profile
+	 * @return the profile definition
+	 * 
+	 * @pathExample /profiles/EmptyProfile
+	 * @responseExample application/xml classpath:/api-docs-examples/profile/read-profile-response.xml
+	 * 
+	 * @pathExample /profiles/EmptyProfile
+	 * @responseExample application/json classpath:/api-docs-examples/profile/read-profile-response.json
+	 */
 	@GET
 	@Path("/{" + PROFILE_NAME_PARAMETER + "}")
-	@Produces({MediaType.APPLICATION_XML, GCatConstants.APPLICATION_JSON_CHARSET_UTF_8})
-	public String read(@PathParam(PROFILE_NAME_PARAMETER) String name,
-			@DefaultValue(MediaType.APPLICATION_XML) @HeaderParam("Accept") String accept) {
+	@Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
+	@StatusCodes ({
+		@ResponseCode ( code = 200, condition = "The profile exists.")
+	})
+	@Override
+	public String read(@PathParam(PROFILE_NAME_PARAMETER) String name) { 
 		setCalledMethod("GET /" + PROFILES + "/{" + PROFILE_NAME_PARAMETER + "}");
 		try {
 			// If the name is SCHEMA 
@@ -121,10 +157,12 @@ public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.P
 				return DataCalogueMetadataFormatReader.getProfileSchemaString();
 			}
 			
+			String accept = httpHeaders.getHeaderString("Accept");
+			
 			ISProfile isProfile = new ISProfile();
-			boolean xml = false;
-			if(accept.startsWith(MediaType.APPLICATION_XML)) {
-				xml = true;
+			boolean xml = true;
+			if(accept.startsWith(MediaType.APPLICATION_JSON)) {
+				xml = false;
 			}
 			return isProfile.read(name, xml);
 		} catch(WebApplicationException e) {
@@ -134,6 +172,16 @@ public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.P
 		}
 	}
 	
+	/**
+	 * A profile must comply with the defined <a href="../profiles/SCHEMA">XSD schema</a> .
+	 * 
+	 * Please find the documentation of profile schema at:
+	 * at <a href="https://wiki.gcube-system.org/gcube/GCat_Background#Metadata_Profile_v.4">Metadata Profile</>
+	 * 
+	 * @param name
+	 * @param xml
+	 * @return
+	 */
 	@PUT
 	@Path("/{" + PROFILE_NAME_PARAMETER + "}")
 	@Consumes(MediaType.APPLICATION_XML)
@@ -193,11 +241,6 @@ public class Profile extends BaseREST implements org.gcube.gcat.api.interfaces.P
 		
 	}
 	
-	@Override
-	public String read(String name) {
-		return read(name, MediaType.APPLICATION_XML);
-	}
-	
 	@Override
 	public String update(String name, String xml) {
 		return createOrUpdate(name, xml).getEntity().toString();

src/main/java/org/gcube/gcat/rest/REST.java

@@ -1,6 +1,7 @@
 package org.gcube.gcat.rest;
 
 import javax.ws.rs.InternalServerErrorException;
+import javax.ws.rs.WebApplicationException;
 import javax.ws.rs.core.Response;
 import javax.ws.rs.core.Response.ResponseBuilder;
 import javax.ws.rs.core.Response.Status;
@@ -29,8 +30,10 @@ public class REST<C extends CKAN> extends BaseREST implements CRUD<Response,Resp
 			C ckan = reference.newInstance();
 			ckan.setUriInfo(uriInfo);
 			return ckan;
+		} catch (WebApplicationException e) {
+			throw e;
 		} catch(Exception e) {
-			throw new InternalServerErrorException();
+			throw new InternalServerErrorException(e);
 		}
 	}
 	
@@ -95,4 +98,12 @@ public class REST<C extends CKAN> extends BaseREST implements CRUD<Response,Resp
 		return delete(id, true);
 	}
 	
+	protected String resultAsJsonAPI(String data) {
+		StringBuffer stringBuffer = new StringBuffer();
+		stringBuffer.append("{ \"data\":");
+		stringBuffer.append(data);
+		stringBuffer.append("}");
+		return stringBuffer.toString();
+	}
+	
 }

src/main/java/org/gcube/gcat/rest/RequestFilter.java

@@ -32,7 +32,7 @@ public class RequestFilter implements ContainerRequestFilter, ContainerResponseF
 	public void filter(ContainerRequestContext requestContext) throws IOException {
 		logger.trace("PreMatching RequestFilter");
 		
-		SecretManagerProvider.instance.reset();
+		SecretManagerProvider.instance.remove();
 		SecretManager secretManager = new SecretManager();
 		
 		String token = AccessTokenProvider.instance.get();
@@ -48,14 +48,13 @@ public class RequestFilter implements ContainerRequestFilter, ContainerResponseF
 		}
 		
 		SecretManagerProvider.instance.set(secretManager);
-		
 	}
 
 	@Override
 	public void filter(ContainerRequestContext requestContext, ContainerResponseContext responseContext)
 			throws IOException {
 		logger.trace("ResponseFilter");
-		SecretManagerProvider.instance.reset();
+		SecretManagerProvider.instance.remove();
 	}
 
 }

src/main/java/org/gcube/gcat/rest/Resource.java

@@ -19,10 +19,18 @@ import org.gcube.gcat.api.GCatConstants;
 //import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANResource;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
+
 /**
+ * An Item's Resource is an URL (e.g. URL pointing to a file)
+ * and can exists only attached to an <a href="./resource_Item.html">item</a>.
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Resource.COLLECTION)
+@ResourceGroup("Item APIs")
+@ResourceLabel("Item's Resource APIs")
 public class Resource extends BaseREST implements org.gcube.gcat.api.interfaces.Resource<Response,Response> {
 	
 	protected static final String ITEM_ID_PARAMETER = Item.ITEM_ID_PARAMETER;
@@ -42,6 +50,39 @@ public class Resource extends BaseREST implements org.gcube.gcat.api.interfaces.
 		return ckanResource.list();
 	}
 	
+	/**
+	 * An Resource is mainly described by the following attributes (* indicate mandatory attributes):
+	 * 
+	 * <dl>
+	 * 	<dt>name* (string)</dt>
+	 * 	<dd>the name of the resource;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">url* (string)</dt>
+	 * 	<dd>url of resource;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">package_id* (string)</dt>
+	 * 	<dd>id of the item that the resource should be added to;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">revision_id (string)</dt>
+	 * 	<dd></dd>
+	 * 
+	 *	<dt style="margin-top: 5px;">description (string)</dt>
+	 * 	<dd>a description for the resource;</dd> 
+	 * 
+	 * 	<dt style="margin-top: 5px;">format (string)</dt>
+	 * 	<dd></dd>
+	 * 
+	 *  <dt style="margin-top: 5px;">mimetype (string)</dt>
+	 * 	<dd>resource mimetype;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">created (iso date string)</dt>
+	 * 	<dd>resource creation time;</dd>
+	 * 
+	 * 	<dt style="margin-top: 5px;">last_modified (iso date string)</dt>
+	 * 	<dd>resource last update time;</dd>
+	 * 
+	 * </dl>
+	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)

src/main/java/org/gcube/gcat/rest/Trash.java

@@ -7,6 +7,7 @@ import javax.ws.rs.GET;
 import javax.ws.rs.Path;
 import javax.ws.rs.Produces;
 import javax.ws.rs.QueryParam;
+import javax.ws.rs.core.MediaType;
 import javax.ws.rs.core.Response;
 import javax.ws.rs.core.Response.Status;
 import javax.xml.ws.WebServiceException;
@@ -17,15 +18,44 @@ import org.gcube.gcat.api.GCatConstants;
 //import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANPackageTrash;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
+import com.webcohesion.enunciate.metadata.rs.ResponseCode;
+import com.webcohesion.enunciate.metadata.rs.StatusCodes;
+
 /**
+ * This collection allow to interact with thrashed items
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Trash.TRASH)
+@ResourceGroup("Item Related APIs")
+@ResourceLabel("Trash APIs")
 public class Trash extends BaseREST implements org.gcube.gcat.api.interfaces.Trash<Response> {
 
-		
+	
+	/**
+	 * List the thrashed items.<br/>
+	 * By default, it lists only the trashed items of the requesting user.<br/>
+	 * 
+	 * The listed items belong to the supported organizations for the 
+	 * context of the request (i.e. the context where the token has been generated).<br/>
+	 *  
+	 * See <a href="./resource_Configuration.html">supportedOrganizations parameter in
+	 * Configuration</a>.
+	 * 
+	 * If the user specifies <code>own_only=false</code> and the user is
+	 * <em>Catalogue-Admin</em> or above it return the thrashed items of all the 
+	 * users for all the supported organizations. 
+	 * 
+	 * @param ownOnly indicates that the user is interested only in its own items or the items of all the users.
+	 * @return the json array containing the items in the trash
+	 * 
+	 * @pathExample /trash
+	 * @responseExample application/json ["item1","item54"]
+	 */
 	@GET
-	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
+	@Produces(MediaType.APPLICATION_JSON)
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public String list(@QueryParam(GCatConstants.OWN_ONLY_QUERY_PARAMETER) @DefaultValue("true") Boolean ownOnly) throws WebServiceException {
@@ -34,7 +64,34 @@ public class Trash extends BaseREST implements org.gcube.gcat.api.interfaces.Tra
 		return ckanPackageTrash.list();
 	}
 	
+	/**
+	 * Delete in background all items in the trash.<br/>
+	 * The operation returns immediately to the client and continues in background.<br/>
+	 * There is no way to monitor or stop the running operation.<br/>
+	 * The thrashed items cannot be recovered.</br/>
+	 * 
+	 * By default, it empty only the trashed items of the requesting user.<br/>
+	 * 
+	 * The listed items belong to the supported organizations for the 
+	 * context of the request (i.e. the context where the token has been generated).<br/>
+	 *  
+	 * See <a href="./resource_Configuration.html">supportedOrganizations parameter in
+	 * Configuration</a>.
+	 * 
+	 * If the user specifies <code>own_only=false</code> and the user is
+	 * <em>Catalogue-Admin</em> or above it empty the thrash of all the 
+	 * users for all the supported organizations. 
+	 * 
+	 * @param ownOnly indicates that the user is interested only in its own items or the items of all the users.
+	 * @return 202 Accepted if the request has been accepted successfully
+	 * @throws WebServiceException
+	 * 
+	 * @pathExample /trash
+	 */
 	@DELETE
+	@StatusCodes ({
+		@ResponseCode ( code = 202, condition = "The empty trash operation has been accepted successfully.")
+	})
 	@Override
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response empty(@QueryParam(GCatConstants.OWN_ONLY_QUERY_PARAMETER) @DefaultValue("true") Boolean ownOnly) throws WebServiceException {
@@ -50,7 +107,14 @@ public class Trash extends BaseREST implements org.gcube.gcat.api.interfaces.Tra
 		return Response.status(Status.ACCEPTED).build(); 
 	}
 	
+	/**
+	 * It is the same of 
+	 * <a href="resource_Trash.html#resource_Trash_empty_ownOnly_DELETE">DELETE</a> operation
+	 */
 	@PURGE
+	@StatusCodes ({
+		@ResponseCode ( code = 202, condition = "The empty trash operation has been accepted successfully.")
+	})
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response emptyViaPurge(@QueryParam(GCatConstants.OWN_ONLY_QUERY_PARAMETER) @DefaultValue("true") Boolean ownOnly) throws WebServiceException {
 		return empty(ownOnly); 

src/main/java/org/gcube/gcat/rest/administration/Configuration.java

@@ -1,4 +1,4 @@
-package org.gcube.gcat.rest;
+package org.gcube.gcat.rest.administration;
 
 import java.util.Iterator;
 
@@ -31,19 +31,30 @@ import org.gcube.gcat.annotation.PURGE;
 import org.gcube.gcat.api.GCatConstants;
 import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
-import org.gcube.gcat.configuration.ServiceCatalogueConfiguration;
+import org.gcube.gcat.configuration.service.ServiceCatalogueConfiguration;
 import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
+import org.gcube.gcat.persistence.ckan.cache.CKANUserCache;
+import org.gcube.gcat.rest.BaseREST;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 import com.webcohesion.enunciate.metadata.rs.ResponseCode;
 import com.webcohesion.enunciate.metadata.rs.StatusCodes;
+import com.webcohesion.enunciate.metadata.swagger.OperationId;
 
 /**
+ * The catalogue configuration for the context of the request 
+ * (i.e. the context where the token has been generated).
+ * 
+ * Only Catalogue-Managers are able to invoke non-safe methods.
+ *  
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Configuration.CONFIGURATIONS)
+@ResourceGroup("Administration APIs")
+@ResourceLabel("Configuration APIs")
 public class Configuration extends BaseREST implements org.gcube.gcat.api.interfaces.Configuration<Response,Response> {
 
 	private static Logger logger = LoggerFactory.getLogger(Configuration.class);
@@ -95,51 +106,123 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		}
 	}
 	
+	/**
+	 * This API allows to create the catalogue configuration for the 
+	 * context of the request (i.e. the context where the token has been generated)
+	 * using the json provided as request body.<br/>
+	 * 
+	 * Only a <a href="../docs/index.html#roles">Catalogue-Manager</a> can invoke this API.<br/>
+	 * 
+	 * The configuration will be persisted in the infrastructure 
+	 * Information System (IS) in the context of the request.<br/>
+	 *  * A Configuration is described by the following attributes: 
+	 *	
+	 * <dl>
+	 * 	
+	 * 	<dt>context (string)</dt>
+	 * 	<dd>it must contains the same value of requesting context;</dd>
+	 *	
+	 *	<dt style="margin-top: 5px;">defaultOrganization (string)</dt>
+	 *  <dd>
+	 *  	the default ckan organization where an item is created for 
+	 *  	the context of the request;
+	 *  </dd>
+	 *	
+	 *	<dt style="margin-top: 5px;">supportedOrganizations (array of string)</dt>
+	 *  <dd>
+	 *  	it defines the list of organization where an item can be created.
+	 *  	All the organizations must be present in the catalogue of the VRE.  
+	 *  	It must contains at least the defaultOrganization value;
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">sysAdminToken (string)</dt>
+	 *  <dd>
+	 *  	the token can be provided encrypted with the context key as well as plain. 
+	 *  	It any case it is persisted encrypted in IS;
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">ckanURL (string)</dt>
+	 *  <dd>
+	 *  	the Ckan URL used for the catalogue of the VRE.
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">solrURL (string)</dt>
+	 *  <dd>
+	 *  	the Solr URL used by the Ckan instance.
+	 *  	This is normally, but not necessary, the same URL of Ckan plus the path <code>/solr</code>
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">socialPostEnabled (bool)</dt>
+	 *  <dd>
+	 *  	it indicates if the social posts are enabled in the context of the request.
+	 *  	The creation of a social post can be requested by a user when he/she creates 
+	 *  	an item;
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">notificationToUsersEnabled (bool)</dt>
+	 *  <dd>
+	 *  	it indicates if a notification must be created when a social post
+	 *  	is created. It is ignored if <code>socialPostEnabled=false</code>;
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">moderationEnabled (bool)</dt>
+	 *  <dd>
+	 *  	it indicates if the catalogue is moderated. 
+	 *  	See <a href="../docs/index.html#moderated-catalogues">Moderated Catalogues</a>
+	 *  </dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">ckanDB (object)</dt>
+	 *  <dd>
+	 *  	it contains the url, username and password to contact the db used by the 
+	 *  	Ckan instance used for the catalogue of the VRE.
+	 *  	The password can be provided encrypted with the context key as well as plain. 
+	 *  	It any case it is persisted encrypted in IS.
+	 *  </dd>
+	 *  
+	 * </dl>
+	 * 
+	 * Here is an example
+	 * 
+	 * <pre>
+	 * {
+	 *	"context": "/gcube/devsec/devVRE",
+	 *	"defaultOrganization": "devvre",
+	 *	"supportedOrganizations": [ "devvre" "nextnext" ],
+	 *	"sysAdminToken": "SYS_ADMIN_TOKEN_HERE",
+	 *	"ckanURL": "https://ckan-d-d4s.d4science.org",
+	 *	"solrURL": "https://ckan-d-d4s.d4science.org/solr/",
+	 *	"socialPostEnabled": false,
+	 *	"notificationToUsersEnabled": true,
+	 *	"moderationEnabled": true,
+	 *	"ckanDB": {
+	 *		"url": "jdbc:postgresql://ckan-d-d4s.d4science.org:5432/ckan_dev",
+	 *		"username": "ckan",
+	 *		"password": "PWD_HERE"
+	 *	}
+	 * }
+	 * </pre>
+	 * 
+	 * 
+	 * @param json the configuration representation
+	 * @return the created configuration
+	 * @throws WebServiceException when the request fails
+	 * 
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/create-configuration-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/create-configuration-response.json
+	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
-	@Override
-//	@AuthorizationControl(allowedRoles={Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	@StatusCodes ({
 		@ResponseCode(code = 201, condition = "Catalogue configuration successfully created."),
 		@ResponseCode(code = 401, condition = "Only Catalogue-Managers can create catalogue configuration."),
 		@ResponseCode(code = 500, condition = "Error while persisting catalogue configuration."),
 	})
-	/**
-	 * Creates the catalogue configuration for the current context using the json provided as parameter
-	 * @param json the configuration representation
-	 * 
-	 *	{
-	 *		"id": "584b8503-a490-4a89-8372-e21830fa716c",
-	 *		"context": "/gcube/devsec/devVRE",
-	 *		"defaultOrganization": "devvre",
-	 *		"supportedOrganizations": [ "devvre" ],
-	 *		"ckanURL": "https://ckan-d-d4s.d4science.org",
-	 *		"solrURL": "https://ckan-d-d4s.d4science.org/solr/",
-	 *		"socialPostEnabled": false,
-	 *		"notificationToUsersEnabled": true,
-	 *		"moderationEnabled": true
-	 *	}
-	 * 
-	 * @return the created configuration
-	 * 
-	 * 	{
-	 *		"id": "584b8503-a490-4a89-8372-e21830fa716c",
-	 *		"context": "/gcube/devsec/devVRE",
-	 *		"defaultOrganization": "devvre",
-	 *		"supportedOrganizations": [ "devvre" ],
-	 *		"ckanURL": "https://ckan-d-d4s.d4science.org",
-	 *		"solrURL": "https://ckan-d-d4s.d4science.org/solr/",
-	 *		"socialPostEnabled": false,
-	 *		"notificationToUsersEnabled": true,
-	 *		"moderationEnabled": true
-	 *	}
-	 *  
-	 * @throws WebServiceException
-	 */
+	@Override
+//	@AuthorizationControl(allowedRoles={Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response create(String json) throws WebServiceException {
 		try {
-			ServiceCatalogueConfiguration catalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(json);
+			ServiceCatalogueConfiguration catalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(json, ServiceCatalogueConfiguration.class);
 			checkContext(CURRENT_CONTEXT_PATH_PARAMETER, catalogueConfiguration);
 			String ret = createOrUpdate(catalogueConfiguration);
 			ResponseBuilder responseBuilder = Response.status(Status.CREATED);
@@ -154,6 +237,42 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		}
 	}
 	
+	/**
+	 * This API allows to read the catalogue configuration for the 
+	 * current context (i.e. the context where the token has been generated).<br/>
+	 * 
+	 * Please refers to <a href="#resource_Configuration_create_json_POST">Create Configuration API</a> 
+	 * for the list of configuration properties and their meaning.<br/>
+	 * 
+	 * This API can be invoked by any user with at least 
+	 * <a href="../docs/index.html#roles">Catalogue-Editor</a> role.<br/>
+	 * 
+	 * For any non <a href="../docs/index.html#roles">Catalogue-Manager</a> user the configuration 
+	 * will contain only a subset of the properties of the configuration.
+	 * Here is an example:
+	 * 
+	 * <pre>
+	 * 	{
+	 *		"context": "/gcube/devsec/devVRE",
+	 *		"defaultOrganization": "devvre",
+	 *		"supportedOrganizations": [ "devvre" "nextnext" ],
+	 *		"ckanURL": "https://ckan-d-d4s.d4science.org",
+	 *		"solrURL": "https://ckan-d-d4s.d4science.org/solr/",
+	 *		"socialPostEnabled": false,
+	 *		"notificationToUsersEnabled": true,
+	 *		"moderationEnabled": true
+	 * 	}
+	 * </pre>
+	 * 
+	 * @param context must contains the context of the request
+	 * 	(i.e. the context where the token has been generated)
+	 * 	or the placeholder <code>CURRENT_CONTEXT</code>.<br/>
+	 * 	Please note that the context must be URL encoded, 
+	 * 	e.g. /gcube/devsec/devVRE -> %2Fgcube%2Fdevsec%2FdevVRE
+	 * 
+	 * @pathExample /configurations/CURRENT_CONTEXT
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/read-configuration-response.json
+	 */
 	@GET
 	@Path("/{" + CONTEXT_FULLNAME_PARAMETER + "}")
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -197,6 +316,29 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		}
 	}
 	
+	/**
+	 * This API allows to create/update the catalogue configuration for the 
+	 * context of the request (i.e. the context where the token has been generated)
+	 * using the json provided as request body.<br/>
+	 * 
+	 * Only a <a href="../docs/index.html#roles">Catalogue-Manager</a> can invoke this API.<br/> 
+	 * 
+	 * The configuration will be persisted in the infrastructure 
+	 * Information System (IS) in the context of the request.<br/>
+	 * 
+	 * @param context must contains the context of the request
+	 *  (i.e. the context where the token has been generated)
+	 * 	or the placeholder <code>CURRENT_CONTEXT</code>.<br/>
+	 * 	Please note that the context must be URL encoded, 
+	 * 	e.g. /gcube/devsec/devVRE -> %2Fgcube%2Fdevsec%2FdevVRE
+	 * @param json the configuration representation
+	 * @return the updated/created configuration
+	 * @throws WebServiceException when the request fails
+	 * 
+	 * @pathExample /configurations/CURRENT_CONTEXT
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/create-configuration-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/create-configuration-response.json
+	 */
 	@PUT
 	@Path("/{" + CONTEXT_FULLNAME_PARAMETER + "}")
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -207,9 +349,10 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		@ResponseCode(code = 401, condition = "Only Catalogue-Managers can create/update catalogue configuration."),
 		@ResponseCode(code = 500, condition = "Error while creating/updating catalogue configuration."),
 	})
+	@OperationId("Create or Update")
 	public String createOrUpdate(@PathParam(CONTEXT_FULLNAME_PARAMETER) String context, String json) throws WebServiceException {
 		try {
-			ServiceCatalogueConfiguration catalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(json);
+			ServiceCatalogueConfiguration catalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(json, ServiceCatalogueConfiguration.class);
 			checkContext(context, catalogueConfiguration);
 			return createOrUpdate(catalogueConfiguration);
 		}catch (WebApplicationException e) {
@@ -222,7 +365,7 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 	@Override
 	public Response update(String json) throws WebServiceException {
 		try {
-			ServiceCatalogueConfiguration catalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(json);
+			ServiceCatalogueConfiguration catalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(json, ServiceCatalogueConfiguration.class);
 			checkContext(CURRENT_CONTEXT_PATH_PARAMETER);
 			catalogueConfiguration = CatalogueConfigurationFactory.createOrUpdate(catalogueConfiguration);
 			String configuration = catalogueConfiguration.toJsonString();
@@ -239,6 +382,30 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		}
 	}
 	
+	/**
+	 * This API allows to patch the catalogue configuration for the 
+	 * context of the request (i.e. the context where the token has been generated)
+	 * using the json provided as request body.<br/>
+	 * Only a <a href="../docs/index.html#roles">Catalogue-Manager</a> can invoke this API. <br/>
+	 * The configuration will be persisted in the infrastructure 
+	 * Information System (IS) in the context of the request.<br/>
+	 * 
+	 * Please refers to <a href="#resource_Configuration_create_json_POST">Create Configuration API</a> 
+	 * for the list of configuration properties and their meaning.
+	 * 
+	 * @param context must contains the context of the request
+	 *  (i.e. the context where the token has been generated)
+	 * 	or the placeholder <code>CURRENT_CONTEXT</code>.<br/>
+	 * 	Please note that the context must be URL encoded, 
+	 * 	e.g. /gcube/devsec/devVRE -> %2Fgcube%2Fdevsec%2FdevVRE
+	 * @param json must contains only the properties of the configuratoin the user wants to change.
+	 * @return the patched configuration.
+	 * @throws WebServiceException when the request fails
+	 * 
+	 * @pathExample /configurations/CURRENT_CONTEXT
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/create-configuration-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/configuration/create-configuration-response.json
+	 */
 	@PATCH
 	@Path("/{" + CONTEXT_FULLNAME_PARAMETER + "}")
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -284,7 +451,7 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 	            configuration.set(fieldName, node.get(fieldName));
 			}
 			
-			ServiceCatalogueConfiguration newCatalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(configuration);
+			ServiceCatalogueConfiguration newCatalogueConfiguration = ServiceCatalogueConfiguration.getServiceCatalogueConfiguration(configuration, ServiceCatalogueConfiguration.class);
 			newCatalogueConfiguration = CatalogueConfigurationFactory.createOrUpdate(newCatalogueConfiguration);
 			String ret = newCatalogueConfiguration.toJsonString();
 			logger.debug("Configuration in context {} has been patched to {}", catalogueConfiguration.getContext(), ret);
@@ -300,6 +467,28 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		}
 	}
 	
+	/**
+	 * It removes from the cache the configuration for the
+	 * context of the request (i.e. the context where the token has been generated).<br/>
+	 * 
+	 * This API forces the service to read again from the Information System (IS)
+	 * the catalogue configuration for the context of the request.<br/>
+	 * 
+	 * If the user specifies the <code>purge</code> query parameter this API
+	 * remove the configuration from the IS. Please note that this implies that 
+	 * the catalogue is no more configured for the context of the request.
+	 * 
+	 * 
+	 * @param context context must contains the context of the request 
+	 * 	(i.e. the context where the token has been generated)
+	 * 	or the placeholder <code>CURRENT_CONTEXT</code>.<br/>
+	 * 	Please note that the context must be URL encoded, 
+	 * 	e.g. /gcube/devsec/devVRE -> %2Fgcube%2Fdevsec%2FdevVRE
+	 * @param purge indicates to the service to remvoe the configuration from the IS 
+	 * @throws WebServiceException
+	 * 
+	 * @pathExample /configurations/CURRENT_CONTEXT
+	 */
 	@DELETE
 	@Path("/{" + CONTEXT_FULLNAME_PARAMETER + "}")
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
@@ -337,6 +526,23 @@ public class Configuration extends BaseREST implements org.gcube.gcat.api.interf
 		}
 	}
 	
+	/**
+	 * It removes remove the configuration from the IS for the 
+	 * context of the request (i.e. the context where the token has been generated).<br/>
+	 * 
+	 * Please note that this implies that 
+	 * the catalogue is no more configured for the context of the request.
+	 * 
+	 * @param context context must contains the context of the request 
+	 *  (i.e. the context where the token has been generated)
+	 * 	or the placeholder <code>CURRENT_CONTEXT</code>.<br/>
+	 * 	Please note that the context must be URL encoded, 
+	 * 	e.g. /gcube/devsec/devVRE -> %2Fgcube%2Fdevsec%2FdevVRE
+	 * @throws WebServiceException
+	 * 
+	 * @pathExample /configurations/CURRENT_CONTEXT
+	 * 
+	 */
 	@PURGE
 	@Path("/{" + CONTEXT_FULLNAME_PARAMETER + "}")
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)

src/main/java/org/gcube/gcat/rest/administration/Group.java

@@ -1,4 +1,4 @@
-package org.gcube.gcat.rest;
+package org.gcube.gcat.rest.administration;
 
 import javax.ws.rs.Consumes;
 import javax.ws.rs.DELETE;
@@ -20,11 +20,22 @@ import org.gcube.gcat.annotation.PURGE;
 import org.gcube.gcat.api.GCatConstants;
 //import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANGroup;
+import org.gcube.gcat.rest.REST;
+
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 
 /**
+ * This concept is mutated by Ckan which is used as underling technology to persist items.
+ * 
+ * Only Catalogue-Admins or above are able to invoke non-safe methods.
+ * 
  * @author Luca Frosini (ISTI - CNR)
+ * 
  */
 @Path(Group.GROUPS)
+@ResourceGroup("Administration APIs")
+@ResourceLabel("Group APIs")
 public class Group extends REST<CKANGroup> implements org.gcube.gcat.api.interfaces.Group<Response,Response> {
 	
 	protected static final String GROUP_ID_PARAMETER = "GROUP_ID";
@@ -45,9 +56,9 @@ public class Group extends REST<CKANGroup> implements org.gcube.gcat.api.interfa
 	@GET
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
-	public String list(@QueryParam(GCatConstants.LIMIT_PARAMETER) @DefaultValue("10") int limit,
-			@QueryParam(GCatConstants.OFFSET_PARAMETER) @DefaultValue("0") int offset, 
-			@QueryParam(GCatConstants.COUNT_PARAMETER) @DefaultValue("false") Boolean countOnly) {
+	public String list(@QueryParam(GCatConstants.LIMIT_QUERY_PARAMETER) @DefaultValue("10") int limit,
+			@QueryParam(GCatConstants.OFFSET_QUERY_PARAMETER) @DefaultValue("0") int offset, 
+			@QueryParam(GCatConstants.COUNT_QUERY_PARAMETER) @DefaultValue("false") Boolean countOnly) {
 		if(countOnly) {
 			int count = count();
 			return createCountJson(count);
@@ -60,11 +71,54 @@ public class Group extends REST<CKANGroup> implements org.gcube.gcat.api.interfa
 	 * Not used as REST method, implemented to respect {@link org.gcube.gcat.api.interfaces.Item} interface
 	 */
 	@Override
-	public String list(@QueryParam(GCatConstants.LIMIT_PARAMETER) @DefaultValue("10") int limit,
-			@QueryParam(GCatConstants.OFFSET_PARAMETER) @DefaultValue("0") int offset) {
+	public String list(@QueryParam(GCatConstants.LIMIT_QUERY_PARAMETER) @DefaultValue("10") int limit,
+			@QueryParam(GCatConstants.OFFSET_QUERY_PARAMETER) @DefaultValue("0") int offset) {
 		return super.list(limit, offset);
 	}
 	
+	/**
+	 * 
+	 * 
+	 * A group is mainly described by the following attributes (* indicate mandatory attributes):
+	 * 
+	 * <dl>
+	 * 	
+	 * 	<dt>name* (string)</dt>
+	 * 	<dd>
+	 * 		the name of the group, a string between 2 and 100 characters long, 
+	 * 		containing only lowercase alphanumeric characters, '-' and '_' ;
+	 * 	</dd>
+	 *	
+	 *	<dt style="margin-top: 5px;">id (string)</dt>
+	 *  <dd>the id of the group;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">title (string)</dt>
+	 *  <dd>the title of the group;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">description (string)</dt>
+	 *  <dd>the description of the group;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">image_url (string)</dt>
+	 *  <dd>the URL to an image to be displayed on the group’s page;</dd>
+	 * 	
+	 * 	<dt>state (string, default: 'active')</dt>
+	 * 	<dd>
+	 * 		the current state of the group, e.g. 'active' or 'deleted', 
+	 * 		only active groups show up in search results and other lists of groups, 
+	 * 		this parameter will be ignored if you are not authorized 
+	 * 		to change the state of the group;
+	 * 	</dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">extras (list of dataset extra dictionaries)</dt>
+	 *  <dd>
+	 *  	the group’s extras, extras are arbitrary (key: value) metadata that can be added to groups, 
+	 *  	each extra dictionary should have keys 'key' (a string), 
+	 *  	'value' (a string), and optionally 'deleted'.
+	 *  </dd>
+	 *  
+	 * </dl>
+	 * 
+	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)

src/main/java/org/gcube/gcat/rest/administration/Organization.java

@@ -1,4 +1,4 @@
-package org.gcube.gcat.rest;
+package org.gcube.gcat.rest.administration;
 
 import javax.ws.rs.Consumes;
 import javax.ws.rs.DELETE;
@@ -20,11 +20,21 @@ import org.gcube.gcat.annotation.PURGE;
 import org.gcube.gcat.api.GCatConstants;
 //import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANOrganization;
+import org.gcube.gcat.rest.REST;
+
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 
 /**
+ * This concept is mutated by Ckan which is used as underling technology to persist items.
+ * 
+ * Only Catalogue-Admins or above are able to invoke non-safe methods.
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(Organization.ORGANIZATIONS)
+@ResourceGroup("Administration APIs")
+@ResourceLabel("Organization APIs")
 public class Organization extends REST<CKANOrganization>
 		implements org.gcube.gcat.api.interfaces.Organization<Response,Response> {
 	
@@ -46,9 +56,9 @@ public class Organization extends REST<CKANOrganization>
 	@GET
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_EDITOR, Role.CATALOGUE_ADMIN, Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
-	public String list(@QueryParam(GCatConstants.LIMIT_PARAMETER) @DefaultValue("10") int limit,
-			@QueryParam(GCatConstants.OFFSET_PARAMETER) @DefaultValue("0") int offset, 
-			@QueryParam(GCatConstants.COUNT_PARAMETER) @DefaultValue("false") Boolean countOnly) {
+	public String list(@QueryParam(GCatConstants.LIMIT_QUERY_PARAMETER) @DefaultValue("10") int limit,
+			@QueryParam(GCatConstants.OFFSET_QUERY_PARAMETER) @DefaultValue("0") int offset, 
+			@QueryParam(GCatConstants.COUNT_QUERY_PARAMETER) @DefaultValue("false") Boolean countOnly) {
 		if(countOnly) {
 			int count = count();
 			return createCountJson(count);
@@ -61,11 +71,53 @@ public class Organization extends REST<CKANOrganization>
 	 * Not used as REST method, implemented to respect {@link org.gcube.gcat.api.interfaces.Item} interface
 	 */
 	@Override
-	public String list(@QueryParam(GCatConstants.LIMIT_PARAMETER) @DefaultValue("10") int limit,
-			@QueryParam(GCatConstants.OFFSET_PARAMETER) @DefaultValue("0") int offset) {
+	public String list(@QueryParam(GCatConstants.LIMIT_QUERY_PARAMETER) @DefaultValue("10") int limit,
+			@QueryParam(GCatConstants.OFFSET_QUERY_PARAMETER) @DefaultValue("0") int offset) {
 		return super.list(limit, offset);
 	}
 	
+	/**
+	 * An Organization is mainly described by the following attributes (* indicate mandatory attributes): 
+	 * 
+	 * <dl>
+	 * 	
+	 * 	<dt>name* (string)</dt>
+	 * 	<dd>
+	 * 		the name of the organization, a string between 2 and 100 characters long, 
+	 * 		containing only lowercase alphanumeric characters, '-' and '_' ;
+	 * 	</dd>
+	 *	
+	 *	<dt style="margin-top: 5px;">id (string)</dt>
+	 *  <dd>the id of the organization;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">title (string)</dt>
+	 *  <dd>the title of the organization;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">description (string)</dt>
+	 *  <dd>the description of the organization;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">image_url (string)</dt>
+	 *  <dd>the URL to an image to be displayed on the organization's page;</dd>
+	 * 	
+	 * 	<dt>state (string, default: 'active')</dt>
+	 * 	<dd>
+	 * 		the current state of the organization, e.g. 'active' or 'deleted', 
+	 * 		only active organizations show up in search results and other lists of organizations, 
+	 * 		this parameter will be ignored if you are not authorized 
+	 * 		to change the state of the organization;
+	 * 	</dd>
+	 *  
+	 *  <dt style="margin-top: 5px;">extras (list of dataset extra dictionaries)</dt>
+	 *  <dd>
+	 *  	the organization's extras, extras are arbitrary (key: value) 
+	 *  	metadata that can be added to organizations, 
+	 *  	each extra dictionary should have keys 'key' (a string), 
+	 *  	'value' (a string), and optionally 'deleted'.
+	 *  </dd>
+	 *  
+	 * </dl>
+
+	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)

src/main/java/org/gcube/gcat/rest/administration/User.java

@@ -1,4 +1,4 @@
-package org.gcube.gcat.rest;
+package org.gcube.gcat.rest.administration;
 
 import javax.ws.rs.Consumes;
 import javax.ws.rs.DELETE;
@@ -21,12 +21,22 @@ import org.gcube.gcat.api.GCatConstants;
 import org.gcube.gcat.api.roles.Role;
 //import org.gcube.gcat.api.roles.Role;
 import org.gcube.gcat.persistence.ckan.CKANUser;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
+import org.gcube.gcat.persistence.ckan.cache.CKANUserCache;
+import org.gcube.gcat.rest.REST;
+
+import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
+import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 
 /**
+ * This collection allows to interact with the catalogue users.
+ * 
+ * Only Catalogue-Admins or above are able to invoke non-safe methods.
+ * 
  * @author Luca Frosini (ISTI - CNR)
  */
 @Path(User.USERS)
+@ResourceGroup("Administration APIs")
+@ResourceLabel("User APIs")
 public class User extends REST<CKANUser> implements org.gcube.gcat.api.interfaces.User<Response,Response> {
 	
 	protected static final String GCUBE_USERNAME_PARAMETER = "GCUBE_USERNAME";
@@ -36,6 +46,10 @@ public class User extends REST<CKANUser> implements org.gcube.gcat.api.interface
 		super(USERS, CKAN_USER_ID_PARAMETER, CKANUser.class);
 	}
 	
+	/**
+	 * @pathExample /users
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/user/list-user-response.json
+	 */
 	@GET
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
@@ -43,6 +57,38 @@ public class User extends REST<CKANUser> implements org.gcube.gcat.api.interface
 		return super.list(-1, -1);
 	}
 	
+	/**
+	 * A User is mainly described by the following attributes (* indicate mandatory attributes):
+	 * 
+	 * <dl>
+	 * 	
+	 * 	<dt>name* (string)</dt>
+	 * 	<dd>
+	 * 		the name of the user, a string between 2 and 100 characters long, 
+	 * 		containing only lowercase alphanumeric characters, '-' and '_' ;
+	 * 	</dd>
+	 *	
+	 *	<dt style="margin-top: 5px;">id (string)</dt>
+	 *  <dd>the id of the user;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">fullname (string)</dt>
+	 *  <dd>the fullname of the user;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">email (string)</dt>
+	 *  <dd>the email address for the user;</dd>
+	 *  
+	 *	<dt style="margin-top: 5px;">password (string)</dt>
+	 *  <dd>
+	 *  	the password of the user, a string of at least 4 characters 
+	 *  	(parameter only used internally to create a new user in Ckan);
+	 *  </dd>
+	 * 	
+	 * 	<dt style="margin-top: 5px;">about (string)</dt>
+	 *  <dd>a description of the user.</dd>
+	 *  
+	 * </dl>
+	 * 
+	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -52,6 +98,19 @@ public class User extends REST<CKANUser> implements org.gcube.gcat.api.interface
 		return super.create(json);
 	}
 	
+	/**
+	 * Read the profile of the user in Ckan
+	 * The <code>apikey</code> to interact directly with Ckan are returned only for Catalogue-Managers
+	 * and only for its own profile.
+	 * 
+	 * The service add the user's role in <code>portal_role</code> property when the user read its own profile.
+	 * See <a href="../docs/index.html#roles">Roles</a> section for more information.
+	 * 
+	 * @param username Ckan or gCube username are both accepted
+	 * 
+	 * @pathExample /users/luca.frosini
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/user/read-user-response.json
+	 */
 	@GET
 	@Path("/{" + CKAN_USER_ID_PARAMETER + "}")
 	@Produces(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -82,13 +141,8 @@ public class User extends REST<CKANUser> implements org.gcube.gcat.api.interface
 	@DELETE	
 //	@AuthorizationControl(allowedRoles={Role.CATALOGUE_MANAGER}, exception=NotAuthorizedException.class)
 	public Response removeCallerFromCache() {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		org.gcube.common.authorization.utils.user.User user = secretManager.getUser();
-		if(user.getRoles().contains(Role.MANAGER.getPortalRole())) {
-			CKANUserCache.removeUserFromCache();
-		}else {
-			throw new ForbiddenException("Only " + Role.MANAGER.getPortalRole() + "s are authorized to remove an user from the cache");
-		}
+		// Any user can remove self from cache
+		CKANUserCache.removeUserFromCache();
 		return Response.status(Status.NO_CONTENT).build(); 
 	}
 	
@@ -98,7 +152,8 @@ public class User extends REST<CKANUser> implements org.gcube.gcat.api.interface
 	public Response removeUserFromCache(@PathParam(GCUBE_USERNAME_PARAMETER) String username) {
 		SecretManager secretManager = SecretManagerProvider.instance.get();
 		org.gcube.common.authorization.utils.user.User user = secretManager.getUser();
-		if(user.getRoles().contains(Role.MANAGER.getPortalRole())) {
+		if(user.getRoles().contains(Role.MANAGER.getPortalRole()) || user.getUsername().compareTo(username)==0) {
+			// Any user can remove self from cache
 			CKANUserCache.removeUserFromCache(username);
 		}else {
 			throw new ForbiddenException("Only " + Role.MANAGER.getPortalRole() + "s are authorized to remove an user from the cache");

src/main/java/org/gcube/gcat/rest/package-info.java

@@ -0,0 +1,13 @@
+/**
+ * <h1>gCube Catalogue (gCat) Service</h1>
+ * 
+ * <p>Welcome to gCube Catalogue Service (aka gCat) API documentation.</p>
+ * 
+ * <p>
+ * 	To get a complete overview of gCat service take a look at 
+ * 	<a href="../docs/index.html">wiki page</a>.
+ * </p>
+ * 
+ * 
+ */
+package org.gcube.gcat.rest;

src/main/java/org/gcube/gcat/social/SocialPost.java

@@ -1,204 +0,0 @@
-package org.gcube.gcat.social;
-
-import java.io.StringWriter;
-import java.net.HttpURLConnection;
-import java.util.ArrayList;
-import java.util.List;
-
-import javax.ws.rs.core.HttpHeaders;
-import javax.ws.rs.core.MediaType;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.socialservice.SocialService;
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.gcube.gcat.api.configuration.CatalogueConfiguration;
-import org.gcube.gcat.configuration.CatalogueConfigurationFactory;
-import org.gcube.gcat.persistence.ckan.CKANUserCache;
-import org.gcube.gcat.utils.Constants;
-import org.gcube.gcat.utils.HTTPUtility;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class SocialPost extends Thread {
-	
-	private static final Logger logger = LoggerFactory.getLogger(SocialPost.class);
-	
-	public static final String ITEM_URL = "Item URL";
-	
-	// https://wiki.gcube-system.org/gcube/Social_Networking_Service#Write_application_post_2
-	protected static final String SOCIAL_SERVICE_WRITE_APPLICATION_POST_PATH = "/2/posts/write-post-app";
-	
-	// String.format(NOTIFICATION_MESSAGE, fullName, title, url)
-	protected static final String NOTIFICATION_MESSAGE = "%s just published the item \"%s\"\n"
-			+ "Please find it at %s\n";
-	
-	protected static final String SOCIAL_POST_TEXT_KEY = "text";
-	protected static final String SOCIAL_POST_ENABLE_NOTIFICATION_KEY = "enable_notification";
-	protected static final String SOCIAL_POST_RESPONSE_SUCCESS_KEY = "success";
-	protected static final String SOCIAL_POST_RESPONSE_MESSAGE_KEY = "message";
-	
-	protected final ObjectMapper objectMapper;
-	
-	protected String itemID;
-	protected String itemURL;
-	protected String itemTitle;
-	protected List<String> tags;
-	protected Boolean notification;
-	
-	public SocialPost() throws Exception {
-		super();
-		this.objectMapper = new ObjectMapper();
-	}
-	
-	public String getItemID() {
-		return itemID;
-	}
-	
-	public void setItemID(String itemID) {
-		this.itemID = itemID;
-	}
-	
-	public String getItemURL() {
-		return itemURL;
-	}
-	
-	public void setItemURL(String itemURL) {
-		this.itemURL = itemURL;
-	}
-	
-	public String getItemTitle() {
-		return itemTitle;
-	}
-	
-	public void setItemTitle(String itemTitle) {
-		this.itemTitle = itemTitle;
-	}
-	
-	public List<String> getTags() {
-		return tags;
-	}
-	
-	public void setTags(List<String> tags) {
-		this.tags = tags;
-	}
-	
-	public void setTags(ArrayNode tags) {
-		this.tags = new ArrayList<>();
-		if(tags != null && tags.size() > 0) {
-			for(int i = 0; i < tags.size(); i++) {
-				JsonNode jsonNode = tags.get(i);
-				String tagName = "";
-				if(jsonNode.has("display_name")) {
-					tagName = jsonNode.get("display_name").asText();
-				} else {
-					tagName = jsonNode.get("name").asText();
-				}
-				this.tags.add(tagName);
-			}
-		}
-	}
-	
-	public Boolean isNotification() {
-		return notification;
-	}
-
-	public void setNotification(Boolean notification) {
-		this.notification = notification;
-	}
-	
-	@Override
-	public void run() {
-		
-		try {
-			
-			CatalogueConfiguration instance = CatalogueConfigurationFactory.getInstance();
-			
-			if(!instance.isSocialPostEnabled()) {
-				logger.info("Social Post are disabled in the context {}", SecretManagerProvider.instance.get().getContext());
-				return;
-			}
-			logger.info("Going to send Social Post about the Item {} available at {}", itemID, itemURL);
-			
-			boolean notifyUsers = instance.isNotificationToUsersEnabled();
-			
-			if(notification != null) {
-				if(notifyUsers) {
-					notifyUsers = notifyUsers && notification;
-				}else {
-					notifyUsers = notification;
-				}
-			}
-			
-			// write notification post
-			sendSocialPost(notifyUsers);
-			
-		} catch(Exception e) {
-			logger.error("Error while executing post creation actions", e);
-		}
-	}
-	
-	public void sendSocialPost(boolean notifyUsers) {
-		
-		try {
-			String fullName =  CKANUserCache.getCurrrentCKANUser().getNameSurname();
-			
-			String basePath = SocialService.getSocialService().getServiceBasePath();
-			if(basePath == null) {
-				logger.info("Unable to write a post because there is no social networking service available");
-				return;
-			}
-			basePath = basePath.endsWith("/") ? basePath : basePath + "/";
-			
-			StringWriter messageWriter = new StringWriter();
-			messageWriter.append(String.format(NOTIFICATION_MESSAGE, fullName, itemTitle, itemURL));
-			
-			for(String tag : tags) {
-				tag = tag.trim();
-				tag = tag.replaceAll(" ", "_").replace("_+", "_");
-				if(tag.endsWith("_")) {
-					tag = tag.substring(0, tag.length() - 1);
-				}
-				messageWriter.append("#");
-				messageWriter.append(tag);
-				messageWriter.append(" ");
-			}
-			String message = messageWriter.toString();
-			
-			logger.debug("The post that is going to be written is\n{}", message);
-			
-			ObjectNode objectNode = objectMapper.createObjectNode();
-			objectNode.put(SOCIAL_POST_TEXT_KEY, message);
-			objectNode.put(SOCIAL_POST_ENABLE_NOTIFICATION_KEY, notifyUsers);
-			
-			// Do not use ApplicationMode class here because is a thread and change the current token could impact 
-			// on the other threads.
-			
-			GXHTTPStringRequest gxhttpStringRequest = GXHTTPStringRequest.newRequest(basePath);
-			gxhttpStringRequest.from(Constants.CATALOGUE_NAME);
-			gxhttpStringRequest.header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON);
-			gxhttpStringRequest.setSecurityToken(Constants.getCatalogueSecret().getToken());
-			gxhttpStringRequest.path(SOCIAL_SERVICE_WRITE_APPLICATION_POST_PATH);
-			
-			HttpURLConnection httpURLConnection = gxhttpStringRequest.post(objectMapper.writeValueAsString(objectNode));
-			String ret = HTTPUtility.getResultAsString(httpURLConnection);
-			JsonNode jsonNode = objectMapper.readTree(ret);
-			if(jsonNode.get(SOCIAL_POST_RESPONSE_SUCCESS_KEY).asBoolean()) {
-				logger.info("Post written : {}", message);
-			} else {
-				logger.info("Failed to write the post {}. Reason {}", message,
-						jsonNode.get(SOCIAL_POST_RESPONSE_MESSAGE_KEY).asText());
-			}
-		} catch(Exception e) {
-			logger.error("Unable to send Social Post", e);
-		}
-		
-	}
-
-}

src/main/java/org/gcube/gcat/social/SocialUsers.java

@@ -1,48 +0,0 @@
-package org.gcube.gcat.social;
-
-import java.net.HttpURLConnection;
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Map;
-import java.util.Set;
-
-import org.gcube.com.fasterxml.jackson.databind.JsonNode;
-import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
-import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
-import org.gcube.common.authorization.utils.socialservice.SocialService;
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.gcube.gcat.utils.HTTPUtility;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class SocialUsers {
-	
-	protected static final String GET_USERNAMES_BY_ROLE = "2/users/get-usernames-by-role";
-	protected static final String GET_USERNAMES_BY_ROLE_ROLE_NAME_PARAMETER = "role-name";
-	protected static final String GET_USERNAMES_BY_ROLE_RESULT_KEY = "result";
-
-	public static Set<String> getUsernamesByRole(String roleName) throws Exception {
-		String socialServiceBasePath = SocialService.getSocialService().getServiceBasePath();
-		
-		GXHTTPStringRequest gxhttpStringRequest = HTTPUtility.createGXHTTPStringRequest(socialServiceBasePath,
-				GET_USERNAMES_BY_ROLE, false);
-		Map<String,String> parameters = new HashMap<>();
-		parameters.put(GET_USERNAMES_BY_ROLE_ROLE_NAME_PARAMETER, roleName);
-		gxhttpStringRequest.queryParams(parameters);
-		HttpURLConnection httpURLConnection = gxhttpStringRequest.get();
-		
-		String ret = HTTPUtility.getResultAsString(httpURLConnection);
-		ObjectMapper objectMapper = new ObjectMapper();
-		JsonNode jsonNode = objectMapper.readTree(ret);
-		ArrayNode arrayNode = (ArrayNode) jsonNode.get(GET_USERNAMES_BY_ROLE_RESULT_KEY);
-		
-		Set<String> usernames = new HashSet<>();
-		for(JsonNode node : arrayNode) {
-			usernames.add(node.asText());
-		}
-		
-		return usernames;
-	}
-	
-}

src/main/java/org/gcube/gcat/utils/Constants.java

@@ -1,54 +0,0 @@
-package org.gcube.gcat.utils;
-
-import java.io.InputStream;
-import java.util.Properties;
-
-import javax.ws.rs.InternalServerErrorException;
-
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.secret.JWTSecret;
-import org.gcube.common.authorization.utils.secret.Secret;
-import org.gcube.common.keycloak.KeycloakClientFactory;
-import org.gcube.common.keycloak.model.TokenResponse;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class Constants {
-	
-	public static final String CATALOGUE_NAME = "gCat";
-	
-	private static final String CLIENT_SECRET_FILENAME = "config.properties";
-	private static final String CLIENT_ID = "gcat";
-	protected static String clientSecret;
-	
-	private static String getClientSecret(String context) {
-		try {
-			if(clientSecret==null) {
-				Properties properties = new Properties();
-				InputStream input = Constants.class.getClassLoader().getResourceAsStream(CLIENT_SECRET_FILENAME);
-				properties.load(input);
-				int index = context.indexOf('/', 1);
-				String root = context.substring(0, index == -1 ? context.length() : index);
-				clientSecret = properties.getProperty(root);
-			}
-			return clientSecret;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(
-					"Unable to retrieve Application Token for context " + SecretManagerProvider.instance.get().getContext(), e);
-		}
-	}
-	
-	private static TokenResponse getJWTAccessToken() throws Exception {
-		String contextToAuthorise = SecretManagerProvider.instance.get().getContext();
-		TokenResponse tr = KeycloakClientFactory.newInstance().queryUMAToken(CLIENT_ID, getClientSecret(contextToAuthorise), contextToAuthorise, null);
-	    return tr;
-	}
-	
-	public static Secret getCatalogueSecret() throws Exception {
-		TokenResponse tr = getJWTAccessToken();
-		Secret secret = new JWTSecret(tr.getAccessToken());
-		return secret;
-	}
-	
-}

src/main/java/org/gcube/gcat/utils/HTTPCall.java

@@ -1,90 +0,0 @@
-package org.gcube.gcat.utils;
-
-import java.net.HttpURLConnection;
-import java.net.MalformedURLException;
-import java.net.URL;
-import java.util.concurrent.TimeUnit;
-
-import javax.ws.rs.InternalServerErrorException;
-import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.Response.Status;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class HTTPCall {
-	
-	protected static final String USER_AGENT_KEY = "User-Agent";
-	protected static final String USER_AGENT_NAME = "gCat";
-	
-	protected final String address;
-	
-	/**
-	 * When the target service is a gCube Service it adds the HTTP header 
-	 * to provide gCube authorization token and/or scope
-	 */
-	protected boolean gCubeTargetService;
-	
-	public boolean isgCubeTargetService() {
-		return gCubeTargetService;
-	}
-	
-	public void setgCubeTargetService(boolean gCubeTargetService) {
-		this.gCubeTargetService = gCubeTargetService;
-	}
-	
-	public HTTPCall(String address) {
-		this(address, HTTPCall.USER_AGENT_NAME);
-	}
-	
-	protected HTTPCall(String address, String userAgent) {
-		this.address = address;
-		this.gCubeTargetService = true;
-	}
-	
-	protected URL getURL(String urlString) throws MalformedURLException {
-		URL url = new URL(urlString);
-		if(url.getProtocol().compareTo("https") == 0) {
-			url = new URL(url.getProtocol(), url.getHost(), url.getDefaultPort(), url.getFile());
-		}
-		return url;
-	}
-	
-	public URL getFinalURL(URL url) {
-		try {
-			URL finalURL = url;
-			
-			HttpURLConnection connection = (HttpURLConnection) url.openConnection();
-			connection.setInstanceFollowRedirects(false);
-			connection.setRequestProperty(USER_AGENT_KEY, USER_AGENT_NAME);
-			connection.setConnectTimeout((int) TimeUnit.SECONDS.toMillis(1));
-			// connection.setRequestMethod(HEAD.class.getSimpleName());
-			
-			int responseCode = connection.getResponseCode();
-			
-			if(responseCode >= Status.BAD_REQUEST.getStatusCode()) {
-				Status status = Status.fromStatusCode(responseCode);
-				String responseMessage = connection.getResponseMessage();
-				throw new WebApplicationException(responseMessage, status);
-			}
-			
-			if(responseCode == HttpURLConnection.HTTP_MOVED_TEMP || responseCode == HttpURLConnection.HTTP_MOVED_PERM
-					|| responseCode == HttpURLConnection.HTTP_SEE_OTHER
-					|| responseCode == Status.TEMPORARY_REDIRECT.getStatusCode() || responseCode == 308) {
-				
-				URL newURL = getURL(connection.getHeaderField("Location"));
-				connection.disconnect();
-				finalURL = getFinalURL(newURL);
-			}
-			
-			return finalURL;
-			
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new InternalServerErrorException(e);
-		}
-		
-	}
-	
-}

src/main/java/org/gcube/gcat/utils/HTTPUtility.java

@@ -1,65 +0,0 @@
-package org.gcube.gcat.utils;
-
-import java.io.BufferedReader;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-import java.io.UnsupportedEncodingException;
-import java.net.HttpURLConnection;
-
-import javax.ws.rs.WebApplicationException;
-import javax.ws.rs.core.HttpHeaders;
-import javax.ws.rs.core.MediaType;
-import javax.ws.rs.core.Response.Status;
-
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class HTTPUtility {
-	
-	private static final Logger logger = LoggerFactory.getLogger(HTTPUtility.class);
-	
-	public static StringBuilder getStringBuilder(InputStream inputStream) throws IOException {
-		StringBuilder result = new StringBuilder();
-		try(BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream))) {
-			String line;
-			while((line = reader.readLine()) != null) {
-				result.append(line);
-			}
-		}
-		
-		return result;
-	}
-	
-	public static GXHTTPStringRequest createGXHTTPStringRequest(String url, String path, boolean post)
-			throws UnsupportedEncodingException {
-		GXHTTPStringRequest gxhttpStringRequest = GXHTTPStringRequest.newRequest(url);
-		gxhttpStringRequest.from(Constants.CATALOGUE_NAME);
-		if(post) {
-			gxhttpStringRequest.header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON);
-		}
-		gxhttpStringRequest.header(HttpHeaders.ACCEPT, MediaType.APPLICATION_JSON);
-		gxhttpStringRequest.path(path);
-		return gxhttpStringRequest;
-	}
-	
-	public static String getResultAsString(HttpURLConnection httpURLConnection) throws IOException {
-		int responseCode = httpURLConnection.getResponseCode();
-		if(responseCode >= Status.BAD_REQUEST.getStatusCode()) {
-			Status status = Status.fromStatusCode(responseCode);
-			InputStream inputStream = httpURLConnection.getErrorStream();
-			StringBuilder result = getStringBuilder(inputStream);
-			logger.trace(result.toString());
-			throw new WebApplicationException(result.toString(), status);
-		}
-		InputStream inputStream = httpURLConnection.getInputStream();
-		String ret = getStringBuilder(inputStream).toString();
-		logger.trace("Got Respose is {}", ret);
-		return ret;
-	}
-	
-}

src/main/java/org/gcube/gcat/utils/RandomString.java

@@ -1,37 +0,0 @@
-package org.gcube.gcat.utils;
-
-import java.util.Random;
-
-/**
- * @author Lucio Lelii (ISTI - CNR)
- * @author Luca Frosini (ISTI - CNR)
- */
-public class RandomString {
-	
-	private static final char[] symbols;
-	
-	static {
-		StringBuilder tmp = new StringBuilder();
-		for(char ch = '0'; ch <= '9'; ++ch)
-			tmp.append(ch);
-		for(char ch = 'a'; ch <= 'z'; ++ch)
-			tmp.append(ch);
-		symbols = tmp.toString().toCharArray();
-	}
-	
-	private final Random random = new Random();
-	
-	private final char[] buf;
-	
-	public RandomString(int length) {
-		if(length < 1)
-			throw new IllegalArgumentException("length < 1: " + length);
-		buf = new char[length];
-	}
-	
-	public String nextString() {
-		for(int idx = 0; idx < buf.length; ++idx)
-			buf[idx] = symbols[random.nextInt(symbols.length)];
-		return new String(buf);
-	}
-}

src/main/java/org/gcube/gcat/utils/URIResolver.java

@@ -1,40 +0,0 @@
-package org.gcube.gcat.utils;
-
-import java.util.HashMap;
-import java.util.Map;
-
-import javax.ws.rs.WebApplicationException;
-
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.portlets.user.uriresolvermanager.UriResolverManager;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public abstract class URIResolver {
-	
-	private static final String CATALOGUE_CONTEXT = "gcube_scope";
-	private static final String ENTITY_TYPE = "entity_context";
-	private static final String ENTITY_NAME = "entity_name";
-	
-	private static final String DATASET = "dataset";
-	
-	
-	public static String getCatalogueItemURL(String name) {
-		try {
-			String context = SecretManagerProvider.instance.get().getContext();
-			UriResolverManager uriResolverManager = new UriResolverManager("CTLG");
-			Map<String, String> params = new HashMap<>();
-			params.put(CATALOGUE_CONTEXT, context);
-			params.put(ENTITY_TYPE, DATASET);
-			params.put(ENTITY_NAME, name);
-			String url = uriResolverManager.getLink(params, false);
-			return url;
-		} catch(WebApplicationException e) {
-			throw e;
-		} catch(Exception e) {
-			throw new WebApplicationException(e);
-		}
-	}
-	
-}

src/main/java/org/gcube/gcat/workspace/CatalogueMetadata.java

@@ -1,48 +0,0 @@
-package org.gcube.gcat.workspace;
-
-import java.net.URL;
-import java.util.HashMap;
-import java.util.Map;
-
-import org.gcube.common.storagehub.model.Metadata;
-import org.gcube.storagehub.MetadataMatcher;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CatalogueMetadata implements MetadataMatcher {
-	
-	public static final String ORIGINAL_URL = "OriginalURL";
-	public static final String ORIGINAL_NAME = "OriginalName";
-	
-	public static final String CATALOGUE_ITEM_ID = "CatalogueItemID";
-	public static final String CATALOGUE_RESOURCE_ID = "CatalogueResourceID";
-	public static final String CATALOGUE_RESOURCE_REVISION_ID = "CatalogueResourceRevisionID";
-	
-	protected String itemID;
-	
-	public CatalogueMetadata(String itemID) {
-		this.itemID = itemID;
-	}
-	
-	@Override
-	public boolean check(Metadata metadata) {
-		Map<String,Object> map = metadata.getMap();
-		Object obj = map.get(CATALOGUE_ITEM_ID);
-		if(obj!=null && obj.toString().compareTo(itemID) == 0) {
-			return true;
-		}
-		return false;
-	}
-	
-	public Metadata getMetadata(URL url, String originalName, String resourceID) {
-		Map<String,Object> map = new HashMap<>();
-		map.put(ORIGINAL_URL, url.toString());
-		map.put(ORIGINAL_NAME, originalName);
-		map.put(CATALOGUE_ITEM_ID, itemID);
-		map.put(CATALOGUE_RESOURCE_ID, resourceID);
-		Metadata metadata = new Metadata(map);
-		return metadata;
-	}
-	
-}

src/main/java/org/gcube/gcat/workspace/CatalogueStorageHubManagement.java

@@ -1,146 +0,0 @@
-package org.gcube.gcat.workspace;
-
-import java.net.HttpURLConnection;
-import java.net.URL;
-import java.util.Map;
-
-import org.gcube.common.authorization.utils.manager.SecretManager;
-import org.gcube.common.authorization.utils.manager.SecretManagerProvider;
-import org.gcube.common.authorization.utils.secret.Secret;
-import org.gcube.common.gxhttp.request.GXHTTPStringRequest;
-import org.gcube.common.storagehub.client.dsl.FileContainer;
-import org.gcube.common.storagehub.model.Metadata;
-import org.gcube.gcat.utils.Constants;
-import org.gcube.storagehub.StorageHubManagement;
-import org.glassfish.jersey.media.multipart.ContentDisposition;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * @author Luca Frosini (ISTI - CNR)
- */
-public class CatalogueStorageHubManagement {
-	
-	private static final Logger logger = LoggerFactory.getLogger(CatalogueStorageHubManagement.class);
-	
-	protected StorageHubManagement storageHubManagement;
-	
-	protected String originalFilename;
-	protected String mimeType;
-	
-	public String getOriginalFilename() {
-		return originalFilename;
-	}
-	
-	public String getMimeType() {
-		return mimeType;
-	}
-	
-	public CatalogueStorageHubManagement() {
-		this.storageHubManagement = new StorageHubManagement();
-	}
-	
-	protected String getOriginalFileName(HttpURLConnection httpURLConnection) throws Exception {
-		String contentDisposition = httpURLConnection.getHeaderField("Content-Disposition");
-		contentDisposition = contentDisposition.replaceAll("= ", "=").replaceAll(" =", "=");
-		ContentDisposition formDataContentDisposition = new ContentDisposition(contentDisposition);
-		return formDataContentDisposition.getFileName();
-	}
-	
-	public URL ensureResourcePersistence(URL persistedURL, String itemID, String resourceID) throws Exception {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		try {
-			secretManager.startSession(secret);
-			GXHTTPStringRequest gxhttpStringRequest = GXHTTPStringRequest.newRequest(persistedURL.toString());
-			gxhttpStringRequest.from(Constants.CATALOGUE_NAME);
-			gxhttpStringRequest.isExternalCall(true);
-			HttpURLConnection httpURLConnection = gxhttpStringRequest.get();
-			mimeType = httpURLConnection.getContentType().split(";")[0];
-			originalFilename = getOriginalFileName(httpURLConnection);
-			CatalogueMetadata catalogueMetadata = new CatalogueMetadata(itemID);
-			storageHubManagement.setCheckMetadata(catalogueMetadata);
-			Metadata metadata = catalogueMetadata.getMetadata(persistedURL, originalFilename, resourceID);
-			persistedURL = storageHubManagement.persistFile(httpURLConnection.getInputStream(), resourceID, mimeType,
-					metadata);
-			mimeType = storageHubManagement.getMimeType();
-			return persistedURL;
-		} catch (Exception e) {
-			logger.error("Error while trying to persists the resource", e);
-			throw e;
-		} finally {
-			secretManager.endSession();
-		}
-	}
-	
-	public void deleteResourcePersistence(String itemID, String resourceID, String mimeType) throws Exception {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		try {
-			secretManager.startSession(secret);
-			storageHubManagement = new StorageHubManagement();
-			CatalogueMetadata catalogueMetadata = new CatalogueMetadata(itemID);
-			storageHubManagement.setCheckMetadata(catalogueMetadata);
-			storageHubManagement.removePersistedFile(resourceID, mimeType);
-		} finally {
-			secretManager.endSession();
-		}
-	}
-	
-	protected void internalAddRevisionID(String resourceID, String revisionID) throws Exception {
-		FileContainer fileContainer = storageHubManagement.getPersistedFile();
-		if(fileContainer != null) {
-			Metadata metadata = fileContainer.get().getMetadata();
-			Map<String,Object> map = metadata.getMap();
-			map.put(CatalogueMetadata.CATALOGUE_RESOURCE_ID, resourceID);
-			map.put(CatalogueMetadata.CATALOGUE_RESOURCE_REVISION_ID, revisionID);
-			metadata.setMap(map);
-			fileContainer.setMetadata(metadata);
-		} else {
-			logger.warn(
-					"Unable to set revision id {} to the file of resource with id {} because the file was NOT found on storage-hub. This could be related to an item not created via gCat. Skipping it.",
-					revisionID, resourceID);
-		}
-	}
-	
-	public void renameFile(String resourceID, String revisionID) throws Exception {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		try {
-			secretManager.startSession(secret);
-			FileContainer createdfile = storageHubManagement.getPersistedFile();
-			createdfile.rename(resourceID);
-			internalAddRevisionID(resourceID, revisionID);
-		} finally {
-			secretManager.endSession();
-		}
-		
-	}
-	
-	public void addRevisionID(String resourceID, String revisionID) throws Exception {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		try {
-			secretManager.startSession(secret);
-			internalAddRevisionID(resourceID, revisionID);
-		} finally {
-			secretManager.endSession();
-		}
-	}
-	
-	public FileContainer retrievePersistedFile(String id, String mimeType) throws Exception {
-		SecretManager secretManager = SecretManagerProvider.instance.get();
-		Secret secret = Constants.getCatalogueSecret();
-		try {
-			secretManager.startSession(secret);
-			return storageHubManagement.getPersistedFile(id, mimeType);
-		} finally {
-			secretManager.endSession();
-		}
-	}
-	
-	public FileContainer getPersistedFile() {
-		return storageHubManagement.getPersistedFile();
-	}
-	
-}

src/main/resources/api-docs-examples/configuration/create-configuration-request.json

@@ -0,0 +1,19 @@
+{
+    "context": "/gcube/devsec/devVRE",
+    "defaultOrganization": "devvre",
+    "supportedOrganizations": [
+        "nextnext",
+        "devvre"
+    ],
+    "sysAdminToken": "SYS_ADMIN_TOKEN_HERE",
+    "ckanURL": "https://ckan-d-d4s.d4science.org",
+    "solrURL": "https://ckan-d-d4s.d4science.org/solr/",
+    "socialPostEnabled": false,
+    "notificationToUsersEnabled": true,
+    "moderationEnabled": false,
+    "ckanDB": {
+        "url": "jdbc:postgresql://ckan-d-d4s.d4science.org:5432/ckan_dev",
+        "username": "ckan",
+        "password": "PWD_HERE"
+    }
+}

src/main/resources/api-docs-examples/configuration/create-configuration-response.json

@@ -0,0 +1,20 @@
+{
+    "id": "584b8503-a490-4a89-8372-e21830fa716c",
+    "context": "/gcube/devsec/devVRE",
+    "defaultOrganization": "devvre",
+    "supportedOrganizations": [
+        "nextnext",
+        "devvre"
+    ],
+    "sysAdminToken": "SYS_ADMIN_TOKEN",
+    "ckanURL": "https://ckan-d-d4s.d4science.org",
+    "solrURL": "https://ckan-d-d4s.d4science.org/solr/",
+    "socialPostEnabled": false,
+    "notificationToUsersEnabled": true,
+    "moderationEnabled": false,
+    "ckanDB": {
+        "url": "jdbc:postgresql://ckan-d-d4s.d4science.org:5432/ckan_dev",
+        "username": "ckan",
+        "password": "PWD"
+    }
+}

src/main/resources/api-docs-examples/configuration/read-configuration-response.json

@@ -0,0 +1,14 @@
+{
+    "id": "584b8503-a490-4a89-8372-e21830fa716c",
+    "context": "/gcube/devsec/devVRE",
+    "defaultOrganization": "devvre",
+    "supportedOrganizations": [
+        "nextnext",
+        "devvre"
+    ],
+    "ckanURL": "https://ckan-d-d4s.d4science.org",
+    "solrURL": "https://ckan-d-d4s.d4science.org/solr/",
+    "socialPostEnabled": false,
+    "notificationToUsersEnabled": true,
+    "moderationEnabled": false
+}

src/main/resources/api-docs-examples/item/create-item-request.json

@@ -0,0 +1,24 @@
+{
+    "name": "my_test_item",
+    "title": "My Test Item",
+    "license_id": "CC-BY-SA-4.0",
+    "private": false,
+    "notes": "A test item of Luca Frosini",
+    "url": "http://www.d4science.org",
+    "tags": [
+        {
+            "name": "Test"
+        }
+    ],
+    "resources": [],
+    "extras": [
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ]
+}

src/main/resources/api-docs-examples/item/create-item-response.json

@@ -0,0 +1,67 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "Frosini Luca",
+    "relationships_as_object": [],
+    "private": false,
+    "maintainer_email": "luca.frosini@isti.cnr.it",
+    "num_tags": 1,
+    "id": "93b3e578-5cb2-4560-adcb-5512f2449b98",
+    "metadata_created": "2022-09-27T13:54:23.505142",
+    "metadata_modified": "2022-09-27T13:54:23.505150",
+    "author": "Frosini Luca",
+    "author_email": "luca.frosini@isti.cnr.it",
+    "state": "active",
+    "version": null,
+    "creator_user_id": "aabddbb0-b761-4f30-9629-3ca2fdc08eb4",
+    "type": "dataset",
+    "resources": [],
+    "num_resources": 0,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Test",
+            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+            "name": "Test"
+        }
+    ],
+    "groups": [],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "",
+        "created": "2016-05-30T11:30:41.710079",
+        "title": "devVRE",
+        "name": "devvre",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+        "type": "organization",
+        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+        "approval_status": "approved"
+    },
+    "name": "my_test_item",
+    "isopen": true,
+    "url": "http://www.d4science.org",
+    "notes": "A test item of Luca Frosini",
+    "extras": [
+        {
+            "key": "Item URL",
+            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item"
+        },
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "My Test Item",
+    "revision_id": "47af0aa8-bf5e-4ff8-adf3-d2f120cbd4a5"
+}

src/main/resources/api-docs-examples/item/patch-item-request.json

@@ -0,0 +1,4 @@
+{
+    "name": "my_test_item",
+    "title": "Patched Title of My Test Item"
+}

src/main/resources/api-docs-examples/item/patch-item-response.json

@@ -0,0 +1,67 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "Frosini Luca",
+    "relationships_as_object": [],
+    "private": false,
+    "maintainer_email": "luca.frosini@isti.cnr.it",
+    "num_tags": 1,
+    "id": "93b3e578-5cb2-4560-adcb-5512f2449b98",
+    "metadata_created": "2022-09-27T13:54:23.505142",
+    "metadata_modified": "2022-09-27T13:57:28.825790",
+    "author": "Frosini Luca",
+    "author_email": "luca.frosini@isti.cnr.it",
+    "state": "active",
+    "version": null,
+    "creator_user_id": "aabddbb0-b761-4f30-9629-3ca2fdc08eb4",
+    "type": "dataset",
+    "resources": [],
+    "num_resources": 0,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Test",
+            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+            "name": "Test"
+        }
+    ],
+    "groups": [],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "",
+        "created": "2016-05-30T11:30:41.710079",
+        "title": "devVRE",
+        "name": "devvre",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+        "type": "organization",
+        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+        "approval_status": "approved"
+    },
+    "name": "my_test_item",
+    "isopen": true,
+    "url": "http://www.d4science.org",
+    "notes": "A test item of Luca Frosini",
+     "extras": [
+        {
+            "key": "Item URL",
+            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item"
+        },
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Patched Title of My Test Item",
+    "revision_id": "65c6bce2-c5c6-47e9-9264-5891abe78000"
+}

src/main/resources/api-docs-examples/item/read-item-response.json

@@ -0,0 +1,67 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "Frosini Luca",
+    "relationships_as_object": [],
+    "private": false,
+    "maintainer_email": "luca.frosini@isti.cnr.it",
+    "num_tags": 1,
+    "id": "93b3e578-5cb2-4560-adcb-5512f2449b98",
+    "metadata_created": "2022-09-27T13:54:23.505142",
+    "metadata_modified": "2022-09-27T13:54:23.505150",
+    "author": "Frosini Luca",
+    "author_email": "luca.frosini@isti.cnr.it",
+    "state": "active",
+    "version": null,
+    "creator_user_id": "aabddbb0-b761-4f30-9629-3ca2fdc08eb4",
+    "type": "dataset",
+    "resources": [],
+    "num_resources": 0,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Test",
+            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+            "name": "Test"
+        }
+    ],
+    "groups": [],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "",
+        "created": "2016-05-30T11:30:41.710079",
+        "title": "devVRE",
+        "name": "devvre",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+        "type": "organization",
+        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+        "approval_status": "approved"
+    },
+    "name": "my_test_item",
+    "isopen": true,
+    "url": "http://www.d4science.org",
+    "notes": "A test item of Luca Frosini",
+    "extras": [
+        {
+            "key": "Item URL",
+            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item"
+        },
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "My Test Item",
+    "revision_id": "47af0aa8-bf5e-4ff8-adf3-d2f120cbd4a5"
+}

src/main/resources/api-docs-examples/item/reject.json

@@ -0,0 +1,4 @@
+{
+	"system:cm_item_status":"rejected",
+	"message": "The indicated language does not match with the item resource language"
+}

src/main/resources/api-docs-examples/item/update-item-request.json

@@ -0,0 +1,67 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "Frosini Luca",
+    "relationships_as_object": [],
+    "private": false,
+    "maintainer_email": "luca.frosini@isti.cnr.it",
+    "num_tags": 1,
+    "id": "93b3e578-5cb2-4560-adcb-5512f2449b98",
+    "metadata_created": "2022-09-27T13:54:23.505142",
+    "metadata_modified": "2022-09-27T13:54:23.505150",
+    "author": "Frosini Luca",
+    "author_email": "luca.frosini@isti.cnr.it",
+    "state": "active",
+    "version": null,
+    "creator_user_id": "aabddbb0-b761-4f30-9629-3ca2fdc08eb4",
+    "type": "dataset",
+    "resources": [],
+    "num_resources": 0,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Test",
+            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+            "name": "Test"
+        }
+    ],
+    "groups": [],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "",
+        "created": "2016-05-30T11:30:41.710079",
+        "title": "devVRE",
+        "name": "devvre",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+        "type": "organization",
+        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+        "approval_status": "approved"
+    },
+    "name": "my_test_item",
+    "isopen": true,
+    "url": "http://www.d4science.org",
+    "notes": "A test item of Luca Frosini",
+    "extras": [
+        {
+            "key": "Item URL",
+            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item"
+        },
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Updated title of My Test Item",
+    "revision_id": "47af0aa8-bf5e-4ff8-adf3-d2f120cbd4a5"
+}

src/main/resources/api-docs-examples/item/update-item-response.json

@@ -0,0 +1,67 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "Frosini Luca",
+    "relationships_as_object": [],
+    "private": false,
+    "maintainer_email": "luca.frosini@isti.cnr.it",
+    "num_tags": 1,
+    "id": "93b3e578-5cb2-4560-adcb-5512f2449b98",
+    "metadata_created": "2022-09-27T13:54:23.505142",
+    "metadata_modified": "2022-09-27T13:56:52.746494",
+    "author": "Frosini Luca",
+    "author_email": "luca.frosini@isti.cnr.it",
+    "state": "active",
+    "version": null,
+    "creator_user_id": "aabddbb0-b761-4f30-9629-3ca2fdc08eb4",
+    "type": "dataset",
+    "resources": [],
+    "num_resources": 0,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Test",
+            "id": "fec9de86-51a2-41b0-aef4-ba06eb39e16d",
+            "name": "Test"
+        }
+    ],
+    "groups": [],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "",
+        "created": "2016-05-30T11:30:41.710079",
+        "title": "devVRE",
+        "name": "devvre",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "a7eee485-a6d5-4a7b-8f73-b0ed999d5b03",
+        "type": "organization",
+        "id": "3571cca5-b0ae-4dc6-b791-434a8e062ce5",
+        "approval_status": "approved"
+    },
+    "name": "my_test_item",
+    "isopen": true,
+    "url": "http://www.d4science.org",
+    "notes": "A test item of Luca Frosini",
+    "extras": [
+        {
+            "key": "Item URL",
+            "value": "https://data.dev.d4science.org/ctlg/devVRE/my_test_item"
+        },
+        {
+            "key": "Language",
+            "value": "EN"
+        },
+        {
+            "key": "system:type",
+            "value": "EmptyProfile"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Updated title of My Test Item",
+    "revision_id": "bfa50b95-e936-4843-a405-3d6ff7e427aa"
+}

src/main/resources/api-docs-examples/namespace/list-namespace-response.json

@@ -0,0 +1,32 @@
+[
+	{
+		"id": "ClassificationInformation",
+		"title": "Classification Information",
+		"name": "ClassificationInformation",
+		"description": "Classification Information"
+	},
+	{
+		"id": "LocationInformation",
+		"title": "Location Information",
+		"name": "LocationInformation",
+		"description": "Location Information"
+	},
+	{
+		"id": "ContactInformation",
+		"title": "Contact Information",
+		"name": "ContactInformation",
+		"description": "Contact Information"
+	},
+	{
+		"id": "OtherInformation",
+		"title": "Other Information",
+		"name": "OtherInformation",
+		"description": "Other Information"
+	},
+	{
+		"id": "AvailabilityInformation",
+		"title": "Availability Information",
+		"name": "AvailabilityInformation",
+		"description": "Availability Information"
+	}
+]

src/main/resources/api-docs-examples/profile/create-profile-request.xml

@@ -0,0 +1,8 @@
+<metadataformat type="EmptyProfile">
+	<metadatafield>
+		<fieldName>test</fieldName>
+		<mandatory>false</mandatory>
+		<dataType>String</dataType>
+		<note>Test field</note>
+	</metadatafield>
+</metadataformat>

src/main/resources/api-docs-examples/profile/create-profile-response.xml

@@ -0,0 +1,8 @@
+<metadataformat type="EmptyProfile">
+	<metadatafield>
+		<fieldName>test</fieldName>
+		<mandatory>false</mandatory>
+		<dataType>String</dataType>
+		<note>Test field</note>
+	</metadatafield>
+</metadataformat>

src/main/resources/api-docs-examples/profile/read-profile-response.json

@@ -0,0 +1,11 @@
+{
+	"metadataformat": {
+		"metadatafield": {
+			"note": "Test field",
+			"fieldName": "test",
+			"dataType": "String",
+			"mandatory": false
+		},
+		"type": "EmptyProfile"
+	}
+}

src/main/resources/api-docs-examples/profile/read-profile-response.xml

@@ -0,0 +1,8 @@
+<metadataformat type="EmptyProfile">
+	<metadatafield>
+		<fieldName>test</fieldName>
+		<mandatory>false</mandatory>
+		<dataType>String</dataType>
+		<note>Test field</note>
+	</metadatafield>
+</metadataformat>

src/main/resources/api-docs-examples/user/list-user-response.json

@@ -0,0 +1,32 @@
+[
+	{
+        "openid": null,
+        "about": "",
+        "display_name": "Blue Mister",
+        "name": "mister_blue",
+        "created": "2022-04-08T14:31:03.978191",
+        "email_hash": "XXXXXXX",
+        "sysadmin": false,
+        "activity_streams_email_notifications": false,
+        "state": "active",
+        "number_of_edits": 28,
+        "fullname": "Blue Mister",
+        "id": "c9f7a81d-75f6-4cf8-aab9-b4c90dce9405",
+        "number_created_packages": 0
+    },
+    {
+        "openid": null,
+        "about": "",
+        "display_name": "Brown Mister",
+        "name": "mister_brown",
+        "created": "2022-04-12T17:06:51.075728",
+        "email_hash": "XXXXXXX",
+        "sysadmin": false,
+        "activity_streams_email_notifications": false,
+        "state": "active",
+        "number_of_edits": 0,
+        "fullname": "Brown Mister",
+        "id": "7445ef41-08d8-4559-8750-3232eb0e1914",
+        "number_created_packages": 0
+    }
+]

src/main/resources/api-docs-examples/user/read-user-response.json

@@ -0,0 +1,17 @@
+{
+	"openid": null,
+	"about": "",
+	"apikey": "XXXXXXX",
+	"display_name": "Frosini Luca",
+	"name": "luca_frosini",
+	"created": "2016-12-09T15:18:21.915742",
+	"email_hash": "XXXXXXX",
+	"email": "XXXXXXX@XXXXXXX",
+	"sysadmin": false,
+	"activity_streams_email_notifications": false,
+	"state": "active",
+	"number_of_edits": 1622,
+	"fullname": "Frosini Luca",
+	"id": "aabddbb0-b761-4f30-9629-3ca2fdc08eb4",
+	"number_created_packages": 4
+}

src/main/resources/query-template/01-get-calls-for-query-template.json

@@ -0,0 +1,39 @@
+{
+	"type" : "QueryTemplate",
+	"name" : "GCat-Get-CallsFor-to-VirtualService",
+	"description" : "The following query return all CallsFor relation from the EService of gcat identified by the UUID provided as parameter to the Virtual Service with name 'catalogue-virtual-service'. The content of the request to run this query template will be something like {\"$uuid\": \"335580b6-c164-4506-980a-21e5bcf8dbcf\"}",
+	"template" : {
+		"type" : "CallsFor",
+		"source" : {
+			"type" : "EService",
+			"id" : "$uuid",
+			"consistsOf" : [ {
+				"type" : "IsIdentifiedBy",
+				"target" : {
+					"type" : "SoftwareFacet",
+					"group" : "org.gcube.data-catalogue",
+					"name" : "gcat"
+				}
+			} ]
+		},
+		"target" : {
+			"type" : "VirtualService",
+			"consistsOf" : [ {
+				"type" : "IsIdentifiedBy",
+				"target" : {
+					"type" : "SoftwareFacet",
+					"group" : "org.gcube.data-catalogue",
+					"name" : "catalogue-virtual-service"
+				}
+			} ]
+		}
+	},
+	"templateVariables" : {
+		"$uuid" : {
+			"type": "TemplateVariable",
+			"name": "$uuid",
+			"description": "The uuid of the gCat EService, e.g. 335580b6-c164-4506-980a-21e5bcf8dbcf. Please note that the default value has no meaning but we need a valid value so that the query can be tested by the resource-registry service.",
+			"defaultValue": "335580b6-c164-4506-980a-21e5bcf8dbcf"
+		}
+	}	
+}

src/main/resources/query/01-get-catalogue-virtual-service.json

@@ -0,0 +1,13 @@
+{
+	"type": "VirtualService",
+	"consistsOf": [
+		{
+			"type": "IsIdentifiedBy",
+			"target": {
+				"type": "SoftwareFacet",
+				"group": "org.gcube.data-catalogue",
+				"name": "catalogue-virtual-service"
+			}
+		}
+	]
+}

src/main/resources/query/02-get-catalogue-configuration.json

@@ -0,0 +1,30 @@
+{
+	"type": "Configuration",
+	"consistsOf": [
+		{
+			"type": "IsIdentifiedBy",
+			"target": {
+				"type": "IdentifierFacet",
+				"value": "catalogue-configuration"
+			}
+		}
+	],
+	"isRelatedTo": [
+		{
+			"type": "IsCustomizedBy",
+			"source": {
+				"type": "VirtualService",
+				"consistsOf": [
+					{
+						"type": "IsIdentifiedBy",
+						"target": {
+							"type": "SoftwareFacet",
+							"group": "org.gcube.data-catalogue",
+							"name": "catalogue-virtual-service"
+						}
+					}
+				]
+			}
+		}
+	]
+}

src/main/resources/query/03-get-simple-facet-of-catalogue-configuration.json

@@ -0,0 +1,36 @@
+{
+	"type": "SimpleFacet",
+	"_source": {
+		"type": "ConsistsOf",
+		"source": {
+			"type": "Configuration",
+			"consistsOf": [
+				{
+					"type": "IsIdentifiedBy",
+					"target": {
+						"type": "IdentifierFacet",
+						"value": "gcat-configuration"
+					}
+				}
+			],
+			"isRelatedTo": [
+				{
+					"type": "IsCustomizedBy",
+					"source": {
+						"type": "VirtualService",
+						"consistsOf": [
+							{
+								"type": "IsIdentifiedBy",
+								"target": {
+									"type": "SoftwareFacet",
+									"group": "org.gcube.data-catalogue",
+									"name": "catalogue-virtual-service"
+								}
+							}
+						]
+					}
+				}
+			]
+		}
+	}
+}

src/main/resources/query/04-get-ckan-service.json

@@ -0,0 +1,31 @@
+{
+	"type": "EService",
+	"consistsOf": [
+		{
+			"type": "IsIdentifiedBy",
+			"target": {
+				"type": "SoftwareFacet",
+				"group": "ckan-organization",
+				"name": "ckan"
+			}
+		}
+	],
+	"isRelatedTo": [
+		{
+			"type": "CallsFor",
+			"source": {
+				"type": "VirtualService",
+				"consistsOf": [
+					{
+						"type": "IsIdentifiedBy",
+						"target": {
+							"type": "SoftwareFacet",
+							"group": "org.gcube.data-catalogue",
+							"name": "catalogue-virtual-service"
+						}
+					}
+				]
+			}
+		}
+	]
+}

src/main/resources/query/05-get-access-point-facet-of-ckan-service.json

@@ -0,0 +1,37 @@
+{
+	"type": "AccessPointFacet",
+	"_source": {
+		"type": "ConsistsOf",
+		"source": {
+			"type": "EService",
+			"consistsOf": [
+				{
+					"type": "IsIdentifiedBy",
+					"target": {
+						"type": "SoftwareFacet",
+						"group": "ckan-organization",
+						"name": "ckan"
+					}
+				}
+			],
+			"isRelatedTo": [
+				{
+					"type": "CallsFor",
+					"source": {
+						"type": "VirtualService",
+						"consistsOf": [
+							{
+								"type": "IsIdentifiedBy",
+								"target": {
+									"type": "SoftwareFacet",
+									"group": "org.gcube.data-catalogue",
+									"name": "catalogue-virtual-service"
+								}
+							}
+						]
+					}
+				}
+			]
+		}
+	}
+}

src/main/resources/query/06-get-postgres-ckan-db.json

@@ -0,0 +1,49 @@
+{
+	"type": "EService",
+	"consistsOf": [
+		{
+			"type": "IsIdentifiedBy",
+			"target": {
+				"type": "SoftwareFacet",
+				"group": "org.postgresql",
+				"name": "postgresql"
+			}
+		}
+	],
+	"isRelatedTo": [
+		{
+			"type": "Uses",
+			"source": {
+				"type": "EService",
+				"consistsOf": [
+					{
+						"type": "IsIdentifiedBy",
+						"target": {
+							"type": "SoftwareFacet",
+							"group": "ckan-organization",
+							"name": "ckan"
+						}
+					}
+				],
+				"isRelatedTo": [
+					{
+						"type": "CallsFor",
+						"source": {
+							"type": "VirtualService",
+							"consistsOf": [
+								{
+									"type": "IsIdentifiedBy",
+									"target": {
+										"type": "SoftwareFacet",
+										"group": "org.gcube.data-catalogue",
+										"name": "catalogue-virtual-service"
+									}
+								}
+							]
+						}
+					}
+				]
+			}
+		}
+	]
+}

src/main/resources/query/07-get-access-point-facet-of-postgres-ckan-db.json

@@ -0,0 +1,55 @@
+{
+	"type": "AccessPointFacet",
+	"_source": {
+		"type": "ConsistsOf",
+		"source": {
+			"type": "EService",
+			"consistsOf": [
+				{
+					"type": "IsIdentifiedBy",
+					"target": {
+						"type": "SoftwareFacet",
+						"group": "org.postgresql",
+						"name": "postgresql"
+					}
+				}
+			],
+			"isRelatedTo": [
+				{
+					"type": "Uses",
+					"source": {
+						"type": "EService",
+						"consistsOf": [
+							{
+								"type": "IsIdentifiedBy",
+								"target": {
+									"type": "SoftwareFacet",
+									"group": "ckan-organization",
+									"name": "ckan"
+								}
+							}
+						],
+						"isRelatedTo": [
+							{
+								"type": "CallsFor",
+								"source": {
+									"type": "VirtualService",
+									"consistsOf": [
+										{
+											"type": "IsIdentifiedBy",
+											"target": {
+												"type": "SoftwareFacet",
+												"group": "org.gcube.data-catalogue",
+												"name": "catalogue-virtual-service"
+											}
+										}
+									]
+								}
+							}
+						]
+					}
+				}
+			]
+		}
+	}
+}

src/main/resources/query/08-get-solr-service.json

@@ -0,0 +1,49 @@
+{
+	"type": "EService",
+	"consistsOf": [
+		{
+			"type": "IsIdentifiedBy",
+			"target": {
+				"type": "SoftwareFacet",
+				"group": "org.apache.solr",
+				"name": "solr"
+			}
+		}
+	],
+	"isRelatedTo": [
+		{
+			"type": "Uses",
+			"source": {
+				"type": "EService",
+				"consistsOf": [
+					{
+						"type": "IsIdentifiedBy",
+						"target": {
+							"type": "SoftwareFacet",
+							"group": "ckan-organization",
+							"name": "ckan"
+						}
+					}
+				],
+				"isRelatedTo": [
+					{
+						"type": "CallsFor",
+						"source": {
+							"type": "VirtualService",
+							"consistsOf": [
+								{
+									"type": "IsIdentifiedBy",
+									"target": {
+										"type": "SoftwareFacet",
+										"group": "org.gcube.data-catalogue",
+										"name": "catalogue-virtual-service"
+									}
+								}
+							]
+						}
+					}
+				]
+			}
+		}
+	]
+}

src/main/resources/query/09-get-access-point-facet-of-solr-service.json

@@ -0,0 +1,55 @@
+{
+	"type": "AccessPointFacet",
+	"_source": {
+		"type": "ConsistsOf",
+		"source": {
+			"type": "EService",
+			"consistsOf": [
+				{
+					"type": "IsIdentifiedBy",
+					"target": {
+						"type": "SoftwareFacet",
+						"group": "org.apache.solr",
+						"name": "solr"
+					}
+				}
+			],
+			"isRelatedTo": [
+				{
+					"type": "Uses",
+					"source": {
+						"type": "EService",
+						"consistsOf": [
+							{
+								"type": "IsIdentifiedBy",
+								"target": {
+									"type": "SoftwareFacet",
+									"group": "ckan-organization",
+									"name": "ckan"
+								}
+							}
+						],
+						"isRelatedTo": [
+							{
+								"type": "CallsFor",
+								"source": {
+									"type": "VirtualService",
+									"consistsOf": [
+										{
+											"type": "IsIdentifiedBy",
+											"target": {
+												"type": "SoftwareFacet",
+												"group": "org.gcube.data-catalogue",
+												"name": "catalogue-virtual-service"
+											}
+										}
+									]
+								}
+							}
+						]
+					}
+				}
+			]
+		}
+	}
+}

src/main/resources/query/GraphOfResources.txt

@@ -0,0 +1,30 @@
+
+                                                                                  Configuration
+                                                                           ---------------------------
+                                                          IsCustomizedBy   |                         |
+                                                        -----------------> | catalogue-configuration |
+                                                       /                   |                         |
+                                                      /                    ---------------------------
+     EService                        VirtualService  /
+   ------------               -----------------------------
+   |          |   CallsFor    |                           |
+   |   gcat   | ------------> | catalogue-virtual-service |
+   |          |               |                           |
+   ------------               -----------------------------
+                                                    \                                                                 EService
+                                                     \                                                          --------------------
+                                                      \                                             Uses        |                  |                         
+                                                       \                                    ------------------> | postgres-ckan-db |
+                                                        \                                  /                    |                  |
+                                                         \                     EService   /                     --------------------
+                                                          \                -----------------
+                                                           \   CallsFor    |               |
+                                                            -------------> |     ckan      |
+                                                                           |               |
+                                                                           -----------------                          EService   
+                                                                                          \                     --------------------
+                                                                                           \         Uses       |                  |
+                                                                                            ------------------> |       solr       |
+                                                                                                                |                  |
+                                                                                                                --------------------
+