3 * Mutable version of RevisionSlots, for constructing a new revision.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
23 namespace MediaWiki\Revision
;
28 * Mutable version of RevisionSlots, for constructing a new revision.
31 * @since 1.32 Renamed from MediaWiki\Storage\MutableRevisionSlots
33 class MutableRevisionSlots
extends RevisionSlots
{
36 * Constructs a MutableRevisionSlots that inherits from the given
39 * @param SlotRecord[] $slots
41 * @return MutableRevisionSlots
43 public static function newFromParentRevisionSlots( array $slots ) {
45 foreach ( $slots as $slot ) {
46 $role = $slot->getRole();
47 $inherited[$role] = SlotRecord
::newInherited( $slot );
50 return new MutableRevisionSlots( $inherited );
54 * @param SlotRecord[] $slots An array of SlotRecords.
56 public function __construct( array $slots = [] ) {
57 parent
::__construct( $slots );
61 * Sets the given slot.
62 * If a slot with the same role is already present, it is replaced.
64 * @param SlotRecord $slot
66 public function setSlot( SlotRecord
$slot ) {
67 if ( !is_array( $this->slots
) ) {
68 $this->getSlots(); // initialize $this->slots
71 $role = $slot->getRole();
72 $this->slots
[$role] = $slot;
76 * Sets the given slot to an inherited version of $slot.
77 * If a slot with the same role is already present, it is replaced.
79 * @param SlotRecord $slot
81 public function inheritSlot( SlotRecord
$slot ) {
82 $this->setSlot( SlotRecord
::newInherited( $slot ) );
86 * Sets the content for the slot with the given role.
87 * If a slot with the same role is already present, it is replaced.
90 * @param Content $content
92 public function setContent( $role, Content
$content ) {
93 $slot = SlotRecord
::newUnsaved( $role, $content );
94 $this->setSlot( $slot );
98 * Remove the slot for the given role, discontinue the corresponding stream.
100 * @param string $role
102 public function removeSlot( $role ) {
103 if ( !is_array( $this->slots
) ) {
104 $this->getSlots(); // initialize $this->slots
107 unset( $this->slots
[$role] );
113 * Retain the old class name for backwards compatibility.
114 * @deprecated since 1.32
116 class_alias( MutableRevisionSlots
::class, 'MediaWiki\Storage\MutableRevisionSlots' );