表单数据源
<h1>表单数据源</h1>
<h2>模型与数据仓库</h2>
<p>数据仓库(<code>Repository</code>)是一个可以提供特定接口对数据进行读写操作的类，通过数据仓库的引入，可以让页面的构建不再关心数据读写功能的具体实现，开发者只需要实现特定的操作接口即可轻松切换数据源。关于数据仓库的详细用法请参考文档<a href="model-repository.md">数据仓库</a>。</p>
<h2>数据来自模型</h2>
<p>> {tip} 如果你的数据来自<code>Model</code>，那么你也可以直接使用<code>Model</code>实例，底层会自动把<code>Model</code>转化为数据仓库实例。</p>
<p>当数据源支持模型时，只需创建一个非常简单的<code>Repository</code>类既可：</p>
<pre><code class="language-php">&lt;?php
namespace App\Admin\Repositories;
use Dcat\Admin\Repositories\EloquentRepository;
use App\Models\Movie as MovieModel;
class Movie extends EloquentRepository
{
// 这里定义你的模型类名
protected $eloquentClass = MovieModel::class;
// 通过这个方法可以指定表单页查询的字段，默认&quot;*&quot;
public function getFormColumns()
{
return [$this-&gt;getKeyName(), 'name', 'title', 'created_at'];
}
}</code></pre>
<p>使用：</p>
<pre><code class="language-php">use App\Admin\Repositories\Movie;
$form = new Form(new Movie);
...</code></pre>
<h2>数据来自外部API</h2>
<p>下面以<code>豆瓣电影</code>的API为例子，来展示<code>Repository</code>的表单数据读写操作相关接口的用法：</p>
<pre><code class="language-php">&lt;?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-&gt;builder()-&gt;getResourceId();
$data = file_get_contents(&quot;http://api.douban.com/v2/movie/subject/$id&quot;);
return json_decode($data, true);
}
// 这个方法用于在修改数据前查询原记录
// 如果使用了文件上传表单，当文件发生变更时会根据这个原始记录自动删除旧文件
// 如果不需要此数据返回空数组即可
public function updating(Form $form)
{
// 获取id
$id = $form-&gt;builder()-&gt;getResourceId();
return [];
}
// 修改操作
// 返回一个bool类型的数据
public function update(Form $form)
{
// 获取id
$id = $form-&gt;builder()-&gt;getResourceId();
// 获取要修改的数据
$attributes = $form-&gt;updates();
// TODO
// 这里写你的修改逻辑
return true;
}
// 这个方法用于在修改数据前查询原始数据
// 如果使用了文件上传表单，会根据这个数据自动删除文件
// 如果不需要此数据返回空数组即可
public function deleting(Form $form)
{
$id = $form-&gt;builder()-&gt;getResourceId();
$id = explode(',', $id);
// $data = file_get_contents(&quot;http://api.douban.com/v2/movie/subject/$id&quot;);
//
// return json_decode($data, true);
return [];
}
// 删除数据
// $deletingData 是由 getDataWhenDeleting 方法返回的数据
public function destroy(Form $form, $deletingData)
{
// 注意这里的id可能是多个
$id = $form-&gt;builder()-&gt;getResourceId();
// 当使用批量删除功能时，这里的id是用“,”隔开的字符串
$id = explode(',', $id);
// TODO
// var_dump($id, $deletingData);
return true;
}
}</code></pre>