Storage layer class for WatchedItems. More...

Inheritance diagram for WatchedItemStore:

Collaboration diagram for WatchedItemStore:

[legend]

Public Member Functions
	__construct (ILBFactory $lbFactory, JobQueueGroup $queueGroup, BagOStuff $stash, HashBagOStuff $cache, ReadOnlyMode $readOnlyMode, $updateRowsPerQuery)

	addWatch (User $user, LinkTarget $target)

	addWatchBatchForUser (User $user, array $targets)

	clearUserWatchedItems (User $user)
	Deletes ALL watched items for the given user when under $updateRowsPerQuery entries exist. More...

	clearUserWatchedItemsUsingJobQueue (User $user)
	Queues a job that will clear the users watchlist using the Job Queue. More...

	countUnreadNotifications (User $user, $unreadLimit=null)

	countVisitingWatchers (LinkTarget $target, $threshold)

	countVisitingWatchersMultiple (array $targetsWithVisitThresholds, $minimumWatchers=null)

	countWatchedItems (User $user)

	countWatchers (LinkTarget $target)

	countWatchersMultiple (array $targets, array $options=[])

	duplicateAllAssociatedEntries (LinkTarget $oldTarget, LinkTarget $newTarget)

	duplicateEntry (LinkTarget $oldTarget, LinkTarget $newTarget)

	getLatestNotificationTimestamp ( $timestamp, User $user, LinkTarget $target)
	Convert $timestamp to TS_MW or return null if the page was visited since then by $user. More...

	getMaxId ()

	getNotificationTimestampsBatch (User $user, array $targets)

	getWatchedItem (User $user, LinkTarget $target)

	getWatchedItemsForUser (User $user, array $options=[])

	isWatched (User $user, LinkTarget $target)

	loadWatchedItem (User $user, LinkTarget $target)

	overrideDeferredUpdatesAddCallableUpdateCallback (callable $callback)
	Overrides the DeferredUpdates::addCallableUpdate callback This is intended for use while testing and will fail if MW_PHPUNIT_TEST is not defined. More...

	overrideRevisionGetTimestampFromIdCallback (callable $callback)
	Overrides the Revision::getTimestampFromId callback This is intended for use while testing and will fail if MW_PHPUNIT_TEST is not defined. More...

	removeWatch (User $user, LinkTarget $target)

	removeWatchBatchForUser (User $user, array $titles)

	resetAllNotificationTimestampsForUser (User $user, $timestamp=null)
	Schedule a DeferredUpdate that sets all of the "last viewed" timestamps for a given user to the same value. More...

	resetNotificationTimestamp (User $user, Title $title, $force='', $oldid=0)

	setNotificationTimestampsForUser (User $user, $timestamp, array $targets=[])
	Set the "last viewed" timestamps for certain titles on a user's watchlist. More...

	setStatsdDataFactory (StatsdDataFactoryInterface $stats)

	updateNotificationTimestamp (User $editor, LinkTarget $target, $timestamp)

Public Member Functions inherited from WatchedItemStoreInterface
	resetAllNotificationTimestampsForUser (User $user)
	Reset all watchlist notificaton timestamps for a user using the job queue. More...

Private Member Functions
	cache (WatchedItem $item)

	dbCond (User $user, LinkTarget $target)
	Return an array of conditions to select or update the appropriate database row. More...

	getCached (User $user, LinkTarget $target)

	getCacheKey (User $user, LinkTarget $target)

	getConnectionRef ( $dbIndex)

	getNotificationTimestamp (User $user, Title $title, $item, $force, $oldid)

	getPageSeenKey (LinkTarget $target)

	getPageSeenTimestamps (User $user)

	getPageSeenTimestampsKey (User $user)

	getTitleDbKeysGroupedByNamespace (array $titles)

	getVisitingWatchersCondition (IDatabase $db, array $targetsWithVisitThresholds)
	Generates condition for the query used in a batch count visiting watchers. More...

	uncache (User $user, LinkTarget $target)

	uncacheAllItemsForUser (User $user)

	uncacheLinkTarget (LinkTarget $target)

	uncacheTitlesForUser (User $user, array $titles)

	uncacheUser (User $user)

