fdesk/app/common/traits/crud/CrudServiceTrait.php

<?php
namespace app\common\traits\crud;

use support\exception\BusinessException;
use support\Request;

/**
 * Trait CrudServiceTrait
 *
 * 提供标准的增删改查 Service 接口，依赖 CrudLogicTrait。
 * 使用此 Trait 的 Service 类，须：
 *   use CrudLogicTrait, CrudServiceTrait;
 *   protected string $modelClass = \App\common\model\YourModel::class;
 */
trait CrudServiceTrait
{
    use CrudLogicTrait;

    /** 具体 Service 里定义：protected string $modelClass = YourModel::class; */

    /**
     * 获取验证器
     */
    public function getValidator()
    {
        return  $this->validator;
    }

    /** 分页列表 */
    public function serviceList(Request $request)
    {
        if (method_exists($this, 'complexQuery')) {
            $result = $this->complexQuery($request->get());
        } else {
            $config = $this->buildQueryConfig($request, 'index');
            $limit = (int)$request->get('size', 15);
            $page  = (int)$request->get('current',  1);
            $result = $this->logicList($config, $limit, $page);
        }
        return $this->postProcess('List', $result);
    }

    /** 全量列表 */
    public function serviceListAll(Request $request)
    {
        if (method_exists($this, 'complexQuery')) {
            $result = $this->complexQuery($request->get());
        } else {
            $config = $this->buildQueryConfig($request, 'default');
            $result = $this->logicListAll($config);
        }
        return $this->postProcess('ListAll', $result);
    }

    /** 查看单条 */
    public function serviceShow(Request $request)
    {
        $config = $this->buildQueryConfig($request, 'show');
        $item = $this->logicShow($config);
        return $this->postProcess('Show', $item);
    }

    /** 创建 */
    public function serviceStore(Request $request, array $data = [])
    {
        $data = $this->preProcess('Store', $data, $request);
        $dl   = $this->getDataLimitFromRequest($request);
        $created = $this->logicCreate($data, $dl);
        return $this->postProcess('Store', $created);
    }

    /** 更新 */
    public function serviceUpdate(Request $request, array $data = [])
    {
        $data = $this->preProcess('Update', $data, $request);
        $config = $this->buildQueryConfig($request, 'update');
        $updated = $this->logicUpdateBy($config, $data);
        return $this->postProcess('Update', $data);
    }

    /** 删除 */
    public function serviceDestroy(Request $request)
    {
        $config = $this->buildQueryConfig($request, 'destroy');
        $deleted = $this->logicDeleteBy($config);
        return $this->postProcess('Destroy', $deleted);
    }

    /** ----------------- 公共辅助方法 ----------------- */
    
    /**
     * 构造 CrudUtil 查询配置
     */
    protected function buildQueryConfig(Request $request, string $scene = 'default'): array
    {
        $p = $request->all();
        
        $config = [];
        $config['model'] = $this->modelClass;
        switch ($scene) {
            case 'default':
                $config['where']['status'] = 1;
                $config['order']['sort'] = 'desc';
                $config['order']['id'] = 'desc';
                break;
            case 'index':
                $config['where']['status'] = 1;
                $config['order']['sort'] = 'desc';
                $config['order']['id'] = 'desc';
                break;
            case 'show':
                $config['where']['id'] = $p['id'];
                $config['where']['status'] = 1;
                break;
            case 'store':
                break;
            case 'update':
                $config['where']['id'] = $p['id'];
                break;
            case 'destroy':
                $config['where']['id'] = $p['id'];
                break;
        }
        
        return $config;
    }

    /** 解析 withFields 字符串 "rel:field,field;..." */
    protected function parseWithFields(string $str): array
    {
        if (!$str) {
            return [];
        }
        $out = [];
        foreach (explode(';', $str) as $pair) {
            [$rel, $flds] = explode(':', $pair);
            $out[$rel]   = explode(',', $flds);
        }
        return $out;
    }

    /** 从请求读取 dataLimitType, dataLimitField */
    protected function getDataLimitFromRequest(Request $req): array
    {
        $type = $req->get('dataLimitType');
        if (!$type) {
            return [];
        }
        return [
            'type'  => $type,
            'field' => $req->get('dataLimitField', 'admin_id'),
        ];
    }

    /**
     * $data 前置处理
     *
     * @param array   $data
     * @param Request $request
     * @return array
     */
    protected function preProcess(string $op, mixed $data, Request $request): mixed
    {
        $hook = "beforeService{$op}";
        return method_exists($this, $hook)
            ? $this->{$hook}($data, $request)
            : $data;
    }

    /**
     * 根据操作类型，调用对应的后置钩子
     *
     * @param string $op    操作：List, Show, Store, Update, Destroy
     * @param mixed  $data  原始返回值
     * @return mixed        处理后的返回值
     */
    protected function postProcess(string $op, mixed $data): mixed
    {
        $hook = "afterService{$op}";
        return method_exists($this, $hook)
            ? $this->{$hook}($data)
            : $data;
    }

    
    /** 
     * 处理复杂查询 
     * 覆盖此方法，实现复杂查询逻辑
     */
    // protected function complexQuery(array $params): array
    // {
    //     throw new BusinessException('请在子类实现 complexQuery');
    // }
}