Value object representing a modification of revision slots. More...

Collaboration diagram for MediaWiki\Storage\RevisionSlotsUpdate:

[legend]

Public Member Functions
	__construct (array $modifiedSlots=[], array $removedRoles=[])

	apply (MutableRevisionSlots $slots)
	Applies this update to the given MutableRevisionSlots, setting all modified slots, and removing all removed roles. More...

	getModifiedRoles ()
	Returns a list of modified slot roles, that is, roles modified by calling modifySlot(), and not later removed by calling removeSlot(). More...

	getModifiedSlot ( $role)
	Returns the SlotRecord associated with the given role, if the slot with that role was modified (and not again removed). More...

	getRemovedRoles ()
	Returns a list of removed slot roles, that is, roles removed by calling removeSlot(), and not later re-introduced by calling modifySlot(). More...

	getTouchedRoles ()
	Returns a list of all slot roles that modified or removed. More...

	hasSameUpdates (RevisionSlotsUpdate $other)
	Returns true if $other represents the same update - that is, if all methods defined by RevisionSlotsUpdate when called on $this or $other will yield the same result when called with the same parameters. More...

	isModifiedSlot ( $role)
	Returns whether getModifiedSlot() will return a SlotRecord for the given role. More...

	isRemovedSlot ( $role)
	Returns whether the given role is to be removed from the page. More...

	modifyContent ( $role, Content $content)
	Sets the content for the slot with the given role to be modified. More...

	modifySlot (SlotRecord $slot)
	Sets the given slot to be modified. More...

	removeSlot ( $role)
	Remove the slot for the given role, discontinue the corresponding stream. More...

Static Public Member Functions
static	newFromContent (array $newContent, RevisionSlots $parentSlots=null)
	Constructs a RevisionSlotsUpdate representing the update of $parentSlots when changing $newContent. More...

static	newFromRevisionSlots (RevisionSlots $newSlots, RevisionSlots $parentSlots=null)
	Constructs a RevisionSlotsUpdate representing the update that turned $parentSlots into $newSlots. More...

Private Attributes
SlotRecord[]	$modifiedSlots = []
	modified slots, using the slot role as the key. More...

bool[]	$removedRoles = []
	removed roles, stored in the keys of the array. More...

Detailed Description

Value object representing a modification of revision slots.

Since: 1.32

Definition at line 36 of file RevisionSlotsUpdate.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Storage\RevisionSlotsUpdate::__construct	(	array	$modifiedSlots = `[]`,
		array	$removedRoles = `[]`
	)

Parameters

SlotRecord[]	$modifiedSlots
string[]	$removedRoles

Definition at line 116 of file RevisionSlotsUpdate.php.

References MediaWiki\Storage\RevisionSlotsUpdate\$modifiedSlots, MediaWiki\Storage\RevisionSlotsUpdate\$removedRoles, as, MediaWiki\Storage\RevisionSlotsUpdate\modifySlot(), and MediaWiki\Storage\RevisionSlotsUpdate\removeSlot().

Member Function Documentation

◆ apply()

MediaWiki\Storage\RevisionSlotsUpdate::apply ( MutableRevisionSlots $slots )

Applies this update to the given MutableRevisionSlots, setting all modified slots, and removing all removed roles.

Parameters

MutableRevisionSlots $slots

Definition at line 290 of file RevisionSlotsUpdate.php.

References as, MediaWiki\Storage\RevisionSlotsUpdate\getModifiedRoles(), MediaWiki\Storage\RevisionSlotsUpdate\getModifiedSlot(), MediaWiki\Storage\RevisionSlotsUpdate\getRemovedRoles(), Revision\MutableRevisionSlots\removeSlot(), and Revision\MutableRevisionSlots\setSlot().

◆ getModifiedRoles()

MediaWiki\Storage\RevisionSlotsUpdate::getModifiedRoles ( )

Returns a list of modified slot roles, that is, roles modified by calling modifySlot(), and not later removed by calling removeSlot().

Note that slots in modified roles may still be inherited slots. This is for instance the case when the RevisionSlotsUpdate objects represents some kind of rollback operation, in which slots that existed in an earlier revision are restored in a new revision.

Returns: string[]

Definition at line 137 of file RevisionSlotsUpdate.php.

Referenced by MediaWiki\Storage\RevisionSlotsUpdate\apply(), MediaWiki\Storage\RevisionSlotsUpdate\getTouchedRoles(), MediaWiki\Storage\RevisionSlotsUpdate\hasSameUpdates(), and MediaWiki\Storage\DerivedPageDataUpdater\prepareContent().

◆ getModifiedSlot()

MediaWiki\Storage\RevisionSlotsUpdate::getModifiedSlot ( $role )

Returns the SlotRecord associated with the given role, if the slot with that role was modified (and not again removed).

Note: If the SlotRecord returned by this method returns a non-inherited slot, the content of that slot may or may not already have PST applied. Methods that take a RevisionSlotsUpdate as a parameter should specify whether they expect PST to already have been applied to all slots. Inherited slots should never have PST applied again.

Parameters

string $role The role name of the desired slot

Exceptions

RevisionAccessException if the slot does not exist or was removed.

