IcePHP框架中的快速后台中的通用CRUD功能框架(五) SCrud 主控类

古城微笑少年丶 2022-09-20 12:45 10阅读 0赞

<?php  
/\*\*  
 \* CRUD主控类  
 \* @author bluehire  
 \*/  
class SCrud \{  
    const PATH\_VIEW='crud';    //视图路径名  
              
    /\*\*  
     \* 当前列表操作配置  
     \* @var SCrudOperation  
     \*/  
    public $operation;  
      
    /\*\*  
     \* 数据访问对象  
     \* @var STable  
     \*/  
    public $model;  
      
    private $table;    // 主表名  
    private $config;    //表配置 array  
    public $fields;    //所有字段对象数组  
  
    public $title;    // 当前整个CRUD的业务标题  
    public $pageSize=20; //列表分页尺寸  
    public $pageSort='id'; //列表排序依据  
    public $pageDir='desc'; //列表排序方向  
    public $rowNo=true; //列表是否显示行号  
      
    /\*\*  
     \* 列表时的过滤  
     \* @var Closure  
     \*/  
    public $gridFilter;  
      
    //是否有以下操作  
    public $operationView=true;  
    public $operationInsert=true;  
    public $operationUpdate=true;  
    public $operationDelete=true;  
    public $operationMultiDelete=true;  
      
    // 当前请求的控制器与动作名称,用于以后拼接超链接  
    private $controller;  
    private $action;  
      
    /\*\*  
     \*  
     \* @param unknown $table            主表名  
     \* @param unknown $controller            控制器名称  
     \* @param unknown $action            动作名称  
     \*/  
    public function \_\_construct($table, $controller, $action) \{  
        $this->table = $table;  
        $this->controller = $controller;  
        $this->action = $action;  
          
        // 生成各种配置对象  
        $this->config = config ( 'crud/' . $table );  
        foreach ( $this->config as $c => $v ) \{  
            if (strpos ( $c, '\_' ) === 0) \{  
                $n = substr ( $c, 1 );  
                $this->$n = $v;  
            \} else \{  
                $this->fields \[$c\] = new SCrudField ( $this, $v );  
            \}  
        \}  
          
        //本功能的标题  
        $this->title=$this->title?:$table.'管理';  
          
        //所有操作集合  
        $this->operation = new SCrudOperationSet ( $this );  
          
        //数据访问模型  
        $this->model = table($table);  
    \}  
      
    /\*\*  
     \* 取一个字段  
     \*  
     \* @param unknown $name              
     \* @return SCrudField  
     \*/  
    public function field($name) \{  
        if (! isset ( $this->fields \[$name\] )) \{  
            return null;  
        \}  
        return $this->fields \[$name\];  
    \}  
          
    /\*\*  
     \* 取本表主键字段名  
     \* @return SCrudField  
     \*/  
    public function getPrimaryField() \{  
        // 查看所有字段  
        foreach ( $this->fields as $field ) \{  
            // 主键字段必须查询  
            if ($field->primaryKey) \{  
                return $field;  
            \}  
        \}  
          
        return false;  
    \}  
      
    /\*\*  
     \* 获取所有可作为排序依据字段  
     \* @return array of SCrudField  
     \*/  
    public function listSortable()\{  
        return array\_filter ( $this->fields, function ($f) \{  
            return $f->isSortable ();  
        \} );  
    \}  
      
    /\*\*  
     \* 获取所有可搜索字段  
     \* @return multitype:  
     \*/  
    public function listSearchable()\{  
        return array\_filter ( $this->fields, function ($f) \{  
            return $f->isSearchable ();  
        \} );  
    \}  
      
    /\*\*  
     \* 获取所有参与列表的字段  
     \* @return multitype:  
     \*/  
    public function listGridable()\{  
        return array\_filter ( $this->fields, function ($f) \{  
            return $f->isGridable ();  
        \} );  
    \}  
      
    /\*\*  
     \* 获取所有参与查看的字段  
     \* @return multitype:  
     \*/  
    public function listViewable()\{  
        return array\_filter ( $this->fields, function ($f) \{  
            return $f->isViewable ();  
        \} );          
    \}  
      
    /\*\*  
     \* 获取所有参与创建的字段  
     \* @return multitype:  
     \*/  
    public function listInsertable()\{  
        return array\_filter ( $this->fields, function ($f) \{  
            return $f->isInsertable ();  
        \} );  
    \}  
      
    /\*\*  
     \* 获取所有参与编辑的字段  
     \* @return multitype:  
     \*/  
    public function listUpdatable()\{  
        return array\_filter ( $this->fields, function ($f) \{  
            return $f->isUpdatable ();  
        \} );  
    \}  
      
