updated

solved Incident #22230

.classpath

@@ -9,6 +9,7 @@
 	<classpathentry excluding="**" kind="src" output="target/classes" path="src/main/resources">
 		<attributes>
 			<attribute name="maven.pomderived" value="true"/>
+			<attribute name="optional" value="true"/>
 		</attributes>
 	</classpathentry>
 	<classpathentry kind="src" output="target/test-classes" path="src/test/java">
@@ -22,12 +23,12 @@
 		<attributes>
 			<attribute name="test" value="true"/>
 			<attribute name="maven.pomderived" value="true"/>
+			<attribute name="optional" value="true"/>
 		</attributes>
 	</classpathentry>
 	<classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">
 		<attributes>
 			<attribute name="maven.pomderived" value="true"/>
-			<attribute name="org.eclipse.jst.component.dependency" value="/WEB-INF/lib"/>
 		</attributes>
 	</classpathentry>
 	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8">

.gitignore

@@ -1 +1,2 @@
 target
+/.externalToolBuilders/

.settings/org.eclipse.wst.common.component

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?><project-modules id="moduleCoreId" project-version="1.5.0">
-                                                                                                
+                                                                                                    
+    
     
     
     
@@ -23,7 +24,8 @@
     
     
     <wb-module deploy-name="storagehub">
-                                                                                                                                                                                                
+                                                                                                                                                                                                        
+        
         
         
         
@@ -47,7 +49,8 @@
         
         
         <wb-resource deploy-path="/" source-path="/target/m2e-wtp/web-resources"/>
-                                                                                                                                                                                                
+                                                                                                                                                                                                        
+        
         
         
         
@@ -71,7 +74,8 @@
         
         
         <wb-resource deploy-path="/" source-path="/src/main/webapp" tag="defaultRootSource"/>
-                                                                                                                                                                                                
+                                                                                                                                                                                                        
+        
         
         
         
@@ -95,7 +99,8 @@
         
         
         <wb-resource deploy-path="/WEB-INF/classes" source-path="/src/main/java"/>
-                                                                                                                                                                                                
+                                                                                                                                                                                                        
+        
         
         
         
@@ -119,13 +124,8 @@
         
         
         <wb-resource deploy-path="/WEB-INF/classes" source-path="/src/main/resources"/>
-        <dependent-module archiveName="storagehub-model-1.1.0-SNAPSHOT.jar" deploy-path="/WEB-INF/lib" handle="module:/resource/storagehub-model/storagehub-model">
-            <dependency-type>uses</dependency-type>
-        </dependent-module>
-        <dependent-module archiveName="storagehub-script-utils-1.0.0.jar" deploy-path="/WEB-INF/lib" handle="module:/resource/storagehub-scripting-util/storagehub-scripting-util">
-            <dependency-type>uses</dependency-type>
-        </dependent-module>
-                                                                                                                                                                                                
+                                                                                                                                                                                                        
+        
         
         
         
@@ -149,7 +149,8 @@
         
         
         <property name="context-root" value="storagehub"/>
-                                                                                                                                                                                                
+                                                                                                                                                                                                        
+        
         
         
         
@@ -173,7 +174,8 @@
         
         
         <property name="java-output-path" value="/storagehub-webapp_BRANCH/target/classes"/>
-                                                                                                                                                                                            
+                                                                                                                                                                                                    
+    
     
     
     
@@ -197,7 +199,8 @@
     
     
     </wb-module>
-                                                                                            
+                                                                                                
+
 
 
 

CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v1.4.2] - [2023-05-22]
+
+- added enunciate libraries for documentation
+
+## [v1.4.1] - [2022-11-14]
+
+- added libraries to manage different image format
+
 ## [v1.4.0] - [2021-10-07]
 
 - slow query removed from VRE retrieving and recents

distro/gcube-app.xml

@@ -1,7 +1,8 @@
 <application mode='online'>
 		<name>StorageHub</name>
 		<group>DataAccess</group>
-		<version>${version}</version>
+		<version>1.4.2</version>
 		<description>Storage Hub webapp</description>
 		<local-persistence location='target' />
