thinkphp5.x之Collection(集合)解析 php集合

国庆节放假了,出去了发现所有地方全是人。
怕你们了,还是找个咖啡厅,静静的看着你们玩耍。
TP5也出来一段时间了,Let’s Go 看看新框架优点。
注释难免有不足之处,欢迎指正
thinkphp5.x之数据库操作相关解析 Db类
http://blog.csdn.net/fenglailea/article/details/52728705
thinkphp5 数据库 链接
http://blog.csdn.net/fenglailea/article/details/52728899
Collection 是集合的意思,也可以叫数据集/数据集合/对象
fox.风

//命名空间 这没什么好说的
//如果你还不知道这是什么,请先看 http://blog.csdn.net/fenglailea/article/details/52717646
namespace think;
// 数组式访问接口,php预定义接口 http://php.net/manual/zh/class.arrayaccess.php
use ArrayAccess;
// 数组迭代器 http://php.net/manual/zh/class.arrayiterator.php
use ArrayIterator;
// 统计元素对象个数接口 http://php.net/manual/zh/class.countable.php
use Countable;
// 聚合式迭代器接口,php预定义接口  http://php.net/manual/zh/class.iteratoraggregate.php
use IteratorAggregate;
// JSON序列话接口 http://php.net/manual/zh/class.jsonserializable.php
use JsonSerializable;
// 类 Collection 实现了ArrayAccess, Countable, IteratorAggregate, JsonSerializable接口
class Collection implements ArrayAccess, Countable, IteratorAggregate, JsonSerializable
{
    // 数据存储变量
    protected $items = [];
    // 构造函数
    public function __construct($items = [])
    {
        // 转化成数组,并赋值给变量items
        $this->items = $this->convertToArray($items);
    }
    // 装载/生成/制作等等,怎么叫法都可以,就是生成一个新结果集合
    public static function make($items = [])
    {
        // new static即是获取最终调用时的类[后续有介绍]
        return new static($items);
    }

    /**
     * 是否为空
     * @return bool
     */
    public function isEmpty()
    {
        return empty($this->items);
    }
    // 返回数组
    public function toArray()
    {
        // array_map :数组里的每个元素都经过这个回调函数处理
        return array_map(
            // 这是一个匿名回调函数
            function ($value) {
            return (
            // instanceof 检测变量$value是否属于Model类的实例
            $value instanceof Model ||
            // instanceof 检测变量$value是否属于当前 Collection类的实例
            $value instanceof self) ?
            // 返回数组
            $value->toArray() : $value;
        }, $this->items);
    }
    // 返回变量 items 所有数据集
    public function all()
    {
        return $this->items;
    }

    /**
     * 合并数组
     *
     * @param  mixed $items
     * @return static
     */
    public function merge($items)
    {
        // new static即是获取最终调用时的类[后续有介绍]
        return new static(
        // array_merge 合并数组
        array_merge($this->items,
        // 转换成数组
        $this->convertToArray($items)));
    }

    /**
     * 比较数组,返回差集
     *
     * @param  mixed $items
     * @return static
     */
    public function diff($items)
    {
        return new static(
        // 数组之间的差集
        array_diff($this->items, $this->convertToArray($items)));
    }

    /**
     * 交换数组中的键和值
     *
     * @return static
     */
    public function flip()
    {
        return new static(
        //  array_flip 交换数组中的键和值
        array_flip($this->items));
    }

    /**
     * 比较数组,返回交集
     *
     * @param  mixed $items
     * @return static
     */
    public function intersect($items)
    {
        return new static(
        // array_intersect 比较数组,返回交集
        array_intersect($this->items, $this->convertToArray($items)));
    }

    /**
     * 返回数组中所有的键名
     *
     * @return static
     */
    public function keys()
    {
        return new static(
        // array_keys 返回数组中所有的键名
        array_keys($this->items));
    }

    /**
     * 删除数组的最后一个元素(出栈)
     *
     * @return mixed
     */
    public function pop()
    {
        // 删除数组的最后一个元素(出栈)
        return array_pop($this->items);
    }