Returns: SlotRecord

Definition at line 217 of file RevisionSlotsUpdate.php.

Referenced by MediaWiki\Storage\RevisionSlotsUpdate\apply(), MediaWiki\Storage\DerivedPageDataUpdater\getPreparedEdit(), MediaWiki\Storage\RevisionSlotsUpdate\hasSameUpdates(), and MediaWiki\Storage\DerivedPageDataUpdater\prepareContent().

◆ getRemovedRoles()

MediaWiki\Storage\RevisionSlotsUpdate::getRemovedRoles ( )

Returns a list of removed slot roles, that is, roles removed by calling removeSlot(), and not later re-introduced by calling modifySlot().

Returns: string[]

Definition at line 147 of file RevisionSlotsUpdate.php.

Referenced by MediaWiki\Storage\RevisionSlotsUpdate\apply(), MediaWiki\Storage\RevisionSlotsUpdate\getTouchedRoles(), MediaWiki\Storage\RevisionSlotsUpdate\hasSameUpdates(), and MediaWiki\Storage\DerivedPageDataUpdater\prepareContent().

◆ getTouchedRoles()

MediaWiki\Storage\RevisionSlotsUpdate::getTouchedRoles ( )

Returns a list of all slot roles that modified or removed.

Returns: string[]

Definition at line 156 of file RevisionSlotsUpdate.php.

References MediaWiki\Storage\RevisionSlotsUpdate\getModifiedRoles(), and MediaWiki\Storage\RevisionSlotsUpdate\getRemovedRoles().

◆ hasSameUpdates()

MediaWiki\Storage\RevisionSlotsUpdate::hasSameUpdates ( RevisionSlotsUpdate $other )

Returns true if $other represents the same update - that is, if all methods defined by RevisionSlotsUpdate when called on $this or $other will yield the same result when called with the same parameters.

SlotRecords for the same role are compared based on their model and content.

Parameters

RevisionSlotsUpdate $other

Returns: bool

Definition at line 261 of file RevisionSlotsUpdate.php.

References $s, $t, as, MediaWiki\Storage\RevisionSlotsUpdate\getModifiedRoles(), MediaWiki\Storage\RevisionSlotsUpdate\getModifiedSlot(), and MediaWiki\Storage\RevisionSlotsUpdate\getRemovedRoles().

Referenced by MediaWiki\Storage\DerivedPageDataUpdater\isReusableFor(), and MediaWiki\Tests\Storage\RevisionSlotsUpdateTest\testHasSameUpdates().

◆ isModifiedSlot()

MediaWiki\Storage\RevisionSlotsUpdate::isModifiedSlot ( $role )

Returns whether getModifiedSlot() will return a SlotRecord for the given role.

Will return true for the role names returned by getModifiedRoles(), false otherwise.

Parameters

string $role The role name of the desired slot

Returns: bool

Definition at line 234 of file RevisionSlotsUpdate.php.

Referenced by MediaWiki\Storage\DerivedPageDataUpdater\getPreparedEdit(), and MediaWiki\Storage\DerivedPageDataUpdater\prepareContent().

◆ isRemovedSlot()

MediaWiki\Storage\RevisionSlotsUpdate::isRemovedSlot ( $role )

Returns whether the given role is to be removed from the page.

Will return true for the role names returned by getRemovedRoles(), false otherwise.

Parameters

string $role The role name of the desired slot

Returns: bool

Definition at line 247 of file RevisionSlotsUpdate.php.

◆ modifyContent()

MediaWiki\Storage\RevisionSlotsUpdate::modifyContent	(		$role,
		Content	$content
	)

Sets the content for the slot with the given role to be modified.

If a slot with the same role is already present, it is replaced.

Parameters

string	$role
Content	$content

Definition at line 184 of file RevisionSlotsUpdate.php.

References $content, MediaWiki\Storage\RevisionSlotsUpdate\modifySlot(), and Revision\SlotRecord\newUnsaved().

◆ modifySlot()

MediaWiki\Storage\RevisionSlotsUpdate::modifySlot ( SlotRecord $slot )

Sets the given slot to be modified.

If a slot with the same role is already present, it is replaced.

The roles used with modifySlot() will be returned from getModifiedRoles(), unless overwritten with removeSlot().

Parameters

SlotRecord $slot

Definition at line 169 of file RevisionSlotsUpdate.php.

References Revision\SlotRecord\getRole().

Referenced by MediaWiki\Storage\RevisionSlotsUpdate\__construct(), and MediaWiki\Storage\RevisionSlotsUpdate\modifyContent().

◆ newFromContent()

static MediaWiki\Storage\RevisionSlotsUpdate::newFromContent	(	array	$newContent,
		RevisionSlots	$parentSlots = `null`
	)

static

Constructs a RevisionSlotsUpdate representing the update of $parentSlots when changing $newContent.

If a slot has the same content in $newContent as in $parentSlots, that slot is considered inherited and thus omitted from the resulting RevisionSlotsUpdate.

In contrast to newFromRevisionSlots(), slots in $parentSlots that are not present in $newContent are not considered removed. They are instead assumed to be inherited.

Parameters

Content[] $newContent The new content, using slot roles as array keys.