Private Attributes
HashBagOStuff	$cache

array[]	$cacheIndex = []
	Looks like $cacheIndex[Namespace ID][Target DB Key][User Id] => 'key' The index is needed so that on mass changes all relevant items can be un-cached. More...

callable null	$deferredUpdatesAddCallableUpdateCallback

HashBagOStuff	$latestUpdateCache

ILBFactory	$lbFactory

LoadBalancer	$loadBalancer

JobQueueGroup	$queueGroup

ReadOnlyMode	$readOnlyMode

callable null	$revisionGetTimestampFromIdCallback

BagOStuff	$stash

StatsdDataFactoryInterface	$stats

int	$updateRowsPerQuery

Additional Inherited Members
Public Attributes inherited from WatchedItemStoreInterface
const	SORT_ASC = 'ASC'

const	SORT_DESC = 'DESC'

Detailed Description

Storage layer class for WatchedItems.

Database interaction & caching TODO caching should be factored out into a CachingWatchedItemStore class

Author: Addshore

Since: 1.27

Definition at line 19 of file WatchedItemStore.php.

Constructor & Destructor Documentation

◆ __construct()

WatchedItemStore::__construct	(	ILBFactory	$lbFactory,
		JobQueueGroup	$queueGroup,
		BagOStuff	$stash,
		HashBagOStuff	$cache,
		ReadOnlyMode	$readOnlyMode,
			$updateRowsPerQuery
	)

Parameters

ILBFactory	$lbFactory
JobQueueGroup	$queueGroup
BagOStuff	$stash
HashBagOStuff	$cache
ReadOnlyMode	$readOnlyMode
int	$updateRowsPerQuery

Definition at line 92 of file WatchedItemStore.php.

References $cache, $lbFactory, $queueGroup, $readOnlyMode, $stash, $updateRowsPerQuery, cache(), class, and Wikimedia\Rdbms\ILBFactory\getMainLB().

Member Function Documentation

◆ addWatch()

WatchedItemStore::addWatch	(	User	$user,
		LinkTarget	$target
	)

Since: 1.27

Parameters

User	$user
LinkTarget	$target

Exceptions

MWException

Implements WatchedItemStoreInterface.

Definition at line 735 of file WatchedItemStore.php.

References addWatchBatchForUser().

◆ addWatchBatchForUser()

WatchedItemStore::addWatchBatchForUser	(	User	$user,
		array	$targets
	)

Since: 1.27

Parameters

User	$user
LinkTarget[]	$targets

Returns: bool

Exceptions

MWException

Implements WatchedItemStoreInterface.

Definition at line 746 of file WatchedItemStore.php.

References $rows, $user, as, cache(), captcha-old\count, DB_MASTER, getConnectionRef(), and uncache().

Referenced by addWatch().

◆ cache()

WatchedItemStore::cache ( WatchedItem $item )

private

Definition at line 178 of file WatchedItemStore.php.

References $user, getCacheKey(), WatchedItem\getLinkTarget(), and WatchedItem\getUser().

Referenced by __construct(), addWatchBatchForUser(), getCached(), getCacheKey(), loadWatchedItem(), uncache(), uncacheAllItemsForUser(), uncacheLinkTarget(), and uncacheUser().

◆ clearUserWatchedItems()

WatchedItemStore::clearUserWatchedItems ( User $user )

Deletes ALL watched items for the given user when under $updateRowsPerQuery entries exist.

Since: 1.30

Parameters

User $user

Returns: bool true on success, false when too many items are watched

Implements WatchedItemStoreInterface.

Definition at line 267 of file WatchedItemStore.php.

References $user, countWatchedItems(), DB_MASTER, and uncacheAllItemsForUser().

◆ clearUserWatchedItemsUsingJobQueue()

