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

<?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;
}