RevisionSlots.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Storage;
 
use Content;
use LogicException;
use Wikimedia\Assert\Assert;
 
class RevisionSlots {
 
    protected $slots;
 
    public function __construct( $slots ) {
        Assert::parameterType( 'array|callable', $slots, '$slots' );
 
        if ( is_callable( $slots ) ) {
            $this->slots = $slots;
        } else {
            $this->setSlotsInternal( $slots );
        }
    }
 
    private function setSlotsInternal( array $slots ) {
        $this->slots = [];
 
        // re-key the slot array
        foreach ( $slots as $slot ) {
            $role = $slot->getRole();
            $this->slots[$role] = $slot;
        }
    }
 
    public function __sleep() {
        throw new LogicException( __CLASS__ . ' is not serializable.' );
    }
 
    public function getContent( $role ) {
        // Return a copy to be safe. Immutable content objects return $this from copy().
        return $this->getSlot( $role )->getContent()->copy();
    }
 
    public function getSlot( $role ) {
        $slots = $this->getSlots();
 
        if ( isset( $slots[$role] ) ) {
            return $slots[$role];
        } else {
            throw new RevisionAccessException( 'No such slot: ' . $role );
        }
    }
 
    public function hasSlot( $role ) {
        $slots = $this->getSlots();
 
        return isset( $slots[$role] );
    }
 
    public function getSlotRoles() {
        $slots = $this->getSlots();
        return array_keys( $slots );
    }
 
    public function computeSize() {
        return array_reduce( $this->getSlots(), function ( $accu, SlotRecord $slot ) {
            return $accu + $slot->getSize();
        }, 0 );
    }
 
    public function getSlots() {
        if ( is_callable( $this->slots ) ) {
            $slots = call_user_func( $this->slots );
 
            Assert::postcondition(
                is_array( $slots ),
                'Slots info callback should return an array of objects'
            );
 
            $this->setSlotsInternal( $slots );
        }
 
        return $this->slots;
    }
 
    public function computeSha1() {
        $slots = $this->getSlots();
        ksort( $slots );
 
        if ( empty( $slots ) ) {
            return SlotRecord::base36Sha1( '' );
        }
 
        return array_reduce( $slots, function ( $accu, SlotRecord $slot ) {
            return $accu === null
                ? $slot->getSha1()
                : SlotRecord::base36Sha1( $accu . $slot->getSha1() );
        }, null );
    }
 
}