WatchedItemStore::clearUserWatchedItemsUsingJobQueue ( User $user )

Queues a job that will clear the users watchlist using the Job Queue.

Since: 1.31

Parameters

User $user

Implements WatchedItemStoreInterface.

Definition at line 314 of file WatchedItemStore.php.

References $job, $user, getMaxId(), and ClearUserWatchlistJob\newForUser().

◆ countUnreadNotifications()

WatchedItemStore::countUnreadNotifications	(	User	$user,
			$unreadLimit = `null`
	)

Since: 1.27

Parameters

User	$user
int \| null	$unreadLimit

Returns: int|bool

Implements WatchedItemStoreInterface.

Definition at line 1145 of file WatchedItemStore.php.

References $dbr, $user, DB_REPLICA, and getConnectionRef().

◆ countVisitingWatchers()

WatchedItemStore::countVisitingWatchers	(	LinkTarget	$target,
			$threshold
	)

Since: 1.27

Parameters

LinkTarget	$target
string \| int	$threshold

Returns: int

Implements WatchedItemStoreInterface.

Definition at line 378 of file WatchedItemStore.php.

References $dbr, DB_REPLICA, getConnectionRef(), MediaWiki\Linker\LinkTarget\getDBkey(), and MediaWiki\Linker\LinkTarget\getNamespace().

◆ countVisitingWatchersMultiple()

WatchedItemStore::countVisitingWatchersMultiple	(	array	$targetsWithVisitThresholds,
			$minimumWatchers = `null`
	)

Since: 1.27

Parameters

array	$targetsWithVisitThresholds
int \| null	$minimumWatchers

Returns: array

Implements WatchedItemStoreInterface.

Definition at line 482 of file WatchedItemStore.php.

References $dbr, $res, as, DB_REPLICA, getConnectionRef(), getVisitingWatchersCondition(), and list.

◆ countWatchedItems()

WatchedItemStore::countWatchedItems ( User $user )

Since: 1.31

Parameters

User $user

Returns: int

Implements WatchedItemStoreInterface.

Definition at line 338 of file WatchedItemStore.php.

References $dbr, $user, DB_REPLICA, and getConnectionRef().

Referenced by clearUserWatchedItems().

◆ countWatchers()

WatchedItemStore::countWatchers ( LinkTarget $target )

Since: 1.27

Parameters

LinkTarget $target

Returns: int

Implements WatchedItemStoreInterface.

Definition at line 357 of file WatchedItemStore.php.

References $dbr, DB_REPLICA, getConnectionRef(), MediaWiki\Linker\LinkTarget\getDBkey(), and MediaWiki\Linker\LinkTarget\getNamespace().

◆ countWatchersMultiple()

WatchedItemStore::countWatchersMultiple	(	array	$targets,
		array	$options = `[]`
	)

Since: 1.27

Parameters

LinkTarget[]	$targets
array	$options

Returns: array

Implements WatchedItemStoreInterface.

Definition at line 446 of file WatchedItemStore.php.

References $dbr, $options, $res, as, DB_REPLICA, and getConnectionRef().

◆ dbCond()

WatchedItemStore::dbCond	(	User	$user,
		LinkTarget	$target
	)

private

Return an array of conditions to select or update the appropriate database row.

Parameters

User	$user
LinkTarget	$target

Returns: array

Definition at line 239 of file WatchedItemStore.php.

References $user, MediaWiki\Linker\LinkTarget\getDBkey(), and MediaWiki\Linker\LinkTarget\getNamespace().

Referenced by loadWatchedItem().

◆ duplicateAllAssociatedEntries()

WatchedItemStore::duplicateAllAssociatedEntries	(	LinkTarget	$oldTarget,
		LinkTarget	$newTarget
	)

Since: 1.27

Parameters

LinkTarget	$oldTarget
LinkTarget	$newTarget

Implements WatchedItemStoreInterface.

Definition at line 1177 of file WatchedItemStore.php.