+		<exclude>/workspace/api-docs/*</exclude>
 </application>

enunciate.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<enunciate
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:noNamespaceSchemaLocation="http://enunciate.webcohesion.com/schemas/enunciate-2.14.0.xsd">
+	<api-classes>
+		<!-- Use patterns to exclude classes... e.g. for URI-Resolver <exclude 
+			pattern="org.gcube.datatransfer.resolver.services.DocsGenerator" /> -->
+	</api-classes>
+	<modules>
+		<gwt-json-overlay disabled="true" />
+		<php-json-client disabled="true" />
+		<ruby-json-client disabled="true" />
+		<java-json-client disabled="true" />
+		<javascript-client disabled="true" />
+		<docs docsDir="${project.build.directory}" docsSubdir="api-docs" />
+		
+		<docs
+			freemarkerTemplate="${project.basedir}/src/main/resources/META-INF/enunciate/d4science_docs.fmt">
+			<additional-css
+				file="css/d4science_enunciate_custom.css" />
+		</docs>
+		<swagger basePath="/workspace" />
+	</modules>
+</enunciate>

pom.xml

@@ -1,29 +1,23 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-
 	<parent>
 		<artifactId>maven-parent</artifactId>
 		<groupId>org.gcube.tools</groupId>
 		<version>1.1.0</version>
 		<relativePath />
 	</parent>
-
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>org.gcube.data.access</groupId>
 	<artifactId>storagehub</artifactId>
-	<version>1.4.0</version>
+	<version>1.4.2</version>
 	<name>storagehub</name>
-
 	<scm>
 		<connection>scm:git:https://code-repo.d4science.org/gCubeSystem/storagehub.git</connection>
 		<developerConnection>scm:git:https://code-repo.d4science.org/gCubeSystem/storagehub.git</developerConnection>
 		<url>https://code-repo.d4science.org/gCubeSystem/storagehub</url>
 	</scm>
-
-
 	<packaging>war</packaging>
-
 	<properties>
 		<webappDirectory>${project.basedir}/src/main/webapp/WEB-INF</webappDirectory>
 		<jackrabbit.version>2.20.2</jackrabbit.version>
@@ -32,21 +26,19 @@
 		<tomcat.version>7.0.40</tomcat.version>
 		<jetty.version>6.1.26</jetty.version>
 		<tika.version>1.21</tika.version>
-
 		<distroDirectory>${project.basedir}/distro</distroDirectory>
 		<description>REST web service for Jackrabbit</description>
 		<warname>storagehub</warname>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
-
+		<enunciate.version>2.14.0</enunciate.version>
 	</properties>
-
 	<dependencyManagement>
 		<dependencies>
 			<dependency>
 				<groupId>org.gcube.distribution</groupId>
 				<artifactId>gcube-smartgears-bom</artifactId>
-				<version>2.0.0</version>
+				<version>2.1.1</version>
 				<type>pom</type>
 				<scope>import</scope>
 			</dependency>
@@ -57,87 +49,85 @@
 			</dependency>
 		</dependencies>
 	</dependencyManagement>
-
 	<dependencies>
-
 		<dependency>
 			<groupId>org.aspectj</groupId>
 			<artifactId>aspectjrt</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.core</groupId>
 			<artifactId>common-smartgears</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.core</groupId>
 			<artifactId>common-smartgears-app</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.common</groupId>
 			<artifactId>authorization-control-library</artifactId>
 			<version>[1.0.0,2.0.0-SNAPSHOT)</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.common</groupId>
 			<artifactId>common-authorization</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.core</groupId>
 			<artifactId>common-encryption</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.core</groupId>
 			<artifactId>common-scope-maps</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.core</groupId>
 			<artifactId>common-scope</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.common</groupId>
 			<artifactId>storagehub-model</artifactId>
-			<version>[1.0.0,2.0.0-SNAPSHOT)</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.data.access</groupId>
 			<artifactId>storagehub-script-utils</artifactId>
-			<version>[1.0.0-SNAPSHOT,2.0.0)</version>
+			<version>[1.0.0, 2.0.0-SNAPSHOT)</version>
 		</dependency>
-
 		<dependency>
 			<groupId>com.itextpdf</groupId>
 			<artifactId>itextpdf</artifactId>
 			<version>5.5.13.2</version>
 		</dependency>
-
+		<!-- needed to manage strange image types -->
+		<dependency>
+			<groupId>com.twelvemonkeys.imageio</groupId>
+			<artifactId>imageio-jpeg</artifactId>
+			<version>3.3.2</version>
+		</dependency>
+		<dependency>
+			<groupId>com.twelvemonkeys.imageio</groupId>
+			<artifactId>imageio-bmp</artifactId>
+			<version>3.3.2</version>
+		</dependency>
+		<dependency>
+			<groupId>com.twelvemonkeys.imageio</groupId>
+			<artifactId>imageio-core</artifactId>
+			<version>3.3.2</version>
+		</dependency>
 		<!-- https://mvnrepository.com/artifact/org.bouncycastle/bcprov-jdk15on -->
 		<dependency>
 			<groupId>org.bouncycastle</groupId>
 			<artifactId>bcprov-jdk15on</artifactId>
 			<version>1.62</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.slf4j</groupId>
 			<artifactId>slf4j-api</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.common</groupId>
 			<artifactId>gxJRS</artifactId>
 		</dependency>
-
 		<!-- JCR dependencies -->
-
 		<dependency>
 			<groupId>javax.jcr</groupId>
 			<artifactId>jcr</artifactId>
@@ -158,74 +148,67 @@
 			<artifactId>jackrabbit-jcr-server</artifactId>
 			<version>${jackrabbit.version}</version>
 		</dependency>
-
 		<dependency>
 			<groupId>com.fasterxml.jackson.core</groupId>
 			<artifactId>jackson-annotations</artifactId>
 			<version>${jackson.version}</version>
 		</dependency>
-
 		<dependency>
 			<groupId>com.fasterxml.jackson.core</groupId>
 			<artifactId>jackson-core</artifactId>
 			<version>${jackson.version}</version>
 		</dependency>
-
 		<dependency>
 			<groupId>com.fasterxml.jackson.core</groupId>
 			<artifactId>jackson-databind</artifactId>
 			<version>${jackson.version}</version>
 		</dependency>
-
-
 		<!-- https://mvnrepository.com/artifact/org.apache.tika/tika-parsers -->
 		<dependency>
 			<groupId>org.apache.tika</groupId>
 			<artifactId>tika-parsers</artifactId>
 			<version>1.21</version>
 		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/org.apache.tika/tika-core -->
 		<dependency>
 			<groupId>org.apache.tika</groupId>
 			<artifactId>tika-core</artifactId>
 			<version>1.21</version>
 		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/net.bull.javamelody/javamelody-core -->
 		<dependency>
 			<groupId>net.bull.javamelody</groupId>
 			<artifactId>javamelody-core</artifactId>
 			<version>1.82.0</version>
 		</dependency>
-
-
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<version>1.18.2</version>
+			<scope>provided</scope>
+		</dependency>
 		<!-- jersey & weld -->
 		<dependency>
 			<groupId>javax.servlet</groupId>
 			<artifactId>javax.servlet-api</artifactId>
 			<version>3.0.1</version>
 		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/javax.interceptor/javax.interceptor-api -->
 		<dependency>
 			<groupId>javax.interceptor</groupId>
 			<artifactId>javax.interceptor-api</artifactId>
 			<version>1.2.2</version>
 		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/javax.enterprise/cdi-api -->
 		<dependency>
 			<groupId>javax.enterprise</groupId>
 			<artifactId>cdi-api</artifactId>
 			<version>2.0</version>
 		</dependency>
-
 		<dependency>
 			<groupId>javax.ws.rs</groupId>
 			<artifactId>javax.ws.rs-api</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.glassfish.jersey.containers</groupId>
 			<artifactId>jersey-container-servlet</artifactId>
@@ -234,14 +217,12 @@
 			<groupId>org.glassfish.jersey.containers</groupId>
 			<artifactId>jersey-container-servlet-core</artifactId>
 		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/org.glassfish.jersey.inject/jersey-hk2 -->
 		<dependency>
 			<groupId>org.glassfish.jersey.inject</groupId>
 			<artifactId>jersey-hk2</artifactId>
 			<version>2.30.1</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.glassfish.jersey.core</groupId>
 			<artifactId>jersey-server</artifactId>
@@ -259,87 +240,67 @@
 			<artifactId>weld-servlet-core</artifactId>
 			<version>3.1.0.Final</version>
 		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/org.jboss/jandex -->
 		<dependency>
 			<groupId>org.jboss</groupId>
 			<artifactId>jandex</artifactId>
 			<version>2.2.2.Final</version>
 		</dependency>
-
-		<dependency>
-			<groupId>javax.servlet</groupId>
-			<artifactId>javax.servlet-api</artifactId>
-			<version>3.0.1</version>
-		</dependency>
-
 		<!-- https://mvnrepository.com/artifact/org.glassfish.jersey.core/jersey-common -->
 		<dependency>
 			<groupId>org.glassfish.jersey.core</groupId>
 			<artifactId>jersey-common</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.glassfish.jersey.media</groupId>
 			<artifactId>jersey-media-json-jackson</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>org.glassfish.jersey.media</groupId>
 			<artifactId>jersey-media-multipart</artifactId>
 		</dependency>
-
 		<dependency>
 			<groupId>postgresql</groupId>
 			<artifactId>postgresql</artifactId>
 			<version>9.1-901.jdbc4</version>
 			<scope>runtime</scope>
 		</dependency>
-
 		<!-- Storage dependencies -->
 		<dependency>
 			<groupId>org.gcube.contentmanagement</groupId>
 			<artifactId>storage-manager-core</artifactId>
 			<version>[3.0.0-SNAPSHOT,4.0.0-SNAPSHOT)</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.gcube.contentmanagement</groupId>
 			<artifactId>storage-manager-wrapper</artifactId>
 			<version>[3.0.0-SNAPSHOT,4.0.0-SNAPSHOT)</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.reflections</groupId>
 			<artifactId>reflections</artifactId>
 			<version>0.9.10</version>
 		</dependency>
-
 		<dependency>
 			<groupId>com.google.guava</groupId>
 			<artifactId>guava</artifactId>
 			<version>16.0</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.apache.commons</groupId>
 			<artifactId>commons-compress</artifactId>
 			<version>1.17</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.tukaani</groupId>
 			<artifactId>xz</artifactId>
 			<version>1.5</version>
 		</dependency>
-
-
 		<dependency>
 			<groupId>org.glassfish.jersey.test-framework.providers</groupId>
 			<artifactId>jersey-test-framework-provider-simple</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 		<dependency>
 			<groupId>org.apache.derby</groupId>
 			<artifactId>derby</artifactId>
@@ -352,7 +313,6 @@
 			<version>10.8.2.2</version>
 			<scope>test</scope>
 		</dependency>
-
 		<dependency>
 			<groupId>com.googlecode.jeeunit</groupId>
 			<artifactId>jeeunit</artifactId>
@@ -365,20 +325,29 @@
 			<artifactId>gson</artifactId>
 			<version>2.7</version>
 		</dependency>
-
 		<dependency>
 			<groupId>ch.qos.logback</groupId>
 			<artifactId>logback-classic</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 		<dependency>
 			<groupId>com.vlkan.rfos</groupId>
 			<artifactId>rotating-fos</artifactId>
 			<version>0.9.2</version>
 		</dependency>
-
-
+		<!-- enunciate deps -->
+		<dependency>
+			<groupId>com.webcohesion.enunciate</groupId>
+			<artifactId>enunciate-core-annotations</artifactId>
+			<version>${enunciate.version}</version>
+			<scope>provided</scope>
+		</dependency>
+		<dependency>
+			<groupId>com.webcohesion.enunciate</groupId>
+			<artifactId>enunciate-rt-util</artifactId>
+			<version>${enunciate.version}</version>
+			<scope>provided</scope>
+		</dependency>
 		<!-- https://mvnrepository.com/artifact/org.mockito/mockito-all -->
 		<dependency>
 			<groupId>org.mockito</groupId>
@@ -386,14 +355,11 @@
 			<version>1.9.5</version>
 			<scope>test</scope>
 		</dependency>
-
-
 		<dependency>
 			<groupId>org.slf4j</groupId>
 			<artifactId>jul-to-slf4j</artifactId>
 			<version>${slf4j.version}</version>
 		</dependency>
-
 		<dependency>
 			<groupId>org.jboss.weld.se</groupId>
 			<artifactId>weld-se</artifactId>
@@ -406,19 +372,16 @@
 			<version>4.11</version>
 			<scope>test</scope>
 		</dependency>
-
 		<dependency>
 			<groupId>org.glassfish.jersey.test-framework</groupId>
 			<artifactId>jersey-test-framework-core</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 		<dependency>
 			<groupId>org.glassfish.jersey.test-framework.providers</groupId>
 			<artifactId>jersey-test-framework-provider-grizzly2</artifactId>
 			<scope>test</scope>
 		</dependency>
-
 	</dependencies>
 	<build>
 		<finalName>${project.artifactId}</finalName>
@@ -452,7 +415,7 @@
 				<plugin>
 					<groupId>org.codehaus.mojo</groupId>
 					<artifactId>aspectj-maven-plugin</artifactId>
-					<version>1.7</version>
+					<version>1.14.0</version>
 					<configuration>
 						<complianceLevel>1.8</complianceLevel>
 						<source>1.8</source>
@@ -509,7 +472,46 @@
 					</execution>
 				</executions>
 			</plugin>
+			<!-- Enunciate Maven plugin -->
+			<plugin>
+				<groupId>com.webcohesion.enunciate</groupId>
+				<artifactId>enunciate-maven-plugin</artifactId>
+				<version>${enunciate.version}</version>
+				<configuration></configuration>
+				<executions>
+					<execution>
+						<id>assemble</id>
+						<goals>
+							<goal>assemble</goal>
+						</goals>
+					</execution>
+				</executions>
+			</plugin>
+			<!-- Copy Enunciate Documentation from your-application/docs to your-application.war -->
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-resources-plugin</artifactId>
+				<version>2.5</version>
+				<executions>
+					<execution>
+						<id>copy-enunciate-docs</id>
+						<phase>process-resources</phase>
+						<goals>
+							<goal>copy-resources</goal>
+						</goals>
+						<configuration>
+							<outputDirectory>target</outputDirectory>
+							<resources>
+								<resource>
+									<targetPath>${project.build.directory}/${project.artifactId}/api-docs</targetPath>
+									<directory>${project.build.directory}/api-docs</directory>
+									<filtering>true</filtering>
+								</resource>
+							</resources>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
 		</plugins>
 	</build>
-
 </project>

src/main/java/org/gcube/data/access/storagehub/StorageHub.java

@@ -8,6 +8,7 @@ import javax.ws.rs.core.Application;
 
 import org.gcube.common.gxrest.response.entity.SerializableErrorEntityTextWriter;
 import org.gcube.data.access.storagehub.services.ACLManager;
+import org.gcube.data.access.storagehub.services.DocManager;
 import org.gcube.data.access.storagehub.services.GroupManager;
 import org.gcube.data.access.storagehub.services.Impersonable;
 import org.gcube.data.access.storagehub.services.ItemSharing;
@@ -39,6 +40,7 @@ public class StorageHub extends Application {
         classes.add(MultiPartFeature.class);
         classes.add(SerializableErrorEntityTextWriter.class);
         classes.add(MyApplicationListener.class);
+        classes.add(DocManager.class);
         return classes;
     }
 

src/main/java/org/gcube/data/access/storagehub/services/ACLManager.java

@@ -47,8 +47,14 @@ import org.glassfish.jersey.media.multipart.FormDataParam;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 @Path("items")
 @ManagedBy(StorageHubAppllicationManager.class)
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class ACLManager extends Impersonable {
 
 	private static final Logger log = LoggerFactory.getLogger(ACLManager.class);

src/main/java/org/gcube/data/access/storagehub/services/DocManager.java

@@ -0,0 +1,47 @@
+package org.gcube.data.access.storagehub.services;
+
+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.Path;
+import javax.ws.rs.WebApplicationException;
+import javax.ws.rs.core.Context;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+@Path("api-docs")
+public class DocManager {
+
+    private static Logger logger = LoggerFactory.getLogger(DocManager.class);
+
+    @GET
+    @Path("/{any: .*}")
+    public InputStream toDoc(@Context HttpServletRequest req) throws WebApplicationException {
+        logger.info(DocManager.class.getSimpleName() + " toDoc called");
+
+        String pathInfo = req.getPathInfo();
+        logger.debug("pathInfo {}", pathInfo);
+        try {
+
+            if (pathInfo.endsWith("/api-docs")) {
+                pathInfo += "index.html";
+            }
+
+            if (pathInfo.endsWith("/api-docs/")) {
+                pathInfo += "index.html";
+            }
+
+            logger.info("going to {}", pathInfo);
+
+            String realPath = req.getServletContext().getRealPath(pathInfo);
+            return new FileInputStream(new File(realPath));
+
+        } catch (Exception e) {
+        	throw new WebApplicationException("error getting docs",e);
+        }
+    }
+}

src/main/java/org/gcube/data/access/storagehub/services/GroupManager.java

@@ -73,8 +73,14 @@ import org.glassfish.jersey.media.multipart.FormDataParam;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 @Path("groups")
 @ManagedBy(StorageHubAppllicationManager.class)
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class GroupManager {
 
 	

src/main/java/org/gcube/data/access/storagehub/services/ItemSharing.java

@@ -55,9 +55,15 @@ import org.glassfish.jersey.media.multipart.FormDataParam;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 
 
 @Path("items")
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class ItemSharing extends Impersonable{
 
 	private static final Logger log = LoggerFactory.getLogger(ItemSharing.class);

src/main/java/org/gcube/data/access/storagehub/services/ItemsCreator.java

@@ -38,45 +38,50 @@ import org.glassfish.jersey.media.multipart.FormDataParam;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
 
 @Path("items")
 @ManagedBy(StorageHubAppllicationManager.class)
-public class ItemsCreator extends Impersonable{
+@RequestHeaders({
+		@RequestHeader(name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"), })
+public class ItemsCreator extends Impersonable {
 
 	private static final Logger log = LoggerFactory.getLogger(ItemsCreator.class);
-	
+
 	@Context
 	ServletContext context;
-	
+
 	RepositoryInitializer repository = StorageHubAppllicationManager.repository;
-	
+
 	@Inject
 	ItemHandler itemHandler;
 
 	@POST
 	@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
 	@Path("/{id}/create/FOLDER")
-	public Response createFolder(@PathParam("id") String id, @FormParam("name") String name, 
+	public Response createFolder(@PathParam("id") String id, @FormParam("name") String name,
 			@FormParam("description") String description, @FormParam("hidden") boolean hidden) {
 		InnerMethodName.instance.set("createItem(FOLDER)");
 		log.info("create folder item called");
 		Session ses = null;
 		String toReturn = null;
-		try{
+		try {
 			ses = repository.getRepository().login(CredentialHandler.getAdminCredentials(context));
-			ItemsParameterBuilder<FolderCreationParameters> builder = FolderCreationParameters.builder().name(name).description(description).hidden(hidden).on(id).with(ses).author(currentUser);
-			toReturn =  itemHandler.create(builder.build());
-		}catch(StorageHubException she ){
+			ItemsParameterBuilder<FolderCreationParameters> builder = FolderCreationParameters.builder().name(name)
+					.description(description).hidden(hidden).on(id).with(ses).author(currentUser);
+			toReturn = itemHandler.create(builder.build());
+		} catch (StorageHubException she) {
 			log.error(she.getErrorMessage(), she);
 			GXOutboundErrorResponse.throwException(she, Response.Status.fromStatusCode(she.getStatus()));
-		}catch(RepositoryException re ){
+		} catch (RepositoryException re) {
 			log.error("jcr error creating item", re);
 			GXOutboundErrorResponse.throwException(new BackendGenericError("jcr error creating item", re));
-		}catch(Throwable e ){
+		} catch (Throwable e) {
 			log.error("unexpected error", e);
 			GXOutboundErrorResponse.throwException(new BackendGenericError(e));
-		}finally{
-			if (ses!=null)
+		} finally {
+			if (ses != null)
 				ses.logout();
 
 		}
@@ -86,69 +91,70 @@ public class ItemsCreator extends Impersonable{
 	@POST
 	@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
 	@Path("/{id}/create/EXTERNALFOLDER")
-	public Response createExternalFolder(@PathParam("id") String id, @FormParam("name") String name, 
+	public Response createExternalFolder(@PathParam("id") String id, @FormParam("name") String name,
 			@FormParam("description") String description, @FormParam("hidden") boolean hidden,
-			@FormParam("pluginName") String pluginName,
-			@FormParam("parameters") String pluginParameters) {
+			@FormParam("pluginName") String pluginName, @FormParam("parameters") String pluginParameters) {
 		InnerMethodName.instance.set("createItem(EXTERNALFOLDER)");
 		log.info("create folder item called");
 		Session ses = null;
 		String toReturn = null;
-		try{
-			//TODO
+		try {
+			// TODO
 			ses = repository.getRepository().login(CredentialHandler.getAdminCredentials(context));
 			ItemsParameterBuilder<FolderCreationParameters> builder = FolderCreationParameters.builder().name(name)
-					.description(description).onRepository(pluginName).withParameters(null).hidden(hidden).on(id).with(ses).author(currentUser);
-			toReturn =  itemHandler.create(builder.build());
-		}catch(StorageHubException she ){
+					.description(description).onRepository(pluginName).withParameters(null).hidden(hidden).on(id)
+					.with(ses).author(currentUser);
+			toReturn = itemHandler.create(builder.build());
+		} catch (StorageHubException she) {
 			log.error(she.getErrorMessage(), she);
 			GXOutboundErrorResponse.throwException(she, Response.Status.fromStatusCode(she.getStatus()));
-		}catch(RepositoryException re ){
+		} catch (RepositoryException re) {
 			log.error("jcr error creating item", re);
 			GXOutboundErrorResponse.throwException(new BackendGenericError("jcr error creating item", re));
-		}catch(Throwable e ){
+		} catch (Throwable e) {
 			log.error("unexpected error", e);
 			GXOutboundErrorResponse.throwException(new BackendGenericError(e));
-		}finally{
-			if (ses!=null)
+		} finally {
+			if (ses != null)
 				ses.logout();
 
 		}
 		return Response.ok(toReturn).build();
 	}
-	
+
 	@POST
 	@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
 	@Path("/{id}/create/URL")
-	public Response createURL(@PathParam("id") String id, @FormParam("name") String name, @FormParam("description") String description, @FormParam("value") URL value) {
+	public Response createURL(@PathParam("id") String id, @FormParam("name") String name,
+			@FormParam("description") String description, @FormParam("value") URL value) {
 		InnerMethodName.instance.set("createItem(URL)");
 		log.info("create url called");
 		Session ses = null;
 		String toReturn = null;
-		try{
+		try {
 			ses = repository.getRepository().login(CredentialHandler.getAdminCredentials(context));
-			
-			ItemsParameterBuilder<URLCreationParameters> builder = URLCreationParameters.builder().name(name).description(description).url(value).on(id).with(ses).author(currentUser);
 
-			toReturn =  itemHandler.create(builder.build());
-		}catch(StorageHubException she ){
+			ItemsParameterBuilder<URLCreationParameters> builder = URLCreationParameters.builder().name(name)
+					.description(description).url(value).on(id).with(ses).author(currentUser);
+
+			toReturn = itemHandler.create(builder.build());
+		} catch (StorageHubException she) {
 			log.error(she.getErrorMessage(), she);
 			GXOutboundErrorResponse.throwException(she, Response.Status.fromStatusCode(she.getStatus()));
-		}catch(RepositoryException re ){
+		} catch (RepositoryException re) {
 			log.error("jcr error creating item", re);
 			GXOutboundErrorResponse.throwException(new BackendGenericError("jcr error creating item", re));
-		}catch(Throwable e ){
+		} catch (Throwable e) {
 			log.error("unexpected error", e);
 			GXOutboundErrorResponse.throwException(new BackendGenericError(e));
-		}finally{
-			if (ses!=null)
+		} finally {
+			if (ses != null)
 				ses.logout();
 
 		}
 		return Response.ok(toReturn).build();
 	}
-	
-	
+
 	@POST
 	@Consumes(MediaType.APPLICATION_JSON)
 	@Path("/{id}/create/GCUBEITEM")
@@ -158,58 +164,58 @@ public class ItemsCreator extends Impersonable{
 		Session ses = null;
 		String toReturn = null;
 
-		try{
+		try {
 			ses = repository.getRepository().login(CredentialHandler.getAdminCredentials(context));
-			ItemsParameterBuilder<GCubeItemCreationParameters> builder = GCubeItemCreationParameters.builder().item(item).on(id).with(ses).author(currentUser);
-	
-			toReturn =  itemHandler.create(builder.build());
-		}catch(StorageHubException she ){
+			ItemsParameterBuilder<GCubeItemCreationParameters> builder = GCubeItemCreationParameters.builder()
+					.item(item).on(id).with(ses).author(currentUser);
+
+			toReturn = itemHandler.create(builder.build());
+		} catch (StorageHubException she) {
 			log.error(she.getErrorMessage(), she);
 			GXOutboundErrorResponse.throwException(she, Response.Status.fromStatusCode(she.getStatus()));
-		}catch(RepositoryException re ){
+		} catch (RepositoryException re) {
 			log.error("jcr error creating item", re);
 			GXOutboundErrorResponse.throwException(new BackendGenericError("jcr error creating item", re));
-		}catch(Throwable e ){
+		} catch (Throwable e) {
 			log.error("unexpected error", e);
 			GXOutboundErrorResponse.throwException(new BackendGenericError(e));
-		}finally{
-			if (ses!=null)
+		} finally {
+			if (ses != null)
 				ses.logout();
 		}
 		return toReturn;
 	}
 
-
 	@POST
 	@Consumes(MediaType.MULTIPART_FORM_DATA)
 	@Path("/{id}/create/FILE")
 	public String createFileItem(@PathParam("id") String id, @FormDataParam("name") String name,
-			@FormDataParam("description") String description,
-			@FormDataParam("file") InputStream stream,
-			@FormDataParam("file") FormDataContentDisposition fileDetail){
+			@FormDataParam("description") String description, @FormDataParam("file") InputStream stream,
+			@FormDataParam("file") FormDataContentDisposition fileDetail) {
 		InnerMethodName.instance.set("createItem(FILE)");
 
 		Session ses = null;
 		String toReturn = null;
-		try{
-			
+		try {
+
 			ses = repository.getRepository().login(CredentialHandler.getAdminCredentials(context));
-			ItemsParameterBuilder<FileCreationParameters> builder = FileCreationParameters.builder().name(name).description(description).stream(stream).fileDetails(fileDetail)
-					.on(id).with(ses).author(currentUser);
-			
-			toReturn =  itemHandler.create(builder.build());
-			
-		}catch(RepositoryException re ){
+			ItemsParameterBuilder<FileCreationParameters> builder = FileCreationParameters.builder().name(name)
+					.description(description).stream(stream).fileDetails(fileDetail).on(id).with(ses)
+					.author(currentUser);
+
+			toReturn = itemHandler.create(builder.build());
+
+		} catch (RepositoryException re) {
 			log.error("jcr error creating file item", re);
 			GXOutboundErrorResponse.throwException(new BackendGenericError("jcr error creating file item", re));
-		}catch(StorageHubException she ){
+		} catch (StorageHubException she) {
 			log.error(she.getErrorMessage(), she);
 			GXOutboundErrorResponse.throwException(she, Response.Status.fromStatusCode(she.getStatus()));
-		}catch(Throwable e ){
+		} catch (Throwable e) {
 			log.error("unexpected error", e);
 			GXOutboundErrorResponse.throwException(new BackendGenericError(e));
-		}finally{
-			if (ses!=null && ses.isLive()) {
+		} finally {
+			if (ses != null && ses.isLive()) {
 				log.info("session closed");
 				ses.logout();
 			}
@@ -218,47 +224,39 @@ public class ItemsCreator extends Impersonable{
 
 	}
 
-	
-
-	
-
-
 	@POST
 	@Consumes(MediaType.MULTIPART_FORM_DATA)
 	@Path("/{id}/create/ARCHIVE")
 	public String uploadArchive(@PathParam("id") String id, @FormDataParam("parentFolderName") String parentFolderName,
-			@FormDataParam("file") InputStream stream,
-			@FormDataParam("file") FormDataContentDisposition fileDetail){
+			@FormDataParam("file") InputStream stream, @FormDataParam("file") FormDataContentDisposition fileDetail) {
 		InnerMethodName.instance.set("createItem(ARCHIVE)");
 
 		Session ses = null;
 		String toReturn = null;
-		try{
+		try {
 			ses = repository.getRepository().login(CredentialHandler.getAdminCredentials(context));
 
-			ItemsParameterBuilder<ArchiveStructureCreationParameter> builder = ArchiveStructureCreationParameter.builder().parentName(parentFolderName).stream(stream).fileDetails(fileDetail)
-					.on(id).with(ses).author(currentUser);
-			
-			toReturn =  itemHandler.create(builder.build());
+			ItemsParameterBuilder<ArchiveStructureCreationParameter> builder = ArchiveStructureCreationParameter
+					.builder().parentName(parentFolderName).stream(stream).fileDetails(fileDetail).on(id).with(ses)
+					.author(currentUser);
 
-		}catch(RepositoryException | ArchiveException | IOException re){
+			toReturn = itemHandler.create(builder.build());
+
+		} catch (RepositoryException | ArchiveException | IOException re) {
 			log.error("jcr error extracting archive", re);
 			GXOutboundErrorResponse.throwException(new BackendGenericError("jcr error extracting archive", re));
-		}catch(StorageHubException she ){
+		} catch (StorageHubException she) {
 			log.error(she.getErrorMessage(), she);
 			GXOutboundErrorResponse.throwException(she, Response.Status.fromStatusCode(she.getStatus()));
-		}catch(Throwable e ){
+		} catch (Throwable e) {
 			log.error("unexpected error", e);
 			GXOutboundErrorResponse.throwException(new BackendGenericError(e));
-		} finally{
-			if (ses!=null)
+		} finally {
+			if (ses != null)
 				ses.logout();
 
 		}
 		return toReturn;
 	}
 
-
-	
-
 }

src/main/java/org/gcube/data/access/storagehub/services/ItemsManager.java

@@ -94,9 +94,15 @@ import org.gcube.smartgears.utils.InnerMethodName;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 
 @Path("items")
 @ManagedBy(StorageHubAppllicationManager.class)
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class ItemsManager extends Impersonable{
 
 	private static final Logger log = LoggerFactory.getLogger(ItemsManager.class);

src/main/java/org/gcube/data/access/storagehub/services/MessageManager.java

@@ -63,8 +63,14 @@ import org.gcube.smartgears.utils.InnerMethodName;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 @Path("messages")
 @ManagedBy(StorageHubAppllicationManager.class)
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class MessageManager extends Impersonable{
 
 	private static final Logger log = LoggerFactory.getLogger(MessageManager.class);
@@ -375,13 +381,13 @@ public class MessageManager extends Impersonable{
 	private Node checkRights(String user, Message messageItem) throws RepositoryException, StorageHubException{
 		Node personalNode = null;
 		Node messageNode = (Node) messageItem.getRelatedNode();
-		if (messageNode.getPath().startsWith(pathUtil.getWorkspacePath(currentUser).toPath()))
+		if (messageNode.getPath().startsWith(pathUtil.getInboxPath(user).toPath()))
 			return messageNode;
 
 		NodeIterator nodeIt = messageNode.getSharedSet();
 		while (nodeIt.hasNext()) {
 			Node node = nodeIt.nextNode();
-			if (node.getPath().startsWith(pathUtil.getWorkspacePath(currentUser).toPath()))
+			if (node.getPath().startsWith(pathUtil.getInboxPath(user).toPath()))
 				personalNode = node;
 		}
 		if (personalNode == null && 

src/main/java/org/gcube/data/access/storagehub/services/UserManager.java

@@ -58,8 +58,14 @@ import org.gcube.smartgears.utils.InnerMethodName;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 @Path("users")
 @ManagedBy(StorageHubAppllicationManager.class)
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class UserManager {
 
 	private static final String INFRASTRUCTURE_MANAGER_ROLE = "Infrastructure-Manager";

src/main/java/org/gcube/data/access/storagehub/services/WorkspaceManager.java

@@ -55,10 +55,16 @@ import org.gcube.smartgears.utils.InnerMethodName;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 
 
 @Path("/")
 @ManagedBy(StorageHubAppllicationManager.class)
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class WorkspaceManager extends Impersonable{
 
 	private static final Logger log = LoggerFactory.getLogger(WorkspaceManager.class);

src/main/java/org/gcube/data/access/storagehub/services/admin/ScriptManager.java

@@ -40,7 +40,13 @@ import org.glassfish.jersey.media.multipart.FormDataParam;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import com.webcohesion.enunciate.metadata.rs.RequestHeader;
+import com.webcohesion.enunciate.metadata.rs.RequestHeaders;
+
 @Path("admin/script")
+@RequestHeaders({
+	  @RequestHeader( name = "Authorization", description = "Bearer token, see https://dev.d4science.org/how-to-access-resources"),
+	})
 public class ScriptManager {
 
 

src/main/webapp/WEB-INF/LICENSE

@@ -1,313 +1,297 @@
 European Union Public Licence V. 1.1
 
 
-			EUPL © the European Community 2007
+            EUPL © the European Community 2007
 
 
-			This European Union Public Licence (the “EUPL”) applies to the Work or Software
-			(as defined below) which is provided under the terms of this Licence. Any use of
-			the Work, other than as authorised under this Licence is prohibited (to the
-			extent such use is covered by a right of the copyright holder of the Work).
+            This European Union Public Licence (the “EUPL”) applies to the Work or Software
+            (as defined below) which is provided under the terms of this Licence. Any use of
+            the Work, other than as authorised under this Licence is prohibited (to the
+            extent such use is covered by a right of the copyright holder of the Work).
 
-			The Original Work is provided under the terms of this Licence when the Licensor
-			(as defined below) has placed the following notice immediately following the
-			copyright notice for the Original Work:
+            The Original Work is provided under the terms of this Licence when the Licensor
+            (as defined below) has placed the following notice immediately following the
+            copyright notice for the Original Work:
 
-			Licensed under the EUPL V.1.1
+            Licensed under the EUPL V.1.1
 
-			or has expressed by any other mean his willingness to license under the EUPL.
+            or has expressed by any other mean his willingness to license under the EUPL.
 
 
+            1. Definitions
 
-			1. Definitions
+            In this Licence, the following terms have the following meaning:
 
-			In this Licence, the following terms have the following meaning:
+            - The Licence: this Licence.
 
-			- The Licence: this Licence.
+            - The Original Work or the Software: the software distributed and/or
+            communicated by the Licensor under this Licence, available as Source Code and
+            also as Executable Code as the case may be.
 
-			- The Original Work or the Software: the software distributed and/or
-			communicated by the Licensor under this Licence, available as Source Code and
-			also as Executable Code as the case may be.
+            - Derivative Works: the works or software that could be created by the Licensee,
+            based upon the Original Work or modifications thereof. This Licence does not
+            define the extent of modification or dependence on the Original Work required
+            in order to classify a work as a Derivative Work; this extent is determined by
+            copyright law applicable in the country mentioned in Article 15.
 
-			- Derivative Works: the works or software that could be created by the Licensee,
-			based upon the Original Work or modifications thereof. This Licence does not
-			define the extent of modification or dependence on the Original Work required
-			in order to classify a work as a Derivative Work; this extent is determined by
-			copyright law applicable in the country mentioned in Article 15.
+            - The Work: the Original Work and/or its Derivative Works.
 
-			- The Work: the Original Work and/or its Derivative Works.
+            - The Source Code: the human-readable form of the Work which is the most
+            convenient for people to study and modify.
 
-			- The Source Code: the human-readable form of the Work which is the most
-			convenient for people to study and modify.
+            - The Executable Code: any code which has generally been compiled and which is
+            meant to be interpreted by a computer as a program.
 
-			- The Executable Code: any code which has generally been compiled and which is
-			meant to be interpreted by a computer as a program.
+            - The Licensor: the natural or legal person that distributes and/or communicates
+            the Work under the Licence.
 
-			- The Licensor: the natural or legal person that distributes and/or communicates
-			the Work under the Licence.
+            - Contributor(s): any natural or legal person who modifies the Work under the
+            Licence, or otherwise contributes to the creation of a Derivative Work.
 
-			- Contributor(s): any natural or legal person who modifies the Work under the
-			Licence, or otherwise contributes to the creation of a Derivative Work.
+            - The Licensee or “You”: any natural or legal person who makes any usage of the
+            Software under the terms of the Licence.
 
-			- The Licensee or “You”: any natural or legal person who makes any usage of the
-			Software under the terms of the Licence.
+            - Distribution and/or Communication: any act of selling, giving, lending,
+            renting, distributing, communicating, transmitting, or otherwise making
+            available, on-line or off-line, copies of the Work or providing access to its
+            essential functionalities at the disposal of any other natural or legal
+            person.
 
-			- Distribution and/or Communication: any act of selling, giving, lending,
-			renting, distributing, communicating, transmitting, or otherwise making
-			available, on-line or off-line, copies of the Work or providing access to its
-			essential functionalities at the disposal of any other natural or legal
-			person.
 
+            2. Scope of the rights granted by the Licence
 
+            The Licensor hereby grants You a world-wide, royalty-free, non-exclusive,
+            sub-licensable licence to do the following, for the duration of copyright vested
+            in the Original Work:
 
-			2. Scope of the rights granted by the Licence
+            - use the Work in any circumstance and for all usage, reproduce the Work, modify
+            - the Original Work, and make Derivative Works based upon the Work, communicate
+            - to the public, including the right to make available or display the Work or
+            - copies thereof to the public and perform publicly, as the case may be, the
+            - Work, distribute the Work or copies thereof, lend and rent the Work or copies
+            - thereof, sub-license rights in the Work or copies thereof.
 
-			The Licensor hereby grants You a world-wide, royalty-free, non-exclusive,
-			sub-licensable licence to do the following, for the duration of copyright vested
-			in the Original Work:
+            Those rights can be exercised on any media, supports and formats, whether now
+            known or later invented, as far as the applicable law permits so.
 
-			- use the Work in any circumstance and for all usage, reproduce the Work, modify
-			- the Original Work, and make Derivative Works based upon the Work, communicate
-			- to the public, including the right to make available or display the Work or
-			- copies thereof to the public and perform publicly, as the case may be, the
-			- Work, distribute the Work or copies thereof, lend and rent the Work or copies
-			- thereof, sub-license rights in the Work or copies thereof.
+            In the countries where moral rights apply, the Licensor waives his right to
+            exercise his moral right to the extent allowed by law in order to make effective
+            the licence of the economic rights here above listed.
 
-			Those rights can be exercised on any media, supports and formats, whether now
-			known or later invented, as far as the applicable law permits so.
+            The Licensor grants to the Licensee royalty-free, non exclusive usage rights to
+            any patents held by the Licensor, to the extent necessary to make use of the
+            rights granted on the Work under this Licence.
 
-			In the countries where moral rights apply, the Licensor waives his right to
-			exercise his moral right to the extent allowed by law in order to make effective
-			the licence of the economic rights here above listed.
 
-			The Licensor grants to the Licensee royalty-free, non exclusive usage rights to
-			any patents held by the Licensor, to the extent necessary to make use of the
-			rights granted on the Work under this Licence.
+            3. Communication of the Source Code
 
+            The Licensor may provide the Work either in its Source Code form, or as
+            Executable Code. If the Work is provided as Executable Code, the Licensor
+            provides in addition a machine-readable copy of the Source Code of the Work
+            along with each copy of the Work that the Licensor distributes or indicates, in
+            a notice following the copyright notice attached to the Work, a repository where
+            the Source Code is easily and freely accessible for as long as the Licensor
+            continues to distribute and/or communicate the Work.
 
 
-			3. Communication of the Source Code
+            4. Limitations on copyright
 
-			The Licensor may provide the Work either in its Source Code form, or as
-			Executable Code. If the Work is provided as Executable Code, the Licensor
-			provides in addition a machine-readable copy of the Source Code of the Work
-			along with each copy of the Work that the Licensor distributes or indicates, in
-			a notice following the copyright notice attached to the Work, a repository where
-			the Source Code is easily and freely accessible for as long as the Licensor
-			continues to distribute and/or communicate the Work.
+            Nothing in this Licence is intended to deprive the Licensee of the benefits from
+            any exception or limitation to the exclusive rights of the rights owners in the
+            Original Work or Software, of the exhaustion of those rights or of other
+            applicable limitations thereto.
 
 
+            5. Obligations of the Licensee
 
-			4. Limitations on copyright
+            The grant of the rights mentioned above is subject to some restrictions and
+            obligations imposed on the Licensee. Those obligations are the following:
 
-			Nothing in this Licence is intended to deprive the Licensee of the benefits from
-			any exception or limitation to the exclusive rights of the rights owners in the
-			Original Work or Software, of the exhaustion of those rights or of other
-			applicable limitations thereto.
+            Attribution right: the Licensee shall keep intact all copyright, patent or
+            trademarks notices and all notices that refer to the Licence and to the
+            disclaimer of warranties. The Licensee must include a copy of such notices and a
+            copy of the Licence with every copy of the Work he/she distributes and/or
+            communicates. The Licensee must cause any Derivative Work to carry prominent
+            notices stating that the Work has been modified and the date of modification.
 
+            Copyleft clause: If the Licensee distributes and/or communicates copies of the
+            Original Works or Derivative Works based upon the Original Work, this
+            Distribution and/or Communication will be done under the terms of this Licence
+            or of a later version of this Licence unless the Original Work is expressly
+            distributed only under this version of the Licence. The Licensee (becoming
+            Licensor) cannot offer or impose any additional terms or conditions on the Work
+            or Derivative Work that alter or restrict the terms of the Licence.
 
+            Compatibility clause: If the Licensee Distributes and/or Communicates Derivative
+            Works or copies thereof based upon both the Original Work and another work
+            licensed under a Compatible Licence, this Distribution and/or Communication can
+            be done under the terms of this Compatible Licence. For the sake of this clause,
+            “Compatible Licence” refers to the licences listed in the appendix attached to
+            this Licence. Should the Licensee’s obligations under the Compatible Licence
+            conflict with his/her obligations under this Licence, the obligations of the
+            Compatible Licence shall prevail.
 
-			5. Obligations of the Licensee
+            Provision of Source Code: When distributing and/or communicating copies of the
+            Work, the Licensee will provide a machine-readable copy of the Source Code or
+            indicate a repository where this Source will be easily and freely available for
+            as long as the Licensee continues to distribute and/or communicate the Work.
 
-			The grant of the rights mentioned above is subject to some restrictions and
-			obligations imposed on the Licensee. Those obligations are the following:
+            Legal Protection: This Licence does not grant permission to use the trade names,
+            trademarks, service marks, or names of the Licensor, except as required for
+            reasonable and customary use in describing the origin of the Work and
+            reproducing the content of the copyright notice.
 
-			Attribution right: the Licensee shall keep intact all copyright, patent or
-			trademarks notices and all notices that refer to the Licence and to the
-			disclaimer of warranties. The Licensee must include a copy of such notices and a
-			copy of the Licence with every copy of the Work he/she distributes and/or
-			communicates. The Licensee must cause any Derivative Work to carry prominent
-			notices stating that the Work has been modified and the date of modification.
 
-			Copyleft clause: If the Licensee distributes and/or communicates copies of the
-			Original Works or Derivative Works based upon the Original Work, this
-			Distribution and/or Communication will be done under the terms of this Licence
-			or of a later version of this Licence unless the Original Work is expressly
-			distributed only under this version of the Licence. The Licensee (becoming
-			Licensor) cannot offer or impose any additional terms or conditions on the Work
-			or Derivative Work that alter or restrict the terms of the Licence.
+            6. Chain of Authorship
 
-			Compatibility clause: If the Licensee Distributes and/or Communicates Derivative
-			Works or copies thereof based upon both the Original Work and another work
-			licensed under a Compatible Licence, this Distribution and/or Communication can
-			be done under the terms of this Compatible Licence. For the sake of this clause,
-			“Compatible Licence” refers to the licences listed in the appendix attached to
-			this Licence. Should the Licensee’s obligations under the Compatible Licence
-			conflict with his/her obligations under this Licence, the obligations of the
-			Compatible Licence shall prevail.
+            The original Licensor warrants that the copyright in the Original Work granted
+            hereunder is owned by him/her or licensed to him/her and that he/she has the
+            power and authority to grant the Licence.
 
-			Provision of Source Code: When distributing and/or communicating copies of the
-			Work, the Licensee will provide a machine-readable copy of the Source Code or
-			indicate a repository where this Source will be easily and freely available for
-			as long as the Licensee continues to distribute and/or communicate the Work.
+            Each Contributor warrants that the copyright in the modifications he/she brings
+            to the Work are owned by him/her or licensed to him/her and that he/she has the
+            power and authority to grant the Licence.
 
-			Legal Protection: This Licence does not grant permission to use the trade names,
-			trademarks, service marks, or names of the Licensor, except as required for
-			reasonable and customary use in describing the origin of the Work and
-			reproducing the content of the copyright notice.
+            Each time You accept the Licence, the original Licensor and subsequent
+            Contributors grant You a licence to their contributions to the Work, under the
+            terms of this Licence.
 
 
+            7. Disclaimer of Warranty
 
-			6. Chain of Authorship
+            The Work is a work in progress, which is continuously improved by numerous
+            contributors. It is not a finished work and may therefore contain defects or
+            “bugs” inherent to this type of software development.
 
-			The original Licensor warrants that the copyright in the Original Work granted
-			hereunder is owned by him/her or licensed to him/her and that he/she has the
-			power and authority to grant the Licence.
+            For the above reason, the Work is provided under the Licence on an “as is” basis
+            and without warranties of any kind concerning the Work, including without
+            limitation merchantability, fitness for a particular purpose, absence of defects
+            or errors, accuracy, non-infringement of intellectual property rights other than
+            copyright as stated in Article 6 of this Licence.
 
-			Each Contributor warrants that the copyright in the modifications he/she brings
-			to the Work are owned by him/her or licensed to him/her and that he/she has the
-			power and authority to grant the Licence.
+            This disclaimer of warranty is an essential part of the Licence and a condition
+            for the grant of any rights to the Work.
 
-			Each time You accept the Licence, the original Licensor and subsequent
-			Contributors grant You a licence to their contributions to the Work, under the
-			terms of this Licence.
 
+            8. Disclaimer of Liability
 
+            Except in the cases of wilful misconduct or damages directly caused to natural
+            persons, the Licensor will in no event be liable for any direct or indirect,
+            material or moral, damages of any kind, arising out of the Licence or of the use
+            of the Work, including without limitation, damages for loss of goodwill, work
+            stoppage, computer failure or malfunction, loss of data or any commercial
+            damage, even if the Licensor has been advised of the possibility of such
+            damage. However, the Licensor will be liable under statutory product liability
+            laws as far such laws apply to the Work.
 
-			7. Disclaimer of Warranty
 
-			The Work is a work in progress, which is continuously improved by numerous
-			contributors. It is not a finished work and may therefore contain defects or
-			“bugs” inherent to this type of software development.
+            9. Additional agreements
 
-			For the above reason, the Work is provided under the Licence on an “as is” basis
-			and without warranties of any kind concerning the Work, including without
-			limitation merchantability, fitness for a particular purpose, absence of defects
-			or errors, accuracy, non-infringement of intellectual property rights other than
-			copyright as stated in Article 6 of this Licence.
+            While distributing the Original Work or Derivative Works, You may choose to
+            conclude an additional agreement to offer, and charge a fee for, acceptance of
+            support, warranty, indemnity, or other liability obligations and/or services
+            consistent with this Licence. However, in accepting such obligations, You may
+            act only on your own behalf and on your sole responsibility, not on behalf of
+            the original Licensor or any other Contributor, and only if You agree to
+            indemnify, defend, and hold each Contributor harmless for any liability incurred
+            by, or claims asserted against such Contributor by the fact You have accepted
+            any such warranty or additional liability.
 
-			This disclaimer of warranty is an essential part of the Licence and a condition
-			for the grant of any rights to the Work.
 
+            10. Acceptance of the Licence
 
+            The provisions of this Licence can be accepted by clicking on an icon “I agree”
+            placed under the bottom of a window displaying the text of this Licence or by
+            affirming consent in any other similar way, in accordance with the rules of
+            applicable law. Clicking on that icon indicates your clear and irrevocable
+            acceptance of this Licence and all of its terms and conditions.
 
-			8. Disclaimer of Liability
+            Similarly, you irrevocably accept this Licence and all of its terms and
+            conditions by exercising any rights granted to You by Article 2 of this Licence,
+            such as the use of the Work, the creation by You of a Derivative Work or the
+            Distribution and/or Communication by You of the Work or copies thereof.
 
-			Except in the cases of wilful misconduct or damages directly caused to natural
-			persons, the Licensor will in no event be liable for any direct or indirect,
-			material or moral, damages of any kind, arising out of the Licence or of the use
-			of the Work, including without limitation, damages for loss of goodwill, work
-			stoppage, computer failure or malfunction, loss of data or any commercial
-			damage, even if the Licensor has been advised of the possibility of such
-			damage. However, the Licensor will be liable under statutory product liability
-			laws as far such laws apply to the Work.
 
+            11. Information to the public
 
+            In case of any Distribution and/or Communication of the Work by means of
+            electronic communication by You (for example, by offering to download the Work
+            from a remote location) the distribution channel or media (for example, a
+            website) must at least provide to the public the information requested by the
+            applicable law regarding the Licensor, the Licence and the way it may be
+            accessible, concluded, stored and reproduced by the Licensee.
 
-			9. Additional agreements
 
-			While distributing the Original Work or Derivative Works, You may choose to
-			conclude an additional agreement to offer, and charge a fee for, acceptance of
-			support, warranty, indemnity, or other liability obligations and/or services
-			consistent with this Licence. However, in accepting such obligations, You may
-			act only on your own behalf and on your sole responsibility, not on behalf of
-			the original Licensor or any other Contributor, and only if You agree to
-			indemnify, defend, and hold each Contributor harmless for any liability incurred
-			by, or claims asserted against such Contributor by the fact You have accepted
-			any such warranty or additional liability.
+            12. Termination of the Licence
 
+            The Licence and the rights granted hereunder will terminate automatically upon
+            any breach by the Licensee of the terms of the Licence.
 
+            Such a termination will not terminate the licences of any person who has
+            received the Work from the Licensee under the Licence, provided such persons
+            remain in full compliance with the Licence.
 
-			10. Acceptance of the Licence
 
-			The provisions of this Licence can be accepted by clicking on an icon “I agree”
-			placed under the bottom of a window displaying the text of this Licence or by
-			affirming consent in any other similar way, in accordance with the rules of
-			applicable law. Clicking on that icon indicates your clear and irrevocable
-			acceptance of this Licence and all of its terms and conditions.
+            13. Miscellaneous
 
-			Similarly, you irrevocably accept this Licence and all of its terms and
-			conditions by exercising any rights granted to You by Article 2 of this Licence,
-			such as the use of the Work, the creation by You of a Derivative Work or the
-			Distribution and/or Communication by You of the Work or copies thereof.
+            Without prejudice of Article 9 above, the Licence represents the complete
+            agreement between the Parties as to the Work licensed hereunder.
 
+            If any provision of the Licence is invalid or unenforceable under applicable
+            law, this will not affect the validity or enforceability of the Licence as a
+            whole. Such provision will be construed and/or reformed so as necessary to make
+            it valid and enforceable.
 
+            The European Commission may publish other linguistic versions and/or new
+            versions of this Licence, so far this is required and reasonable, without
+            reducing the scope of the rights granted by the Licence. New versions of the
+            Licence will be published with a unique version number.
 
-			11. Information to the public
+            All linguistic versions of this Licence, approved by the European Commission,
+            have identical value. Parties can take advantage of the linguistic version of
+            their choice.
 
-			In case of any Distribution and/or Communication of the Work by means of
-			electronic communication by You (for example, by offering to download the Work
-			from a remote location) the distribution channel or media (for example, a
-			website) must at least provide to the public the information requested by the
-			applicable law regarding the Licensor, the Licence and the way it may be
-			accessible, concluded, stored and reproduced by the Licensee.
 
+            14. Jurisdiction
 
+            Any litigation resulting from the interpretation of this License, arising
+            between the European Commission, as a Licensor, and any Licensee, will be
+            subject to the jurisdiction of the Court of Justice of the European Communities,
+            as laid down in article 238 of the Treaty establishing the European Community.
 
-			12. Termination of the Licence
+            Any litigation arising between Parties, other than the European Commission, and
+            resulting from the interpretation of this License, will be subject to the
+            exclusive jurisdiction of the competent court where the Licensor resides or
+            conducts its primary business.
 
-			The Licence and the rights granted hereunder will terminate automatically upon
-			any breach by the Licensee of the terms of the Licence.
 
-			Such a termination will not terminate the licences of any person who has
-			received the Work from the Licensee under the Licence, provided such persons
-			remain in full compliance with the Licence.
+            15. Applicable Law
 
+            This Licence shall be governed by the law of the European Union country where
+            the Licensor resides or has his registered office.
 
+            This licence shall be governed by the Belgian law if:
 
-			13. Miscellaneous
+            - a litigation arises between the European Commission, as a Licensor, and any
+            - Licensee; the Licensor, other than the European Commission, has no residence
+            - or registered office inside a European Union country.
 
-			Without prejudice of Article 9 above, the Licence represents the complete
-			agreement between the Parties as to the Work licensed hereunder.
 
-			If any provision of the Licence is invalid or unenforceable under applicable
-			law, this will not affect the validity or enforceability of the Licence as a
-			whole. Such provision will be construed and/or reformed so as necessary to make
-			it valid and enforceable.
+            ===
 
-			The European Commission may publish other linguistic versions and/or new
-			versions of this Licence, so far this is required and reasonable, without
-			reducing the scope of the rights granted by the Licence. New versions of the
-			Licence will be published with a unique version number.
 
-			All linguistic versions of this Licence, approved by the European Commission,
-			have identical value. Parties can take advantage of the linguistic version of
-			their choice.
+            Appendix
 
 
+            “Compatible Licences” according to article 5 EUPL are:
 
-			14. Jurisdiction
 
-			Any litigation resulting from the interpretation of this License, arising
-			between the European Commission, as a Licensor, and any Licensee, will be
-			subject to the jurisdiction of the Court of Justice of the European Communities,
-			as laid down in article 238 of the Treaty establishing the European Community.
+            - GNU General Public License (GNU GPL) v. 2
 
-			Any litigation arising between Parties, other than the European Commission, and
-			resulting from the interpretation of this License, will be subject to the
-			exclusive jurisdiction of the competent court where the Licensor resides or
-			conducts its primary business.
+            - Open Software License (OSL) v. 2.1, v. 3.0
 
+            - Common Public License v. 1.0
 
+            - Eclipse Public License v. 1.0
 
-			15. Applicable Law
-
-			This Licence shall be governed by the law of the European Union country where
-			the Licensor resides or has his registered office.
-
-			This licence shall be governed by the Belgian law if:
-
-			- a litigation arises between the European Commission, as a Licensor, and any
-			- Licensee; the Licensor, other than the European Commission, has no residence
-			- or registered office inside a European Union country.
-
-
-			===
-
-
-			Appendix
-
-
-
-			“Compatible Licences” according to article 5 EUPL are:
-
-
-			- GNU General Public License (GNU GPL) v. 2
-
-			- Open Software License (OSL) v. 2.1, v. 3.0
-
-			- Common Public License v. 1.0
-
-			- Eclipse Public License v. 1.0
-
-			- Cecill v. 2.0
+            - Cecill v. 2.0

src/main/webapp/WEB-INF/README

@@ -5,27 +5,27 @@ REST web service for Jackrabbit
  
  
 This software is part of the gCube Framework (https://www.gcube-system.org/): an
-			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.
+            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), EUBrazilOpenBio (grant no. 288754), iMarine
-			(grant no. 283644);
-			* the H2020 research and innovation programme - BlueBRIDGE (grant no. 675680),
-			EGIEngage (grant no. 654142), ENVRIplus (grant no. 654182), Parthenos (grant
-			no. 654119), SoBigData (grant no. 654024), AGINFRA PLUS (grant no. 731001).
+            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), EUBrazilOpenBio (grant no. 288754), iMarine
+            (grant no. 283644);
+            * the H2020 research and innovation programme - BlueBRIDGE (grant no. 675680),
+            EGIEngage (grant no. 654142), ENVRIplus (grant no. 654182), Parthenos (grant
+            no. 654119), SoBigData (grant no. 654024), AGINFRA PLUS (grant no. 731001).
  
  
 Version
 --------------------------------------------------
  
-1.3.1 (20210910-085653)
+1.4.2 (20230524-150450)
  
 Please see the file named "changelog.xml" in this directory for the release notes.
  

src/main/webapp/WEB-INF/gcube-app.xml

@@ -1,7 +1,8 @@
 <application mode='online'>
 		<name>StorageHub</name>
 		<group>DataAccess</group>
-		<version>1.3.1</version>
+		<version>1.4.2</version>
 		<description>Storage Hub webapp</description>
 		<local-persistence location='target' />
+		<exclude>/workspace/api-docs/*</exclude>
 </application>

src/main/webapp/api-docs/css/d4science_enunciate_custom.css

@@ -0,0 +1,26 @@
+.d4science_intro {
+	top: 0;
+	z-index: 2000;
+	position: fixed;
+	display: block ruby;
+	padding: 10px;
+	background: white;
+	width: 100%;
+	height: 100px;
+}
+
+.navbar-fixed-top {
+	top: 100px !important;
+}
+
+.sidebar {
+	top: 160px !important;
+}
+
+.navbar {
+	margin-bottom: 40px !important;
+}
+
+.main {
+	top: 90px;
+}