From 647e21bbc4e1c831a0764f09f92de73297e6a560 Mon Sep 17 00:00:00 2001
From: "Sven F." <9976560+sven1103@users.noreply.github.com>
Date: Tue, 19 Nov 2024 14:53:33 +0100
Subject: [PATCH 1/6] Improve software quality and configure Sonarcloud (#917)
Further improves the reliability of the software code and also introduces a Sonarcloud property file, to tell Sonarcloud to exclude
certain contents from the evaluation (template content, etc).
---
.github/workflows/sonarcloud.yml | 40 ++++++++++++++++++
pom.xml | 5 +++
.../TIBTerminologyServiceIntegration.java | 2 +
.../application/DeletionService.java | 3 +-
.../measurement/MeasurementService.java | 33 +++++++++------
sonar-project.properties | 3 ++
user-interface/src/main/bundles/dev.bundle | Bin 3289811 -> 3289848 bytes
...ejectedExecutionHandlerImplementation.java | 1 +
.../ExperimentDetailsComponent.java | 7 +--
9 files changed, 77 insertions(+), 17 deletions(-)
create mode 100644 .github/workflows/sonarcloud.yml
create mode 100644 sonar-project.properties
diff --git a/.github/workflows/sonarcloud.yml b/.github/workflows/sonarcloud.yml
new file mode 100644
index 0000000000..48ae4281c6
--- /dev/null
+++ b/.github/workflows/sonarcloud.yml
@@ -0,0 +1,40 @@
+name: SonarCloud Analysis
+
+# Run this workflow on commits to the development branch
+on:
+ push:
+ branches:
+ - development
+
+jobs:
+ sonarcloud:
+ runs-on: ubuntu-latest
+
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+ - name: Set up JDK 17
+ uses: actions/setup-java@v4
+ with:
+ distribution: 'zulu'
+ java-version: '17'
+ - name: Load local Maven repository cache
+ uses: actions/cache@v4
+ with:
+ path: ~/.m2/repository
+ key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+ restore-keys: |
+ ${{ runner.os }}-maven-
+
+ # Build the project using Maven
+ - name: Build with Maven
+ run: mvn clean install
+
+ # Run SonarCloud analysis
+ - name: SonarCloud Scan
+ env:
+ SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }} # Use the token stored in GitHub secrets
+ run: mvn sonar:sonar \
+ -Dsonar.projectKey=qbicsoftware_data-manager-app \
+ -Dsonar.organization=qbicsoftware \
+ -Dsonar.host.url=https://sonarcloud.io
diff --git a/pom.xml b/pom.xml
index 5fa1d3cfb8..b371480f06 100644
--- a/pom.xml
+++ b/pom.xml
@@ -233,6 +233,11 @@
${maven.compiler.target}
+
+ org.sonarsource.scanner.maven
+ sonar-maven-plugin
+ 5.0.0.4389
+
diff --git a/project-management-infrastructure/src/main/java/life/qbic/projectmanagement/infrastructure/ontology/TIBTerminologyServiceIntegration.java b/project-management-infrastructure/src/main/java/life/qbic/projectmanagement/infrastructure/ontology/TIBTerminologyServiceIntegration.java
index 6c693ae0d7..82200d6c3a 100644
--- a/project-management-infrastructure/src/main/java/life/qbic/projectmanagement/infrastructure/ontology/TIBTerminologyServiceIntegration.java
+++ b/project-management-infrastructure/src/main/java/life/qbic/projectmanagement/infrastructure/ontology/TIBTerminologyServiceIntegration.java
@@ -164,6 +164,7 @@ public List query(String searchTerm, int offset, int limit)
} catch (IOException e) {
throw wrapIO(e);
} catch (InterruptedException e) {
+ Thread.currentThread().interrupt();
throw wrapInterrupted(e);
} catch (Exception e) {
throw wrapUnknown(e);
@@ -193,6 +194,7 @@ public List search(String searchTerm, int offset, int limit)
} catch (IOException e) {
throw wrapIO(e);
} catch (InterruptedException e) {
+ Thread.currentThread().interrupt();
throw wrapInterrupted(e);
} catch (Exception e) {
throw wrapUnknown(e);
diff --git a/project-management/src/main/java/life/qbic/projectmanagement/application/DeletionService.java b/project-management/src/main/java/life/qbic/projectmanagement/application/DeletionService.java
index 641a58ca20..11b43edff4 100644
--- a/project-management/src/main/java/life/qbic/projectmanagement/application/DeletionService.java
+++ b/project-management/src/main/java/life/qbic/projectmanagement/application/DeletionService.java
@@ -29,7 +29,7 @@
@Service
public class DeletionService {
- private ApplicationContext context;
+ private final ApplicationContext context;
private final ProjectInformationService projectInformationService;
private final ExperimentInformationService experimentInformationService;
@@ -52,6 +52,7 @@ public DeletionService(ProjectInformationService projectInformationService,
BatchDomainService.class.getSimpleName() + " must not be null");
this.sampleDomainService = requireNonNull(sampleDomainService,
SampleDomainService.class.getSimpleName() + " must not be null");
+ this.context = requireNonNull(context);
}
/**
diff --git a/project-management/src/main/java/life/qbic/projectmanagement/application/measurement/MeasurementService.java b/project-management/src/main/java/life/qbic/projectmanagement/application/measurement/MeasurementService.java
index 966d1d2cab..9fae7177d6 100644
--- a/project-management/src/main/java/life/qbic/projectmanagement/application/measurement/MeasurementService.java
+++ b/project-management/src/main/java/life/qbic/projectmanagement/application/measurement/MeasurementService.java
@@ -44,6 +44,7 @@
import life.qbic.projectmanagement.domain.repository.MeasurementRepository;
import life.qbic.projectmanagement.domain.service.MeasurementDomainService;
import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.ApplicationContext;
import org.springframework.scheduling.annotation.Async;
import org.springframework.security.access.prepost.PostAuthorize;
import org.springframework.security.access.prepost.PreAuthorize;
@@ -60,6 +61,7 @@
public class MeasurementService {
private static final Logger log = logger(MeasurementService.class);
+ private final ApplicationContext context;
private final MeasurementDomainService measurementDomainService;
private final MeasurementLookupService measurementLookupService;
private final SampleInformationService sampleInformationService;
@@ -75,7 +77,8 @@ public MeasurementService(MeasurementDomainService measurementDomainService,
OrganisationLookupService organisationLookupService,
MeasurementLookupService measurementLookupService,
ProjectInformationService projectInformationService,
- MeasurementRepository measurementRepository) {
+ MeasurementRepository measurementRepository,
+ ApplicationContext context) {
this.measurementDomainService = Objects.requireNonNull(measurementDomainService);
this.sampleInformationService = Objects.requireNonNull(sampleInformationService);
this.speciesLookupService = Objects.requireNonNull(speciesLookupService);
@@ -83,6 +86,7 @@ public MeasurementService(MeasurementDomainService measurementDomainService,
this.measurementLookupService = Objects.requireNonNull(measurementLookupService);
this.projectInformationService = Objects.requireNonNull(projectInformationService);
this.measurementRepository = Objects.requireNonNull(measurementRepository);
+ this.context = Objects.requireNonNull(context);
}
/**
@@ -113,7 +117,8 @@ public long countNGSMeasurements(ExperimentId experimentId) {
@PostAuthorize(
"hasPermission(#projectId, 'life.qbic.projectmanagement.domain.model.project.Project', 'READ') ")
public Collection findProteomicsMeasurements(String filter,
- ExperimentId experimentId, int offset, int limit, List sortOrder, ProjectId projectId) {
+ ExperimentId experimentId, int offset, int limit, List sortOrder,
+ ProjectId projectId) {
var result = sampleInformationService.retrieveSamplesForExperiment(experimentId);
var samplesInExperiment = result.getValue().stream().map(Sample::sampleId).toList();
return measurementLookupService.queryProteomicsMeasurementsBySampleIds(filter,
@@ -145,7 +150,8 @@ public Collection findNGSMeasurements(String filter, ExperimentI
@PostAuthorize(
"hasPermission(#projectId, 'life.qbic.projectmanagement.domain.model.project.Project', 'READ') ")
- public Collection findNGSMeasurements(ExperimentId experimentId, ProjectId projectId) {
+ public Collection findNGSMeasurements(ExperimentId experimentId,
+ ProjectId projectId) {
var result = sampleInformationService.retrieveSamplesForExperiment(experimentId);
var samplesInExperiment = result.getValue().stream().map(Sample::sampleId).toList();
return measurementLookupService.queryAllNGSMeasurement(samplesInExperiment);
@@ -192,7 +198,7 @@ public CompletableFuture>> registerAll(
return CompletableFuture.completedFuture(List.of(Result.fromError(e.reason)));
}
try {
- results = performRegistration(measurementMetadataList, projectId).stream()
+ results = context.getBean(MeasurementService.class).performRegistration(measurementMetadataList, projectId).stream()
.map(Result::fromValue).toList();
} catch (MeasurementRegistrationException e) {
log.error("Failed to register measurement", e);
@@ -202,7 +208,7 @@ public CompletableFuture>> registerAll(
return CompletableFuture.completedFuture(List.of(Result.fromError(ErrorCode.FAILED)));
}
// if the creation worked, we forward the events, otherwise it will be rolled back
- if(results.stream().allMatch(Result::isValue)) {
+ if (results.stream().allMatch(Result::isValue)) {
domainEventsCache.forEach(
domainEvent -> DomainEventDispatcher.instance().dispatch(domainEvent));
}
@@ -529,21 +535,21 @@ public CompletableFuture>> updateAll(
private void handleUpdateEvents(List domainEventsCache,
List> results) {
- if(results.stream().anyMatch(Result::isError)) {
+ if (results.stream().anyMatch(Result::isError)) {
return;
}
Set dispatchedIDs = new HashSet<>();
- for(DomainEvent event : domainEventsCache) {
- if(event instanceof MeasurementUpdatedEvent measurementUpdatedEvent) {
+ for (DomainEvent event : domainEventsCache) {
+ if (event instanceof MeasurementUpdatedEvent measurementUpdatedEvent) {
MeasurementId id = measurementUpdatedEvent.measurementId();
- if(dispatchedIDs.contains(id)) {
+ if (dispatchedIDs.contains(id)) {
continue;
}
DomainEventDispatcher.instance().dispatch(event);
dispatchedIDs.add(id);
}
}
-
+
}
/**
@@ -803,7 +809,7 @@ public Result deletePxPMeasurements(ProjectI
Set selectedMeasurements) {
try {
measurementDomainService.deletePxP(selectedMeasurements);
- if(!selectedMeasurements.isEmpty()) {
+ if (!selectedMeasurements.isEmpty()) {
dispatchProjectChangedOnMeasurementDeleted(projectId);
}
return Result.fromValue(null);
@@ -817,7 +823,7 @@ public Result deleteNGSMeasurements(ProjectI
Set selectedMeasurements) {
try {
measurementDomainService.deleteNGS(selectedMeasurements);
- if(!selectedMeasurements.isEmpty()) {
+ if (!selectedMeasurements.isEmpty()) {
dispatchProjectChangedOnMeasurementDeleted(projectId);
}
return Result.fromValue(null);
@@ -829,7 +835,8 @@ public Result deleteNGSMeasurements(ProjectI
private void dispatchProjectChangedOnMeasurementDeleted(ProjectId projectId) {
ProjectChanged projectChanged = ProjectChanged.create(projectId);
DomainEventDispatcher.instance().dispatch(projectChanged);
-}
+ }
+
public enum DeletionErrorCode {
FAILED, DATA_ATTACHED
}
diff --git a/sonar-project.properties b/sonar-project.properties
new file mode 100644
index 0000000000..1b2e6e2874
--- /dev/null
+++ b/sonar-project.properties
@@ -0,0 +1,3 @@
+sonar.projectKey=qbicsoftware_data-manager-app
+sonar.organization=qbicsoftware
+sonar.exclusions=src/test/**,build/**,node_modules/**, **/DataPrivacyAgreement.html, **/LegalNotice.html
diff --git a/user-interface/src/main/bundles/dev.bundle b/user-interface/src/main/bundles/dev.bundle
index 88973dba13db69b7cd465b18c5148d35e44d47d0..2902e0e7ee8f2583cb047c0efc12985efc2e15ff 100644
GIT binary patch
delta 3100043
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 Cw2-=JHNltA8dKHi%8)cyU#oF2Oz%
zrxdWMxC^_O$A5q#T-|_?0*?FxzVK6&R`vk}UU<^^h^b392Cca+KQ4IAC_RFzEt^wu
z7Emn8vvM5Gpk<*zH$ue5)BGgKo}R|zkE(Su
zud2&0y#m6o%3myAD&z$5Gy$z`oWkx?d#FT1+@)%?VJ3vP7LVx$Z*N3mvV8xW9zoHv
z@R`TKCVx!nJVCcmpQy$erOR%1>kwY+&B9A*CUnwK{cxMt2H^jO9vn6H0EJ!CI7k8g
zWD@^%efWa@(YSoj%3C_-Bu29}DA`jjo@|emqqLWro$G_nm3KIXiX8&Jd>2o0veV+j
z2#J>2Qh&`z#vO}SS7919Zf}ikcw@9$qOzs;)qkl)ZQ!U!el_9{f%>=1XDvqe1e7My
zg?(bJ4m!GuGf291B_7fP2?8xSbYS!^efq)#UFiv<;PBzcqsim{?|=V)AKu0vpc>JO
zm5VICRImIOhdlviItAT5zJ*w5Vb2>nxuPG&-nH>M&a_W*GAfG9u0Bn=-T#t
z$QO5`Az##npQ*X6t#QOI9pT3ltnkk={8BAH*!#oSeSvpo;*@Uoe})BrlNmFFmsQ${
zocr7)_-(n}68m8lx$|Aw(gV@ZYY