/**
 * StudentDao类用于执行与学生相关的数据库操作。
 * 包括增、删、查等功能，通过SQLiteOpenHelper管理数据库。
 */
public class StudentDao {
    private SQLiteDatabase db; // SQLiteDatabase对象，用于执行SQL命令

    /**
     * 构造方法，初始化StudentDao对象并获取可写的数据库实例。
     *
     * @param dbHelper SQLiteOpenHelper对象，用于管理数据库创建和版本管理
     */
    public StudentDao(SQLiteOpenHelper dbHelper) {
        db = dbHelper.getWritableDatabase(); // 获取可写数据库
    }

    /**
     * 执行查询操作，并将结果存储到给定的列表中。
     *
     * @param list   存储查询结果的列表，使用Map来表示每一行数据
     * @param strSQL 要执行的SQL查询语句
     */
    public void execQuery(List<Map<String, Object>> list, final String strSQL) {
        Cursor cursor = null; // 定义Cursor对象用于遍历查询结果
        try {
            cursor = db.rawQuery(strSQL, null); // 执行查询
            list.clear(); // 清空列表以准备存储新结果
            if (cursor.moveToFirst()) { // 检查游标是否有数据
                do {
                    // 创建一个Map用于存储一行数据
                    Map<String, Object> map = new HashMap<>();
                    map.put("sid", cursor.getInt(0)); // 获取学生ID
                    map.put("stu_no", cursor.getString(1)); // 获取学号
                    map.put("name", cursor.getString(2)); // 获取姓名
                    map.put("clazz", cursor.getString(3)); // 获取班级
                    map.put("publish", cursor.getString(4)); // 获取发布日期
                    list.add(map); // 将当前行的数据添加到列表中
                } while (cursor.moveToNext()); // 移动到下一行
            }
        } catch (RuntimeException e) {
            e.printStackTrace(); // 打印异常信息
        } finally {
            if (cursor != null) {
                cursor.close(); // 确保游标在使用后被关闭，避免内存泄漏
            }
        }
    }

    /**
     * 执行不返回结果的SQL语句（如INSERT、DELETE等）。
     *
     * @param strSQL 要执行的SQL语句
     * @return 如果执行成功返回true，否则返回false
     */
    public boolean execSQL(final String strSQL) {
        try {
            db.beginTransaction(); // 开始事务
            db.execSQL(strSQL); // 执行SQL语句
            db.setTransactionSuccessful(); // 设置事务成功
        } catch (RuntimeException e) {
            e.printStackTrace(); // 打印异常信息
            return false; // 返回执行失败
        } finally {
            db.endTransaction(); // 结束事务
        }
        return true; // 返回执行成功
    }

    /**
     * 添加学生信息到数据库。
     *
     * @param stuNo   学号
     * @param name    姓名
     * @param clazz   班级
     * @param publish 发布日期
     */
    public void addStudent(String stuNo, String name, String clazz, String publish) {
        // 构建INSERT SQL语句
        String strSQL = "INSERT INTO student(stu_no, name, clazz, publish) VALUES('"
                + stuNo + "', '" + name + "', '" + clazz + "', '" + publish + "')";
        execSQL(strSQL); // 执行SQL语句
    }

    /**
     * 根据学号删除学生信息。
     *
     * @param stuNo 学号
     */
    public void deleteStudent(String stuNo) {
        // 构建DELETE SQL语句
        String strSQL = "DELETE FROM student WHERE stu_no = '" + stuNo + "'";
        execSQL(strSQL); // 执行SQL语句
    }

    /**
     * 查询学生信息，根据提供的条件过滤结果。
     *
     * @param list   存储查询结果的列表
     * @param stuNo  学号（可选）
     * @param name   姓名（可选）
     * @param clazz  班级（可选）
     */
    public void queryStudents(List<Map<String, Object>> list, String stuNo, String name, String clazz) {
        StringBuilder strSQL = new StringBuilder("SELECT * FROM student WHERE 1=1 "); // 基础查询语句
        if (!stuNo.isEmpty()) {
            strSQL.append(" AND stu_no LIKE '%").append(stuNo).append("%'"); // 添加学号过滤条件
        }
        if (!name.isEmpty()) {
            strSQL.append(" AND name LIKE '%").append(name).append("%'"); // 添加姓名过滤条件
        }
        if (!clazz.isEmpty()) {
            strSQL.append(" AND clazz LIKE '%").append(clazz).append("%'"); // 添加班级过滤条件
        }
        strSQL.append(" ORDER BY publish DESC"); // 按发布日期降序排列
        execQuery(list, strSQL.toString()); // 执行查询
    }
}

dao = new StudentDao(new StudentDBHelper(this));