* * @author Julius Härtl * @author Kate Döen * * @license GNU AGPL version 3 or any later version * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . */ namespace OC\Core\Controller; use OCP\AppFramework\Controller; use OCP\AppFramework\Http; use OCP\AppFramework\Http\Attribute\FrontpageRoute; use OCP\AppFramework\Http\DataDownloadResponse; use OCP\AppFramework\Http\DataResponse; use OCP\Collaboration\Reference\IReferenceManager; use OCP\Files\AppData\IAppDataFactory; use OCP\Files\NotFoundException; use OCP\Files\NotPermittedException; use OCP\IRequest; class ReferenceController extends Controller { public function __construct( string $appName, IRequest $request, private IReferenceManager $referenceManager, private IAppDataFactory $appDataFactory, ) { parent::__construct($appName, $request); } /** * @PublicPage * @NoCSRFRequired * * Get a preview for a reference * * @param string $referenceId the reference cache key * @return DataDownloadResponse|DataResponse * * 200: Preview returned * 404: Reference not found */ #[FrontpageRoute(verb: 'GET', url: '/core/references/preview/{referenceId}')] public function preview(string $referenceId): DataDownloadResponse|DataResponse { $reference = $this->referenceManager->getReferenceByCacheKey($referenceId); try { $appData = $this->appDataFactory->get('core'); $folder = $appData->getFolder('opengraph'); $file = $folder->getFile($referenceId); $contentType = $reference === null || $reference->getImageContentType() === null ? $file->getMimeType() : $reference->getImageContentType(); $response = new DataDownloadResponse( $file->getContent(), $referenceId, $contentType ); } catch (NotFoundException|NotPermittedException $e) { $response = new DataResponse('', Http::STATUS_NOT_FOUND); } $response->cacheFor(3600, false, true); return $response; } }