60 parent::__construct( $query, $moduleName,
'wr' );
61 $this->watchedItemQueryService = $watchedItemQueryService;
62 $this->contentLanguage = $contentLanguage;
63 $this->namespaceInfo = $namespaceInfo;
64 $this->genderCache = $genderCache;
72 $this->
run( $resultPageSet );
79 private function run( $resultPageSet =
null ) {
84 $prop = array_fill_keys( (array)
$params[
'prop'],
true );
85 $show = array_fill_keys( (array)
$params[
'show'],
true );
86 if ( isset( $show[WatchedItemQueryService::FILTER_CHANGED] )
87 && isset( $show[WatchedItemQueryService::FILTER_NOT_CHANGED] )
94 $options[
'namespaceIds'] =
$params[
'namespace'];
96 if ( isset( $show[WatchedItemQueryService::FILTER_CHANGED] ) ) {
99 if ( isset( $show[WatchedItemQueryService::FILTER_NOT_CHANGED] ) ) {
103 if ( isset(
$params[
'continue'] ) ) {
105 $options[
'startFrom'] = TitleValue::tryNew( $cont[0], $cont[1] );
109 if ( isset(
$params[
'fromtitle'] ) ) {
113 if ( isset(
$params[
'totitle'] ) ) {
118 if (
$params[
'dir'] ===
'descending' ) {
121 $options[
'limit'] =
$params[
'limit'] + 1;
125 $items = $this->watchedItemQueryService->getWatchedItemsForUser( $user, $options );
128 if ( $items !== [] && $resultPageSet ===
null &&
129 $this->contentLanguage->needsGenderDistinction()
132 foreach ( $items as $item ) {
133 $linkTarget = $item->getTarget();
134 if ( $this->namespaceInfo->hasGenderDistinction( $linkTarget->getNamespace() ) ) {
135 $usernames[] = $linkTarget->getText();
138 if ( $usernames !== [] ) {
139 $this->genderCache->doQuery( $usernames, __METHOD__ );
143 foreach ( $items as $item ) {
144 $ns = $item->getTarget()->getNamespace();
145 $dbKey = $item->getTarget()->getDBkey();
146 if ( ++$count >
$params[
'limit'] ) {
152 $t = Title::makeTitle( $ns, $dbKey );
154 if ( $resultPageSet ===
null ) {
157 if ( isset( $prop[
'changed'] ) && $item->getNotificationTimestamp() !==
null ) {
158 $vals[
'changed'] =
wfTimestamp( TS_ISO_8601, $item->getNotificationTimestamp() );
169 if ( $resultPageSet ===
null ) {
172 $resultPageSet->populateFromTitles( $titles );
182 ParamValidator::PARAM_ISMULTI =>
true,
183 ParamValidator::PARAM_TYPE =>
'namespace'
186 ParamValidator::PARAM_DEFAULT => 10,
187 ParamValidator::PARAM_TYPE =>
'limit',
188 IntegerDef::PARAM_MIN => 1,
193 ParamValidator::PARAM_ISMULTI =>
true,
194 ParamValidator::PARAM_TYPE => [
200 ParamValidator::PARAM_ISMULTI =>
true,
201 ParamValidator::PARAM_TYPE => [
202 WatchedItemQueryService::FILTER_CHANGED,
203 WatchedItemQueryService::FILTER_NOT_CHANGED
207 ParamValidator::PARAM_TYPE =>
'user',
208 UserDef::PARAM_ALLOWED_USER_TYPES => [
'name' ],
211 ParamValidator::PARAM_TYPE =>
'string',
212 ParamValidator::PARAM_SENSITIVE =>
true,
215 ParamValidator::PARAM_DEFAULT =>
'ascending',
216 ParamValidator::PARAM_TYPE => [
222 ParamValidator::PARAM_TYPE =>
'string'
225 ParamValidator::PARAM_TYPE =>
'string'
232 'action=query&list=watchlistraw'
233 =>
'apihelp-query+watchlistraw-example-simple',
234 'action=query&generator=watchlistraw&gwrshow=changed&prop=info'
235 =>
'apihelp-query+watchlistraw-example-generator',
240 return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Watchlistraw';
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
array $params
The job parameters.
dieWithError( $msg, $code=null, $data=null, $httpCode=0)
Abort execution with an error.
getWatchlistUser( $params)
Gets the user for whom to get the watchlist.
dieContinueUsageIf( $condition)
Die with the 'badcontinue' error.
parseContinueParamOrDie(string $continue, array $types)
Parse the 'continue' parameter in the usual format and validate the types of each part,...
const PARAM_HELP_MSG_PER_VALUE
((string|array|Message)[]) When PARAM_TYPE is an array, or 'string' with PARAM_ISMULTI,...
const LIMIT_BIG1
Fast query, standard limit.
getResult()
Get the result object.
extractRequestParams( $options=[])
Using getAllowedParams(), this function makes an array of the values provided by the user,...
const PARAM_HELP_MSG
(string|array|Message) Specify an alternative i18n documentation message for this parameter.
const LIMIT_BIG2
Fast query, apihighlimits limit.
getModuleName()
Get the name of the module being executed by this instance.
static addTitleInfo(&$arr, $title, $prefix='')
Add information (title and namespace) about a Title object to a result array.
parsePrefixedTitlePart( $titlePart, $defaultNamespace=NS_MAIN)
Convert an input title or title prefix into a TitleValue.
setContinueEnumParameter( $paramName, $paramValue)
Overridden to set the generator param if in generator mode.
This query action allows clients to retrieve a list of pages on the logged-in user's watchlist.
getHelpUrls()
Return links to more detailed help pages about the module.
getExamplesMessages()
Returns usage examples for this module.
__construct(ApiQuery $query, $moduleName, WatchedItemQueryService $watchedItemQueryService, Language $contentLanguage, NamespaceInfo $namespaceInfo, GenderCache $genderCache)
executeGenerator( $resultPageSet)
Execute this module as a generator.
execute()
Evaluates the parameters, performs the requested query, and sets up the result.
getAllowedParams()
Returns an array of allowed parameters (parameter name) => (default value) or (parameter name) => (ar...
This is the main query class.
Base class for language-specific code.