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

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("/api/catalog-items")
public class CatalogController {

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

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

    /**
     * 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) {
        return new ResponseEntity<>(catalogService.getCatalog(name, country, type), HttpStatus.OK);
    }

    /**
     * Updates catalog item with given ID
     *
     * @param id             ID
     * @param catalogItemDto catalog item DTO
     */
    @PutMapping("/{id}")
    @Operation(summary = "updates catalog item with given ID")
    public void updateCatalogItem(@PathVariable UUID id, @RequestBody CatalogItemDto catalogItemDto) {
        catalogService.updateCatalogItem(id, catalogItemDto);
    }

    /**
     * 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
     */
    @RequestMapping(value = "/{id}", method = RequestMethod.GET, produces = "application/json")
    @Operation(summary = "returns catalog item with given ID")
    public CatalogItemDto getCatalogItem(@PathVariable UUID id) {
        return catalogService.getCatalogItem(id);
    }
}