References duplicateEntry(), and Title\newFromLinkTarget().

◆ duplicateEntry()

WatchedItemStore::duplicateEntry	(	LinkTarget	$oldTarget,
		LinkTarget	$newTarget
	)

Since: 1.27

Parameters

LinkTarget	$oldTarget
LinkTarget	$newTarget

Implements WatchedItemStoreInterface.

Definition at line 1190 of file WatchedItemStore.php.

References as, DB_MASTER, getConnectionRef(), MediaWiki\Linker\LinkTarget\getDBkey(), and MediaWiki\Linker\LinkTarget\getNamespace().

Referenced by duplicateAllAssociatedEntries().

◆ getCached()

WatchedItemStore::getCached	(	User	$user,
		LinkTarget	$target
	)

private

Parameters

User	$user
LinkTarget	$target

Returns: WatchedItem|false

Definition at line 226 of file WatchedItemStore.php.

References cache(), and getCacheKey().

Referenced by getNotificationTimestampsBatch(), and getWatchedItem().

◆ getCacheKey()

WatchedItemStore::getCacheKey	(	User	$user,
		LinkTarget	$target
	)

private

Definition at line 170 of file WatchedItemStore.php.

References $user, cache(), MediaWiki\Linker\LinkTarget\getDBkey(), MediaWiki\Linker\LinkTarget\getNamespace(), and string.

Referenced by cache(), getCached(), and uncache().

◆ getConnectionRef()

WatchedItemStore::getConnectionRef ( $dbIndex )

private

Parameters

int $dbIndex DB_MASTER or DB_REPLICA

Returns: IDatabase

Exceptions

MWException

Definition at line 253 of file WatchedItemStore.php.

Referenced by addWatchBatchForUser(), countUnreadNotifications(), countVisitingWatchers(), countVisitingWatchersMultiple(), countWatchedItems(), countWatchers(), countWatchersMultiple(), duplicateEntry(), getMaxId(), getNotificationTimestampsBatch(), getWatchedItemsForUser(), loadWatchedItem(), removeWatchBatchForUser(), setNotificationTimestampsForUser(), and updateNotificationTimestamp().

◆ getLatestNotificationTimestamp()

WatchedItemStore::getLatestNotificationTimestamp	(		$timestamp,
		User	$user,
		LinkTarget	$target
	)

Convert $timestamp to TS_MW or return null if the page was visited since then by $user.

Use this only on single-user methods (having higher read-after-write expectations) and not in places involving arbitrary batches of different users

Usage of this method should be limited to WatchedItem* classes

Parameters

string \| null	$timestamp	Value of wl_notificationtimestamp from the DB
User	$user
LinkTarget	$target

Returns: string TS_MW timestamp or null

Implements WatchedItemStoreInterface.

Definition at line 876 of file WatchedItemStore.php.

References getPageSeenTimestamps(), and wfTimestampOrNull().

Referenced by getNotificationTimestampsBatch(), and loadWatchedItem().

◆ getMaxId()

WatchedItemStore::getMaxId ( )

Since: 1.31

Returns: int The maximum current wl_id

Definition at line 323 of file WatchedItemStore.php.

References $dbr, DB_REPLICA, and getConnectionRef().

Referenced by clearUserWatchedItemsUsingJobQueue().

◆ getNotificationTimestamp()

WatchedItemStore::getNotificationTimestamp	(	User	$user,
		Title	$title,
			$item,
			$force,
			$oldid
	)

private

Definition at line 1092 of file WatchedItemStore.php.

References $title, and loadWatchedItem().

Referenced by resetNotificationTimestamp().

◆ getNotificationTimestampsBatch()

WatchedItemStore::getNotificationTimestampsBatch	(	User	$user,
		array	$targets
	)

Since: 1.27

Parameters

User	$user
LinkTarget[]	$targets

Returns: array

Implements WatchedItemStoreInterface.

Definition at line 681 of file WatchedItemStore.php.

