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

package cz.zcu.kiv.backendapi.catalog;

import cz.zcu.kiv.backendapi.path.PathDto;

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

/**
 * Catalog item service interface
 */
public interface ICatalogItemService {
    /**
     * Saves list of catalog items DTO
     *
     * @param catalogItemDtoList list of catalog items DTO
     */
    void saveCatalogItems(List<CatalogItemDto> catalogItemDtoList);

    /**
     * Saves one catalog item (creates new if ID is null or does not exist, updates catalog item otherwise)
     *
     * @param catalogItemDto catalog item DTO
     */
    void saveCatalogItem(CatalogItemDto catalogItemDto);

    /**
     * Deletes catalog item with given ID
     *
     * @param id ID
     */
    void deleteCatalogItem(UUID id);

    /**
     * Returns catalog items satisfying given filter
     *
     * @param name        name - optional
     * @param country     country - optional
     * @param type        type - optional
     * @param writtenForm written form - optional
     * @return list of catalog items satisfying given filter
     */
    List<CatalogItemDto> getCatalog(String name, String country, String type, String writtenForm);

    /**
     * Returns catalog item with given ID
     *
     * @param id ID
     * @return catalog item with given ID
     */
    CatalogItemDto getCatalogItem(UUID id);

    /**
     * Returns highlighted searched text and searched items
     *
     * @param text text
     * @return highlighted searched text and searched items
     */
    PathDto getPath(String text);

}