    /**
     * 通过使用用户自定义函数,以字符串返回数组
     *
     * @param  callable $callback
     * @param  mixed    $initial
     * @return mixed
     */
    public function reduce(callable $callback, $initial = null)
    {
        // array_reduce 用回调函数迭代地将数组简化为单一的值
        return array_reduce($this->items, $callback, $initial);
    }

    /**
     * 以相反的顺序返回数组。
     *
     * @return static
     */
    public function reverse()
    {
        return new static(
        // array_reverse 以相反的顺序返回数组
        array_reverse($this->items));
    }

    /**
     * 删除数组中首个元素,并返回被删除元素的值
     *
     * @return mixed
     */
    public function shift()
    {
        // array_shift 删除数组中首个元素,并返回被删除元素的值
        return array_shift($this->items);
    }

    /**
     * 把一个数组分割为新的数组块.
     *
     * @param  int  $size
     * @param  bool $preserveKeys
     * @return static
     */
    public function chunk($size, $preserveKeys = false)
    {
        $chunks = [];
        //array_chunk 把一个数组分割为新的数组块.
        foreach (array_chunk($this->items, $size, $preserveKeys) as $chunk) {
            $chunks[] = new static($chunk);
        }

        return new static($chunks);
    }

    /**
     * 在数组开头插入一个元素
     * @param mixed $value
     * @param null  $key
     * @return int
     */
    public function unshift($value, $key = null)
    {
        // 检测 $key 是否为null
        if (is_null($key)) {
            // array_unshift 在数组开头插入一个元素
            array_unshift($this->items, $value);
        } else {
            //两个数组组合成为新的数组,并赋值给items
            $this->items = [$key => $value] + $this->items;
        }
    }

    /**
     * 给每个元素执行个回调
     *
     * @param  callable $callback
     * @return $this
     */
    public function each(callable $callback)
    {
        //数组循环
        foreach ($this->items as $key => $item) {
            // 数组回调,如果不明白的,看PHP基础吧
            if ($callback($item, $key) === false) {
                break;
            }
        }
        //返回 当前对象
        return $this;
    }

    /**
     * 用回调函数过滤数组中的元素
     * @param callable|null $callback
     * @return static
     */
    public function filter(callable $callback = null)
    {
        if ($callback) {
            return new static(
            // array_filter用回调函数过滤数组中的元素
            array_filter($this->items, $callback));
        }

        return new static(
        // array_filter用回调函数过滤数组中的元素
        array_filter($this->items));
    }

    /**
     * 返回数组中指定的一列
     * @param      $column_key
     * @param null $index_key
     * @return array
     */
    public function column($column_key, $index_key = null)
    {
        // 检测函数是否存在,如果存在,则使用PHP内置函数处理,不存在则使用我们自己实现的方法
        if (function_exists('array_column')) {
            // array_column 返回数组中指定的列
            return array_column($this->items, $column_key, $index_key);
        }

        $result = [];
        foreach ($this->items as $row) {
            $key    = $value = null;
            $keySet = $valueSet = false;
            // array_key_exists 检查给定的键名或索引$index_key是否存在于数组$row中
            if (null !== $index_key && array_key_exists($index_key, $row)) {
                //如果存在,设置变量$keySet值为真
                $keySet = true;
                //
                $key    = (string)$row[$index_key];
            }
            if (null === $column_key) {
                $valueSet = true;
                $value    = $row;
            } elseif (is_array($row) && array_key_exists($column_key, $row)) {
                $valueSet = true;
                $value    = $row[$column_key];
            }
            if ($valueSet) {
                if ($keySet) {
                    $result[$key] = $value;
                } else {
                    $result[] = $value;
                }
            }
        }
        return $result;
    }

    /**
     * 对数组排序
     *
     * @param  callable|null $callback
     * @return static
     */
    public function sort(callable $callback = null)
    {
        $items = $this->items;

        $callback ?
        // uasort 使用用户自定义的$callback比较函数对$items数组中的值进行排序并保持索引关联
        uasort($items, $callback) : uasort($items,
            // 这是个匿名函数
            function ($a, $b) {
            // 检测两个变量的值是否相等,相等返回0
            if ($a == $b) {
                return 0;
            }
            // 如果变量$a小于$b时,返回-1,否则都返回1
            return ($a < $b) ? -1 : 1;
        });

        return new static($items);
    }

