package io.delphiplatform.api.v3.view;

import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;

import java.util.List;

import javax.validation.Valid;
import javax.validation.constraints.Max;
import javax.validation.constraints.Min;

import io.delphiplatform.api.v3.constant.ApplicationConstants;
import io.delphiplatform.api.v3.model.SortOrder;
import io.delphiplatform.api.v3.model.gras.RepertoireOwner;
import io.delphiplatform.api.v3.model.gras.RepertoireOwners;
import io.delphiplatform.api.v3.view.util.Params;

@Validated
public interface RepertoireOwnersApi {

    /**
     * GET /repertoire-owners/{rep_owner_key} : Get one Company Resource route for getting a single
     * `RepertoireOwner`.
     *
     * @param repOwnerKey Primary key identifier for a `RepertoireOwner` (`Company`). (required)
     * @return `Repertoire Owner` response object (status code 200) or A `400 Bad Request` response
     * status indicates a problem with the input provided by a client request. If you are receiving this error, check
     * your request parameters are valid.  (status code 400) or A `401 Unauthorized` response status indicates
     * that the request did not include a required Authorization header, or that there was a problem authenticating the
     * client. Possible problems include an expired or invalid token, or the Authorization header is not in the expected
     * format.  (status code 401) or A `404 Not Found` response status is returned when a single item queried
     * by primary key identifier was not found in the database, or an endpoint path was provided that does not exist.
     * (status code 404) or A `500 Internal Error` response status is returned for any application and server
     * level errors that are not already associated with another error status. A 500 is used as a generic fallback
     * error.  (status code 500)
     */
    @RequestMapping(value = "/repertoire-owners/{rep_owner_key}",
        produces = {"application/json"},
        method = RequestMethod.GET)
    default ResponseEntity<RepertoireOwner> repertoireOwnersGet(@PathVariable("rep_owner_key") String repOwnerKey) {
        return findOne(repOwnerKey);
    }

    ResponseEntity<RepertoireOwner> findOne(String repOwnerKey);

    /**
     * GET /repertoire-owners : Search for Repertoire Owners Resource route for getting a list of &#x60;Repertoire
     * Owner&#x60; with filtering based on provided parameters.
     *
     * @param profitCenterKey   Profit Center key (optional, default to new ArrayList&lt;&gt;())
     * @param parentRepOwnerKey Parent Repertoire Owner key (optional, default to new ArrayList&lt;&gt;())
     * @param labelId           Primary key identifier for a (local) &#x60;Label&#x60;. (optional)
     * @param limit             The maximum number of &#x60;items&#x60; to return in a single request (i.e.: a single
     *                          page). (optional)
     * @param offset            The number of &#x60;items&#x60; to offset (aka skip) for pagination.  (optional, default
     *                          to 0)
     * @param sortBy            Field name existing in the top level of an object in &#x60;items&#x60; by which to sort
     *                          the results. (optional)
     * @param sortOrder         Direction to sort the data. Default: &#x60;desc&#x60; if &#x60;sort_by&#x60; provided.
     *                          (optional, default to desc)
     * @return &#x60;Repertoire Owners&#x60; response object (status code 200) or A &#x60;400 Bad Request&#x60; response
     * status indicates a problem with the input provided by a client request. If you are receiving this error, check
     * your request parameters are valid.  (status code 400) or A &#x60;401 Unauthorized&#x60; response status indicates
     * that the request did not include a required Authorization header, or that there was a problem authenticating the
     * client. Possible problems include an expired or invalid token, or the Authorization header is not in the expected
     * format.  (status code 401) or A &#x60;500 Internal Error&#x60; response status is returned for any application
     * and server level errors that are not already associated with another error status. A 500 is used as a generic
     * fallback error.  (status code 500)
     */
    @RequestMapping(value = "/repertoire-owners",
        produces = {"application/json"},
        method = RequestMethod.GET)
    default ResponseEntity<RepertoireOwners> repertoireOwnersSearch(
        @Valid @RequestParam(value = "profit_center_key", required = false) List<String> profitCenterKey,
        @Valid @RequestParam(value = "parent_rep_owner_key", required = false) List<String> parentRepOwnerKey,
        @Valid @RequestParam(value = "label_id", required = false) String labelId,
        @Min(0) @Max(ApplicationConstants.MAX_PAGE_SIZE) @Valid @RequestParam(value = "limit", required = false) Integer limit,
        @Min(0) @Valid @RequestParam(value = "offset", required = false, defaultValue = "0") Integer offset,
        @Valid @RequestParam(value = "sort_by", required = false) String sortBy,
        @Valid @RequestParam(value = "sort_order", required = false, defaultValue = "desc") SortOrder sortOrder) {
        return getSearchData(Params.builder()
            .profitCenterKeys(profitCenterKey)
            .parentRepOwnerKeys(parentRepOwnerKey)
            .labelId(labelId)
            .limit(limit)
            .offset(offset)
            .sortBy(sortBy)
            .sortOrder(sortOrder)
            .build());
    }

    ResponseEntity<RepertoireOwners> getSearchData(Params params);

}