<?php
|
// +----------------------------------------------------------------------
|
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
|
// +----------------------------------------------------------------------
|
// | Copyright (c) 2006~2025 http://thinkphp.cn All rights reserved.
|
// +----------------------------------------------------------------------
|
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
|
// +----------------------------------------------------------------------
|
// | Author: liu21st <liu21st@gmail.com>
|
// +----------------------------------------------------------------------
|
declare(strict_types=1);
|
|
namespace think\contract;
|
|
use Closure;
|
use think\db\BaseQuery as Query;
|
use think\Model;
|
|
/**
|
* 模型关联接口
|
*/
|
interface ModelRelationInterface
|
{
|
/**
|
* 延迟获取关联数据
|
* @access public
|
* @param array $subRelation 子关联
|
* @param Closure $closure 闭包查询条件
|
* @return mixed
|
*/
|
public function getRelation(array $subRelation = [], ?Closure $closure = null);
|
|
/**
|
* 预载入关联查询
|
* @access public
|
* @param array $resultSet 数据集
|
* @param string $relation 当前关联名
|
* @param array $subRelation 子关联名
|
* @param Closure $closure 闭包条件
|
* @return void
|
*/
|
public function eagerlyResultSet(array &$resultSet, string $relation, array $subRelation, ?Closure $closure = null): void;
|
|
/**
|
* 预载入关联查询
|
* @access public
|
* @param Model $result 数据对象
|
* @param string $relation 当前关联名
|
* @param array $subRelation 子关联名
|
* @param Closure $closure 闭包条件
|
* @return void
|
*/
|
public function eagerlyResult(Model $result, string $relation, array $subRelation = [], ?Closure $closure = null): void;
|
|
/**
|
* 关联统计
|
* @access public
|
* @param Model $result 模型对象
|
* @param Closure $closure 闭包
|
* @param string $aggregate 聚合查询方法
|
* @param string $field 字段
|
* @param string $name 统计字段别名
|
* @return integer
|
*/
|
public function relationCount(Model $result, Closure $closure, string $aggregate = 'count', string $field = '*', ?string &$name = null);
|
|
/**
|
* 创建关联统计子查询
|
* @access public
|
* @param Closure $closure 闭包
|
* @param string $aggregate 聚合查询方法
|
* @param string $field 字段
|
* @param string $name 统计字段别名
|
* @return string
|
*/
|
public function getRelationCountQuery(?Closure $closure = null, string $aggregate = 'count', string $field = '*', ?string &$name = null): string;
|
|
/**
|
* 根据关联条件查询当前模型
|
* @access public
|
* @param string $operator 比较操作符
|
* @param integer $count 个数
|
* @param string $id 关联表的统计字段
|
* @param string $joinType JOIN类型
|
* @return Query
|
*/
|
public function has(string $operator = '>=', int $count = 1, string $id = '*', string $joinType = 'INNER', ?Query $query = null): Query;
|
|
/**
|
* 根据关联条件查询当前模型
|
* @access public
|
* @param mixed $where 查询条件（数组或者闭包）
|
* @param mixed $fields 字段
|
* @param string $joinType JOIN类型
|
* @return Query
|
*/
|
public function hasWhere($where = [], $fields = null, string $joinType = ''): Query;
|
}
|
