登录
原创

Dcat Admin 入门应用(二)代码生成器

专栏Dcat Admin入门应用
发布于 2020-09-30 阅读 247
  • 后端
  • Laravel
原创

一、代码生成器

在日常开发中,我们可以用代码生成器一键生成增删改查页面代码,非常的方便快捷。

1、一键生成增删改查页面

1.1、将项目的APP_DEBUG开起(true),打开项目即可看到侧边栏的开发工具菜单,打开代码生成器;

image.png

1.2、点击已有数据库,选择需要生成页面的数据表,选择之后会自动填充字段信息,效果如下,:

image.png

  • 1.2.1、选择数据表后会自动填充处理主键Id和时间戳意外的字段
  • 1.2.2、可以选择性的创建业务文件:迁移文件、model、数据仓、控制器等等,如有文件已存在按需选择
  • 1.2.3、翻译字段信息,这将以字段标题的形式展现在列表页面和相关的数据页面

1.3、点击提交就可以自动生成相关文件,目录如下:

    app/Admin
    ├── Controllers
    │   └── AdminUserController.php  # 控制器
    └── Repositories                 # 数据仓库
    │   └── AdminUser.php
    resouces/lang/{当前语言}
    └── admin-user.php  
    ├── Models                        # 数据模型
    │   └── AdminUser.php       

3、添加路由

打开路由配置文件app/Admin/routes.php,往里面添加一行:

    $router->resource('adminUser', 'AdminUserController');

到此,就可以打开浏览器输入地址http://你的域名/admin/adminUser访问刚刚创建完的页面了

4、添加左侧菜单

打开项目主页,可以看到页面如下,可以在此处添加左侧菜单栏:

image.png

注意:

  • 添加路径的时候需要去除admin.php里面配置的路由前缀(默认是admin)
  • 如果添加的是外部链接的话,需要添加完整的链接地址

5、菜单语言翻译文件

在您的语言文件的menu_ti<x>tles索引中追加菜单标题。 例如“工作单位”标题:

在resources/lang/{当前语言}/admin.php中


    // 用_小写并用_替换空格
    'menu_titles' => [
        'work_units' => '当前语言包翻译内容'
    ],


自此完成了代码生成器的使用和增删改查页面的生成

二、增删改查功能简易说明

1、控制器

Dcat Admin的增删改查页面代码是非常简洁和易懂的,对开发者非常的友好,只需极少的代码即可构建出一个功能完善的后台系统,并且非常简单灵活和易于扩展。

打开app/Admin/Controllers/AdminUserController.php可以看到如下代码


<?php

namespace App\Admin\Controllers;

use App\Admin\Repositories\User;
use Dcat\Admin\Form;
use Dcat\Admin\Grid;
use Dcat\Admin\Show;
use Dcat\Admin\Controllers\AdminController;

class AdminUserController extends AdminController
{
    
     /**
     * 页面列表渲染展示,可以附加一些页面设置
     *
     * @param Content $content
     * @return Content
     */
    public function index(Content $content)
    {
        $content->header('产品管理');
        $content->description('草稿数据');

        $content->breadcrumb(
            ['text' => '管理', 'url' => '/sdk/manager/draft'],
            ['text' => '数据']
        );

        $grid = $this->grid();
        $this->addscript($grid);

        //filter
        $this->gridSearch($grid);

        //actions
        $this->gridActions($grid);

        //可以链式添加页面原始(html,js,css等)一个body相当于页面一个div.row层
        return $content->body($grid)->body(new Copyscript());
    }


    /**
     * 列表信息生成
     *
     * @return Grid
     */
    protected function grid()
    {
        return Grid::make(new User(), function (Grid $grid) {
            // 这里的字段会自动使用翻译文件
            $grid->column('id')->sortable();
            $grid->column('name');
            ...
            $grid->column('updated_at')->sortable();

            //筛选项,如果数据信息较多,建议单独方法处理筛选配置
            $grid->filter(function (Grid\Filter $filter) {
                $filter->equal('id');

            });
        });
    }

    /**
     * 详情页面信息生成
     *
     * @param mixed $id
     *
     * @return Show
     */
    protected function detail($id)
    {
        return Show::make($id, new User(), function (Show $show) {
            // 这里的字段会自动使用翻译文件
            $show->field('id');
            $show->field('name');
            ...      
            $show->field('created_at');
            $show->field('updated_at');
        });
    }

    /**
     * 编辑、新增表单生成.
     *
     * @return Form
     */
    protected function form()
    {
        return Form::make(new User(), function (Form $form) {
            // 这里的字段会自动使用翻译文件
            $form->display('id');
            $form->text('name');
            ...
            $form->display('created_at');
            $form->display('updated_at');
        });
    }
    
     /**
     * 数据编辑(经过扩展).
     *
     * @param int $id
     *
     * @return \Illuminate\Http\Response
     */
    public function update($id)
    {
        //原始操作
        //return $this->form()->update($id);

        //扩展操作
        $form = (new AccountEdit())->accountStatusEdit();
        $update = $form->update($id);
        $status = request()->input('status');
        $response = json_decode($update->getContent(), true);
        if ($response && isset($response['status']) && $response['status'] && in_array($status, [3, 4])) {
            AccountLoginTokenDao::removeAccountToken($id);
        }
        
        return $update;
    }

}

控制器方法简述:

  • 自动生成:
    • grid:页面列表数生成器:生成信息、展示基础信息、关联数据信息、自定义状态显示等等,更多请参考,grid使用方法
    • detail:数据详情生成器,选择数据显示
    • form:表单生成器,如数据编辑、新增等功能,生成基础表单
  • 扩展重写
    • index:代码生成器不会主动创建该方法,如果有需要可以自定义重写该方法:比如,按需加载js、css,或者需要自定义页面布局等等,根据业务需要进行重写
    • update:该方法是自定义编辑,当自动生成的表单不满足编辑需求的是,可以自定表单和更新方法,然后处理更新结果

2、数据仓

打开刚生成的文件app/Admin/Repositories/AdminUser.php,可以看到只有如下内容,非常简单:

<?php

    namespace App\Admin\Repositories;
    
    use Dcat\Admin\Repositories\EloquentRepository;
    use App\User as UserModel;
    
    class AdminUser extends EloquentRepository
    {
        protected $eloquentClass = UserModel::class;
    }

3、语言包

每个控制器都会生成相对于的语言包,语言包放置地址:resouces/lang/{当前语言}/admin-user.php。语言包命名是控制器文件名称去除controller后小写通过中横线连接:

<?php 
    return [
        // labels是自定义标签翻译
        'labels' => [
            // 这个是页面 title 翻译
            'User' => '用户',
        ],
        // 表字段翻译
        'fields' => [
            'name' => '名称',
            'email' => '邮箱',
            'email_verified_at' => '验证时间',
            'password' => '密码',
            'remember_token' => 'remember_token',
        ],
        'options' => [
        ],
    ];

评论区

励志做一条安静的咸鱼,从此走上人生巅峰。

0

0

1