    /\*\*  
     \* 获取所有 创建时间 字段,通常只有一个  
     \* @return multitype:  
     \*/  
    public function listCreated()\{  
        return array\_filter ( $this->fields, function ($field) \{  
            return $field->isCreated;  
        \} );  
    \}  
      
    /\*\*  
     \* 获取所有修改时间字段,通常只有一个  
     \* @return multitype:  
     \*/  
    public function listUpdated()\{  
        return array\_filter ( $this->fields, function ($field) \{  
            return $field->isUpdated;  
        \} );  
    \}  
      
    /\*\*  
     \* 构造 URL  
     \*  
     \* @param unknown $method  
     \*            第三个系统参数(名称固定为m)  
     \* @param unknown $params  
     \*            其它参数  
     \* @return string  
     \*/  
    public function url($method, $params = array()) \{  
        return STemplate::append ( LUrl::ice () . '/', array\_merge ( $params, array (  
                'c' => $this->controller,  
                'a' => $this->action,  
                'm' => $method  
        ) ) );  
    \}  
          
    /\*\*  
     \* 增加一个普通多选操作  
     \*  
     \* @return SCrudOperationMulti  
     \*/  
    public function operationMulti($method) \{  
        return $this->operation->add ( new SCrudOperationMulti ( $this, $method ) );  
    \}  
      
    /\*\*  
     \* 增加一个普通单行操作  
     \*  
     \* @return SCrudOperationRow  
     \*/  
    public function operationRow($method) \{  
        return $this->operation->add ( new SCrudOperationRow ( $this, $method ) );  
    \}  
      
    /\*\*  
     \* 增加一个普通全表操作  
     \*  
     \* @return SCrudOperationTable  
     \*/  
    public function operationTable($method) \{  
        return $this->operation->add ( new SCrudOperationTable ( $this, $method ) );  
    \}  
          
    /\*\*  
     \* 处理请求,由操作类来实现  
     \*  
     \* @param SRequest $req              
     \*/  
    public function process(SRequest $req) \{  
        //处理前,先为搜索条件,列表,创建,修改,查看,排序 初始化字段  
        foreach($this->fields as $field)\{  
            if(!$field->isAbandon)\{  
                $field->process();  
            \}  
        \}  
          
        //设置操作  
        if($this->operationInsert)\{  
            $this->operation->insert(new SCrudOperationTable($this,SCrudOperation::METHOD\_INSERT));  
            $this->operation->insert(new SCrudOperation($this,SCrudOperation::METHOD\_DOINSERT));  
        \}  
        if($this->operationMultiDelete)\{  
            $this->operation->insert(new SCrudOperationMulti($this,SCrudOperation::METHOD\_DELETEMULTI));  
        \}  
        if($this->operationDelete)\{  
            $this->operation->insert(new SCrudOperationRow($this,SCrudOperation::METHOD\_DELETE));              
        \}  
        if($this->operationUpdate)\{  
            $this->operation->insert(new SCrudOperationRow($this,SCrudOperation::METHOD\_UPDATE));  
            $this->operation->insert(new SCrudOperation($this,SCrudOperation::METHOD\_DOUPDATE));  
        \}  
        if($this->operationView)\{  
            $this->operation->insert(new SCrudOperationRow($this,SCrudOperation::METHOD\_VIEW));  
        \}  
          
        //转交操作类处理  
        $this->operation->process ( $req );  
    \}  
      
    /\*\*  
     \* 显示CRUD片段  
     \* @param unknown $tpl 模板名  
     \* @param unknown $params  
     \*/  
    public function display($tpl, $params = array()) \{  
        display ( self::PATH\_VIEW . DIRECTORY\_SEPARATOR . $tpl, array\_merge ( $params, array (  
                'url\_view' => $this->url ( SCrudOperation::METHOD\_VIEW ),  
                'url\_index' => $this->url ( SCrudOperation::METHOD\_INDEX ),  
                'url\_search' => $this->url ( SCrudOperation::METHOD\_SEARCH ),  
                'url\_insert' => $this->url ( SCrudOperation::METHOD\_INSERT ),  
                'url\_update' => $this->url( SCrudOperation::METHOD\_UPDATE ),  
                'url\_doupdate' => $this->url ( SCrudOperation::METHOD\_DOUPDATE ),  
                'url\_doinsert' => $this->url ( SCrudOperation::METHOD\_DOINSERT ),  
                'url\_delete' =>$this->url ( SCrudOperation::METHOD\_DELETE ),  
                'url\_delete\_multi'=>$this->url(SCrudOperation::METHOD\_DELETEMULTI)  
        ) ) );  
    \}  
\}  
  
/\*\*  
 \* 所有CRUD子类的基类,实现了一个记录主CRUD对象的方法  
 \*  
 \* @author bluehire  
 \*          
 \*/  
abstract class SCrudSub \{  
    // 主CRUD对象  
    protected $crud;  
\}