数据源

未匹配的标注

表单数据源

模型与数据仓库

数据仓库(Repository)是一个可以提供特定接口对数据进行读写操作的类,通过数据仓库的引入,可以让页面的构建不再关心数据读写功能的具体实现。只需要实现特定的操作接口即可轻松切换数据源,关于数据仓库的详细用法请参考文档数据仓库

数据来自模型

如果你的数据来自Model,那么你也可以直接使用Model实例,底层会自动把Model转化为数据仓库实例。

当数据源支持模型时,只需创建一个非常简单的Repository类既可:

<?php

namespace App\Admin\Repositories;

use Dcat\Admin\Repositories\EloquentRepository;
use App\Models\Movie as MovieModel;

class Movie extends EloquentRepository
{
    // 这里定义你的模型类名
    protected $eloquentClass = MovieModel::class;

    // 通过这个方法可以指定表单页查询的字段,默认"*"
    public function getFormColumns()
    {
        return [$this->getKeyName(), 'name', 'title', 'created_at'];
    }
}

使用:

use App\Admin\Repositories\Movie;

$form = new Form(new Movie);

...

数据来自外部API

下面以豆瓣电影的API为例子,来展示Repository的表单数据读写操作相关接口的用法:

<?php
namespace App\Admin\Repositories;

use Dcat\Admin\Repositories\Repository;
use Dcat\Admin\Form;

class ComingSoon extends Repository
{
    protected $api = 'https://api.douban.com/v2/movie/coming_soon';

    // 返回你的id字段名称,默认“id”
    protected $keyName = '_id';

    // 查询编辑页数据
    // 这个方法需要返回一个数组
    public function edit(Form $form)
    {
        // 获取id
        $id = $form->builder()->getResourceId();

        $data = file_get_contents("http://api.douban.com/v2/movie/subject/$id");

        return json_decode($data, true);
    }

    // 这个方法用于在修改数据前查询原记录
    // 如果使用了文件上传表单,当文件发生变更时会根据这个原始记录自动删除旧文件
     // 如果不需要此数据返回空数组即可
    public function updating(Form $form)
    {
        // 获取id
        $id = $form->builder()->getResourceId();

        return [];
    }

    // 修改操作
    // 返回一个bool类型的数据
    public function update(Form $form)
    {
        // 获取id
        $id = $form->builder()->getResourceId();

        // 获取要修改的数据
        $attributes = $form->updates();

        // TODO
        // 这里写你的修改逻辑

        return true;
    }

    // 这个方法用于在修改数据前查询原始数据
    // 如果使用了文件上传表单,会根据这个数据自动删除文件
    // 如果不需要此数据返回空数组即可
    public function deleting(Form $form)
    {
        $id = $form->builder()->getResourceId();

        $id = explode(',', $id);

//        $data = file_get_contents("http://api.douban.com/v2/movie/subject/$id");
//
//        return json_decode($data, true);

        return [];
    }

    // 删除数据
    // $deletingData 是由 getDataWhenDeleting 方法返回的数据
    public function destroy(Form $form, $deletingData)
    {
        // 注意这里的id可能是多个
        $id = $form->builder()->getResourceId();

        // 当使用批量删除功能时,这里的id是用“,”隔开的字符串
        $id = explode(',', $id);

        // TODO
//        var_dump($id, $deletingData);

        return true;
    }

}

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
讨论数量: 0
发起讨论 只看当前版本


暂无话题~