人妻无码一区二区三区四区,欧美亚洲另类制服自拍,亚洲一区在线直播

展開

列表類使用

### 一、列表答疑

**（1）為什么控制器繼承了應(yīng)用基礎(chǔ)控制器后我們可以直接使用$this->dataList() ?**
因為應(yīng)用基礎(chǔ)控制器繼承了BaseLikeShopController，而BaseLikeShopController中存在dataLists方法，所以只要我們自己的控制器繼承了應(yīng)用基礎(chǔ)控制器就可以直接調(diào)用該方法。

**（2）調(diào)用了$this->dataList()方法就能馬上得到數(shù)據(jù)嗎？還要做什么？**
不會馬上得到數(shù)據(jù)，還要創(chuàng)建相應(yīng)的列表類。原因可從dataLists()這個方法的實現(xiàn)中可以看出：
調(diào)用方法不傳參數(shù)，需創(chuàng)建以當前控制器名+Lists的列表類
調(diào)用方法傳了指定列表類實例，實現(xiàn)指定列表類即可 
列表類通常存放于當前應(yīng)用的 lists目錄中

**（3）列表請求方式必須是GET嗎**？是的！

**（4）特別注意： 分頁改為用limit()方法，不要再使用page()**
原因：底層導(dǎo)出功能設(shè)計需要limit()支持，而page()無法滿足需求
前端傳遞分頁參數(shù)不變,仍然是 page_no/page_size, 底層會自動獲取前端分頁參數(shù)并計算出$this->limitOffset, $this->limitLength的值
```
limit($this->limitOffset, $this->limitLength)
```

**（5）參考例子: 文章列表類**
```
<?php
namespace app\adminapi\lists;

use app\common\lists\ListsSearchInterface;
use app\common\model\Article;

class ArticleLists extends BaseAdminDataLists implements ListsSearchInterface
{
    /**
     * @notes 設(shè)置搜索
     * @return \string[][]
     * @author Tab
     * @date 2021/7/14 9:48
     */
    public function setSearch() : array
    {
        return [
            '=' => ['type', 'cid', 'is_notice'],
            '%like%' => ['title']
        ];
    }

/**
     * @notes 文章/幫助列表
     * @return array
     * @throws \think\db\exception\DataNotFoundException
     * @throws \think\db\exception\DbException
     * @throws \think\db\exception\ModelNotFoundException
     * @author Tab
     * @date 2021/7/14 9:48
     */
    public function lists() : array
    {
        $lists = Article::field('id,title,image,cid,is_notice,is_show,visit,likes,sort,create_time')
            ->where($this->searchWhere)
   					->limit($this->limitOffset, $this->limitLength)
            ->select()
            ->toArray();
        return $lists;
    }

/**
     * @notes 文章/幫助總記錄數(shù)
     * @return int
     * @author Tab
     * @date 2021/7/14 9:48
     */
    public function count() : int
    {
        return Article::where($this->searchWhere)->count();
    }
}
```

### 二、搜索接口使用
**(1) 須實現(xiàn)`ListsSearchInterface`接口，該接口包含一個需要實現(xiàn)的`setSearch()`**,該方法用于設(shè)置搜索條件
```
public function setSearch() : array
{
    return [
        '=' => ['type', 'cid'],
        '%like%' => ['title']
    ];
}
```