    /**
     * 将数组打乱
     *
     * @return static
     */
    public function shuffle()
    {
        $items = $this->items;
        // 将数组打乱
        shuffle($items);

        return new static($items);
    }

    /**
     * 截取数组
     *
     * @param  int  $offset
     * @param  int  $length
     * @param  bool $preserveKeys
     * @return static
     */
    public function slice($offset, $length = null, $preserveKeys = false)
    {
        return new static(
        // array_slice 截取  $this->items 数组中 $offset 和 $length 之间的数组
        // $preserveKeys 默认会重新排序并重置数组的数字索引
        array_slice($this->items, $offset, $length, $preserveKeys));
    }

    // ArrayAccess
    public function offsetExists($offset)
    {
        // 检查给定的$offset键名或索引是否存在于$this->items数组中
        return array_key_exists($offset, $this->items);
    }

    public function offsetGet($offset)
    {
        //返回 $this->items数组中指定 $offset键名或索引 的数据或者对象
        return $this->items[$offset];
    }
    // 数组 中增加一条新数据或者对象
    public function offsetSet($offset, $value)
    {
        if (is_null($offset)) {
            $this->items[] = $value;
        } else {
            $this->items[$offset] = $value;
        }
    }
    // 删除指定 $offset键名或索引 的数据或者对象
    public function offsetUnset($offset)
    {
        unset($this->items[$offset]);
    }

    //Countable
    public function count()
    {
        // 返回 计算数组中的单元数目或对象中的属性个数
        return count($this->items);
    }

    //IteratorAggregate
    public function getIterator()
    {
        // 返回 创建外部迭代器
        return new ArrayIterator($this->items);
    }

    //JsonSerializable
    public function jsonSerialize()
    {
        // 返回序列化数组
        return $this->toArray();
    }

    /**
     * 转换当前数据集为JSON字符串
     * @access public
     * @param integer $options json参数
     * @return string
     */
    public function toJson($options = JSON_UNESCAPED_UNICODE)
    {
        // 返回JSON 格式数据
        return json_encode($this->toArray(), $options);
    }

    public function __toString()
    {
        // 返回JSON 格式数据
        return $this->toJson();
    }

    /**
     * 转换成数组
     *
     * @param  mixed $items
     * @return array
     */
    protected function convertToArray($items)
    {
        // instanceof 检测变量$items是否属于当前类Collection的实例
        if ($items instanceof self) {
            // 执行all方法,返回所有
            return $items->all();
        }
        // 强制转换为数组
        return (array)$items;
    }
}

new self 和 new static(后期静态绑定 )

self 取决于当前方法定义的类
static 即是获取最终调用时的类(即当前实例化的那个类)

class A{
    public static function testSelf() {
        return new self();
    }
    public static function testStatic() {
        return new static();
    }
}
class B extends A{}
echo get_class(B::testSelf());  /* A */
echo get_class(B::testStatic());  /* B  */

输出
A
B

制作自己的 PHP Collection类

看看上面的源码,只要删除2处($value instanceof Model ),命名空间名字再改一下,就是自己 PHP Collection集合类,是不是非常棒~
使用方式

$data 就是数据库取出的数据
$result=new Collection($data);
时间: 2024-09-21 03:27:56

thinkphp5.x之Collection(集合)解析 php集合的相关文章

为什么 map不继承与collection collection不是所有集合的父类吗

问题描述 为什么 map不继承与collection collection不是所有集合的父类吗 为什么 map不继承与collection collection不是所有集合的父类吗 解决方案 map和collection的数据结构是不一样的collection定义了其实现类的基本操作,map也定义了其实现类的基本操作,操作不同,所以接口不同,而这正是因为接口是种规范. 解决方案二: Collection接口 Collection是最基本的集合接口,一个Collection代表一组Object,即

详解MongoDB中创建集合与删除集合的操作方法_MongoDB

创建集合:createCollection() 方法 MongoDB db.createCollection(name, options)  是用来创建集合. 语法: 基本的 createCollection() 命令语法如下: db.createCollection(name, options) 在命令中, name 是要创建的集合的名称. Options 是一个文件,用于指定配置的集合 参数 类型 描述 Name String 要创建的集合名称 Options Document (可选)指定

