[#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;
 }