[#1580] Software Module & Distribution Set lock: add lock at rest level (#1646)

Signed-off-by: Marinov Avgustin <Avgustin.Marinov@bosch.com>

hawkbit-rest/hawkbit-mgmt-api/src/main/java/org/eclipse/hawkbit/mgmt/json/model/distributionset/MgmtDistributionSet.java

@@ -58,6 +58,7 @@ import com.fasterxml.jackson.annotation.JsonProperty;
          "type" : "os",
          "typeName" : "OS",
          "vendor" : "vendor Limited Inc, California",
+         "locked" : true,
          "deleted" : false,
          "encrypted" : false,
          "_links" : {
@@ -77,6 +78,7 @@ import com.fasterxml.jackson.annotation.JsonProperty;
          "type" : "runtime",
          "typeName" : "runtime",
          "vendor" : "vendor GmbH, Stuttgart, Germany",
+         "locked" : true,
          "deleted" : false,
          "encrypted" : false,
          "_links" : {
@@ -96,6 +98,7 @@ import com.fasterxml.jackson.annotation.JsonProperty;
          "type" : "application",
          "typeName" : "Application",
          "vendor" : "vendor Limited, California",
+         "locked" : true,
          "deleted" : false,
          "encrypted" : false,
          "_links" : {
@@ -137,12 +140,6 @@ public class MgmtDistributionSet extends MgmtNamedEntity {
     @Schema(description = "Package version", example = "1.4.2")
     private String version;
 
-    @JsonProperty
-    @Schema(description = """
-        True if DS is a required migration step for another DS. As a result the DS’s assignment will not be cancelled
-        when another DS is assigned (note: updatable only if DS is not yet assigned to a target)""", example = "false")
-    private boolean requiredMigrationStep;
-
     @JsonProperty
     @Schema(description = "The type of the distribution set", example = "test_default_ds_type")
     private String type;
@@ -158,6 +155,10 @@ public class MgmtDistributionSet extends MgmtNamedEntity {
         distribution set type""", example = "true")
     private Boolean complete;
 
+    @JsonProperty
+    @Schema(description = "If the distribution set is locked", example = "true")
+    private boolean locked;
+
     @JsonProperty
     @Schema(description = "Deleted flag, used for soft deleted entities", example = "false")
     private boolean deleted;
@@ -167,6 +168,12 @@ public class MgmtDistributionSet extends MgmtNamedEntity {
             example = "true")
     private boolean valid;
 
+    @JsonProperty
+    @Schema(description = """
+        True if DS is a required migration step for another DS. As a result the DS’s assignment will not be cancelled
+        when another DS is assigned (note: updatable only if DS is not yet assigned to a target)""", example = "false")
+    private boolean requiredMigrationStep;
+
     @JsonProperty
     private List<MgmtSoftwareModule> modules = new ArrayList<>();
 }

hawkbit-rest/hawkbit-mgmt-api/src/main/java/org/eclipse/hawkbit/mgmt/json/model/distributionset/MgmtDistributionSetRequestBodyPut.java

@@ -29,12 +29,21 @@ public class MgmtDistributionSetRequestBodyPut {
     @JsonProperty
     @Schema(description = "The name of the entity", example = "dsOne")
     private String name;
+
     @JsonProperty
     @Schema(description = "The description of the entity", example = "Description of the distribution set.")
     private String description;
+
     @JsonProperty
     @Schema(description = "Package version", example = "1.0.0")
     private String version;
+
+    @JsonProperty
+    @Schema(description = "Put it to true only if want to lock the distribution set. Otherwise skip it. " +
+            "Shall not be false!",
+            example = "true")
+    private Boolean locked;
+
     @JsonProperty
     @Schema(description = """
         True if DS is a required migration step for another DS. As a result the DS’s assignment will not be cancelled

hawkbit-rest/hawkbit-mgmt-api/src/main/java/org/eclipse/hawkbit/mgmt/json/model/softwaremodule/MgmtSoftwareModule.java

@@ -45,8 +45,9 @@ import com.fasterxml.jackson.annotation.JsonProperty;
       "type" : "os",
       "typeName" : "OS",
       "vendor" : "Vendor Limited, California",
-      "deleted" : false,
       "encrypted" : false,
+      "locked" : true,
+      "deleted" : false,
       "_links" : {
         "self" : {
           "href" : "https://management-api.host.com/rest/v1/softwaremodules/6"
@@ -84,11 +85,15 @@ public class MgmtSoftwareModule extends MgmtNamedEntity {
     @Schema(description = "The software vendor", example = "Vendor Limited, California")
     private String vendor;
 
-    @JsonProperty
-    @Schema(description = "If the software module is deleted", example = "false")
-    private boolean deleted;
-
     @JsonProperty
     @Schema(description = "If the software module is encrypted", example = "false")
     private boolean encrypted;
+
+    @JsonProperty
+    @Schema(description = "If the software module is locked", example = "true")
+    private boolean locked;
+
+    @JsonProperty
+    @Schema(description = "If the software module is deleted", example = "false")
+    private boolean deleted;
 }

hawkbit-rest/hawkbit-mgmt-api/src/main/java/org/eclipse/hawkbit/mgmt/json/model/softwaremodule/MgmtSoftwareModuleRequestBodyPut.java

@@ -24,7 +24,14 @@ public class MgmtSoftwareModuleRequestBodyPut {
     @JsonProperty
     @Schema(example = "SM Description")
     private String description;
+
     @JsonProperty
     @Schema(example = "SM Vendor Name")
     private String vendor;
+
+    @JsonProperty
+    @Schema(description = "Put it to true only if want to lock the software module. Otherwise skip it. " +
+            "Shall not be false!",
+            example = "true")
+    private Boolean locked;
 }

hawkbit-rest/hawkbit-mgmt-resource/src/main/java/org/eclipse/hawkbit/mgmt/rest/resource/MgmtDistributionSetMapper.java

@@ -111,6 +111,7 @@ public final class MgmtDistributionSetMapper {
         response.setComplete(distributionSet.isComplete());
         response.setType(distributionSet.getType().getKey());
         response.setTypeName(distributionSet.getType().getName());
+        response.setLocked(distributionSet.isLocked());
         response.setDeleted(distributionSet.isDeleted());
         response.setValid(distributionSet.isValid());
 

hawkbit-rest/hawkbit-mgmt-resource/src/main/java/org/eclipse/hawkbit/mgmt/rest/resource/MgmtDistributionSetResource.java

@@ -198,10 +198,10 @@ public class MgmtDistributionSetResource implements MgmtDistributionSetRestApi {
     public ResponseEntity<MgmtDistributionSet> updateDistributionSet(
             @PathVariable("distributionSetId") final Long distributionSetId,
             @RequestBody final MgmtDistributionSetRequestBodyPut toUpdate) {
-
         final DistributionSet updated = distributionSetManagement.update(entityFactory.distributionSet()
                 .update(distributionSetId).name(toUpdate.getName()).description(toUpdate.getDescription())
-                .version(toUpdate.getVersion()).requiredMigrationStep(toUpdate.getRequiredMigrationStep()));
+                .version(toUpdate.getVersion()).locked(toUpdate.getLocked())
+                .requiredMigrationStep(toUpdate.getRequiredMigrationStep()));
 
         final MgmtDistributionSet response = MgmtDistributionSetMapper.toResponse(updated);
         MgmtDistributionSetMapper.addLinks(updated, response);

hawkbit-rest/hawkbit-mgmt-resource/src/main/java/org/eclipse/hawkbit/mgmt/rest/resource/MgmtSoftwareModuleMapper.java

@@ -115,6 +115,7 @@ public final class MgmtSoftwareModuleMapper {
         response.setType(softwareModule.getType().getKey());
         response.setTypeName(softwareModule.getType().getName());
         response.setVendor(softwareModule.getVendor());
+        response.setLocked(softwareModule.isLocked());
         response.setDeleted(softwareModule.isDeleted());
         response.setEncrypted(softwareModule.isEncrypted());
 

hawkbit-rest/hawkbit-mgmt-resource/src/main/java/org/eclipse/hawkbit/mgmt/rest/resource/MgmtSoftwareModuleResource.java

@@ -248,7 +248,9 @@ public class MgmtSoftwareModuleResource implements MgmtSoftwareModuleRestApi {
             @RequestBody final MgmtSoftwareModuleRequestBodyPut restSoftwareModule) {
         final SoftwareModule module = softwareModuleManagement
                 .update(entityFactory.softwareModule().update(softwareModuleId)
-                        .description(restSoftwareModule.getDescription()).vendor(restSoftwareModule.getVendor()));
+                        .description(restSoftwareModule.getDescription())
+                        .vendor(restSoftwareModule.getVendor())
+                        .locked(restSoftwareModule.getLocked()));
 
         final MgmtSoftwareModule response = MgmtSoftwareModuleMapper.toResponse(module);
         MgmtSoftwareModuleMapper.addLinks(module, response);