summaryrefslogtreecommitdiffstats
path: root/openecomp-be/api/openecomp-sdc-rest-webapp/vendor-software-products-rest/vendor-software-products-rest-services/src/main/java/org/openecomp/sdcrests/vsp/rest/services/OrchestrationTemplateCandidateUploadManager.java
blob: c4b3e2ef9b443544946beab17f3f45c9219b6b8e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/*
 * -
 *  ============LICENSE_START=======================================================
 *  Copyright (C) 2022 Nordix Foundation.
 *  ================================================================================
 *  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.
 *
 *  SPDX-License-Identifier: Apache-2.0
 *  ============LICENSE_END=========================================================
 */

package org.openecomp.sdcrests.vsp.rest.services;

import java.util.Optional;
import java.util.UUID;
import org.openecomp.sdc.vendorsoftwareproduct.dao.type.VspUploadStatus;
import org.openecomp.sdcrests.vendorsoftwareproducts.types.VspUploadStatusDto;

public interface OrchestrationTemplateCandidateUploadManager {

    /**
     * Creates a lock to start uploading a package.
     *
     * @param vspId        the Vendor Software Product id
     * @param vspVersionId the Vendor Software Product version id
     * @param user         the current user
     * @return a new upload status containing the lock
     */
    VspUploadStatusDto putUploadInProgress(String vspId, String vspVersionId, String user);

    /**
     * Finishes the upload process, applying the given VspUploadStatusType completion status.
     *
     * @param vspId            the Vendor Software Product id
     * @param vspVersionId     the Vendor Software Product version id
     * @param lockId           the upload lock id
     * @param completionStatus any status that represents a completion
     * @param user             the current user
     * @return the updated status
     */
    VspUploadStatusDto putUploadAsFinished(final String vspId, final String vspVersionId, final UUID lockId, final VspUploadStatus completionStatus,
                                           final String user);

    /**
     * Updates the upload status to a validation state.
     *
     * @param vspId        the Vendor Software Product id
     * @param vspVersionId the Vendor Software Product version id
     * @param user         the current user
     * @return the updated upload status
     */
    VspUploadStatusDto putUploadInValidation(final String vspId, final String vspVersionId, final String user);

    /**
     * Updates the upload status to a processing state.
     *
     * @param vspId        the Vendor Software Product id
     * @param vspVersionId the Vendor Software Product version id
     * @param user         the current user
     * @return the updated upload status
     */
    VspUploadStatusDto putUploadInProcessing(String vspId, String vspVersionId, String user);

    /**
     * Finds the latest upload status for a given Vendor Software Product version.
     *
     * @param vspId        the Vendor Software Product id
     * @param vspVersionId the Vendor Software Product version id
     * @param user         the current user
     * @return the latest upload status for the requested Vendor Software Product version
     */
    Optional<VspUploadStatusDto> findLatestStatus(String vspId, String vspVersionId, String user);
}