**(2) 組裝后的搜索條件通過!!#ff0000 $this->searchWhere!!屬性接收**
具體組裝邏輯可參考:app/common/lists/ListsSearchTrait.php
多個條件關(guān)系是: and關(guān)系
例 ： 前端傳過來的值 type = 1, cid = 10
后端：['=' =>[ 'type', 'cid']]   組裝后生成 $this->searchWhere = [ ['type', '=', '1'], ['cid', '=', '10'] ]
后端：['<>' => [ 'type', 'cid']] 組裝后生成 $this->searchWhere = [ ['type', '<>', '1'], ['cid', '<>', '10'] ]
后端：['>' => [ 'type', 'cid']]   組裝后生成 $this->searchWhere = [ ['type', '>', '1'], ['cid', '>', '10'] ]
后端：['>=' => [ 'type', 'cid']] 組裝后生成 $this->searchWhere = [ ['type', '>=', '1'], ['cid', '>=', '10'] ]
后端：['<' => [ 'type', 'cid']]   組裝后生成 $this->searchWhere = [ ['type', '<', '1'], ['cid', '<', '10'] ]
后端：['<=' => [ 'type', 'cid']] 組裝后生成 $this->searchWhere = [ ['type', '<=', '1'], ['cid', '<=', '10'] ]
后端：['in' => [ 'type', 'cid']]  組裝后生成 $this->searchWhere = [ ['type', 'in', '1'], ['cid', 'in', '10'] ]
例 ： 前端傳過來的值 name = 好象
后端：['%like%' => ['name']] 組裝后生成 $this->searchWhere = [ 'name', 'like', '%好象%' ]
后端：['%like' => ['name']]    組裝后生成 $this->searchWhere = [ 'name', 'like', '%好象' ]
后端：['like%' => ['name']]    組裝后生成 $this->searchWhere = [ 'name', 'like', '好象%' ]
例 ： 前端傳過來的值 start_time = 2021-07-01  end_time = 2021-07-31
后端：['between_time' => 'create_time'] 組裝后生成 $this->searchWhere = [ 'create_time', 'between', [66666666,88888888]]   注：66666666對應(yīng)的是2021-07-01的時間戳，88888888對應(yīng)的是2021-07-01的時間戳
例 ： 前端傳過來的值 start = 10  end = 100
后端：['between' => 'sort'] 組裝后生成 $this->searchWhere = [ 'sort', 'between', [10,100]] 
 **例：支持別名**
后端：['=' => [ 'a.type', 'a.cid']]   組裝后生成 $this->searchWhere = [ ['a.type', '=', '1'], ['a.cid', '=', '10'] ]
**(3) 使用參考 **
Admin::where(!!#ff0000 $this->searchWhere!!)->select();
**(4)、更復(fù)雜的條件**
若setSearch()方法中無法實現(xiàn)的搜索條件，可不實現(xiàn)搜索接口，在lists()及count()方法中自行定義自己需要的搜索條件即可
```
    public function lists() : array
    {
        // $where[] = [xxx,xxx,xx];  這里疊加自已搜索條件
        $lists = Footprint::where($where)->select()->toArray();
        return $lists;
    }

public function count() : int
    {        
        // $where[] = [xxx,xxx,xx]; 這里疊加自已搜索條件
        return Footprint::where( $where)->count();
    }
```

### 三、排序接口使用
**(1) 列表須實現(xiàn)`ListsSortInterface`接口，該接口中包含兩個需要實現(xiàn)的方法`setSortFields()`、`setDefaultOrder()`**
`setSortFields()` 設(shè)置允許的排序字段，例：
``` 
public function setSortFields(): array
{
    // 格式: ['前端傳過來的字段名' => '數(shù)據(jù)庫中的字段名'];
		// 前端傳過來create_time,后端會根據(jù)create_time排序
		// 前端傳過來id，但后端會根據(jù)user_id排序
    return ['create_time' => 'create_time','id'=>'user_id'];
}
```
`setDefaultOrder()` 設(shè)置默認排序規(guī)則
什么情況下會使用默認排序：
1.1、前端未傳排序字段 field時
1.2、前端未傳排序規(guī)則 order_by時
1.3、后端setSortFileds()方法返回 空數(shù)組時
1.4、前端傳過來的排序字段不在允許的排序字段中時，例：前端傳過來排序字段money, 但允許的排序字段數(shù)組 ['create_time' => 'create_time'] 中并沒有money這個字段
1.5、允許排序字段格式設(shè)置不正確時,例： ['create_time' => 'create_time'] 設(shè)置成了  ['create_time']
```
public function setDefaultOrder(): array
{
    return ['id' => 'desc'];
}
```

**(2) 前端必須傳的兩個參數(shù)**
order_by排序規(guī)則（desc-倒序 asc-升序)  ，field排序字段

**(3) 后端組裝后的排序規(guī)則通過 $this->sortOrder屬性接收**
具本的排序組裝邏輯請參考： app/common/lists/ListsSortTrait.php
例：前端傳  { order_by: desc, field: create_time }
    后端：$this->sortOrder  = [‘create_time’ => ‘desc’];
	   前端傳  { order_by: desc, field: id }
    后端：$this->sortOrder  = [‘user_id’ => ‘desc’];
	   前端不傳排序相關(guān)參數(shù) 或 符合設(shè)置默認排序中說明的情況時
	   后端：$this->sortOrder  =  [‘id’ => ‘desc’];
	   
**(4) 使用參考 **
Admin::order(!!#ff0000 $this->sortOrder!!)->select();

99色这里只有精品_久久视频在线观看中文字幕_日韩高清国产一区在线观看_99久久久久国产精品免费