References $dbr, $res, $user, as, DB_REPLICA, getCached(), getConnectionRef(), and getLatestNotificationTimestamp().

◆ getPageSeenKey()

WatchedItemStore::getPageSeenKey ( LinkTarget $target )

private

Parameters

LinkTarget $target

Returns: string

Definition at line 1088 of file WatchedItemStore.php.

Referenced by resetNotificationTimestamp().

◆ getPageSeenTimestamps()

WatchedItemStore::getPageSeenTimestamps ( User $user )

private

Parameters

User $user

Returns: MapCacheLRU|null The map contains prefixed title keys and TS_MW values

Definition at line 1060 of file WatchedItemStore.php.

References getPageSeenTimestampsKey(), IExpiringStore\TTL_PROC_LONG, and use.

Referenced by getLatestNotificationTimestamp().

◆ getPageSeenTimestampsKey()

WatchedItemStore::getPageSeenTimestampsKey ( User $user )

private

Parameters

User $user

Returns: string

Definition at line 1076 of file WatchedItemStore.php.

References $user.

Referenced by getPageSeenTimestamps(), resetNotificationTimestamp(), and uncacheUser().

◆ getTitleDbKeysGroupedByNamespace()

WatchedItemStore::getTitleDbKeysGroupedByNamespace ( array $titles )

private

Parameters

LinkTarget[] $titles

Returns: array

Definition at line 1235 of file WatchedItemStore.php.

References $rows, $title, $titles, and as.

Referenced by removeWatchBatchForUser(), and setNotificationTimestampsForUser().

◆ getVisitingWatchersCondition()

WatchedItemStore::getVisitingWatchersCondition	(	IDatabase	$db,
		array	$targetsWithVisitThresholds
	)

private

Generates condition for the query used in a batch count visiting watchers.

Parameters

IDatabase	$db
array	$targetsWithVisitThresholds	array of pairs (LinkTarget, last visit threshold)

Returns: string

Definition at line 527 of file WatchedItemStore.php.

References Wikimedia\Rdbms\IDatabase\addQuotes(), as, list, LIST_AND, LIST_OR, Wikimedia\Rdbms\IDatabase\makeList(), and Wikimedia\Rdbms\IDatabase\timestamp().

Referenced by countVisitingWatchersMultiple().

◆ getWatchedItem()

WatchedItemStore::getWatchedItem	(	User	$user,
		LinkTarget	$target
	)

Since: 1.27

Parameters

User	$user
LinkTarget	$target

Returns: bool

Implements WatchedItemStoreInterface.

Definition at line 570 of file WatchedItemStore.php.

References $user, getCached(), and loadWatchedItem().

Referenced by isWatched().

◆ getWatchedItemsForUser()

WatchedItemStore::getWatchedItemsForUser	(	User	$user,
		array	$options = `[]`
	)

Since: 1.27

Parameters

User	$user
array	$options

Returns: WatchedItem[]

Implements WatchedItemStoreInterface.

Definition at line 625 of file WatchedItemStore.php.

References $options, $res, $user, as, DB_MASTER, DB_REPLICA, false, and getConnectionRef().

◆ isWatched()

WatchedItemStore::isWatched	(	User	$user,
		LinkTarget	$target
	)

Since: 1.27

Parameters

User	$user
LinkTarget	$target

Returns: bool

Implements WatchedItemStoreInterface.

Definition at line 671 of file WatchedItemStore.php.

References getWatchedItem().

◆ loadWatchedItem()

WatchedItemStore::loadWatchedItem	(	User	$user,
		LinkTarget	$target
	)

Since: 1.27

Parameters

User	$user
LinkTarget	$target

Returns: WatchedItem|bool

Implements WatchedItemStoreInterface.

Definition at line 590 of file WatchedItemStore.php.

References $dbr, $user, cache(), DB_REPLICA, dbCond(), getConnectionRef(), and getLatestNotificationTimestamp().

Referenced by getNotificationTimestamp(), getWatchedItem(), and resetNotificationTimestamp().

