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\Storage
;
28 * Mutable version of RevisionSlots, for constructing a new revision.
32 class MutableRevisionSlots
extends RevisionSlots
{
35 * Constructs a MutableRevisionSlots that inherits from the given
38 * @param SlotRecord[] $slots
40 * @return MutableRevisionSlots
42 public static function newFromParentRevisionSlots( array $slots ) {
44 foreach ( $slots as $slot ) {
45 $role = $slot->getRole();
46 $inherited[$role] = SlotRecord
::newInherited( $slot );
49 return new MutableRevisionSlots( $inherited );
53 * @param SlotRecord[] $slots An array of SlotRecords.
55 public function __construct( array $slots = [] ) {
56 parent
::__construct( $slots );
60 * Sets the given slot.
61 * If a slot with the same role is already present, it is replaced.
63 * @note This may cause the slot meta-data for the revision to be lazy-loaded.
65 * @param SlotRecord $slot
67 public function setSlot( SlotRecord
$slot ) {
68 if ( !is_array( $this->slots
) ) {
69 $this->getSlots(); // initialize $this->slots
72 $role = $slot->getRole();
73 $this->slots
[$role] = $slot;
77 * Sets the content for the slot with the given role.
78 * If a slot with the same role is already present, it is replaced.
80 * @note This may cause the slot meta-data for the revision to be lazy-loaded.
83 * @param Content $content
85 public function setContent( $role, Content
$content ) {
86 $slot = SlotRecord
::newUnsaved( $role, $content );
87 $this->setSlot( $slot );
91 * Remove the slot for the given role, discontinue the corresponding stream.
93 * @note This may cause the slot meta-data for the revision to be lazy-loaded.
97 public function removeSlot( $role ) {
98 if ( !is_array( $this->slots
) ) {
99 $this->getSlots(); // initialize $this->slots
102 unset( $this->slots
[$role] );
106 * Return all slots that are not inherited.
108 * @note This may cause the slot meta-data for the revision to be lazy-loaded.
110 * @return SlotRecord[]
112 public function getTouchedSlots() {
115 function ( SlotRecord
$slot ) {
116 return !$slot->isInherited();
122 * Return all slots that are inherited.
124 * @note This may cause the slot meta-data for the revision to be lazy-loaded.
126 * @return SlotRecord[]
128 public function getInheritedSlots() {
131 function ( SlotRecord
$slot ) {
132 return $slot->isInherited();