* @author Kunal Mehta * * @since 1.24 * @stable to extend * @ingroup Content */ class JsonContentHandler extends CodeContentHandler { /** * @param string $modelId * @stable to call */ public function __construct( $modelId = CONTENT_MODEL_JSON ) { parent::__construct( $modelId, [ CONTENT_FORMAT_JSON ] ); } /** * @return class-string */ protected function getContentClass() { return JsonContent::class; } public function makeEmptyContent() { $class = $this->getContentClass(); return new $class( '{}' ); } /** * Enables EditPage's preload feature on .json pages as well as for extensions like MassMessage * that subclass {@see JsonContentHandler}. * * @return true */ public function supportsPreloadContent(): bool { return true; } /** * @param Content $content * @param ValidationParams $validationParams * @return StatusValue */ public function validateSave( Content $content, ValidationParams $validationParams ) { $status = parent::validateSave( $content, $validationParams ); '@phan-var JsonContent $content'; if ( !$status->isOK() ) { if ( !$content->getData()->isGood() ) { return StatusValue::newFatal( $content->getData()->getMessage( 'invalid-json-data' ) ); } else { return $status; } } $this->getHookRunner()->onJsonValidateSave( $content, $validationParams->getPageIdentity(), $status ); return $status; } public function preSaveTransform( Content $content, PreSaveTransformParams $pstParams ): Content { '@phan-var JsonContent $content'; // FIXME: WikiPage::doUserEditContent invokes PST before validation. As such, native // data may be invalid (though PST result is discarded later in that case). if ( !$content->isValid() ) { return $content; } $contentClass = $this->getContentClass(); return new $contentClass( JsonContent::normalizeLineEndings( $content->beautifyJSON() ) ); } /** * Set the HTML and add the appropriate styles. * * @since 1.38 * @param Content $content * @param ContentParseParams $cpoParams * @param ParserOutput &$parserOutput The output object to fill (reference). */ protected function fillParserOutput( Content $content, ContentParseParams $cpoParams, ParserOutput &$parserOutput ) { '@phan-var JsonContent $content'; // FIXME: WikiPage::doUserEditContent generates parser output before validation. // As such, native data may be invalid (though output is discarded later in that case). if ( $cpoParams->getGenerateHtml() ) { if ( $content->isValid() ) { $parserOptions = $cpoParams->getParserOptions(); if ( $cpoParams->getParserOptions()->getUseParsoid() ) { $title = MediaWikiServices::getInstance()->getTitleFactory() ->newFromPageReference( $cpoParams->getPage() ); $parser = MediaWikiServices::getInstance()->getParsoidParserFactory() ->create(); $parserOutput = $parser->parse( // It is necessary to pass a Content rather than a // string in order for Parsoid to handle the // contentmodel correctly. $content, $title, $parserOptions, true, true, $cpoParams->getRevId() ); // Register the use of the 'parsoid' option again, since // we have a new $parserOutput now. $parserOptions->getUseParsoid(); } else { $parserOutput->setRawText( $content->rootValueTable( $content->getData()->getValue() ) ); } } else { $error = wfMessage( 'invalid-json-data' )->parse(); $parserOutput->setRawText( $error ); } $parserOutput->addModuleStyles( [ 'mediawiki.content.json' ] ); } else { $parserOutput->setRawText( null ); } } } /** @deprecated class alias since 1.43 */ class_alias( JsonContentHandler::class, 'JsonContentHandler' );