◆ overrideDeferredUpdatesAddCallableUpdateCallback()

WatchedItemStore::overrideDeferredUpdatesAddCallableUpdateCallback ( callable $callback )

Overrides the DeferredUpdates::addCallableUpdate callback This is intended for use while testing and will fail if MW_PHPUNIT_TEST is not defined.

Parameters

callable $callback

See also: DeferredUpdates::addCallableUpdate for callback signiture

Returns: ScopedCallback to reset the overridden value

Exceptions

MWException

Definition at line 134 of file WatchedItemStore.php.

References $deferredUpdatesAddCallableUpdateCallback, and use.

◆ overrideRevisionGetTimestampFromIdCallback()

WatchedItemStore::overrideRevisionGetTimestampFromIdCallback ( callable $callback )

Overrides the Revision::getTimestampFromId callback This is intended for use while testing and will fail if MW_PHPUNIT_TEST is not defined.

Parameters

callable $callback

See also: Revision::getTimestampFromId for callback signiture

Returns: ScopedCallback to reset the overridden value

Exceptions

MWException

Definition at line 157 of file WatchedItemStore.php.

References $revisionGetTimestampFromIdCallback, and use.

◆ removeWatch()

WatchedItemStore::removeWatch	(	User	$user,
		LinkTarget	$target
	)

Since: 1.27

Parameters

User	$user
LinkTarget	$target

Returns: bool

Exceptions

MWException

Implements WatchedItemStoreInterface.

Definition at line 807 of file WatchedItemStore.php.

References removeWatchBatchForUser().

◆ removeWatchBatchForUser()

WatchedItemStore::removeWatchBatchForUser	(	User	$user,
		array	$titles
	)

Parameters

User	$user
TitleValue[]	$titles

Returns: bool

Exceptions

MWException

Implements WatchedItemStoreInterface.

Definition at line 402 of file WatchedItemStore.php.

References $rows, $titles, $user, as, captcha-old\count, DB_MASTER, getConnectionRef(), getTitleDbKeysGroupedByNamespace(), and uncacheTitlesForUser().

Referenced by removeWatch().

◆ resetAllNotificationTimestampsForUser()

WatchedItemStore::resetAllNotificationTimestampsForUser	(	User	$user,
			$timestamp = `null`
	)

Schedule a DeferredUpdate that sets all of the "last viewed" timestamps for a given user to the same value.

Parameters

User	$user
string \| int \| null	$timestamp	Value to set all timestamps to, null to clear them

Definition at line 900 of file WatchedItemStore.php.

References $job, $user, and use.

Referenced by setNotificationTimestampsForUser().

◆ resetNotificationTimestamp()

WatchedItemStore::resetNotificationTimestamp	(	User	$user,
		Title	$title,
			$force = `''`,
			$oldid = `0`
	)

Since: 1.27

Parameters

User	$user
Title	$title
string	$force
int	$oldid

Returns: bool

Implements WatchedItemStoreInterface.

Definition at line 987 of file WatchedItemStore.php.

References $cache, $job, $time, $title, $user, $value, getNotificationTimestamp(), getPageSeenKey(), getPageSeenTimestampsKey(), loadWatchedItem(), null, Hooks\run(), IExpiringStore\TTL_HOUR, IExpiringStore\TTL_PROC_LONG, uncache(), use, and wfTimestamp().

◆ setNotificationTimestampsForUser()

WatchedItemStore::setNotificationTimestampsForUser	(	User	$user,
			$timestamp,
		array	$targets = `[]`
	)

Set the "last viewed" timestamps for certain titles on a user's watchlist.

If the $targets parameter is omitted or set to [], this method simply wraps resetAllNotificationTimestampsForUser(), and in that case you should instead call that method directly; support for omitting $targets is for backwards compatibility.

If $targets is omitted or set to [], timestamps will be updated for every title on the user's watchlist, and this will be done through a DeferredUpdate. If $targets is a non-empty array, only the specified titles will be updated, and this will be done immediately (not deferred).

