Merge branch 'development' into feature/#1062-implemtation-of-sample-management-api

Author: KochTobi

project-management/src/main/java/life/qbic/projectmanagement/application/api/AsyncProjectService.java

@@ -2,6 +2,7 @@
 
 import static java.util.Objects.nonNull;
 
+import java.nio.ByteBuffer;
 import java.util.Collection;
 import java.util.List;
 import java.util.Optional;
@@ -10,10 +11,8 @@
 import life.qbic.application.commons.SortOrder;
 import life.qbic.projectmanagement.application.batch.SampleUpdateRequest.SampleInformation;
 import life.qbic.projectmanagement.application.confounding.ConfoundingVariableService.ConfoundingVariableInformation;
-import life.qbic.projectmanagement.application.sample.SampleIdCodeEntry;
 import life.qbic.projectmanagement.application.sample.SamplePreview;
 import life.qbic.projectmanagement.domain.model.sample.Sample;
-import life.qbic.projectmanagement.domain.model.sample.SampleId;
 import life.qbic.projectmanagement.domain.model.sample.SampleRegistrationRequest;
 import org.springframework.lang.Nullable;
 import reactor.core.publisher.Flux;
@@ -116,6 +115,34 @@ Mono<ProjectCreationResponse> create(ProjectCreationRequest request)
       throws UnknownRequestException, RequestFailedException, AccessDeniedException;
 
 
+  /**
+   * Returns a reactive stream of a zipped RO-Crate encoded in UTF-8.
+   * <p>
+   * The content represents a project summary with information about the research project.
+   * <p>
+   * Currently, the RO-Crate contains three files:
+   *
+   * <pre>
+   *    ro-crate-metadata.json // required by the RO-Crate specification
+   *    project-summary.docx // docx version of <a href="https://schema.org/ResearchProject">ResearchProject</a>
+   *    project-summary.yml // yaml encoding of <a href="https://schema.org/ResearchProject">ResearchProject</a>
+   *  </pre>
+   *
+   * <b>Exceptions</b>
+   * <p>
+   * Exceptions are wrapped as {@link Mono#error(Throwable)} and are one of the types described in
+   * the throw section below.
+   *
+   * @param projectId the project ID for the project the RO-Crate
+   * @return a reactive stream of the zipped RO-Crate. Exceptions are provided as
+   * {@link Mono#error(Throwable)}.
+   * @throws RequestFailedException in case the request cannot be processed
+   * @throws AccessDeniedException  in case of insufficient rights
+   * @since 1.10.0
+   */
+  Flux<ByteBuffer> roCrateSummary(String projectId)
+      throws RequestFailedException, AccessDeniedException;
+
   /**
    * Requests {@link SamplePreview} for a given experiment with pagination support.
    * <p>

project-management/src/main/java/life/qbic/projectmanagement/application/api/AsyncProjectServiceImpl.java

@@ -5,6 +5,7 @@
 import static life.qbic.projectmanagement.application.authorization.ReactiveSecurityContextUtils.writeSecurityContext;
 import static life.qbic.projectmanagement.application.authorization.ReactiveSecurityContextUtils.writeSecurityContextMany;
 
+import java.nio.ByteBuffer;
 import java.util.List;
 import java.util.Objects;
 import life.qbic.application.commons.SortOrder;
@@ -80,6 +81,11 @@ public Mono<ProjectCreationResponse> create(ProjectCreationRequest request)
     throw new RuntimeException("not implemented");
   }
 
+  @Override
+  public Flux<ByteBuffer> roCrateSummary(String projectId) {
+    throw new RuntimeException("not implemented");
+  }
+
 
   @Override
   public Flux<SamplePreview> getSamplePreviews(String projectId, String experimentId, int offset,