package backend.dao.interfaces;
import backend.model.DataItem;
import java.util.*;
import java.sql.*;

/**
 * 数据项DAO接口，提供数据项的增删改查操作
 */
public interface DataItemDao {
    /**
     * 根据ID查找数据项
     * @param id 数据项ID
     * @return 找到的数据项对象，如果未找到则返回null
     */
    DataItem findById(int id);

    /**
     * 查找所有数据项
     * @return 包含所有数据项的列表
     */
    List<DataItem> findAll();

    /**
     * 根据关键字搜索数据项
     * @param keyword 搜索关键字
     * @return 匹配关键字的数据项列表
     */
    List<DataItem> searchByKeyword(String keyword);

    /**
     * 添加数据项
     * @param item 要添加的数据项对象
     * @return 添加成功返回true，失败返回false
     */
    boolean addItem(DataItem item);

    /**
     * 更新数据项
     * @param item 包含更新信息的数据项对象
     * @return 更新成功返回true，失败返回false
     */
    boolean updateItem(DataItem item);

    /**
     * 删除数据项
     * @param id 要删除的数据项ID
     * @return 删除成功返回true，失败返回false
     */
    boolean deleteItem(int id);
}