aswi2022code-of-duty-gitlab/backend/src/main/java/cz/zcu/kiv/backendapi/catalog/CatalogController.java @ 0598e57d

package cz.zcu.kiv.backendapi.catalog;

import io.swagger.v3.oas.annotations.Operation;
import lombok.RequiredArgsConstructor;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;
import java.util.UUID;

/**
 * Controller for catalog
 */
@RestController
@RequiredArgsConstructor
@RequestMapping("/catalog-items")
public class CatalogController {

    /**
     * Catalog service
     */
    private final ICatalogItemService catalogService;

    /**
     * Creates new or updates catalog item
     *
     * @param catalogItemDto catalog item DTO
     */
    @PostMapping("")
    @Operation(summary = "creates new or updates catalog item")
    public void saveCatalogItem(@RequestBody CatalogItemDto catalogItemDto) {
        catalogService.saveCatalogItem(catalogItemDto);
    }

    /**
     * Saves list of catalog items
     *
     * @param catalogItemDtoList list of catalog items DTO
     */
    @PostMapping("/batch")
    @Operation(summary = "saves list of catalog items")
    public void saveCatalogItems(@RequestBody List<CatalogItemDto> catalogItemDtoList) {
        catalogService.saveCatalogItems(catalogItemDtoList);
    }

    /**
     * Returns catalog items satisfying given filter
     *
     * @param name    name - optional
     * @param country country - optional
     * @param type    type - optional
     * @return list of catalog items satisfying given filter
     */
    @GetMapping("")
    @Operation(summary = "returns catalog items based on filter")
    public ResponseEntity<List<CatalogItemDto>> getCatalog(@RequestParam(defaultValue = "") String name, @RequestParam(defaultValue = "") String country, @RequestParam(defaultValue = "") String type, @RequestParam(defaultValue = "") String writtenForm) {
        return new ResponseEntity<>(catalogService.getCatalog(name, country, type, writtenForm), HttpStatus.OK);
    }


    /**
     * Deletes catalog item with given ID
     *
     * @param id ID
     */
    @DeleteMapping("/{id}")
    @Operation(summary = "deletes catalog item with given ID")
    public void deleteCatalogItem(@PathVariable UUID id) {
        catalogService.deleteCatalogItem(id);
    }

    /**
     * Returns catalog item with given ID
     *
     * @param id ID
     * @return catalog item with given ID
     */
    @GetMapping(value = "/{id}")
    @Operation(summary = "returns catalog item with given ID")
    public CatalogItemDto getCatalogItem(@PathVariable UUID id) {
        return catalogService.getCatalogItem(id);
    }
}