Move TemplateProvider registration to boot context and make template type registration lazy

Signed-off-by: Julius Härtl <jus@bitgrid.net>
This commit is contained in:
Julius Härtl 2021-01-28 11:50:40 +01:00
parent 2d46971199
commit 6c1b357973
No known key found for this signature in database
GPG Key ID: 4C614C6ED2CDE6DF
8 changed files with 72 additions and 29 deletions

View File

@ -44,7 +44,7 @@ class TemplateController extends OCSController {
* @NoAdminRequired
*/
public function list(): DataResponse {
return new DataResponse($this->templateManager->listCreators());
return new DataResponse($this->templateManager->listTemplates());
}
/**

View File

@ -315,7 +315,7 @@ return array(
'OCP\\Files\\Storage\\IStorage' => $baseDir . '/lib/public/Files/Storage/IStorage.php',
'OCP\\Files\\Storage\\IStorageFactory' => $baseDir . '/lib/public/Files/Storage/IStorageFactory.php',
'OCP\\Files\\Storage\\IWriteStreamStorage' => $baseDir . '/lib/public/Files/Storage/IWriteStreamStorage.php',
'OCP\\Files\\Template\\CreatedFromTemplateEvent' => $baseDir . '/lib/public/Files/Template/CreatedFromTemplateEvent.php',
'OCP\\Files\\Template\\FileCreatedFromTemplateEvent' => $baseDir . '/lib/public/Files/Template/FileCreatedFromTemplateEvent.php',
'OCP\\Files\\Template\\ICustomTemplateProvider' => $baseDir . '/lib/public/Files/Template/ICustomTemplateProvider.php',
'OCP\\Files\\Template\\ITemplateManager' => $baseDir . '/lib/public/Files/Template/ITemplateManager.php',
'OCP\\Files\\Template\\Template' => $baseDir . '/lib/public/Files/Template/Template.php',

View File

@ -344,7 +344,7 @@ class ComposerStaticInit53792487c5a8370acc0b06b1a864ff4c
'OCP\\Files\\Storage\\IStorage' => __DIR__ . '/../../..' . '/lib/public/Files/Storage/IStorage.php',
'OCP\\Files\\Storage\\IStorageFactory' => __DIR__ . '/../../..' . '/lib/public/Files/Storage/IStorageFactory.php',
'OCP\\Files\\Storage\\IWriteStreamStorage' => __DIR__ . '/../../..' . '/lib/public/Files/Storage/IWriteStreamStorage.php',
'OCP\\Files\\Template\\CreatedFromTemplateEvent' => __DIR__ . '/../../..' . '/lib/public/Files/Template/CreatedFromTemplateEvent.php',
'OCP\\Files\\Template\\FileCreatedFromTemplateEvent' => __DIR__ . '/../../..' . '/lib/public/Files/Template/FileCreatedFromTemplateEvent.php',
'OCP\\Files\\Template\\ICustomTemplateProvider' => __DIR__ . '/../../..' . '/lib/public/Files/Template/ICustomTemplateProvider.php',
'OCP\\Files\\Template\\ITemplateManager' => __DIR__ . '/../../..' . '/lib/public/Files/Template/ITemplateManager.php',
'OCP\\Files\\Template\\Template' => __DIR__ . '/../../..' . '/lib/public/Files/Template/Template.php',

View File

@ -77,6 +77,9 @@ class RegistrationContext {
/** @var array[] */
private $wellKnownHandlers = [];
/** @var array[] */
private $templateProviders = [];
/** @var ILogger */
private $logger;
@ -186,6 +189,13 @@ class RegistrationContext {
$class
);
}
public function registerTemplateProvider(string $providerClass): void {
$this->context->registerTemplateProvider(
$this->appId,
$providerClass
);
}
};
}
@ -279,6 +289,13 @@ class RegistrationContext {
];
}
public function registerTemplateProvider(string $appId, string $class): void {
$this->templateProviders[] = [
'appId' => $appId,
'class' => $class,
];
}
/**
* @param App[] $apps
*/
@ -451,7 +468,7 @@ class RegistrationContext {
}
/**
* @erturn array[]
* @return array[]
*/
public function getInitialStates(): array {
return $this->initialStates;
@ -463,4 +480,8 @@ class RegistrationContext {
public function getWellKnownHandlers(): array {
return $this->wellKnownHandlers;
}
public function getTemplateProviders(): array {
return $this->templateProviders;
}
}

View File

@ -26,6 +26,7 @@ declare(strict_types=1);
namespace OC\Files\Template;
use OC\AppFramework\Bootstrap\Coordinator;
use OC\Files\Cache\Scanner;
use OCP\EventDispatcher\IEventDispatcher;
use OCP\Files\Folder;
@ -35,7 +36,7 @@ use OCP\Files\IRootFolder;
use OCP\Files\Node;
use OCP\Files\NotFoundException;
use OCP\Files\NotPermittedException;
use OCP\Files\Template\CreatedFromTemplateEvent;
use OCP\Files\Template\FileCreatedFromTemplateEvent;
use OCP\Files\Template\ICustomTemplateProvider;
use OCP\Files\Template\ITemplateManager;
use OCP\Files\Template\Template;
@ -48,10 +49,11 @@ use OCP\L10N\IFactory;
use Psr\Log\LoggerInterface;
class TemplateManager implements ITemplateManager {
private $registeredTypes = [];
private $types = [];
private $registeredProviders = [];
private $providers;
/** @var array|null */
private $providers = null;
private $serverContainer;
private $eventDispatcher;
@ -62,10 +64,13 @@ class TemplateManager implements ITemplateManager {
private $logger;
private $userId;
private $l10nFactory;
/** @var Coordinator */
private $bootstrapCoordinator;
public function __construct(
IServerContainer $serverContainer,
IEventDispatcher $eventDispatcher,
Coordinator $coordinator,
IRootFolder $rootFolder,
IUserSession $userSession,
IPreview $previewManager,
@ -75,6 +80,7 @@ class TemplateManager implements ITemplateManager {
) {
$this->serverContainer = $serverContainer;
$this->eventDispatcher = $eventDispatcher;
$this->bootstrapCoordinator = $coordinator;
$this->rootFolder = $rootFolder;
$this->previewManager = $previewManager;
$this->config = $config;
@ -85,39 +91,45 @@ class TemplateManager implements ITemplateManager {
$this->userId = $user ? $user->getUID() : null;
}
public function registerTemplateFileCreator(TemplateFileCreator $templateType): void {
$this->types[] = $templateType;
}
public function registerTemplateProvider(string $providerClass): void {
$this->registeredProviders[] = $providerClass;
public function registerTemplateFileCreator(callable $callback): void {
$this->registeredTypes[] = $callback;
}
public function getRegisteredProviders(): array {
if ($this->providers !== null) {
return $this->providers;
}
$context = $this->bootstrapCoordinator->getRegistrationContext();
$this->providers = [];
foreach ($this->registeredProviders as $providerClass) {
$this->providers[$providerClass] = $this->serverContainer->get($providerClass);
foreach ($context->getTemplateProviders() as $provider) {
$this->providers[$provider['class']] = $this->serverContainer->get($provider['class']);
}
return $this->providers;
}
public function listCreators():? array {
if ($this->types === null) {
return null;
public function getTypes(): array {
foreach ($this->registeredTypes as $registeredType) {
$this->types[] = $registeredType();
}
return $this->types;
}
usort($this->types, function (TemplateFileCreator $a, TemplateFileCreator $b) {
public function listCreators(): array {
$types = $this->getTypes();
usort($types, function (TemplateFileCreator $a, TemplateFileCreator $b) {
return $a->getOrder() - $b->getOrder();
});
return $types;
}
public function listTemplates(): array {
return array_map(function (TemplateFileCreator $entry) {
return array_merge($entry->jsonSerialize(), [
'templates' => $this->getTemplateFiles($entry)
]);
}, $this->types);
}, $this->listCreators());
}
/**
@ -148,7 +160,7 @@ class TemplateManager implements ITemplateManager {
$template->copy($targetFile->getPath());
}
}
$this->eventDispatcher->dispatchTyped(new CreatedFromTemplateEvent($template, $targetFile));
$this->eventDispatcher->dispatchTyped(new FileCreatedFromTemplateEvent($template, $targetFile));
return $this->formatFile($userFolder->get($filePath));
} catch (\Exception $e) {
$this->logger->error($e->getMessage(), ['exception' => $e]);

View File

@ -31,6 +31,7 @@ namespace OCP\AppFramework\Bootstrap;
use OCP\AppFramework\IAppContainer;
use OCP\EventDispatcher\IEventDispatcher;
use OCP\Files\Template\ICustomTemplateProvider;
use OCP\IContainer;
/**
@ -196,4 +197,14 @@ interface IRegistrationContext {
* @since 21.0.0
*/
public function registerWellKnownHandler(string $class): void;
/**
* Register a custom template provider class that is able to inject custom templates
* in addition to the user defined ones
*
* @param string $providerClass
* @psalm-param class-string<ICustomTemplateProvider> $providerClass
* @since 21.0.0
*/
public function registerTemplateProvider(string $providerClass): void;
}

View File

@ -32,7 +32,7 @@ use OCP\Files\File;
/**
* @since 21.0.0
*/
class CreatedFromTemplateEvent extends Event {
class FileCreatedFromTemplateEvent extends Event {
private $template;
private $target;

View File

@ -36,19 +36,18 @@ interface ITemplateManager {
/**
* Register a template type support
*
* @param TemplateFileCreator $templateType
* @param callable(): TemplateFileCreator $callback A callback which returns the TemplateFileCreator instance to register
* @since 21.0.0
*/
public function registerTemplateFileCreator(TemplateFileCreator $templateType): void;
public function registerTemplateFileCreator(callable $callback): void;
/**
* Register a custom template provider class that is able to inject custom templates
* in addition to the user defined ones
* Get a list of available file creators
*
* @param string $providerClass
* @return array
* @since 21.0.0
*/
public function registerTemplateProvider(string $providerClass): void;
public function listCreators(): array;
/**
* Get a list of available file creators and their offered templates
@ -56,7 +55,7 @@ interface ITemplateManager {
* @return array
* @since 21.0.0
*/
public function listCreators():? array;
public function listTemplates(): array;
/**
* @return bool