Since: 1.27

Parameters

User	$user
string \| int	$timestamp	Value to set the "last viewed" timestamp to (null to clear)
LinkTarget[]	$targets	Titles to set the timestamp for; [] means the entire watchlist

Returns: bool

Implements WatchedItemStoreInterface.

Definition at line 828 of file WatchedItemStore.php.

References $rows, $user, as, DB_MASTER, getConnectionRef(), getTitleDbKeysGroupedByNamespace(), resetAllNotificationTimestampsForUser(), and uncacheUser().

◆ setStatsdDataFactory()

WatchedItemStore::setStatsdDataFactory ( StatsdDataFactoryInterface $stats )

Parameters

StatsdDataFactoryInterface $stats

Implements StatsdAwareInterface.

Definition at line 119 of file WatchedItemStore.php.

References $stats.

◆ uncache()

WatchedItemStore::uncache	(	User	$user,
		LinkTarget	$target
	)

private

Definition at line 187 of file WatchedItemStore.php.

References $user, cache(), getCacheKey(), MediaWiki\Linker\LinkTarget\getDBkey(), and MediaWiki\Linker\LinkTarget\getNamespace().

Referenced by addWatchBatchForUser(), resetNotificationTimestamp(), and uncacheTitlesForUser().

◆ uncacheAllItemsForUser()

WatchedItemStore::uncacheAllItemsForUser ( User $user )

private

Definition at line 283 of file WatchedItemStore.php.

References $user, as, and cache().

Referenced by clearUserWatchedItems().

◆ uncacheLinkTarget()

WatchedItemStore::uncacheLinkTarget ( LinkTarget $target )

private

Definition at line 193 of file WatchedItemStore.php.

References as, cache(), MediaWiki\Linker\LinkTarget\getDBkey(), and MediaWiki\Linker\LinkTarget\getNamespace().

Referenced by updateNotificationTimestamp().

◆ uncacheTitlesForUser()

WatchedItemStore::uncacheTitlesForUser	(	User	$user,
		array	$titles
	)

private

Parameters

User	$user
Title[]	$titles

Definition at line 1248 of file WatchedItemStore.php.

References $title, $titles, as, and uncache().

Referenced by removeWatchBatchForUser().

◆ uncacheUser()

WatchedItemStore::uncacheUser ( User $user )

private

Definition at line 204 of file WatchedItemStore.php.

References $user, as, cache(), and getPageSeenTimestampsKey().

Referenced by setNotificationTimestampsForUser().

◆ updateNotificationTimestamp()

WatchedItemStore::updateNotificationTimestamp	(	User	$editor,
		LinkTarget	$target,
			$timestamp
	)

Since: 1.27

Parameters

User	$editor
LinkTarget	$target
string \| int	$timestamp

Returns: int[]

Implements WatchedItemStoreInterface.

Definition at line 929 of file WatchedItemStore.php.

References $editor, $fname, DeferredUpdates\addCallableUpdate(), as, captcha-old\count, DB_MASTER, getConnectionRef(), MediaWiki\Linker\LinkTarget\getDBkey(), MediaWiki\Linker\LinkTarget\getNamespace(), DeferredUpdates\POSTSEND, uncacheLinkTarget(), and use.

Member Data Documentation

◆ $cache

HashBagOStuff WatchedItemStore::$cache

private

Definition at line 49 of file WatchedItemStore.php.

Referenced by __construct(), and resetNotificationTimestamp().

◆ $cacheIndex

array [] WatchedItemStore::$cacheIndex = []

private

Looks like $cacheIndex[Namespace ID][Target DB Key][User Id] => 'key' The index is needed so that on mass changes all relevant items can be un-cached.

For example: Clearing a users watchlist of all items or updating notification timestamps for all users watching a single target.

Definition at line 62 of file WatchedItemStore.php.

◆ $deferredUpdatesAddCallableUpdateCallback

