study-api-v2/app/Http/Requests/Admin/Students/StudentClassRequest.php

<?php

namespace App\Http\Requests\Admin\Students;

use App\Http\Requests\BaseRequest;

/**
 * 学生班级关联请求验证
 */
class StudentClassRequest extends BaseRequest
{
    /**
     * 获取特定的验证规则
     */
    protected function getSpecificRules(): array
    {
        $action = $this->route()->getActionMethod();

        return match($action) {
            'list' => $this->listRules(),
            'detail' => $this->detailRules(),
            'create' => $this->createRules(),
            'update' => $this->updateRules(),
            'delete' => $this->deleteRules(),
            'batchDelete' => $this->batchDeleteRules(),
            'studentClasses' => $this->studentClassesRules(),
            'classStudents' => $this->classStudentsRules(),
            'schoolStudents' => $this->schoolStudentsRules(),
            'batchAssign' => $this->batchAssignRules(),
            'batchRemove' => $this->batchRemoveRules(),
            'transfer' => $this->transferRules(),
            'stats' => $this->statsRules(),
            default => []
        };
    }

    /**
     * 获取分页验证规则
     */
    private function getPaginationRules(): array
    {
        return [
            'page' => ['sometimes', 'integer', 'min:1'],
            'page_size' => ['sometimes', 'integer', 'min:1', 'max:100'],
        ];
    }

    /**
     * 列表查询验证规则
     */
    private function listRules(): array
    {
        return array_merge($this->getPaginationRules(), [
            'student_id' => ['sometimes', 'integer'],
            'school_id' => ['sometimes', 'integer', 'exists:school,id'],
            'class_id' => ['sometimes', 'integer', 'exists:school_class,id'],
        ]);
    }

    /**
     * 详情查询验证规则
     */
    private function detailRules(): array
    {
        return [
            'id' => ['required', 'integer', 'exists:student_class,id'],
        ];
    }

    /**
     * 创建验证规则
     */
    private function createRules(): array
    {
        return [
            'student_id' => ['required', 'integer'],
            'school_id' => ['required', 'integer', 'exists:school,id'],
            'class_id' => ['required', 'integer', 'exists:school_class,id'],
        ];
    }

    /**
     * 更新验证规则
     */
    private function updateRules(): array
    {
        return [
            'id' => ['required', 'integer', 'exists:student_class,id'],
            'student_id' => ['required', 'integer'],
            'school_id' => ['required', 'integer', 'exists:school,id'],
            'class_id' => ['required', 'integer', 'exists:school_class,id'],
        ];
    }

    /**
     * 删除验证规则
     */
    private function deleteRules(): array
    {
        return [
            'id' => ['required', 'integer', 'exists:student_class,id'],
        ];
    }

    /**
     * 批量删除验证规则
     */
    private function batchDeleteRules(): array
    {
        return [
            'ids' => ['required', 'array', 'min:1'],
            'ids.*' => ['integer', 'exists:student_class,id'],
        ];
    }

    /**
     * 学生班级列表验证规则
     */
    private function studentClassesRules(): array
    {
        return [
            'student_id' => ['required', 'integer'],
        ];
    }

    /**
     * 班级学生列表验证规则
     */
    private function classStudentsRules(): array
    {
        return [
            'class_id' => ['required', 'integer', 'exists:school_class,id'],
        ];
    }

    /**
     * 学校学生列表验证规则
     */
    private function schoolStudentsRules(): array
    {
        return [
            'school_id' => ['required', 'integer', 'exists:school,id'],
        ];
    }

    /**
     * 批量分配验证规则
     */
    private function batchAssignRules(): array
    {
        return [
            'student_ids' => ['required', 'array', 'min:1'],
            'student_ids.*' => ['integer'],
            'class_id' => ['required', 'integer', 'exists:school_class,id'],
        ];
    }

    /**
     * 批量移除验证规则
     */
    private function batchRemoveRules(): array
    {
        return [
            'student_ids' => ['required', 'array', 'min:1'],
            'student_ids.*' => ['integer'],
            'class_id' => ['required', 'integer', 'exists:school_class,id'],
        ];
    }

    /**
     * 转移验证规则
     */
    private function transferRules(): array
    {
        return [
            'student_id' => ['required', 'integer'],
            'old_class_id' => ['required', 'integer', 'exists:school_class,id'],
            'new_class_id' => ['required', 'integer', 'exists:school_class,id'],
        ];
    }

    /**
     * 统计信息验证规则
     */
    private function statsRules(): array
    {
        return [
            'student_id' => ['required', 'integer'],
        ];
    }

    /**
     * 获取特定的验证错误消息
     */
    protected function getSpecificMessages(): array
    {
        return [
            'student_id.required' => '学生ID不能为空',
            'school_id.required' => '学校不能为空',
            'school_id.exists' => '指定的学校不存在',
            'class_id.required' => '班级不能为空',
            'class_id.exists' => '指定的班级不存在',
            'student_ids.required' => '学生ID列表不能为空',
            'student_ids.min' => '至少选择一个学生',
            'old_class_id.required' => '原班级不能为空',
            'old_class_id.exists' => '指定的原班级不存在',
            'new_class_id.required' => '新班级不能为空',
            'new_class_id.exists' => '指定的新班级不存在',
            'ids.required' => '请选择要删除的记录',
            'ids.min' => '至少选择一条记录进行删除',
        ];
    }
}