wanCache = MediaWikiServices::getInstance()->getMainWANObjectCache(); } /** * Get a list of gadget ids from cache/database * * @return string[] */ public function getGadgetIds() { $key = $this->getGadgetIdsKey(); return $this->wanCache->getWithSetCallback( $key, self::CACHE_TTL, function ( $oldValue, &$ttl, array &$setOpts ) { $dbr = wfGetDB( DB_REPLICA ); $setOpts += Database::getCacheSetOptions( $dbr ); return $dbr->selectFieldValues( 'page', 'page_title', [ 'page_namespace' => NS_GADGET_DEFINITION ], __METHOD__ ); }, [ 'checkKeys' => [ $key ], 'pcTTL' => WANObjectCache::TTL_PROC_SHORT, 'lockTSE' => 30 ] ); } /** * Purge the list of gadget ids when a page is deleted or if a new page is created */ public function purgeGadgetIdsList() { $this->wanCache->touchCheckKey( $this->getGadgetIdsKey() ); } /** * @param string $id * @throws InvalidArgumentException * @return Gadget */ public function getGadget( $id ) { $key = $this->getGadgetCacheKey( $id ); $gadget = $this->wanCache->getWithSetCallback( $key, self::CACHE_TTL, function ( $old, &$ttl, array &$setOpts ) use ( $id ) { $setOpts += Database::getCacheSetOptions( wfGetDB( DB_REPLICA ) ); $title = Title::makeTitleSafe( NS_GADGET_DEFINITION, $id ); if ( !$title ) { $ttl = WANObjectCache::TTL_UNCACHEABLE; return null; } $rev = Revision::newFromTitle( $title ); if ( !$rev ) { $ttl = WANObjectCache::TTL_UNCACHEABLE; return null; } $content = $rev->getContent(); if ( !$content instanceof GadgetDefinitionContent ) { // Uhm... $ttl = WANObjectCache::TTL_UNCACHEABLE; return null; } return Gadget::newFromDefinitionContent( $id, $content ); }, [ 'checkKeys' => [ $key ], 'pcTTL' => WANObjectCache::TTL_PROC_SHORT, 'lockTSE' => 30 ] ); if ( $gadget === null ) { throw new InvalidArgumentException( "No gadget registered for '$id'" ); } return $gadget; } /** * Update the cache for a specific Gadget whenever it is updated * * @param string $id */ public function purgeGadgetEntry( $id ) { $this->wanCache->touchCheckKey( $this->getGadgetCacheKey( $id ) ); } /** * @return string */ private function getGadgetIdsKey() { return $this->wanCache->makeKey( 'gadgets', 'namespace', 'ids' ); } /** * @param strng $id * @return string */ private function getGadgetCacheKey( $id ) { return $this->wanCache->makeKey( 'gadgets', 'object', md5( $id ), Gadget::GADGET_CLASS_VERSION ); } }