callable null WatchedItemStore::$deferredUpdatesAddCallableUpdateCallback

private

Definition at line 67 of file WatchedItemStore.php.

Referenced by overrideDeferredUpdatesAddCallableUpdateCallback().

◆ $latestUpdateCache

HashBagOStuff WatchedItemStore::$latestUpdateCache

private

Definition at line 54 of file WatchedItemStore.php.

◆ $lbFactory

ILBFactory WatchedItemStore::$lbFactory

private

Definition at line 24 of file WatchedItemStore.php.

Referenced by __construct().

◆ $loadBalancer

LoadBalancer WatchedItemStore::$loadBalancer

private

Definition at line 29 of file WatchedItemStore.php.

◆ $queueGroup

JobQueueGroup WatchedItemStore::$queueGroup

private

Definition at line 34 of file WatchedItemStore.php.

Referenced by __construct().

◆ $readOnlyMode

ReadOnlyMode WatchedItemStore::$readOnlyMode

private

Definition at line 44 of file WatchedItemStore.php.

Referenced by __construct().

◆ $revisionGetTimestampFromIdCallback

callable null WatchedItemStore::$revisionGetTimestampFromIdCallback

private

Definition at line 72 of file WatchedItemStore.php.

Referenced by overrideRevisionGetTimestampFromIdCallback().

◆ $stash

BagOStuff WatchedItemStore::$stash

private

Definition at line 39 of file WatchedItemStore.php.

Referenced by __construct().

◆ $stats

StatsdDataFactoryInterface WatchedItemStore::$stats

private

Definition at line 82 of file WatchedItemStore.php.

Referenced by setStatsdDataFactory().

◆ $updateRowsPerQuery

int WatchedItemStore::$updateRowsPerQuery

private

Definition at line 77 of file WatchedItemStore.php.

Referenced by __construct().

The documentation for this class was generated from the following file:

includes/watcheditem/WatchedItemStore.php

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addWatch()

◆ addWatchBatchForUser()

◆ cache()

◆ clearUserWatchedItems()

◆ clearUserWatchedItemsUsingJobQueue()

◆ countUnreadNotifications()

◆ countVisitingWatchers()

◆ countVisitingWatchersMultiple()

◆ countWatchedItems()

◆ countWatchers()

◆ countWatchersMultiple()

◆ dbCond()

◆ duplicateAllAssociatedEntries()

◆ duplicateEntry()

◆ getCached()

◆ getCacheKey()

◆ getConnectionRef()

◆ getLatestNotificationTimestamp()

◆ getMaxId()

◆ getNotificationTimestamp()

◆ getNotificationTimestampsBatch()

◆ getPageSeenKey()

◆ getPageSeenTimestamps()

◆ getPageSeenTimestampsKey()

◆ getTitleDbKeysGroupedByNamespace()

◆ getVisitingWatchersCondition()

◆ getWatchedItem()

◆ getWatchedItemsForUser()

◆ isWatched()

◆ loadWatchedItem()

◆ overrideDeferredUpdatesAddCallableUpdateCallback()

◆ overrideRevisionGetTimestampFromIdCallback()

◆ removeWatch()

◆ removeWatchBatchForUser()

◆ resetAllNotificationTimestampsForUser()

◆ resetNotificationTimestamp()

◆ setNotificationTimestampsForUser()

◆ setStatsdDataFactory()

◆ uncache()

◆ uncacheAllItemsForUser()

◆ uncacheLinkTarget()

◆ uncacheTitlesForUser()

◆ uncacheUser()

◆ updateNotificationTimestamp()

Member Data Documentation

◆ $cache

◆ $cacheIndex

◆ $deferredUpdatesAddCallableUpdateCallback

◆ $latestUpdateCache

◆ $lbFactory

◆ $loadBalancer

◆ $queueGroup

◆ $readOnlyMode

◆ $revisionGetTimestampFromIdCallback

◆ $stash

◆ $stats

◆ $updateRowsPerQuery