编写高质量代码改善C#程序的建议:泛型集合、选择集合和集合的安全

前言 软件开发过程中,不可避免会用到集合,C#中的集合表现为数组和若干集合类.不管是数组还是集合类,它们都有各自的优缺点.如何使用好集合是我们在开发过程中必须掌握的技巧.不要小看这些技巧,一旦在开发中使用了错误的集合或针对集合的方法,应用程序将会背离你的预想而运行. 本文已更新至http://www.cnblogs.com/aehyok/p/3624579.html .本文主要学习记录以下内容: 建议20.使用泛型集合来替代非泛型集合 建议21.选择正确的集合 建议22.确保集合的线性安全 建议

(教学思路 C#集合一)集合的概述、动态数组ArrayList

这一节我们来学习集合,什么是集合呢? 集合就如同数组,用来存储和管理一组特定类型的数据对象,除了基本的数据处理功能,集合直 接提供了各种数据结构及算法的实现,如队列.链表.排序等,可以让你轻易地完成复杂的数据操作.在使用数组和集合时要先加入 system.collections命名空间,它提供了支持各种类型集合的接口及类.集合本身上也是一种类型,基本上可以将其作为用来存储一组数据对 象的容器,由于c#面向对象的特性,管理数据对象的集合同样被实现成为对象,而存储在集合中的数据对象则被称为集合元素.

redis基本命令之二:集合、有序集合

5 集合类型 5.1 增加/删除元素 Sad key number [number -] Srem key number [number -] Sadd命令用来向集合中增加一个或多个元素,如果键不存在则会自动创建.因此在一个集合中不能有相同的元素,所以如果要加入的元素已经存在于集合中就会忽略这个元素. 5.2 获取集合中的所有元素 smembers key smembers命令会返回集合中的所有元素 5.3判断元素是否在集合中 Sismember key number 判断一个元素是否在集合中是

编写高质量代码改善C#程序的157个建议[泛型集合、选择集合、集合的安全]

原文:编写高质量代码改善C#程序的157个建议[泛型集合.选择集合.集合的安全] 前言   软件开发过程中,不可避免会用到集合,C#中的集合表现为数组和若干集合类.不管是数组还是集合类,它们都有各自的优缺点.如何使用好集合是我们在开发过程中必须掌握的技巧.不要小看这些技巧,一旦在开发中使用了错误的集合或针对集合的方法,应用程序将会背离你的预想而运行. 本文已更新至http://www.cnblogs.com/aehyok/p/3624579.html .本文主要学习记录以下内容: 建议20.使用

list集合比较-Android 集合之间的比较以及排序算法相关问题

问题描述 Android 集合之间的比较以及排序算法相关问题 下面这个方法是用来比较的,相同的对象就放到同一个集合中,不相同的就新建一个.现在下面我写的判断那里每次比较都只能跟上一个进行比较,并不是和全部进行比较.所以想请教一下前辈们还有什么更好的办法吗?排序吗?怎么写? /** * 按照地点进行分组 * @param list * @return */ public static List<GroupEntity> setAddressOrder(Context context, List&

Hibernate之集合映射的使用(Set集合映射,list集合映射,Map集合映射)

a:数据库的相关知识: (1):一个表能否有多个主键:不能: (2):为什么要设置主键:数据库存储的数据都是有效的,必须保持唯一性: (3)为什么id作为主键:因为表中通常找不到合适的列作为唯一列,即主键,所有为了方便用id列,因为id是数据库系统维护可以保证唯一,所以就把这列作为主键,简单的说为了方便:如果找不到合适的列,除了使用id列以为作为主键,也可以使用联合主键,即多列的值作为一个主键,从而确保了记录的唯一性,即为联合主键: Hibernate的映射很重要哦,如果是一般的映射,很容易掌握

(1)集合 ---遍历map集合

Map接口     实现Map接口的类用来存储键(key)-值(value) 对.Map 接口的实现类有HashMap和TreeMap等.Map类中存储的键-值对通过键来标识,所以键值不能重复. HashMap: 线程不安全,效率高. 允许key或value为nullHashTable:线程安全,效率低. 不允许key或value为nullProperties : HashTable的子类,key和value都是string常用的方法: Object put(Object key, Object