feat(service): add use case for creating api metadata

gravitee-apim-rest-api/gravitee-apim-rest-api-service/src/main/java/io/gravitee/apim/core/api/domain_service/ApiMetadataDomainService.java

@@ -17,6 +17,7 @@
 
 import io.gravitee.apim.core.DomainService;
 import io.gravitee.apim.core.api.model.ApiMetadata;
+import io.gravitee.apim.core.api.model.NewApiMetadata;
 import io.gravitee.apim.core.audit.domain_service.AuditDomainService;
 import io.gravitee.apim.core.audit.model.ApiAuditLogEntity;
 import io.gravitee.apim.core.audit.model.AuditInfo;
@@ -77,6 +78,39 @@ public void saveApiMetadata(String apiId, List<ApiMetadata> metadata, AuditInfo
         throw new TechnicalDomainException("Not yet implemented");
     }
 
+    public ApiMetadata create(NewApiMetadata newApiMetadata, AuditInfo auditInfo) {
+        var now = TimeProvider.now();
+        var createdMetadata = metadataCrudService.create(
+            Metadata
+                .builder()
+                .key(newApiMetadata.getKey())
+                .format(newApiMetadata.getFormat())
+                .name(newApiMetadata.getName())
+                .value(newApiMetadata.getValue())
+                .referenceType(Metadata.ReferenceType.API)
+                .referenceId(newApiMetadata.getApiId())
+                .createdAt(now)
+                .updatedAt(now)
+                .build()
+        );
+        createAuditLog(createdMetadata, auditInfo);
+
+        var defaultValue =
+            this.metadataCrudService.findById("_", Metadata.ReferenceType.DEFAULT, createdMetadata.getKey())
+                .map(Metadata::getValue)
+                .orElse(null);
+
+        return ApiMetadata
+            .builder()
+            .key(createdMetadata.getKey())
+            .format(createdMetadata.getFormat())
+            .name(createdMetadata.getName())
+            .value(createdMetadata.getValue())
+            .defaultValue(defaultValue)
+            .apiId(createdMetadata.getReferenceId())
+            .build();
+    }
+
     private void createAuditLog(Metadata created, AuditInfo auditInfo) {
         auditService.createApiAuditLog(
             ApiAuditLogEntity

gravitee-apim-rest-api/gravitee-apim-rest-api-service/src/main/java/io/gravitee/apim/core/api/model/NewApiMetadata.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright © 2015 The Gravitee team (http://gravitee.io)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.gravitee.apim.core.api.model;
+
+import io.gravitee.apim.core.metadata.model.Metadata;
+import lombok.*;
+
+@Data
+@Builder(toBuilder = true)
+@AllArgsConstructor
+@NoArgsConstructor
+public class NewApiMetadata {
+
+    String apiId;
+    String key;
+    String name;
+
+    @Builder.Default
+    Metadata.MetadataFormat format = Metadata.MetadataFormat.STRING;
+
+    String value;
+}

gravitee-apim-rest-api/gravitee-apim-rest-api-service/src/main/java/io/gravitee/apim/core/api/use_case/CreateApiMetadataUseCase.java

@@ -0,0 +1,69 @@
+/*
+ * Copyright © 2015 The Gravitee team (http://gravitee.io)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.gravitee.apim.core.api.use_case;
+
+import io.gravitee.apim.core.UseCase;
+import io.gravitee.apim.core.api.crud_service.ApiCrudService;
+import io.gravitee.apim.core.api.domain_service.ApiMetadataDomainService;
+import io.gravitee.apim.core.api.domain_service.ValidateApiMetadataDomainService;
+import io.gravitee.apim.core.api.exception.ApiNotFoundException;
+import io.gravitee.apim.core.api.model.ApiMetadata;
+import io.gravitee.apim.core.api.model.NewApiMetadata;
+import io.gravitee.apim.core.audit.model.AuditInfo;
+
+@UseCase
+public class CreateApiMetadataUseCase {
+
+    private final ValidateApiMetadataDomainService validateApiMetadataDomainService;
+    private final ApiMetadataDomainService apiMetadataDomainService;
+    private final ApiCrudService apiCrudService;
+
+    public CreateApiMetadataUseCase(
+        ValidateApiMetadataDomainService validateApiMetadataDomainService,
+        ApiMetadataDomainService apiMetadataDomainService,
+        ApiCrudService apiCrudService
+    ) {
+        this.validateApiMetadataDomainService = validateApiMetadataDomainService;
+        this.apiMetadataDomainService = apiMetadataDomainService;
+        this.apiCrudService = apiCrudService;
+    }
+
+    public Output execute(Input input) {
+        var apiId = input.newApiMetadata.getApiId();
+
+        // Check that api exists with env id
+        var api = apiCrudService.get(apiId);
+
+        if (!api.getEnvironmentId().equals(input.auditInfo().environmentId())) {
+            throw new ApiNotFoundException(apiId);
+        }
+
+        this.validateApiMetadataDomainService.validateUniqueKey(apiId, input.newApiMetadata.getKey());
+        this.validateApiMetadataDomainService.validateUniqueName(apiId, input.newApiMetadata.getName());
+        this.validateApiMetadataDomainService.validateValueByFormat(
+                api,
+                input.auditInfo().organizationId(),
+                input.newApiMetadata.getValue(),
+                input.newApiMetadata.getFormat()
+            );
+
+        return new Output(this.apiMetadataDomainService.create(input.newApiMetadata(), input.auditInfo()));
+    }
+
+    public record Input(NewApiMetadata newApiMetadata, AuditInfo auditInfo) {}
+
+    public record Output(ApiMetadata created) {}
+}